docs.semactic › Intégrations

Drupal

Le connecteur Drupal publie les articles de Content Studio comme contenus de votre site Drupal, puis les met à jour depuis Semactic. Il ne s'appuie que sur des modules du cœur de Drupal : rien à installer.

[!INFO] Sur cette page : préparer le site Drupal, connecter Semactic, choisir où publier, publier un article, mettre à jour un article, ce qui est envoyé à Drupal, déconnecter, dépannage.

Préparer votre site Drupal

À faire une seule fois, par un administrateur du site.

Activer les modules

Dans Extension, activez les deux modules du cœur JSON:API et HTTP Basic Authentication.

Autoriser l'écriture dans JSON:API

Dans Configuration, Services web, JSON:API, choisissez Accept all JSON:API create, read, update, and delete operations. Drupal est livré en lecture seule : sans ce réglage, Semactic refuse la connexion.

Créer un compte pour Semactic

Créez un utilisateur dédié, par exemple « semactic », avec un rôle qui peut :

  • créer et modifier le type de contenu visé (par exemple Article) ;
  • utiliser le format de texte choisi (par exemple Full HTML) ;
  • Create and edit URL aliases ;
  • Administer node published status (Administer content sur les versions plus anciennes).

[!TIP] Utilisez un compte dédié plutôt que le vôtre : vous pouvez le bloquer à tout moment sans toucher à vos accès, et son rôle décide précisément de ce que Semactic peut faire. Le mot de passe est stocké chiffré.

Connecter Semactic

La connexion se fait par marché : sélectionnez le bon projet et le bon marché dans la barre du haut.

Ouvrir la carte Drupal

Dans Integration, cliquez sur Connecter sur la carte Drupal.

Renseigner le site et le compte

Saisissez l'URL du site (par exemple https://www.exemple.com), puis l'Identifiant Drupal et le Mot de passe du compte créé pour Semactic. Cliquez sur Connecter Drupal.

Semactic vérifie aussitôt que le site répond, que le compte est reconnu et que la JSON:API accepte l'écriture. Si l'un de ces points échoue, rien n'est enregistré et un message indique quoi corriger (voir Dépannage).

Choisir où publier

Une fois la connexion faite, la carte Drupal affiche le site, le compte utilisé et le bouton Tester la connexion. Réglez la cible de publication, puis cliquez sur Enregistrer :

Réglage Rôle
Type de contenu (obligatoire) Le type de contenu Drupal qui reçoit les articles. Article est présélectionné s'il existe, tout comme le type unique d'un site qui n'en a qu'un. Sinon, choisissez-le : sans type de contenu, la publication est impossible.
Statut par défaut à la publication Non publié (par défaut : le contenu est créé sur Drupal mais reste invisible des visiteurs) ou Publié. Ce statut pré-remplit le choix proposé à la première publication d'un article ; une mise à jour reprend le statut actuel de la page.
Champ du corps Nom machine du champ de texte formaté qui reçoit l'article : body sur un type de contenu standard.
Format de texte Nom machine du format appliqué à l'article : full_html par défaut, ou par exemple basic_html. Il doit conserver titres, listes, liens, tableaux et images, et le compte doit avoir le droit de l'utiliser.

Publier un article

L'article doit être entièrement approuvé. Dans l'éditeur, ouvrez l'étape Publication, puis l'onglet Drupal de la zone Publication directe CMS.

Choisir le statut

Dans Statut Drupal, choisissez Non publié pour relire la page dans Drupal avant de la mettre en ligne, ou Publié pour la rendre visible tout de suite.

Vérifier l'alias d'URL

L'Alias d'URL est pré-rempli à partir du titre. Un chemin comme blog/mon-article fonctionne aussi. L'adresse finale s'affiche sous le champ.

Marquer l'article comme publié

Avec le statut Publié, la case Marquer aussi cet article comme publié dans Semactic est cochée : l'article passe en Publié dans Semactic et l'étape Suivi commence à mesurer son impact. Elle n'est pas disponible pour un contenu non publié, invisible des visiteurs.

Publier ou planifier

Cliquez sur Publier sur Drupal. Pour publier plus tard, choisissez Planifier, une date et une heure, puis Planifier la publication : c'est la dernière version enregistrée de l'article qui partira à l'heure prévue.

Une fois l'article envoyé, le panneau indique Déjà sur Drupal., avec un lien Voir la page si le contenu est publié, et le bouton devient Mettre à jour la page Drupal.

Mettre à jour un article

Le lien entre un article Semactic et un contenu Drupal se crée à la première publication depuis Semactic. Tout dépend donc de l'origine de la page.

Article déjà publié depuis Semactic

Modifiez l'article dans Semactic, puis cliquez sur Mettre à jour la page Drupal : Semactic modifie le même contenu Drupal, sans créer de doublon.

