Drupal Connector

Der Nolorem Connector ist ein Drupal-10/11-Modul, das Ihre veröffentlichten Blogbeiträge aus der Nolorem Public Content API in Ihre Drupal-Website übernimmt. Beiträge werden einem beliebigen von Ihnen gewählten Inhaltstyp zugeordnet. Der Connector ist schreibgeschützt: Drupal ruft die Inhalte von Nolorem ab, und Nolorem bleibt das System, in dem verfasst wird.

Voraussetzungen

Bevor Sie den Connector installieren, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Nolorem Premium-Plan (die Public Content API ist ausschließlich Premium vorbehalten).
• Einen API-Schlüssel aus den Einstellungen (siehe den Artikel Public Content API).
• Drupal 10 oder 11 mit PHP 8.3 oder neuer.
• Optional das Modul Metatag, falls Sie SEO-Metadaten in Ihre Nodes schreiben möchten.

Erstellen Sie den API-Schlüssel in Nolorem unter Einstellungen, API-Schlüssel. Für einen Connector wird ein blog-gebundener Schlüssel (an ein Blog gebunden) empfohlen.

Modul herunterladen

Laden Sie das Connector-Tarball von der öffentlichen Nolorem-URL herunter:

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

Entpacken Sie es in das Verzeichnis modules/custom/ Ihrer Drupal-Website, sodass der Pfad modules/custom/nolorem_connector/nolorem_connector.info.yml lautet.

Modul aktivieren

Gehen Sie zu Verwaltung > Erweitern (oder führen Sie drush en nolorem_connector aus) und aktivieren Sie Nolorem Connector. Das Modul benötigt die Drupal-Core-Module Node und Taxonomy. Metatag ist optional.

Das Mehrfach-Verbindungsmodell

Eine Connector-Installation kann mehrere Nolorem-Blogs verwalten. Jede Verbindung hat ihren eigenen API-Schlüssel, ihr eigenes Blog-Ziel und ihre eigene Feldzuordnung. So können Sie zum Beispiel "Marketing Blog" in einen Drupal-Inhaltstyp Article und "Company News" in einen Inhaltstyp Press Release aus einer einzigen Installation übernehmen.

Eine Verbindung hinzufügen

Gehen Sie zu Verwaltung > Konfiguration > Webservices > Nolorem Connector und klicken Sie auf Verbindung hinzufügen.

