# Drupal

De Drupal-connector publiceert Content Studio-artikelen als content op uw Drupal-site en werkt ze daarna bij vanuit Semactic. Hij gebruikt alleen modules uit de kern van Drupal: er hoeft niets geïnstalleerd te worden.

> [!INFO]
> **Op deze pagina:** de Drupal-site voorbereiden, Semactic koppelen, kiezen waar u publiceert, een artikel publiceren, een artikel bijwerken, wat naar Drupal wordt gestuurd, ontkoppelen, probleemoplossing.

## Uw Drupal-site voorbereiden

Dit gebeurt één keer, door een beheerder van de site.

### De modules inschakelen
Schakel in **Extend** de twee kernmodules **JSON:API** en **HTTP Basic Authentication** in.

### Schrijven toestaan in JSON:API
Kies in **Configuration**, **Web services**, **JSON:API** de optie **Accept all JSON:API create, read, update, and delete operations**. Drupal wordt standaard alleen-lezen geleverd: zonder deze instelling weigert Semactic de koppeling.

### Een account voor Semactic aanmaken
Maak een aparte gebruiker aan, bijvoorbeeld "semactic", met een rol die:
- het beoogde contenttype kan aanmaken en bewerken (bijvoorbeeld **Article**);
- het gekozen tekstformaat kan gebruiken (bijvoorbeeld **Full HTML**);
- **Create and edit URL aliases** heeft;
- **Administer node published status** heeft (**Administer content** op oudere versies).

> [!TIP]
> Gebruik een apart account in plaats van het uwe: u kunt het op elk moment blokkeren zonder aan uw eigen toegang te raken, en de rol bepaalt precies wat Semactic mag doen. Het wachtwoord wordt versleuteld bewaard.

## Semactic koppelen

De koppeling verloopt per markt: selecteer het juiste project en de juiste markt in de bovenste balk.

### De Drupal-kaart openen
Klik in **Integration** op **Connect** op de kaart **Drupal**.

### De site en het account invullen
Vul de **Site URL** in (bijvoorbeeld `https://www.voorbeeld.com`), en daarna de **Drupal username** en het **Password** van het account dat u voor Semactic hebt aangemaakt. Klik op **Connect Drupal**.

