Headless-Modus

Verwende den Headless-Modus, wenn deine Leser eine andere Website besuchen als diese WordPress-Installation. Typische Setups:

• Dieses WordPress läuft unter cms.example.com und dein Blog wird von example.com durch eine Next.js-, Astro- oder andere statische Frontend-App ausgeliefert.
• Dieses WordPress ist das Redaktions-Backend für eine Single-Page-App oder Mobile-App, und „die öffentliche Website” ist eine Marketing-Site auf einer separaten Domain.

Ohne Headless-Modus geht Structura davon aus, dass diese WordPress-Installation die öffentliche Website ist. Diese Annahme trifft auf die überwiegende Mehrheit der Installationen zu, bricht aber bei den oben genannten Setups: KI-Vorschläge greifen auf die WP-Startseite zu (die im Headless-Setup leer ist), interne Links, die Structura zu neuen Beiträgen hinzufügt, verweisen auf cms.example.com-URLs, die niemand besucht, und Channel-Shares (LinkedIn, IndexNow, Slack) posten die falschen URLs.

Bevor du beginnst

Du brauchst:

• Die vollständige URL deiner öffentlichen Website (z. B. https://example.com).
• Admin-Zugang zu wp-admin.

Wenn du von diesem WordPress über eine CMS-Build-Pipeline (Vercel ISR, Astro Content Collections etc.) auf dein Frontend veröffentlichst, stelle sicher, dass diese Integration bereits läuft, bevor du den Headless-Modus aktivierst — Structuras Einstellungen beschreiben nur, was bereits deployt ist.

Schritte

1. Gehe in wp-admin zu Einstellungen → Allgemein → Öffentliche Website.
2. Schalte Meine öffentliche Website liegt woanders auf an.
3. Klicke auf Erkennen & automatisch konfigurieren. Structura:
   • Schlägt eine öffentliche URL vor, indem ein cms.-Präfix vom Host dieser Installation entfernt wird (so wird aus cms.xerx.io → https://xerx.io).
   • Scrapt diese URL über Jina und schlägt eine Beschreibung sowie wichtige Seiten vor.
   • Öffnet einen Bestätigungsdialog mit den Vorschlägen.
4. Prüfe die Vorschläge. Vorschläge übernehmen schreibt sie ins Formular — du kannst jedes Feld vor dem Speichern noch bearbeiten.
5. Optional: passe an:
   • Beschreibung — ein kurzer Absatz als Fallback, wenn die KI-Verankerung deine Startseite nicht erreichen kann.
   • Wichtige Seiten — die Über-, Preis-, Service-Seiten usw., auf die Structura aus neuen Beiträgen verlinken soll. Die Liste wird automatisch aus deiner Navigation erkannt; entferne oder benenne Zeilen nach Bedarf um.
   • URL-Muster für Beiträge — wie Structura URLs für aus diesem WordPress veröffentlichte Beiträge zusammensetzen soll. Der Standard Präfix-Tausch ({publicUrl}/{lang}/blog/{slug}) entspricht dem von Structura empfohlenen Layout; wähle Eigene Vorlage…, wenn dein Frontend ein anderes Schema verwendet (z. B. /news/{year}/{slug}).
   • Standardsprache für URLs — wird verwendet, wenn {lang} im URL-Muster vorkommt. Standardwert ist deine WP-Site-Sprache.
6. Klicke auf Speichern.

Was danach passiert

Sobald der Headless-Modus aktiv ist:

• KI-Verankerung scrapt deine öffentliche Website, nicht WordPress. Vorschläge spiegeln die Marke und den Inhalt wider, den Leser tatsächlich sehen.
• Interne Links, die Structura zu neuen Beiträgen hinzufügt, verweisen auf die umgeschriebenen öffentlichen URLs (z. B. https://example.com/de/blog/<slug>).
• Channels, die Beitrags-URLs teilen (LinkedIn, Slack, Webhooks), posten die öffentliche URL.
• IndexNow zeigt ebenfalls auf die öffentliche URL — siehe die Seite zum IndexNow-Channel für den Schlüsseldatei-Upload-Schritt, der spezifisch für Headless-Installationen ist.

Beim nächsten Speichern eines Beitrags durch WordPress wird die von Structura über structura/post/inserted ausgegebene Beitrags-URL die umgeschriebene sein. Bestehende Beiträge behalten die URL aus ihren _structura_*-Meta-Daten — eine erneute Veröffentlichung ist nicht erforderlich, es sei denn, du möchtest abgeleiteten Zustand auffrischen.

Häufige Probleme

Der Button „Erkennen & automatisch konfigurieren” bleibt deaktiviert. Dieser Button wird nur ausgelöst, wenn es etwas zu scrapen gibt — bestätige, dass das Feld „Öffentliche URL” einen Wert hat oder dass der Host dieser Installation mit cms. beginnt (der Auto-Ableitungs-Auslöser). Andernfalls gib die öffentliche URL zuerst manuell ein.

Quick-Setup meldet „Scrape fehlgeschlagen”. Häufigste Ursache: die öffentliche Website ist geschützt (Vercel-Passwort, IP-Allowlist, Basic Auth). Trage die URL manuell ein, fülle Beschreibung und wichtige Seiten selbst aus und speichere.

Channel-Vorschauen zeigen weiterhin cms.*-URLs. Veröffentliche einen frischen Beitrag — Structura berechnet die umgeschriebene URL nur zum Zeitpunkt der Einfügung, daher werden zwischengespeicherte Vorschau-Karten bestehender Beiträge erst aktualisiert, wenn der Beitrag erneut gespeichert wird oder der Channel ein neues Event sendet.

Die IndexNow-Schlüsseldatei lässt sich nicht verifizieren. Siehe den Abschnitt zur IndexNow-Fehlerbehebung. Häufigste Ursache: Die Datei ist nicht unter der genau angezeigten URL erreichbar — meist ein noch laufendes Deployment oder die Datei liegt in einem Unterverzeichnis statt im öffentlichen Root des Frontends.

Verwandte Seiten

• IndexNow-Channel — Schlüsseldatei-Upload- und -Verifizierungs-Flow für Headless-Installationen.
• Einstellungs-Tour — Übersicht über die restlichen Einstellungen auf der Allgemein-Seite.
• Wie Channels funktionieren — was Structura bei jeder Veröffentlichung ausgibt und welche Channels es konsumieren.