Un canal Webflow correspond à une collection CMS d’un de vos sites Webflow : vos Blog Posts, un Changelog, des Case Studies. Publiez dessus et Ocoya ajoute un nouvel élément : le titre devient son Name et son slug, le texte son corps en rich text, la première image son image principale. Une seule connexion Webflow peut vous donner un canal pour chaque collection des sites que vous avez choisis.
Webflow peut aussi lancer un workflow : un élément publié sur votre site peut être partagé sur vos autres canaux quelques instants plus tard. Voir Webflow dans les workflows plus bas.
Avant de commencer
Il vous faut un site Webflow qui utilise le CMS et possède au moins une collection, et vous devez être autorisé à y installer des applications. Webflow vous demande de choisir les sites pendant la connexion, et Ocoya ne peut atteindre que les collections de ces sites. Il peut lire et écrire des éléments CMS ; il ne peut pas modifier vos pages, vos styles ni vos réglages.
Connecter Webflow
Ouvrir Channels
Sélectionnez Channels dans la barre latérale gauche, puis Connect channel.
Choisir Webflow
Sélectionnez Webflow dans le panneau Add a connection, sous Blogging.
Choisir les sites dans Webflow
Webflow montre ce qu’Ocoya pourra faire et demande quels sites il peut utiliser. Cochez ceux que vous voulez, puis Authorize. Vous avez 10 minutes pour terminer.
Sélectionner les collections à ajouter
De retour dans Ocoya, chaque collection CMS de ces sites est listée, nommée Site name · Each post becomes an item. Choisissez celles que vous voulez comme canaux pour cette marque. S’il n’y a qu’une collection, elle est ajoutée sans question.
Renseigner les champs obligatoires, si demandé
Si une collection exige un champ pour lequel un article n’a rien (un Author, une Category), Ocoya demande ce que chaque post doit utiliser. Voir Champs obligatoires.
Se reconnecter, pour ajouter d’autres sites ou changer les valeurs des champs obligatoires, met à jour la même connexion, et vos canaux existants continuent de fonctionner.
Aspect des posts
| Partie de votre post | Où elle va dans Webflow |
|---|---|
| Titre | Le Name de l’élément, 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 une courte terminaison aléatoire |
| Texte | Un champ Rich text nommé Post Body, Body, Content ou similaire ; sinon le premier champ Rich text |
| Première image | Un champ Image nommé Main Image, Thumbnail, Cover ou similaire ; sinon le premier champ Image |
| Toutes les images | Le premier champ Multi-image, si la collection en a un |
| Résumé | Un champ Plain text nommé Post Summary, Summary, Excerpt, Card Text ou similaire reçoit l’extrait de l’article, ou les 160 premiers caractères du texte |
| Temps de lecture | Un champ nommé Time to read ou Reading time reçoit les minutes, à 200 mots par minute, dans le même format que vos autres éléments, par exemple 5 min read |
Si la première ligne du texte répète le titre, elle est omise du corps pour que le titre ne s’affiche pas deux fois. Les liens ajoutés au post qui ne figurent pas déjà dans le texte sont placés à la fin.
Le texte écrit en Markdown (titres, listes, citations, gras, liens) arrive en vrai rich text. Le texte brut conserve ses paragraphes et ses sauts de ligne, et les adresses web deviennent des liens cliquables. Le texte alternatif des images est transmis à Webflow, qui garde sa propre copie de chaque image.
Tous les autres champs sont laissés tels quels, sauf si la collection les exige.
Champs obligatoires
Les collections Webflow exigent souvent des champs qu’un article n’a pas : une référence Author, une option Category, une région. À la connexion, Ocoya ouvre Fill in required Webflow fields et demande ce que chaque post venant d’Ocoya doit utiliser :
- Les références (un auteur, une catégorie, des tags) se choisissent parmi les éléments de la collection référencée.
- Les options se choisissent parmi les choix propres au champ.
- Les nombres, textes, liens, e-mails et numéros de téléphone prennent une valeur fixe.
Choisissez Save, ou Not now pour le faire plus tard en vous reconnectant à Webflow. Tant qu’aucune valeur n’est choisie, l’éditeur de posts vous avertit avant que vous planifiiez un post vers cette collection, et le post échoue s’il part quand même.
Certains champs obligatoires ne peuvent pas du tout être remplis par Ocoya : une date, un fichier ou un interrupteur obligatoire, ou un second champ Rich text. Rendez-les facultatifs dans Webflow, ou publiez dans une autre collection.
En ligne ou en brouillon
Les posts créés depuis l’éditeur de posts sont publiés en direct : l’élément est mis en ligne sur votre site dès qu’il est publié. Seul cet élément est publié : le reste de votre site, et les modifications non publiées de vos pages, restent tels quels.
Dans un workflow, l’étape Publish to Webflow vous permet de choisir sous In Webflow :
| Réglage | Ce qui se passe |
|---|---|
| Publish live (par défaut) | L’élément est publié tout de suite sur votre site en ligne |
| Keep as draft | L’élément est ajouté comme brouillon, pour que quelqu’un le publie dans Webflow |
C’est distinct de l’interrupteur Save as draft de l’étape, qui garde le post dans votre planificateur Ocoya sans l’envoyer du tout à Webflow.
Un post publié renvoie vers sa page : l’adresse de votre site, le slug de la collection et le slug de l’élément. Un brouillon renvoie vers votre site.
Ce que vous pouvez publier
| Type de post | Pris en charge |
|---|---|
| Texte | Oui |
| Images | Oui, jusqu’à 10. La première est l’image principale |
| GIF | Oui, comme image |
| Vidéo | Non. Un champ vidéo Webflow est un lien vers une vidéo hébergée, pas un envoi |
Un post a besoin de texte ou d’au moins une image.
Limites de Webflow
| Limite | |
|---|---|
| Texte du post | 100 000 caractères |
| Titre | 256 caractères |
| Images | 10 par post |
| Hashtags | Pas de limite. Webflow les affiche comme du texte brut |
Supprimer un post
Supprimer un post publié dans Ocoya dépublie l’élément de votre site et le retire de la collection. Webflow n’a pas de corbeille pour les éléments CMS : il ne peut pas y être restauré. Les éléments créés par votre équipe ne sont jamais touchés.
Webflow dans les workflows
Webflow fonctionne aux deux extrémités d’un workflow.
Publish to Webflow est une action. Choisissez la collection, un Title (son slug en est tiré), la légende et In Webflow : Publish live ou Keep as draft.
New item published in a Webflow collection est un déclencheur. Choisissez un canal de collection, et le workflow s’exécute une fois pour chaque élément publié.
| 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 quand un élément atteint cette valeur (brouillons compris) au lieu de quand il est publié |
Comportement du déclencheur :
- Un élément publié déclenche une exécution en quelques instants. Webflow prévient Ocoya dès qu’un élément est publié ou modifié. Ocoya vérifie aussi une fois par jour, au cas où une notification se serait perdue.
- Rien d’antérieur à l’activation du workflow ne compte. Les éléments déjà présents sur votre site sont ignorés.
- Chaque élément ne déclenche qu’une exécution. Le modifier ou le republier plus tard ne le republie pas.
- Jusqu’à 10 éléments sont traités par vérification. Publiez-en cinquante d’un coup et ils seront traités au fil des vérifications suivantes, 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é Post Summary devient {{trigger.post_summary}}. Vous pouvez aussi utiliser :
| Valeur | Ce qu’elle contient |
|---|---|
{{trigger.title}} | Le Name de l’élément |
{{trigger.url}} | La page de l’élément sur votre site. Vide pour un brouillon ou un élément non publié |
{{trigger.text}} | Le champ de résumé, sinon le corps en texte brut, sinon le Name |
{{trigger.image}} | La première image. {{trigger.images}} les contient toutes |
Le rich text arrive en texte brut, les options sous forme de noms, et les références sous forme d’ID d’élément plutôt que de noms. Si vous laissez vide la légende ou les médias d’une étape Post to qui suit, elle utilise {{trigger.text}} et les images de l’élément.
Déconnexion
Déconnecter un canal Webflow dans Ocoya arrête les publications d’Ocoya à cet endroit. Les éléments déjà publiés restent sur votre site.
Pour retirer complètement Ocoya de Webflow, révoquez l’application Ocoya dans les réglages des applications et intégrations de votre compte Webflow. Chaque canal Webflow de cette connexion affiche alors Reconnect needed à sa prochaine publication.
Problèmes courants
“… has required fields with no value chosen: …” La collection exige un champ pour lequel Ocoya n’a pas de valeur. Reconnectez Webflow et renseignez Fill in required Webflow fields, ou rendez le champ facultatif dans Webflow.
“… has required fields Ocoya cannot fill: …” La collection exige un champ d’un type qu’Ocoya ne peut pas remplir, comme une date ou un fichier. Rendez-le facultatif dans Webflow, ou publiez dans une autre collection.
“… has no Rich text field for the post’s text.” Ajoutez un champ Rich text à la collection dans Webflow.
“… requires an image.” L’image principale de la collection est obligatoire. Ajoutez une image au post.
“Webflow no longer accepts this connection. Reconnect Webflow.” Ocoya a été révoqué dans Webflow. Reconnectez-vous ; voir Reconnecter un canal.
“Ocoya can no longer reach this Webflow site.” Le site a été omis lors de votre dernière connexion. Reconnectez Webflow et choisissez-le.
“Webflow cannot find this collection.” La collection a été supprimée, ou son site n’est plus partagé avec Ocoya. Choisissez un autre canal.
“Webflow is rate limiting requests.” Webflow a demandé à Ocoya de ralentir. Le post peut être réessayé dans une minute.
“Webflow authorization was declined.” Vous avez sélectionné Cancel sur l’écran de Webflow. Reconnectez-vous et choisissez Authorize.
Une collection attendue n’est pas listée. Vérifiez que son site était coché sur l’écran de Webflow. Reconnectez-vous pour l’ajouter.