Seiten & Blöcke

Anders als Einträge gehören Seiten immer zu genau einer Website und haben einen festen Pfad. Sie bestehen aus Blöcken in einer Reihenfolge — Hero, Text, Galerie, Formular, Eintragsliste — und sind das, was Besucher tatsächlich aufrufen.

Seite anlegen

Unter Seiten → Neu wählen Sie Titel, Pfad, Sprache und optional eine Vorlage. Der Pfad ist vollständig, inklusive Schrägstrich am Anfang; die Startseite hat den Pfad /. Seiten lassen sich verschachteln: /leistungen/webdesign liegt unter /leistungen, die Delivery API liefert daraus die Breadcrumbs.

Der Editor

Links der Seitenbaum (einklappbar, mit Sprachumschalter), rechts der Editor mit vier Reitern: Inhalt (die Blöcke, daneben die Live-Vorschau), Seite (Name, Adresse, Elternseite, Vorlage, Sprache, Status und Zeitplan), SEO und Verlauf (Kenndaten und Versionen). ⌘1 bis ⌘4 springen zwischen den Reitern. Kommentare öffnen sich über die Sprechblase in der Kopfzeile als Seitenpanel.

Blöcke

Jeder Block hat einen Typ und eigene Felder. Die Reihenfolge ändert man per Anfasser links am Block (Drag-and-drop) oder mit Alt und den Pfeiltasten; gespeichert wird sie mit der Seite. Jede Karte zeigt eine Kurzvorschau (erste Textzeile oder Bildname), aufgeklappt die Felder. Ab neun Blöcken erscheint oben eine einklappbare Gliederung mit Sprungmarken. Häufige Blocktypen:

Unbekannte Blocktypen — etwa aus einem Frontend, das eigene Blöcke definiert — bleiben erhalten und werden als JSON angezeigt, statt gelöscht zu werden.

Vorlagen

Eine Seitenvorlage ist kein Inhalt, sondern ein Bauplan: Sie legt den Komponenten-Schlüssel fest (unter dem das Frontend die Render-Komponente sucht, z. B. LandingPage), schränkt optional die erlaubten Blöcke ein und gibt jeder neuen Seite Standard-Blöcke in fester Reihenfolge mit. Benutzte Vorlagen lassen sich nicht löschen, nur archivieren.

Musterseiten mit Parametern

Ein Pfad darf Parameter enthalten: /produkte/:slug oder /team/:person. Die Delivery API vergleicht Segment für Segment, :name passt auf ein beliebiges Segment, und liefert die Werte unter params:

curl "https://entrydeck.app/api/v1/delivery/page?route=/produkte/master-cms&locale=de&expand=all" \
  -H "x-api-key: $ENTRYDECK_API_KEY"

{
  "page": { "title": "Produkt", "fullPath": "/produkte/:slug", "blocks": [ … ], "seo": { … } },
  "params": { "slug": "master-cms" },
  "requestedRoute": "/produkte/master-cms",
  "breadcrumbs": [ { "title": "Produkte", "fullPath": "/produkte" }, { "title": "Produkt", "fullPath": "/produkte/:slug" } ]
}

Das Frontend holt anschließend den passenden Eintrag über GET /delivery/content/produkt/master-cms. Feste Pfade haben Vorrang vor Mustern.

Sprachen

Der Sprachumschalter oben in der Baumspalte wechselt die Übersetzung der Seite. Jede Sprachfassung hat ihren eigenen Pfad; die API liefert unter seo.hreflang alle Alternativen derselben Seite.

SEO je Seite

Reiter SEO im Editor: Titel, Beschreibung, Bild, Canonical, noindex, Sitemap-Priorität und Änderungsfrequenz. Bleiben Titel oder Beschreibung leer, nimmt die API den Seitentitel und die erste Textzeile der Blöcke als Rückfall. Das Ergebnis ist das SEO-Objekt mit Meta-Tags, Open Graph, hreflang und JSON-LD (inklusive BreadcrumbList).

Veröffentlichen

Eine veröffentlichte Seite ist über die API der Website abrufbar. Entwürfe bleiben unsichtbar — auch wenn sie in der Navigation verlinkt sind. GET /delivery/pages/tree liefert den veröffentlichten Seitenbaum für Menüs und Sitemaps, GET /delivery/sitemap alle Pfade mit Zeitstempeln.

Versionen vergleichen

Jedes Speichern und Veröffentlichen legt eine Version der Seite an (Titel, Pfad, SEO, alle Blöcke). Unter Verlauf lässt sich jede Version mit dem Arbeitsstand oder der vorigen Version vergleichen: Texte als Inline-Diff (+ eingefügt, − gelöscht), Blöcke je Position (Bühne #1 · title), hinzugefügte oder entfernte Blöcke als Ganzes. Vor dem Wiederherstellen erscheint derselbe Vergleich als Vorschau; wiederhergestellt wird in den Entwurf, live ändert sich erst mit „Veröffentlichen“.

API: GET /admin/pages/{id}/revisions/{revId}/diff?against=current|{revId}.

Kommentare und gleichzeitiges Bearbeiten

Die Sprechblase in der Kopfzeile des Editors öffnet die Kommentare als Seitenpanel – der Inhalt bleibt sichtbar: Threads mit Antworten, an die Seite oder einen Block geheftet, @Name erwähnt jemanden per E-Mail, „Erledigt“ schließt den Thread. Gleichzeitig hält das Admin eine weiche Bearbeitungssperre: Bearbeitet jemand anderes die Seite, erscheint oben ein Hinweis, und Speichern lehnt der Server mit 423 Locked ab, bis die Sperre frei ist (90 Sekunden ohne Lebenszeichen) oder jemand mit pages.publish übernimmt.

Tipps

• Erst Seite, dann Navigation: ein Menüpunkt auf eine nicht existierende Seite führt ins Leere.
• ⌘ S speichert; beim Verlassen mit offenen Änderungen fragt das Admin nach.
• Für Inhalte, die auf mehreren Websites erscheinen sollen, einen Eintrag anlegen und per Block einbinden — nicht den Text in mehrere Seiten kopieren.