Drupal Connector

De Nolorem Connector is een Drupal 10/11-module die je gepubliceerde blogposts vanuit de Nolorem Public Content API naar je Drupal-site haalt. Posts worden gekoppeld aan elk inhoudstype dat je kiest. De connector is alleen-lezen: Drupal haalt op vanuit Nolorem, en Nolorem blijft het auteurssysteem.

Vereisten

Voordat je de connector installeert, zorg dat je het volgende hebt:

• Een Nolorem Premium plan (de Public Content API is alleen voor Premium).
• Een API-sleutel uit Instellingen (zie het artikel Public Content API).
• Drupal 10 of 11, draaiend op PHP 8.3 of later.
• Optioneel de Metatag-module geïnstalleerd als je SEO-metadata naar je nodes wilt schrijven.

Maak de API-sleutel aan in Nolorem onder Instellingen, API Keys. Een blog-scoped sleutel (gebonden aan één blog) wordt aanbevolen voor een connector.

De module downloaden

Download de connector-tarball vanaf de publieke Nolorem-URL:

https://nolorem.io/drupal-modules/nolorem_connector.tar.gz

Pak deze uit in de map modules/custom/ van je Drupal-site, zodat het pad modules/custom/nolorem_connector/nolorem_connector.info.yml is.

De module inschakelen

Ga naar Admin > Extend (of voer drush en nolorem_connector uit) en schakel Nolorem Connector in. De module is afhankelijk van de Drupal-coremodules Node en Taxonomy. Metatag is optioneel.

Het multiverbindingsmodel

Eén connector-installatie kan meerdere Nolorem-blogs beheren. Elke verbinding heeft een eigen API-sleutel, blogdoel en veldkoppeling. Zo kun je bijvoorbeeld "Marketing Blog" naar een Drupal Article-inhoudstype halen en "Company News" naar een Press Release-inhoudstype, vanuit één installatie.

Een verbinding toevoegen

Ga naar Admin > Configuration > Web Services > Nolorem Connector en klik op Add connection.