1. Geben Sie eine Bezeichnung für diese Verbindung ein (zu Ihrer eigenen Orientierung).
2. Geben Sie die API-Basis-URL ein (für auf nolorem.io gehostete Konten verwenden Sie https://nolorem.io).
3. Geben Sie einen API-Schlüssel ein (beginnend mit nlr_live_).
4. Klicken Sie auf Verbindung testen, um die Zugangsdaten zu überprüfen.

Adaptive Blog-Auswahl

Nach einem erfolgreichen Test ruft der Connector die Nolorem-API auf, um den Geltungsbereich des Schlüssels zu ermitteln, und passt sich automatisch an.

Blog-gebundener Schlüssel: Der Connector liest die für den Schlüssel zugänglichen Blogs und findet genau eines. Er zeigt den Blognamen als schreibgeschützte Bestätigung an. Es wird kein Blog-Dropdown angezeigt, da das Ziel-Blog durch den Schlüssel selbst festgelegt ist.

Organisationsweiter Schlüssel: Der Connector findet mehrere zugängliche Blogs und zeigt ein Dropdown zur Blog-Auswahl an. Wählen Sie, aus welchem Blog diese Verbindung Inhalte abrufen soll. Die Auswahl wird mit der Verbindung gespeichert und für alle Synchronisierungen verwendet.

Klicken Sie auf Verbindung speichern, um die Einstellungen zu sichern.

Felder zuordnen

Klicken Sie auf den Reiter Feldzuordnung und wählen Sie die Verbindung aus, die Sie konfigurieren möchten.

1. Wählen Sie den Ziel-Inhaltstyp, in den Nolorem-Beiträge importiert werden sollen.

2. Ordnen Sie jedes Nolorem-Feld dem entsprechenden Drupal-Feld dieses Inhaltstyps zu:

   • Titel: normalerweise das eingebaute Feld Title
   • Body: das Haupt-Body- oder Inhaltsfeld (akzeptiert HTML; Format auf Full HTML gesetzt)
   • Auszug: ein Klartext- oder Zusammenfassungsfeld
   • Slug: Ordnen Sie dies dem Feld Path (URL-Alias) Ihres Inhaltstyps zu, um importierten Beiträgen aus dem Nolorem-Slug eine saubere URL zu geben, oder einem Klartextfeld, falls Sie den Slug nur als Datenwert speichern möchten
   • Beitragsbild: ein Bildfeld
   • Kategorie: ein Entity-Reference-Feld, das auf ein Taxonomie-Vokabular verweist
   • Tags: ein Entity-Reference-Feld (mehrwertig), das auf ein Taxonomie-Vokabular verweist

   Sie müssen kein Nolorem-ID-Feld zuordnen. Die Deduplizierung erfolgt automatisch: Der Connector erstellt und pflegt ein verstecktes Feld "Nolorem post ID" auf Ihrem Inhaltstyp und verwendet es, um bestehende Nodes zu aktualisieren, anstatt Duplikate zu erzeugen.

3. SEO-Metadaten können auf zwei Arten behandelt werden, die sich gegenseitig ausschließen:

   • Ordnen Sie die einzelnen Zeilen SEO-Titel / SEO-Beschreibung / SEO-Schlüsselwörter Klartextfeldern Ihres Inhaltstyps zu, oder
   • Falls das Modul Metatag installiert ist, aktivieren Sie SEO-Metadaten in Metatag-Feld schreiben und wählen Sie ein Metatag-Feld aus. Der Connector schreibt dann alle drei (Titel, Beschreibung, Schlüsselwörter) in dieses eine Feld.

   Wenn Sie Metatag verwenden, lassen Sie die drei einzelnen SEO-Zeilen unzugeordnet: Metatag übernimmt sie.

4. (Optional) Legen Sie ein URL-Alias-Präfix fest, falls Sie Slug dem Feld Path zugeordnet haben. Lassen Sie es leer, um Beiträge im Website-Root zu veröffentlichen (zum Beispiel /my-post), oder geben Sie ein Präfix wie /blog ein, um unter einem Abschnittspfad zu veröffentlichen (zum Beispiel /blog/my-post). Wenn Sie URL-Muster lieber mit dem Modul Pathauto verwalten möchten, lassen Sie Slug unzugeordnet und dieses Feld leer, damit Pathauto die Aliase steuert.

5. Klicken Sie auf Zuordnung speichern.

Die Nolorem-Kategorien und -Tags für das Blog der Verbindung werden auf dem Zuordnungsbildschirm angezeigt, damit Sie sehen, welche Begriffe importiert werden. Begriffe, die in Ihrem Drupal-Vokabular nicht existieren, werden automatisch erstellt.

Ihre erste Synchronisierung ausführen

Gehen Sie zum Reiter Sync und klicken Sie auf Jetzt synchronisieren, um die neuesten veröffentlichten Beiträge abzurufen (alle Verbindungen). Der Connector erstellt für das Blog jeder Verbindung passende Drupal-Nodes. Anschließend zeigt eine Zusammenfassung pro Blog an, was geschehen ist: Jedes Blog hat einen eigenen Abschnitt mit einer Zählzeile (importiert, aktualisiert, zurückgezogen) und einer Liste der betroffenen Beiträge nach Titel, verlinkt zum Drupal-Node. Entwürfe und Beiträge, die in Nolorem nicht veröffentlicht sind, werden zu einer einzigen Zählung "übersprungen" zusammengefasst, und alle Fehler werden mit ihrer jeweiligen Fehlermeldung aufgeführt.

Bei nachfolgenden Synchronisierungen werden nur Beiträge abgerufen, die sich seit der letzten erfolgreichen Synchronisierung für diese Verbindung geändert haben (inkrementelle Synchronisierung über updated_since und blog).

Automatische Synchronisierung über Cron

Der Connector läuft automatisch über den Drupal-Cron, standardmäßig einmal pro Stunde, und verarbeitet dabei alle Verbindungen. Stellen Sie sicher, dass der Drupal-Cron konfiguriert ist (Modul Automated Cron oder ein System-Cron-Job). Für die laufende Synchronisierung müssen Sie nicht auf "Jetzt synchronisieren" klicken; das übernimmt der Cron.

Welche Beiträge abgerufen werden

Jede Verbindung ruft nur veröffentlichte Beiträge aus ihrem konfigurierten Blog ab. Beiträge in einem anderen Status (Entwurf, bereit, in Prüfung, geplant usw.) sind für den Connector nicht sichtbar, bis sie veröffentlicht werden.

Wenn Sie den API-Schlüssel als Ihr Veröffentlichungsziel nutzen (ohne verbundene WordPress- oder Ghost-Website), funktioniert der Drupal Connector genauso: Veröffentlichen Sie einen Beitrag in Nolorem über die Schaltfläche "Jetzt veröffentlichen" oder "Planen", und der Connector ruft ihn bei der nächsten Synchronisierung ab.

Was passiert, wenn Sie einen Beitrag zurückziehen oder in Entwurf oder Bereit zurücksetzen

Wenn ein Beitrag in Nolorem den Status "veröffentlicht" verlässt (aus welchem Grund auch immer: Klick auf Zurückziehen, Zurücksetzen in Entwurf oder in den Status "Bereit" oder Löschen), erhält der Connector bei der nächsten Synchronisierung ein Tombstone-Signal. Der zugehörige Drupal-Node wird auf unveröffentlicht gesetzt; er wird nicht gelöscht. Dies ist umkehrbar: Wenn Sie den Beitrag in Nolorem erneut veröffentlichen, wird der Node bei der nächsten Synchronisierung wieder veröffentlicht.

Fehlerbehebung

Die Synchronisierungsergebnisse zeigen fehlgeschlagene Elemente. Fehlgeschlagene Elemente erscheinen in der Ergebnistabelle und werden protokolliert. Prüfen Sie Verwaltung > Berichte > Aktuelle Protokollmeldungen und filtern Sie nach Typ = nolorem_connector, um Details zu erhalten. Der Connector bricht einen Synchronisierungslauf niemals wegen eines einzelnen Fehlers ab: Alle anderen Elemente werden weiterhin verarbeitet.

Verbindung testen gibt einen Fehler zurück. Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und ob Ihr Nolorem-Konto den Premium-Plan hat. Stellen Sie sicher, dass Ihr Drupal-Server https://nolorem.io über Port 443 erreichen kann.

Es werden Inhalte des falschen Blogs abgerufen. Prüfen Sie die Blog-Auswahl der Verbindung. Wenn Sie einen blog-gebundenen Schlüssel verwendet haben, ist das Blog durch den Schlüssel festgelegt. Wenn Sie einen organisationsweiten Schlüssel verwendet haben, überprüfen Sie, welches Blog Sie in den Verbindungseinstellungen ausgewählt haben.

Nodes werden erstellt, aber Bilder fehlen. Vergewissern Sie sich, dass das Feld für das Beitragsbild zugeordnet ist und dass Ihr Server ausgehenden HTTP-Zugriff auf das Nolorem-Bild-CDN hat. Fehler beim Bilddownload sind nicht kritisch und werden protokolliert; der Node wird trotzdem ohne das Bild erstellt.

SEO-Metadaten werden nicht geschrieben. Stellen Sie sicher, dass das Modul Metatag installiert und aktiviert ist und dass der SEO-Zuordnungsschalter in der Feldzuordnung mit einem gültigen ausgewählten Metatag-Feld eingeschaltet ist.

Modul-Update verfügbar. Der Connector sucht regelmäßig nach neuen Versionen und zeigt einen Verwaltungshinweis an, wenn eine neuere Version verfügbar ist. Laden Sie das aktualisierte Tarball von der im Hinweis genannten URL herunter, ersetzen Sie die Dateien in modules/custom/nolorem_connector/ und leeren Sie die Drupal-Caches.