# 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](#depannage)).

## 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.
