docs.semactic › Intégrations
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).
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:
- Herwerk de tekst in Content Studio.
- Kopieer hem in de stap Publish met Copy text of Download HTML.
- Plak hem in de bestaande content op Drupal.
- 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.