Dokumentation · Integrationen
Ghost verbinden
Beta. Diese Anbindung ist neu. Sie funktioniert, wird aber noch beobachtet — schau dir den ersten Beitrag bitte in Ghost selbst an, bevor du ihn veröffentlichst.
Noch nicht in der Auswahl? Diese Anbindung wird plattformweit freigeschaltet (Einstellung cms_family_enabled). Solange sie aus ist, zeigt die Seite CMS anbinden nur WordPress. Melde dich bei uns, wenn die Auswahl bei dir fehlt.
Bei der Ghost-Anbindung werden Beiträge zu echten Ghost-Beiträgen in deinem Theme, mit Bildern in deiner Ghost-Mediathek und einem Tag deiner Wahl.
Admin-API-Key anlegen
Ein Admin-API-Key ist nicht dein Passwort. Ghost erzeugt ihn für eine sogenannte Integration.
- In Ghost anmelden und Einstellungen → Erweitert → Integrationen öffnen.
- Auf Add custom integration klicken und einen Namen vergeben, zum Beispiel „Redaktion“.
- Den Wert bei Admin API key kopieren — nicht den Content-Key. Er sieht so aus:
65f0a1b2…:0123456789abcdef… - Ihn zusammen mit der Adresse deines Blogs (zum Beispiel
blog.beispiel.de) in das Formular eintragen.
Wir speichern den Schlüssel verschlüsselt und zeigen ihn nie wieder an.
Welche Rechte werden gebraucht?
Ein Admin-API-Key hat die Rechte des Kontos, unter dem die Integration angelegt wurde. Zum Anlegen und Veröffentlichen von Beiträgen reicht die Rolle Administrator oder Editor.
Technisch schicken wir den Schlüssel nie mit. Aus ihm entsteht bei jedem Aufruf ein Token, das höchstens fünf Minuten gilt — so sieht Ghost, dass wir es sind, ohne dass der Schlüssel über die Leitung geht.
Verbindung testen und Tag wählen
Verbindung testen ruft die Blog-Einstellungen ab. Bei Erfolg meldet die Seite „Verbindung zu Ghost steht“.
Danach holen wir die Tags deines Blogs. Ghost kennt keine Kategorien — ein Tag ist das, was in deinem Theme wie eine Rubrik wirkt. Neue Beiträge bekommen den Tag, den du wählst.
Was diese Anbindung kann
| Fähigkeit | Ghost |
|---|---|
| Bilder in die Mediathek laden | ja — über images/upload |
| Titel und Beschreibung für Suchmaschinen | ja — meta_title und meta_description |
| Autorennamen setzen | nein — Beiträge erscheinen unter dem Besitzer der Integration |
| Nicht öffentliche Entwürfe | ja |
| Bestehende Beiträge ändern | ja |
| Fremde Änderungen erkennen | ja — über updated_at |
Zum Autor: Die Ghost-Admin-API ordnet jeden Beitrag dem Konto zu, das die Integration angelegt hat. Einen freien Autorennamen kann sie nicht setzen — wir behaupten deshalb auch nicht, dass wir es könnten.
Schutz vor gegenseitigem Überschreiben
Ghost verlangt bei jeder Änderung den Zeitpunkt, den der Beitrag zuletzt hatte. Bearbeitet jemand denselben Beitrag parallel in Ghost, lehnt Ghost unsere Änderung ab — wir überschreiben nichts. Der Beitrag geht bei uns in den Zustand „Konflikt“, und du entscheidest, welche Fassung gilt.
Häufige Meldungen
- „Der Admin-API-Key hat nicht die erwartete Form.“ — Es wurde der Content-Key kopiert oder nur ein Teil. Der Admin-Key besteht aus zwei Teilen, getrennt durch einen Doppelpunkt.
- „Unknown Admin API Key“ — Die Integration wurde in Ghost gelöscht. Lege eine neue an.
- „Diese Adresse dürfen wir nicht aufrufen“ — Die eingetragene Adresse zeigt auf ein privates Netz. Trage die öffentliche
https-Adresse deines Blogs ein.
Verbindung trennen
Verbindung trennen löscht den Schlüssel bei uns und stellt neue Beiträge wieder auf das eingebettete Magazin um. Bereits veröffentlichte Ghost-Beiträge bleiben, wo sie sind.