Docs

In BaseHub veröffentlichen

Verbinde dein BaseHub-Repository, damit jeder Artikel zu einer Zeile in einer Collection wird, die deine Website schon ausliest. Kein Code nötig.

Zuletzt aktualisiert am

Verbinde dein BaseHub-Repository einmal und GrowWriter fügt für jeden Artikel, den du veröffentlichst, eine Zeile zu einer Collection hinzu, committet und sofort live. Du brauchst etwa zehn Minuten und einen Admin Token für das Repository.

Was du brauchst

  • Zugang zum BaseHub-Repository, aus dem deine Website liest.
  • Einen Admin Token für dieses Repository, angelegt im nächsten Abschnitt.
  • Eine Collection für Beiträge, deren Felder schon definiert sind.

Hat jemand anderes BaseHub für deine Website eingerichtet, schick dieser Person diesen Abschnitt. Der Token ist das Einzige, was du von ihr brauchst.

Den Token anlegen

  1. Öffne das Repository auf basehub.com.
  2. Geh in die Repository-Einstellungen, dann zu API Tokens.
  3. Lege einen Admin Token an. Er braucht Schreibzugriff. Ein Lese-Token kann nicht veröffentlichen.
  4. Kopiere ihn. BaseHub zeigt ihn nur einmal.

In GrowWriter verbinden

Öffne die Seite Kanäle, suche BaseHub unter Websites & CMS und klicke auf Verbinden.

  1. Admin Token: füge den Token ein.
  2. Klicke auf Verbindung testen. Verbindung erfolgreich heißt, GrowWriter kann das Repository lesen und darin schreiben.

Zwei optionale Einstellungen sitzen unter Erweiterte Optionen:

  • Dashboard-URL: die Adresse des Repositorys, etwa https://basehub.com/your-team/your-repo. Mit ihr öffnet der Link Beitrag ansehen nach dem Veröffentlichen die Zeile in BaseHub.
  • Sprachen: die Sprachvarianten-Codes deines Repositorys, kommagetrennt, etwa en, es. Lass en stehen, wenn du keine Varianten nutzt.
Schritt 1 des Dialogs BaseHub verbinden mit dem Feld Admin Token, den eingeklappten Erweiterten Optionen und dem Button Verbindung testen.
Schritt 1: der Admin Token. Die beiden erweiterten Einstellungen sind optional.

Die Collection wählen

Schritt 2 listet die Collections im Repository. Wähle die, die deine Website für Beiträge nutzt, und klicke auf Weiter.

Sagt die Liste Keine Collections zum Veröffentlichen, lege zuerst in BaseHub eine Collection an. Klicke dann auf Zurück und auf Weiter, um die Liste neu zu laden.

Schritt 2 des Dialogs BaseHub verbinden mit geöffneter Collection-Auswahl.
Schritt 2: die Collection, die deine Beiträge enthält.

Die Felder zuordnen

Schritt 3 verbindet jedes GrowWriter-Feld mit einem Feld der Collection: Titel, Slug, Inhalt, Meta-Beschreibung, Titelbild, Veröffentlichungsdatum, Änderungsdatum und Autor. GrowWriter ordnet zu, was es anhand der Namen erkennt, und sagt dir, wie viele es gefunden hat. Den Rest setzt du über die Auswahlfelder oder wählst Überspringen.

Zwei Details, die du kennen solltest:

  • Der Inhalt kommt als Rich Text an, erzeugt aus Markdown. Wähle dafür also ein Rich-Text-Feld.
  • Ordne Änderungsdatum einem Datumsfeld zu, falls du eins hast. GrowWriter setzt es bei jeder erneuten Veröffentlichung neu, während das Veröffentlichungsdatum bleibt.

Klicke auf Verbindung speichern. Die Zeile auf der Seite Kanäle zeigt Verbunden.

Schritt 3 des Dialogs BaseHub verbinden zeigt GrowWriter-Felder, verbunden mit Collection-Feldern.
Schritt 3: ordne die Felder zu und speichere.
Die BaseHub-Zeile auf der Seite Kanäle mit dem Status Verbunden.
Verbunden. BaseHub erscheint jetzt als Kanal im Veröffentlichen-Dialog.

Deinen ersten Artikel veröffentlichen

Öffne deine Bibliothek, wähle einen fertigen Artikel und klicke auf Veröffentlichen. Hake BaseHub an, wähle einen Autor, falls deine Zuordnung einen hat, und klicke auf Veröffentlichen. GrowWriter fügt die Zeile hinzu und committet sie. Der Artikel ist also live, sobald deine Website neu baut oder die Daten neu abruft.

Später erneut zu veröffentlichen aktualisiert dieselbe Zeile an Ort und Stelle. Der komplette Ablauf mit Screenshots steht auf Wähle, wo du veröffentlichst.

Fehlerbehebung

  • Der BaseHub-Token ist ungültig oder hat keinen Schreibzugriff: lege einen neuen Admin Token an, klicke auf Trennen und verbinde neu.
  • Die BaseHub-Collection wurde nicht gefunden: die Collection wurde gelöscht oder umbenannt. Trenne, verbinde neu und wähle sie erneut.
  • BaseHub hat die Aktualisierung abgelehnt: ein zugeordnetes Feld nimmt den Wert nicht an, meist ein Pflichtfeld auf Überspringen oder ein falscher Feldtyp. Verbinde neu und passe die Zuordnung an.
  • Der ausgewählte Autor existiert nicht mehr im CMS: wähle im Veröffentlichen-Dialog einen anderen Autor.

Auf dieser Seite