Template Parts über theme.json im WordPress-Theme registrieren

Wiederkehrende Layout-Bereiche sollen im Site Editor verständlich auffindbar sein. theme.json registriert Template Parts mit Titel und Bereich und ordnet sie dadurch in die Theme-Bearbeitung ein.

3 Min. von Matthias Ulrich

Header, Footer und weitere wiederkehrende Bereiche werden in WordPress-Block-Themes als Template Parts organisiert. Sie liegen als Block-Markup im Theme und können in mehreren Vorlagen verwendet werden.

Die Datei theme.json ergänzt diese Bausteine um Angaben für den Site Editor. Sie verbindet den Dateinamen mit einem verständlichen Titel und ordnet das Template Part einem Bereich wie Header, Footer oder den allgemeinen Vorlagenbereichen zu.

Template Parts werden als wiederverwendbare Papiermodule registriert und in einer WordPress-Seitenvorlage zusammengesetzt.
theme.json benennt und ordnet wiederverwendbare Template Parts, die Vorlagen über ihren Slug einbinden.

Wiederkehrende Bereiche als Dateien anlegen

Die Dateien eines Template Parts liegen im Ordner /parts des Themes. Ein Block-Theme mit Header, Footer und Seitenleiste kann beispielsweise so aufgebaut sein:

theme/
├── parts/
│   ├── header.html
│   ├── footer.html
│   └── sidebar.html
├── templates/
│   ├── index.html
│   └── single.html
└── theme.json

Jede Datei enthält Block-Markup und bildet einen eigenständigen Layout-Baustein. Vorlagen binden diese Bausteine an den Stellen ein, an denen sie auf der Website erscheinen.

Template Parts im Site Editor benennen

Die Eigenschaft templateParts in der theme.json enthält die verfügbaren Template Parts. Das folgende Beispiel registriert einen Header, einen Footer und eine allgemeine Seitenleiste:

{
	"$schema": "https://schemas.wp.org/trunk/theme.json",
	"version": 3,
	"templateParts": [
		{
			"name": "header",
			"title": "Standard-Header",
			"area": "header"
		},
		{
			"name": "footer",
			"title": "Standard-Footer",
			"area": "footer"
		},
		{
			"name": "sidebar",
			"title": "Seitenleiste",
			"area": "uncategorized"
		}
	]
}

Die drei Angaben übernehmen unterschiedliche Aufgaben:

  • name entspricht dem Dateinamen im Ordner /parts, jeweils ohne die Endung .html.
  • title zeigt im Site Editor eine verständliche Bezeichnung.
  • area ordnet den Baustein einem Bereich zu. WordPress verwendet dafür unter anderem header, footer und uncategorized.

Header und Footer erscheinen dadurch in ihren vorgesehenen Bereichen. uncategorized fasst weitere wiederverwendbare Theme-Bausteine zusammen.

Template Parts in Vorlagen einbinden

Die Registrierung beschreibt das Template Part für WordPress und den Site Editor. Die jeweilige Vorlage bestimmt seine Position im Seitenlayout.

<!-- wp:template-part {"slug":"header","tagName":"header"} /-->

<!-- Seiteninhalt -->

<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->

Der Wert von slug verweist auf den Namen aus der theme.json und damit auf die passende Datei im Ordner /parts. Das Attribut tagName legt das semantische HTML-Element für die Ausgabe fest.

Änderungen aus dem Site Editor ins Theme übernehmen

Registrierte Template Parts erscheinen im Site Editor unter den Vorlagenbereichen. Verständliche Titel und die Zuordnung zum passenden Bereich erleichtern die Auswahl, besonders bei mehreren Header- oder Footer-Varianten.

Im Site Editor gespeicherte Anpassungen liegen in der WordPress-Datenbank und werden bei der Ausgabe verwendet. Für eine dauerhafte Übernahme ins Theme wird das angepasste Block-Markup wieder in die zugehörige Datei unter /parts übertragen.

Ergebnis

Wiederkehrende Layout-Bausteine im Site Editor verwalten

Die Datei theme.json verbindet die Template-Part-Dateien eines Block-Themes mit verständlichen Bezeichnungen im Site Editor. Vorlagen können dieselben Header, Footer und weiteren Bereiche dadurch gemeinsam verwenden.

Dateien im Theme bündeln

Header, Footer und weitere Bestandteile liegen als eigenständige Dateien im Ordner /parts.

Bereiche im Editor einordnen

theme.json ergänzt Titel und Bereich, damit Template Parts im Site Editor verständlich erscheinen.

Vorlagen gemeinsam aufbauen

Vorlagen binden die benötigten Bausteine über ihren Slug ein und verwenden sie an mehreren Stellen.