Editor-Werkzeuge mit theme.json zentral festlegen

Farben, Schriften, Abstände und Layoutwerkzeuge bilden im WordPress-Editor die Gestaltung eines Themes ab. settings in der theme.json bündelt diese Auswahl zentral und stellt sie für die Bearbeitung von Inhalten bereit.

3 Min. von Matthias Ulrich

Der Bereich settings in der theme.json bestimmt, welche Gestaltungswerkzeuge und Presets im WordPress-Editor erscheinen. Dazu gehören Farbpaletten, Schriftgrössen, Inhaltsbreiten und Abstandsoptionen.

Die Konfiguration überträgt das Designsystem des Themes in die Bearbeitungsoberfläche. Redakteurinnen und Redakteure arbeiten dadurch mit benannten Werten, die zentral im Theme gepflegt werden.

Die in theme.json definierten Presets übertragen das Designsystem des Themes in die Bearbeitungsoberfläche.

Editor-Werkzeuge zentral definieren

Eine kompakte Grundstruktur zeigt die wichtigsten Einstellungsbereiche:

{
  "$schema": "https://schemas.wp.org/trunk/theme.json",
  "version": 3,
  "settings": {
    "appearanceTools": true,
    "color": {},
    "typography": {},
    "layout": {},
    "spacing": {},
    "blocks": {}
  }
}

appearanceTools aktiviert eine Gruppe häufig verwendeter Gestaltungswerkzeuge. Die einzelnen Bereiche erhalten anschliessend eigene Presets und blockbezogene Vorgaben.

Farbpalette im Editor bereitstellen

Eine projektspezifische Farbpalette stellt die Farben des Themes im Editor zur Auswahl. WordPress erzeugt aus den Slugs gleichzeitig CSS-Variablen wie --wp--preset--color--accent.

"color": {
  "palette": [
    { "name": "Akzent", "slug": "accent", "color": "#2f6b4f" },
    { "name": "Fläche", "slug": "surface", "color": "#faf9f2" }
  ]
}

Die Bezeichnungen erleichtern die Auswahl im Editor, während die Slugs eine stabile technische Grundlage für Styles im Theme bilden.

Typografie als Presets organisieren

Schriftfamilien und Schriftgrössen werden ebenfalls als benannte Presets hinterlegt. Dadurch erscheinen verständliche Bezeichnungen im Editor, während das Theme mit den zugehörigen Slugs arbeitet.

"typography": {
  "fontFamilies": [
    {
      "name": "Helvetica",
      "slug": "helvetica",
      "fontFamily": "Helvetica, sans-serif"
    }
  ],
  "fontSizes": [
    { "name": "Basis", "slug": "base", "size": "1rem" },
    { "name": "Gross", "slug": "large", "size": "2rem" }
  ]
}

Selbst gehostete Schriftdateien können bei Bedarf zusätzlich über fontFace eingebunden werden. Für die grundlegende Struktur genügt die Definition der Schriftfamilie.

Layout und Gestaltungswerkzeuge abstimmen

layout legt die reguläre und die breite Inhaltsgrösse fest. Die Bereiche spacing und border bestimmen, welche Werkzeuge für Abstände und Rahmen im Editor angeboten werden.

"layout": {
  "contentSize": "730px",
  "wideSize": "1220px"
},
"spacing": {
  "blockGap": true,
  "margin": true,
  "padding": true,
  "units": ["px", "rem", "%"]
},
"border": {
  "color": true,
  "radius": true,
  "style": true,
  "width": true
}

settings stellt diese Werkzeuge bereit. Konkrete Standardwerte wie ein fester Blockabstand oder eine Rahmenfarbe werden im Bereich styles definiert.

Einstellungen für einzelne Blöcke ergänzen

Globale Einstellungen lassen sich für einzelne Blöcke erweitern. Das folgende Beispiel stellt dem Button die Rahmenoptionen bereit und verwendet fest definierte Schriftgrössen aus dem Theme:

"blocks": {
  "core/button": {
    "border": {
      "radius": true,
      "width": true
    },
    "typography": {
      "fontSize": false
    }
  }
}

So erhält jedes Inhaltselement die Werkzeuge, die zu seiner Gestaltung gehören. Dieselbe Struktur steht auch für weitere Core- und eigene Blöcke zur Verfügung.

Settings und Styles zusammenführen

settings definiert die Auswahlmöglichkeiten im Editor. styles verwendet diese Presets für die tatsächliche Grundgestaltung. Eine registrierte Schriftfamilie lässt sich beispielsweise global anwenden:

"styles": {
  "typography": {
    "fontFamily": "var(--wp--preset--font-family--helvetica)"
  }
}

Damit greifen Editor und Frontend auf dieselben benannten Gestaltungswerte zurück.

Ergebnis

Gestaltungswerkzeuge im Editor aus dem Theme bereitstellen

Die theme.json verbindet das Designsystem eines Themes mit den Werkzeugen im WordPress-Editor. Farben, Typografie, Abstände und Layoutwerte stehen dort als zentral gepflegte Auswahl bereit.

Presets zentral bereitstellen

Farben, Schriften, Abstände und Grössen stehen als benannte Werte im Editor bereit.

Werkzeuge sinnvoll begrenzen

Das Theme gibt für Rahmen, Abstände und Layout die Werkzeuge vor, die zum System gehören.

Blöcke differenziert konfigurieren

Einzelne Blöcke erhalten ergänzende Optionen, die ihre redaktionelle Gestaltung unterstützen.