Semactic controleert meteen of de site antwoordt, of het account wordt herkend en of de JSON:API schrijven toestaat. Mislukt een van deze controles, dan wordt niets opgeslagen en geeft een melding aan wat u moet corrigeren (zie [Probleemoplossing](#probleemoplossing)).

## Kiezen waar u publiceert

Zodra de koppeling gemaakt is, toont de kaart **Drupal** de site, het gebruikte account en de knop **Test connection**. Stel het publicatiedoel in en klik daarna op **Save**:

| Instelling | Functie |
|------------|---------|
| **Content type** (verplicht) | Het Drupal-contenttype dat de artikelen ontvangt. **Article** is vooraf geselecteerd als het bestaat, net als het enige type van een site die er maar één heeft. Kies het anders zelf: zonder contenttype is publiceren niet mogelijk. |
| **Default status when publishing** | **Unpublished** (standaard: de content wordt op Drupal aangemaakt maar blijft onzichtbaar voor bezoekers) of **Published**. Deze status vult de keuze vooraf in bij de eerste publicatie van een artikel; een update neemt de huidige status van de pagina over. |
| **Body field** | Machinenaam van het opgemaakte tekstveld dat het artikel ontvangt: `body` op een standaard contenttype. |
| **Text format** | Machinenaam van het tekstformaat dat op het artikel wordt toegepast: standaard `full_html`, of bijvoorbeeld `basic_html`. Het moet koppen, lijsten, links, tabellen en afbeeldingen behouden, en het account moet het mogen gebruiken. |

## Een artikel publiceren

Het artikel moet volledig goedgekeurd zijn. Open in de editor de stap **Publish** en daarna het tabblad **Drupal** in de zone **Direct CMS publishing**.

### De status kiezen
Kies bij **Drupal status** **Unpublished** om de pagina in Drupal na te lezen voordat ze online gaat, of **Published** om ze meteen zichtbaar te maken.

### De URL-alias controleren
De **URL alias** wordt vooraf ingevuld op basis van de titel. Een pad zoals `blog/mijn-artikel` werkt ook. Het uiteindelijke adres verschijnt onder het veld.

### Het artikel als gepubliceerd markeren
Met de status **Published** is het vakje **Also mark this article as published in Semactic** aangevinkt: het artikel gaat in Semactic naar **Published** en de stap **Track** begint de impact ervan te meten. Het vakje is niet beschikbaar voor niet-gepubliceerde content, die onzichtbaar is voor bezoekers.

### Publiceren of plannen
Klik op **Publish to Drupal**. Om later te publiceren, kiest u **Schedule**, een datum en een tijdstip, en daarna **Schedule publication**: de laatst opgeslagen versie van het artikel gaat op het geplande tijdstip online.

Zodra het artikel verstuurd is, toont het paneel **Already on Drupal.**, met een link **View the page** als de content gepubliceerd is, en de knop wordt **Update the Drupal page**.

## Een artikel bijwerken

De koppeling tussen een Semactic-artikel en Drupal-content ontstaat bij de **eerste publicatie vanuit Semactic**. Alles hangt dus af van waar de pagina vandaan komt.

### Artikel dat al vanuit Semactic is gepubliceerd

Wijzig het artikel in Semactic en klik daarna op **Update the Drupal page**: Semactic wijzigt dezelfde Drupal-content, zonder een duplicaat aan te maken.

| Wat wordt vervangen | Wat behouden blijft |
|---------------------|---------------------|
| De titel | De Drupal-content zelf: zelfde ID, zelfde URL |
| **De volledige body** van het artikel, door de Semactic-versie | De andere velden: hoofdafbeelding, tags, metatags, auteur, aanmaakdatum, aangepaste velden |
| De publicatiestatus | |
| De URL-alias, alleen als u hem wijzigt (hij is vooraf ingevuld met de huidige alias) | |

Er wordt niets samengevoegd: Semactic stuurt niet "alleen de wijzigingen", het vervangt de volledige body.

> [!NOTE]
> De **Drupal status** is vooraf ingevuld met de huidige status van de pagina: een online pagina blijft online. Wijzig hem alleen als u de pagina offline wilt halen, of content wilt publiceren die nog niet gepubliceerd is.

> [!WARNING]
> Zodra een artikel vanuit Semactic is gepubliceerd, maakt u tekstwijzigingen in Semactic. Wat rechtstreeks in de body op Drupal wordt gewijzigd, wordt bij de volgende update overschreven.

Of Drupal de vorige versie bewaart in het tabblad **Revisions** van de content, hangt af van uw Drupal-versie en van de instellingen van het contenttype. Is die geschiedenis belangrijk voor u, controleer het dan één keer met een testartikel.

Is de content op Drupal verwijderd, dan maakt de volgende update nieuwe content aan, met de alias die het artikel had.

### Pagina die al op Drupal bestond

Een pagina die rechtstreeks in Drupal is aangemaakt, of die is gepubliceerd voordat de connector werd ingesteld, is aan geen enkel Semactic-artikel gekoppeld, en die koppeling kan voorlopig niet worden gelegd. Ze publiceren vanuit Semactic werkt ze niet bij. Afhankelijk van de configuratie van uw site zijn er twee mogelijkheden:

- Drupal weigert de publicatie, omdat de alias al door de bestaande pagina wordt gebruikt: er wordt niets gepubliceerd;
- Drupal maakt een **duplicaat** aan, met een adres dat dicht bij het originele ligt, zoals `/dezelfde-url-0`.

Geen van beide is wenselijk.

Om een bestaande pagina te optimaliseren en haar URL en geschiedenis te behouden:

1. Herwerk de tekst in Content Studio.
2. Kopieer hem in de stap **Publish** met **Copy text** of **Download HTML**.
3. Plak hem in de bestaande content op Drupal.
4. Vul daarna in Semactic de **Published URL** in en klik op **Mark as published** om de opvolging te starten.

> [!TIP]
> Kort samengevat: gebruik de connector voor nieuwe artikelen en voor artikelen die hij al heeft gepubliceerd; werk pagina's die al bestonden handmatig bij in Drupal.

## Wat naar Drupal wordt gestuurd

- **Titel**: de H1-titel van het artikel. Uw Drupal-thema toont de titel van de content, dus de H1 wordt niet herhaald in de body.
- **Body**: de HTML van het artikel, in het bodyveld, met het ingestelde tekstformaat.
- **Status**: gepubliceerd of niet gepubliceerd.
- **URL-alias**.

De metatitel, de metabeschrijving, de hoofdafbeelding en de tags worden niet verstuurd: vul ze in Drupal in (bijvoorbeeld met de module Metatag voor de metagegevens).

## Ontkoppelen of opnieuw koppelen

**Disconnect** stopt het rechtstreeks publiceren voor deze markt. Reeds gepubliceerde content blijft ongewijzigd op uw site. Semactic bewaart de koppeling tussen elk artikel en de bijbehorende Drupal-content: koppelt u opnieuw dezelfde site met hetzelfde contenttype, dan wijzigen updates nog altijd dezelfde content. Met een andere site of een ander contenttype maken volgende publicaties nieuwe content aan.

Wijzigt het wachtwoord van het account, wordt het account geblokkeerd of wordt de module HTTP Basic Authentication uitgeschakeld, dan toont de kaart **Reconnection needed**. Klik op **Reconnect** en vul de nieuwe inloggegevens in: voor dezelfde site blijven het contenttype en de instellingen behouden.

## Probleemoplossing

| Melding | Waarschijnlijke oorzaak |
|---------|-------------------------|
| We found no Drupal JSON:API at that address | De URL verwijst niet naar de Drupal-site, of de module JSON:API is niet ingeschakeld. |
| This is a Drupal site, but its JSON:API module is not enabled | Schakel **JSON:API** in via **Extend**. |
| Drupal did not recognise this account | Verkeerde gebruikersnaam of verkeerd wachtwoord, of de module **HTTP Basic Authentication** is uitgeschakeld: zonder die module negeert Drupal de inloggegevens zonder iets te melden. |
| Your site’s JSON:API only accepts read operations | Sta in **Configuration**, **Web services**, **JSON:API** alle bewerkingen toe. |
| This Drupal account is not allowed… | De rol van het account kan dit contenttype niet aanmaken of bewerken. |
| This Drupal account cannot set the published status | Geef de rol **Administer node published status**. |
| This Drupal account cannot set the URL alias | Geef de rol **Create and edit URL aliases**. |
| Drupal refused the text format | De machinenaam is verkeerd, of de rol heeft de permissie **Use the … text format** niet. |
| The content type has no field with that machine name | Corrigeer het **Body field**. |
| This content type no longer exists on your Drupal site | Het is verwijderd of hernoemd: kies een ander. |
| Another article already uses this URL in Semactic | De Drupal-pagina is wel aangemaakt, maar een ander Semactic-artikel heeft al deze URL: het artikel is niet als gepubliceerd gemarkeerd. |

Met de knop **Test connection** controleert u op elk moment of Semactic de site bereikt met de opgeslagen inloggegevens.