1. Voer een label in voor deze verbinding (voor je eigen referentie).
2. Voer de API base URL in (voor op nolorem.io gehoste accounts gebruik je https://nolorem.io).
3. Voer een API key in (die begint met nlr_live_).
4. Klik op Test connection om de inloggegevens te verifiëren.

Adaptieve blogselectie

Na een geslaagde test roept de connector de Nolorem API aan om de scope van de sleutel te bepalen en past zich automatisch aan.

Blog-scoped sleutel: de connector leest de toegankelijke blogs van de sleutel en vindt er precies één. De blognaam wordt getoond als alleen-lezen bevestiging. Er wordt geen blog-dropdown weergegeven, omdat de doelblog wordt bepaald door de sleutel zelf.

Org-brede sleutel: de connector vindt meerdere toegankelijke blogs en toont een blogselector-dropdown. Kies uit welke blog deze verbinding moet ophalen. De selectie wordt bij de verbinding opgeslagen en gebruikt voor alle synchronisaties.

Klik op Save connection om de instellingen op te slaan.

Velden koppelen

Klik op het tabblad Field Mapping en selecteer de verbinding die je wilt configureren.

1. Selecteer het doelinhoudstype waarin Nolorem-posts moeten worden geïmporteerd.

2. Koppel elk Nolorem-veld aan het overeenkomstige Drupal-veld op dat inhoudstype:

   • Title -- meestal het ingebouwde Title-veld
   • Body -- het hoofd-body- of contentveld (accepteert HTML; format ingesteld op Full HTML)
   • Excerpt -- een platte-tekst- of samenvattingsveld
   • Slug -- koppel dit aan het Path-veld (URL-alias) van je inhoudstype om geïmporteerde posts een nette URL te geven op basis van de Nolorem-slug, of aan een platte-tekstveld als je de slug alleen als data wilt opslaan
   • Featured image -- een afbeeldingsveld
   • Category -- een entity reference-veld dat verwijst naar een taxonomievocabulaire
   • Tags -- een entity reference-veld (multi-value) dat verwijst naar een taxonomievocabulaire

   Je hoeft geen Nolorem ID-veld te koppelen. Deduplicatie gebeurt automatisch: de connector maakt en onderhoudt een verborgen "Nolorem post ID"-veld op je inhoudstype en gebruikt dit om bestaande nodes bij te werken in plaats van duplicaten te maken.

3. SEO-metadata kan op twee manieren worden verwerkt, en het zijn alternatieven:

   • Koppel de individuele rijen SEO title / SEO description / SEO keywords aan platte-tekstvelden op je inhoudstype, of
   • Als de Metatag-module is geïnstalleerd, schakel dan Write SEO metadata to Metatag field in en selecteer een Metatag-veld. De connector schrijft dan alle drie (title, description, keywords) in dat ene veld.

   Als je Metatag gebruikt, laat je de drie individuele SEO-rijen ongekoppeld -- Metatag handelt ze af.

4. (Optioneel) Stel een URL-aliasvoorvoegsel in als je Slug aan het Path-veld hebt gekoppeld. Laat het leeg om posts in de siteroot te publiceren (bijvoorbeeld /my-post), of voer een voorvoegsel in zoals /blog om onder een sectiepad te publiceren (bijvoorbeeld /blog/my-post). Als je liever URL-patronen beheert met de Pathauto-module, laat je Slug dan ongekoppeld en laat je dit leeg zodat Pathauto de aliassen beheert.

5. Klik op Save mapping.

De Nolorem-categorieën en -tags voor de blog van de verbinding worden op het koppelingsscherm getoond, zodat je kunt zien welke termen worden geïmporteerd. Termen die niet in je Drupal-vocabulaire bestaan, worden automatisch aangemaakt.

Je eerste synchronisatie uitvoeren

Ga naar het tabblad Sync en klik op Sync now om de nieuwste gepubliceerde posts op te halen (alle verbindingen). De connector maakt voor de blog van elke verbinding overeenkomstige Drupal-nodes aan. Daarna toont een overzicht per blog wat er is gebeurd: elke blog heeft een eigen sectie met een telregel (geïmporteerd, bijgewerkt, gedepubliceerd) en een lijst van de betrokken posts op titel, gelinkt aan de Drupal-node. Concepten en posts die niet in Nolorem zijn gepubliceerd, worden samengevouwen in één "overgeslagen"-telling, en eventuele fouten worden vermeld met hun foutmelding.

Bij volgende synchronisaties worden alleen posts opgehaald die sinds de laatste geslaagde synchronisatie voor die verbinding zijn gewijzigd (incrementele synchronisatie via updated_since en blog).

Automatische synchronisatie via cron

De connector draait automatisch op de Drupal-cron, standaard eenmaal per uur, en verwerkt alle verbindingen. Zorg dat de Drupal-cron is geconfigureerd (de Automated Cron-module of een system-cronjob). Je hoeft niet op Sync now te klikken voor doorlopende synchronisatie; de cron regelt dit.

Welke posts worden opgehaald

Elke verbinding haalt alleen gepubliceerde posts op van de geconfigureerde blog. Posts in elke andere status (concept, ready, in review, gepland, enz.) zijn niet zichtbaar voor de connector totdat ze zijn gepubliceerd.

Als je de API-sleutel als je publicatiebestemming gebruikt (zonder een verbonden WordPress- of Ghost-site), werkt de Drupal-connector op dezelfde manier: publiceer een post in Nolorem met de knop "Publish now" of "Schedule", en de connector haalt deze op bij de volgende synchronisatie.

Wat er gebeurt wanneer je een post depubliceert of terugzet naar concept of ready

Wanneer een post uit "gepubliceerd" gaat in Nolorem (om welke reden dan ook: klikken op Depubliceren, terugzetten naar concept of naar de "Ready"-status, of verwijderen), ontvangt de connector bij de volgende synchronisatie een tombstone-signaal. De overeenkomstige Drupal-node wordt op niet-gepubliceerd gezet; deze wordt niet verwijderd. Dit is omkeerbaar: als je de post in Nolorem opnieuw publiceert, wordt de node bij de volgende synchronisatie opnieuw gepubliceerd.

Problemen oplossen

Synchronisatieresultaten tonen mislukte items. Mislukte items verschijnen in de resultatentabel en worden gelogd. Controleer Admin > Reports > Recent log messages en filter op Type = nolorem_connector voor details. De connector stopt een synchronisatierun nooit vanwege één enkele fout -- alle andere items worden nog steeds verwerkt.

Test connection geeft een fout. Verifieer dat je API-sleutel correct is en dat je Nolorem-account op het Premium plan zit. Zorg dat je Drupal-server https://nolorem.io op poort 443 kan bereiken.

Er wordt content van de verkeerde blog opgehaald. Controleer de blogselectie van de verbinding. Als je een blog-scoped sleutel hebt gebruikt, wordt de blog bepaald door de sleutel. Als je een org-brede sleutel hebt gebruikt, verifieer dan welke blog je in de verbindingsinstellingen hebt geselecteerd.

Nodes worden aangemaakt maar afbeeldingen ontbreken. Bevestig dat het uitgelichte-afbeeldingsveld is gekoppeld en dat je server uitgaande HTTP-toegang heeft tot de Nolorem-afbeeldings-CDN. Mislukte afbeeldingsdownloads zijn niet-fataal en worden gelogd; de node wordt nog steeds aangemaakt zonder de afbeelding.

SEO-metadata wordt niet geschreven. Zorg dat de Metatag-module is geïnstalleerd en ingeschakeld, en dat de SEO-koppelingsschakelaar aan staat in Field Mapping met een geldig Metatag-veld geselecteerd.

Module-update beschikbaar. De connector controleert periodiek op nieuwe versies en toont een adminmelding wanneer een nieuwere versie beschikbaar is. Download de bijgewerkte tarball van de URL in de melding, vervang de bestanden in modules/custom/nolorem_connector/ en wis de Drupal-caches.