Framer est en bêta dans Ocoya. Il repose sur la Server API de Framer, que Framer lui-même considère encore comme bêta : des choses peuvent donc changer au gré des évolutions de Framer.
Un canal Framer correspond à une collection CMS d’un projet Framer : votre Blog, un Journal, des Case Studies. Publiez dessus et Ocoya ajoute un nouvel élément, avec le titre, le contenu mis en forme, l’image de couverture et la date renseignés. Ensuite, sauf si vous avez choisi de le garder en brouillon, Ocoya publie le site.
Framer peut aussi lancer un workflow : un nouvel élément dans une collection peut être partagé sur vos autres canaux. Voir Framer dans les workflows ci-dessous.
Avant de commencer
Framer n’a pas de connexion pour les applications. À la place, Ocoya utilise la Server API de Framer, qui s’ouvre avec une clé d’API créée dans les réglages du projet. Une clé ne donne accès qu’à ce projet : pour connecter trois sites Framer, connectez chacun avec sa propre clé.
Vous devez pouvoir ouvrir les Site Settings du projet. La Server API de Framer est en bêta.
Connecter Framer
Créer une clé d’API dans Framer
Ouvrez le projet dans Framer, puis Settings → General. Sous API keys, cliquez sur Add et copiez la clé.
Copier l’adresse du projet
Avec le projet ouvert, copiez l’adresse depuis votre navigateur. Elle commence par https://framer.com/projects/.
Choisir Framer dans Ocoya
Sélectionnez Channels dans la barre latérale gauche, puis Connect channel, et choisissez Framer sous Blogging.
Coller l’adresse et la clé
Collez-les dans Project address et Framer API key, puis sélectionnez Connect Framer. Ocoya ouvre aussitôt le projet pour vérifier que la clé fonctionne.
Sélectionner les collections à ajouter
Toutes les collections du projet sont listées, sous la forme Nom du projet · Each post becomes an item. Choisissez celles que vous voulez comme canaux pour cette marque. S’il n’y en a qu’une, elle est ajoutée sans vous demander.
Une collection qu’un plugin Framer maintient synchronisée, depuis Google Sheets ou Notion par exemple, est listée mais ne peut pas être sélectionnée : A plugin manages this collection, so posts cannot be added to it. Framer ne laisse ce plugin y écrire que lui seul.
Pour remplacer la clé, reconnectez Framer avec la même adresse de projet et la nouvelle clé. Vos canaux continuent de fonctionner.
Comment les publications apparaissent
| Partie de votre publication | Où elle va dans Framer |
|---|---|
| Titre | Le champ sur lequel repose le slug de la collection, généralement Title, jusqu’à 256 caractères. Sans titre, la première ligne de votre texte est utilisée |
| Titre | Le Slug, en lettres minuscules, chiffres et tirets. Un slug déjà utilisé dans la collection reçoit -2, -3, et ainsi de suite |
| Texte | Un champ Formatted Text nommé Content, Body ou similaire, sinon le premier champ Formatted Text |
| Première image | Un champ Image nommé Image, Cover, Thumbnail ou similaire, sinon le premier champ Image. Seule la première image est utilisée |
| Résumé | Un champ texte nommé Summary, Excerpt ou Subtitle reçoit l’extrait de l’article, ou les 160 premiers caractères du texte |
| Date | Un champ Date nommé Date, Published ou similaire est défini sur le moment de la publication |
Si la première ligne du texte reprend le titre, elle est retirée du corps. Les liens que vous avez ajoutés à la publication et qui ne figurent pas déjà dans le texte sont placés à la fin. Le Markdown (titres, listes, citations, gras, liens) arrive sous forme de vrai texte mis en forme, et le texte alternatif des images est transmis à Framer, qui conserve sa propre copie de l’image.
Tous les autres champs sont laissés tels quels.
Ce que fait la publication en direct
Les publications issues de l’éditeur de publications sont publiées en direct : Ocoya ajoute l’élément, puis publie le projet et le déploie sur votre domaine personnalisé.
Framer publie un projet dans son ensemble. Toutes les autres modifications non publiées du projet sont mises en ligne avec l’article : une page à moitié terminée, une refonte en cours. Si quelqu’un travaille sur le site, utilisez plutôt un workflow avec Keep as draft.
Si Framer est brièvement indisponible, Ocoya réessaie plusieurs fois pendant la minute suivante. S’il ne parvient toujours pas à publier, le nouvel élément est retiré et la publication échoue : une publication en échec ne laisse donc jamais d’élément parasite dans votre collection.
Dans un workflow, l’étape Publish to Framer CMS vous permet de choisir sous In Framer :
| Réglage | Ce qui se passe |
|---|---|
| Publish live (par défaut) | L’élément est ajouté et le site est publié |
| Keep as draft | L’élément est ajouté en brouillon. Framer exclut les brouillons de chaque publication tant que quelqu’un ne le modifie pas |
C’est distinct de l’interrupteur Save as draft de l’étape, qui garde la publication dans votre planner Ocoya sans l’envoyer du tout à Framer.
Une publication publiée renvoie vers sa page sur votre site, en utilisant le chemin de la page CMS de la collection dans Framer, par exemple /blog/your-post. Si aucune page n’affiche la collection, ou si l’élément est un brouillon, elle renvoie vers l’élément dans Framer.
Vous n’avez pas besoin que Framer soit ouvert pour tout cela. Ocoya communique directement avec les serveurs de Framer.
Ce que vous pouvez publier
| Type de publication | Pris en charge |
|---|---|
| Texte | Oui |
| Images | Oui : la première devient la couverture. Les collections Framer contiennent une image par champ Image |
| GIF | Oui, comme image |
| Vidéo | Non |
Une publication doit contenir du texte ou une image.
Les limites de Framer
| Limite | |
|---|---|
| Texte de la publication | 100 000 caractères |
| Titre | 256 caractères |
| Images | 1 utilisée par publication |
| Hashtags | Pas de limite. Framer les affiche comme du texte simple |
Supprimer une publication
Supprimer une publication publiée dans Ocoya retire l’élément de la collection. Ocoya ne publie pas le site lorsque vous supprimez, afin que le travail inachevé de personne ne soit mis en ligne à cause de cela : l’élément quitte votre site en direct à la prochaine publication du projet. Les éléments créés par votre équipe ne sont jamais touchés.
Framer dans les workflows
Framer fonctionne aux deux extrémités d’un workflow.
Publish to Framer CMS est une action. Choisissez la collection, un Title (son slug en est tiré), la légende, et In Framer : Publish live ou Keep as draft.
New item in a Framer collection est un déclencheur. Choisissez un canal de collection, et le workflow s’exécute une fois pour chaque nouvel élément.
| Réglage | Ce qu’il fait |
|---|---|
| Collection | La collection à surveiller. Elle doit d’abord être connectée comme canal |
| Only when | Facultatif. Un nom de champ et une valeur, comme Category et News. Le workflow s’exécute alors lorsqu’un élément atteint cette valeur (brouillons compris) au lieu de s’exécuter à son ajout |
Comportement du déclencheur :
- Ocoya vérifie toutes les 15 minutes. Framer ne notifie pas les applications des changements : un nouvel élément peut donc mettre jusqu’à 15 minutes à lancer son exécution.
- Les brouillons sont ignorés. Sans Only when, un élément s’exécute dès qu’il est dans la collection et n’est pas un brouillon.
- Rien d’antérieur à l’activation du workflow n’est pris en compte. Les éléments déjà présents dans la collection sont laissés de côté, et un élément compte à partir de sa création.
- Chaque élément s’exécute une seule fois. Le modifier ensuite ne le republie pas.
- Jusqu’à 10 éléments s’exécutent par vérification, du plus ancien au plus récent.
Chaque champ de l’élément est disponible pour les étapes qui suivent le déclencheur, écrit en minuscules avec des tirets bas : un champ appelé Cover Image devient {{trigger.cover_image}}. Vous pouvez aussi utiliser :
| Valeur | Ce qu’elle contient |
|---|---|
{{trigger.title}} | Le champ titre, sinon le slug |
{{trigger.url}} | La page de l’élément sur votre site. Vide pour un brouillon, ou lorsqu’aucune page n’affiche la collection |
{{trigger.text}} | Le champ résumé, sinon le contenu en texte brut, sinon le titre |
{{trigger.image}} | La première image. {{trigger.images}} les contient toutes |
Le texte mis en forme arrive en texte brut, les options sous forme de leurs noms et les références sous forme d’ID d’élément. Si vous laissez vide la légende ou les médias d’une étape Post to suivante, elle utilise {{trigger.text}} et les images de l’élément.
Déconnexion
Déconnecter un canal Framer dans Ocoya arrête les publications d’Ocoya à cet endroit. Les éléments déjà ajoutés restent dans votre collection.
Pour couper totalement l’accès d’Ocoya, supprimez sa clé d’API dans Site Settings → General du projet. Chaque canal Framer de ce projet affiche alors Reconnect needed à la prochaine publication.
Problèmes courants
“Framer no longer accepts this API key.” La clé a été supprimée, ou elle appartient à un autre projet. Créez une nouvelle clé dans les Site Settings du projet et reconnectez Framer avec elle.
“Paste the project’s address from your browser…” L’adresse du projet doit commencer par https://framer.com/projects/. Copiez-la depuis la barre d’adresse du navigateur, avec le projet ouvert.
“Framer would not publish the site (…), so the item was not added.” Framer a refusé de publier même après qu’Ocoya a réessayé. Rien n’a été laissé dans la collection. Réessayez plus tard.
“A plugin manages the Framer collection …” Cette collection est synchronisée par un plugin. Publiez sur une collection que vous gérez vous-même.
“The Framer collection … has no formatted text field for the post.” Ajoutez un champ Formatted Text à la collection dans Framer.
“Framer is busy” / “Framer took too long to answer.” Les serveurs de Framer ont mis du temps à ouvrir le projet. Réessayez dans une minute.
“Too many sessions are open with this Framer API key.” Plusieurs publications ou workflows ont atteint le projet en même temps. Réessayez dans une minute.