Ce qui est remplacé Ce qui est conservé
Le titre Le contenu Drupal lui-même : même identifiant, même URL
Tout le corps de l'article, par la version Semactic Les autres champs : image principale, étiquettes, méta-tags, auteur, date de création, champs personnalisés
Le statut de publication
L'alias d'URL, seulement si vous le modifiez (il est pré-rempli avec l'alias actuel)

Il n'y a pas de fusion : Semactic n'envoie pas « seulement les nouveautés », il remplace le corps en entier.

[!NOTE] Le Statut Drupal est pré-rempli avec le statut actuel de la page : une page en ligne reste en ligne. Changez-le seulement si vous voulez la dépublier, ou publier un contenu encore non publié.

[!WARNING] Une fois un article publié depuis Semactic, faites les modifications de texte dans Semactic. Ce qui est modifié directement dans le corps sur Drupal est écrasé à la mise à jour suivante.

Que Drupal garde l'ancienne version dans l'onglet Révisions du contenu dépend de votre version de Drupal et des réglages du type de contenu. Si cet historique compte pour vous, vérifiez-le une fois sur un article de test.

Si le contenu a été supprimé sur Drupal, la mise à jour suivante en crée un nouveau, avec l'alias que l'article avait.

Page qui existait déjà sur Drupal

Une page créée directement dans Drupal, ou publiée avant la mise en place du connecteur, n'est liée à aucun article Semactic, et il n'est pas possible pour l'instant de l'y rattacher. La publier depuis Semactic ne la met pas à jour. Selon la configuration de votre site, deux cas :

  • Drupal refuse la publication, car l'alias est déjà pris par la page existante : rien n'est publié ;
  • Drupal crée un doublon, avec une adresse proche de l'originale, du type /la-meme-url-0.

Aucun des deux n'est souhaitable.

Pour optimiser une page existante en gardant son URL et son historique :

  1. Retravaillez le texte dans Content Studio.
  2. À l'étape Publication, copiez-le avec Copier le texte ou Télécharger le HTML.
  3. Collez-le dans le contenu existant sur Drupal.
  4. De retour dans Semactic, saisissez l'URL publiée et cliquez sur Marquer comme publié pour lancer le suivi.

[!TIP] En résumé : utilisez le connecteur pour les nouveaux articles et pour ceux qu'il a déjà publiés ; mettez à jour manuellement dans Drupal les pages qui existaient avant.

Ce qui est envoyé à Drupal

  • Titre : le titre H1 de l'article. Votre thème Drupal affiche le titre du contenu, le H1 n'est donc pas répété dans le corps.
  • Corps : le HTML de l'article, dans le champ du corps, avec le format de texte configuré.
  • Statut : publié ou non publié.
  • Alias d'URL.

Le méta-titre, la méta-description, l'image principale et les étiquettes ne sont pas envoyés : renseignez-les dans Drupal (par exemple avec le module Metatag pour les méta-données).

Déconnecter ou reconnecter

Déconnecter coupe la publication directe pour ce marché. Les contenus déjà publiés restent sur votre site, inchangés. Semactic garde le lien entre chaque article et son contenu Drupal : si vous reconnectez le même site avec le même type de contenu, les mises à jour modifient toujours les mêmes contenus. Avec un autre site ou un autre type de contenu, les publications suivantes créent de nouveaux contenus.

Si le mot de passe du compte change, si le compte est bloqué ou si le module HTTP Basic Authentication est désactivé, la carte affiche Reconnexion nécessaire. Cliquez sur Reconnecter et saisissez les nouveaux identifiants : pour le même site, le type de contenu et les réglages sont conservés.

Dépannage

Message Cause probable
Nous n'avons trouvé aucune JSON:API Drupal à cette adresse L'URL ne pointe pas vers le site Drupal, ou le module JSON:API n'est pas activé.
C'est bien un site Drupal, mais son module JSON:API n'est pas activé Activez JSON:API dans Extension.
Drupal n'a pas reconnu ce compte Identifiant ou mot de passe erroné, ou module HTTP Basic Authentication désactivé : sans lui, Drupal ignore les identifiants sans rien signaler.
La JSON:API de votre site n'accepte que la lecture Dans Configuration, Services web, JSON:API, autorisez toutes les opérations.
Ce compte Drupal n'a pas le droit… Le rôle du compte ne peut pas créer ou modifier ce type de contenu.
Ce compte Drupal ne peut pas choisir le statut de publication Accordez Administer node published status au rôle.
Ce compte Drupal ne peut pas définir l'alias d'URL Accordez Create and edit URL aliases au rôle.
Drupal a refusé le format de texte Le nom machine est erroné, ou le rôle n'a pas la permission Use the … text format.
Le type de contenu n'a aucun champ portant ce nom machine Corrigez le Champ du corps.
Ce type de contenu n'existe plus sur votre site Drupal Il a été supprimé ou renommé : choisissez-en un autre.
Un autre article utilise déjà cette URL dans Semactic La page Drupal a bien été créée, mais un autre article Semactic porte déjà cette URL : l'article n'a pas été marqué comme publié.

Le bouton Tester la connexion vérifie à tout moment que Semactic joint le site avec les identifiants enregistrés.