Template-Hierarchie und der Loop

Wenn jemand eine Seite einer WordPress-Website aufruft, muss WordPress entscheiden, wie sie aussehen soll. Ein einzelner Blogbeitrag braucht eine andere Darstellung als eine Übersicht aller Kurse, eine Kontaktseite eine andere als die Startseite. Diese Entscheidung trifft WordPress nach einem festen Regelwerk, der Template-Hierarchie. Sie legt fest, in welcher Reihenfolge WordPress nach Vorlagen sucht – von sehr speziell bis ganz allgemein. Wer sie versteht, kann gezielt eigene Darstellungen für einzelne Inhaltstypen, Kategorien oder Seiten anlegen, ohne komplizierte Bedingungen in den Code zu schreiben. Diese Lektion zeigt, wie die Hierarchie funktioniert – in klassischen wie in Block-Themes.

1. Das Prinzip

Das Prinzip ist einfach: Je genauer der Dateiname zur Anfrage passt, desto höher die Priorität. Für einen einzelnen Kurs sucht WordPress zuerst nach einer Vorlage genau für diesen Kurs, dann nach einer für alle Kurse, dann nach einer für alle Einzelinhalte und zuletzt nach index.html. Probieren Sie es aus:

In Block-Themes liegen die Vorlagen als HTML-Dateien im Ordner templates, in klassischen Themes als PHP-Dateien im Hauptordner – die Namen und die Reihenfolge sind dieselben. Außerdem kann jede Vorlage im Website-Editor überschrieben werden; diese Anpassungen werden in der Datenbank gespeichert und haben Vorrang vor der Datei im Theme.

2. Die wichtigsten Vorlagen

1index.html
2single.html
3archive.html
4archive-kurs.html
5page.html
6// Anfrage: /kurse/  (Archiv des Inhaltstyps „kurs“)

3. Template-Teile und benutzerdefinierte Vorlagen

Vorlagen setzen sich meist aus Teilen zusammen: Kopfzeile, Fußzeile, eine Seitenleiste. In Block-Themes liegen diese als Template-Teile im Ordner parts und werden mit dem Block „Template-Teil“ eingebunden. Neben der automatischen Hierarchie gibt es benutzerdefinierte Vorlagen, die Redakteure im Editor einer Seite gezielt zuweisen können – etwa „Landingpage ohne Navigation“ oder „Seite mit breiter Kopfgrafik“. Sie werden in theme.json unter customTemplates angemeldet und erscheinen dann in der Vorlagenauswahl des Editors.

1<!-- wp:template-part {"slug":"header","tagName":"header"} /-->
2
3<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
4<main class="wp-block-group">
5  <!-- wp:post-title {"level":1} /-->
6  <!-- wp:post-featured-image /-->
7  <!-- wp:post-content /-->
8  <!-- wp:pattern {"slug":"studio/kurs-buchung"} /-->
9</main>
10<!-- /wp:group -->
11
12<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->

4. Vom Loop zum Abfrage-Block

In klassischen Themes gibt jede Vorlage ihre Inhalte mit dem Loop aus, den Modul 2 gezeigt hat. In Block-Themes übernimmt das der Abfrage-Block (Query Loop): Er legt fest, welche Inhalte angezeigt werden – etwa die Beiträge der aktuellen Seite oder eine eigene Auswahl wie „drei Kurse für Einsteiger“ – und enthält eine Vorlage für jeden Eintrag aus Blöcken wie Titel, Bild und Auszug. Das Ergebnis ist dasselbe wie beim klassischen Loop, lässt sich aber im Editor gestalten und von Redakteuren anpassen, ohne PHP zu schreiben.

5. Gute Praxis

6. Ein Beispiel

Ein Yogastudio hat die Inhaltstypen Kurs und Kursleitung sowie die Taxonomie Niveau. Das Block-Theme enthält neben index.html die Vorlagen single-kurs.html mit Uhrzeit, Preis und Buchungsmuster, archive-kurs.html mit einem Abfrage-Block als Stundenplan, taxonomy-niveau.html mit einer kurzen Beschreibung des Niveaus über der Kursliste und single-leitung.html mit Porträt und einem Abfrage-Block, der alle Kurse dieser Person zeigt. Für Aktionen gibt es eine benutzerdefinierte Vorlage „Landingpage“ ohne Navigation. Keine einzige Bedingung im Code – die Hierarchie wählt immer die richtige Vorlage.

7. Häufige Fragen

Wie finde ich heraus, welche Vorlage gerade verwendet wird? Im Website-Editor zeigt WordPress beim Bearbeiten einer Seite an, welche Vorlage sie nutzt. Entwickler nutzen zusätzlich das Plugin Query Monitor, das bei jedem Seitenaufruf die verwendete Vorlage, alle geprüften Kandidaten und die Template-Teile auflistet – ein sehr hilfreiches Werkzeug, das Modul 5 ausführlich vorstellt.

Was passiert, wenn ich eine Vorlage im Editor ändere und das Theme ein Update bekommt? Die Änderung im Editor wird in der Datenbank gespeichert und hat Vorrang. Neue Fassungen derselben Vorlage aus dem Theme-Update werden erst sichtbar, wenn die angepasste Vorlage im Editor zurückgesetzt wird. Deshalb lohnt es sich, bewusst zu entscheiden, welche Vorlagen im Editor angepasst und welche im Theme gepflegt werden.

Gibt es die Hierarchie auch für eigene Plugins? Ja. Plugins können über Filter wie template_include eigene Vorlagen einspielen oder seit einigen Versionen Block-Vorlagen registrieren, die im Website-Editor erscheinen. So kann ein Buchungs-Plugin eine passende Vorlage für seine Inhalte mitbringen, die Redakteure trotzdem anpassen können.

8. Übung zum Selbermachen

Öffnen Sie in WordPress Playground den Website-Editor des Standard-Themes und legen Sie unter „Vorlagen“ eine neue Vorlage für einzelne Beiträge einer bestimmten Kategorie an. Gestalten Sie sie etwas anders als die allgemeine Beitragsvorlage, etwa mit einem farbigen Kopfbereich. Rufen Sie danach einen Beitrag dieser Kategorie und einen anderen auf und vergleichen Sie. Wer möchte, installiert zusätzlich Query Monitor und prüft, welche Vorlagen WordPress bei jedem Aufruf in Betracht gezogen hat – so wird die Hierarchie unmittelbar sichtbar.

Stand: September 2026, WordPress 7.1, PHP 8.3. Kursmaterial der Klarwerk Akademie. WordPress entwickelt sich schnell – maßgeblich ist die aktuelle Dokumentation auf developer.wordpress.org.