Publier sur BaseHub

Connecte ton repository BaseHub une fois et GrowWriter ajoute une ligne à une collection pour chaque article que tu publies, commitée et en ligne tout de suite. Il te faut environ dix minutes et un admin token pour le repository.

Ce qu'il te faut

• Un accès au repository BaseHub que ton site lit.
• Un Admin Token pour ce repository, créé dans la section suivante.
• Une collection pour les billets, avec ses champs déjà définis.

Si quelqu'un d'autre a installé BaseHub pour ton site, envoie-lui cette section. Le token est la seule chose que cette personne doit te transmettre.

Créer le token

1. Ouvre le repository sur basehub.com.
2. Va dans les réglages du repository, puis API Tokens.
3. Crée un Admin Token. Il doit avoir un accès en écriture ; un token en lecture ne peut pas publier.
4. Copie-le. BaseHub ne le montre qu'une fois.

Connecter dans GrowWriter

Ouvre la page Canaux, trouve BaseHub sous Sites web & CMS et clique sur Connecter.

1. Admin Token : colle le token.
2. Clique sur Tester la connexion. Connexion réussie veut dire que GrowWriter peut lire le repository et y écrire.

Deux réglages facultatifs se trouvent sous Options avancées :

• URL du tableau de bord : l'adresse du repository, comme https://basehub.com/your-team/your-repo. Avec elle, le lien Voir l'article après publication ouvre la ligne dans BaseHub.
• Langues : les codes des variantes de langue de ton repository, séparés par des virgules, comme en, es. Laisse en si tu n'utilises pas de variantes.

Choisir la collection

L'étape 2 liste les collections du repository. Choisis celle que ton site utilise pour les billets et clique sur Continuer.

Si la liste dit Aucune collection où publier, crée d'abord une collection dans BaseHub, puis clique sur Retour et Continuer pour recharger.

Associer les champs

L'étape 3 associe chaque champ GrowWriter à un champ de la collection : titre, slug, contenu, méta-description, image de couverture, date de publication, date de modification et auteur. GrowWriter associe ce qu'il peut par nom et te dit combien il en a trouvé ; règle le reste depuis les listes déroulantes ou choisis Ignorer.

Deux détails bons à savoir :

• Le contenu arrive en texte riche produit depuis le Markdown, donc choisis un champ texte riche pour lui.
• Associe Date de modification à un champ date si tu en as un. GrowWriter la met à jour à chaque republication tandis que la date de publication ne bouge pas.

Clique sur Enregistrer la connexion. La ligne sur la page Canaux affiche Connecté.

Publier ton premier article

Ouvre ta Bibliothèque, choisis un article terminé et clique sur Publier. Coche BaseHub, choisis un auteur si ton mappage en a un, et clique sur Publier. GrowWriter ajoute la ligne et la commite, donc l'article est en ligne dès que ton site se reconstruit ou recharge ses données.

Publier à nouveau plus tard met à jour la même ligne sur place. Le flux complet, avec captures d'écran, est sur Choisir où publier.

Dépannage

• Le token BaseHub est invalide ou n'a pas d'accès en écriture : crée un nouvel Admin Token, clique sur Déconnecter et connecte à nouveau.
• La collection BaseHub est introuvable : la collection a été supprimée ou renommée. Déconnecte, reconnecte et choisis-la à nouveau.
• BaseHub a rejeté la mise à jour : un champ associé n'accepte pas la valeur, généralement un champ obligatoire laissé sur Ignorer ou un mauvais type de champ. Reconnecte et ajuste le mappage.
• L'auteur sélectionné n'existe plus dans le CMS : choisis un autre auteur dans la boîte de dialogue de publication.