Das Schema eines Abschnitts

Aufbau der schema.json, die Felder eines Einstellungseintrags und die Falle mit den Vorgabewerten.

Für Entwickler

Voraussetzungen

  • Recht: website:write

Die Datei `sections/<typ>.schema.json` enthält ein Objekt mit `name` (der Name im Editor), `settings` (die Einstellungen des Abschnitts), `blocks` (die Blockarten) und `default` (Vorgaben).

Ein Eintrag in `settings` kennt: `type` (Pflicht), `id` (Pflicht, der Schlüssel unter `section.settings`), `label` (Pflicht, die Beschriftung im Editor) sowie optional `default`, `options`, `min`, `max`, `step`, `unit` und `info`.

Der Typ wird beim Einlesen NICHT geprüft. Schreiben Sie einen Typ, den der Editor nicht kennt, entsteht kein Fehler — das Feld erscheint einfach nicht. Die Liste der unterstützten Typen steht in einem eigenen Artikel.

Zusätzlich wertet der Editor `max_blocks` aus und verweigert danach weitere Blöcke. Beim Rendern wird die Zahl nicht erzwungen.

DIE FALLE bei den Vorgabewerten: Für einen Abschnitt im Rumpf einer Seite zählt ausschliesslich das `default` AM EINZELNEN FELD. Der Block `default.settings` am Schema wird dort ignoriert — er wirkt nur bei Abschnitten, die über `{% section %}` aus dem Layout kommen, also bei Kopf- und Fussbereich. Wer sich darauf verlässt, sieht seinen Abschnitt leer.

Wo im Dashboard

/restaurant/[slug]/website/themes/[id]/code

Im Dashboard öffnen