Was ist die WordPress-Vorlagenhierarchie und wie funktioniert sie?

Wenn du dich mit der Entwicklung von Themes beschäftigst, musst du die Hierarchie der WordPress-Vorlagen verstehen. Das CMS verwendet Vorlagendateien, um Inhalte im Frontend darzustellen. Daher ist es wichtig, die Grundlagen der WordPress-Hierarchie zu kennen, wenn du ein Theme anpassen oder von Grund auf neu erstellen willst.

Obwohl die Erstellung eines WordPress-Themes keine Raketenwissenschaft ist, musst du die Grundlagen kennen. Neben sicherem WP-Hosting, Domain, Theme und Plugins musst du auch die Template-Hierarchie verstehen. In diesem Artikel erklären wir dir, wie die WP-Template-Hierarchie, die Seitenstruktur und die Template-Dateien funktionieren, damit du wie ein Profi Themes erstellen und anpassen kannst. Lasst uns eintauchen!

Was ist die WordPress-Vorlagenhierarchie?

Die WordPress-Vorlagenhierarchie ist die Struktur, die entscheidet, welche Vorlagen in welcher Reihenfolge für die Anzeige einer Webseite verwendet werden. Technisch gesehen wird die Hierarchie mithilfe von Query-Strings durchsucht, bis die erste passende Vorlage gefunden wird. Diese Hierarchie ermöglicht es Webentwicklern, individuelle Seitenlayouts für verschiedene Arten von Inhalten zu erstellen, indem sie bestimmte Vorlagendateien gegenüber ihren allgemeinen Gegenstücken bevorzugen.

Wenn WordPress eine bestimmte Vorlagendatei nicht finden kann, bewegt es sich in der Hierarchie nach unten, bis es die erste brauchbare Datei gefunden hat. Wenn du die Vorlagenhierarchie verstehst und nutzt, hast du mehr Flexibilität und Kontrolle über das Aussehen und die Funktionen einer WordPress-Website.

Statische Websites verwenden in der Regel statisches HTML und CSS, um ihre Inhalte im Frontend darzustellen. WordPress ist jedoch eine dynamische Plattform, die auf der Programmiersprache PHP basiert. Jede WordPress-Website lädt eine Vielzahl von PHP-Dateien, die jeweils festlegen, wie die verschiedenen Bereiche der Seite aussehen sollen.

Jedes Content Management System sucht jedes Mal, wenn du eine Webanwendung lädst, nach den Vorlagendateien. Wenn du zum Beispiel die WordPress-Suchfunktion verwendest, sucht das CMS nach zwei Vorlagendateien.

1. Search.php bestimmt, wie deine Suchseiten aussehen werden
2. Index.php ist die Standardvorlagendatei, die WordPress verwendet, wenn es die oberste Option innerhalb einer Hierarchie nicht erkennen kann.

Was sind WordPress-Vorlagendateien?

Vorlagendateien sind ein Teil der WordPress-Architektur. Der Code legt den Weg für die Darstellung von Inhalten in Beiträgen, Seiten und anderen Bereichen der Website fest. Die WordPress-Vorlagenhierarchie ist Teil jedes Themes oder Layouts, das du verwendest. Klassische WordPress-Themes verwenden in der Regel PHP-Dateien, die mit HTML- und PHP-Code entwickelt wurden. Moderne Block-Themes hingegen verwenden nur HTML-Dateien.

Die meisten WordPress-Websites benötigen mehrere Vorlagendateien, um Inhalte anzuzeigen. Hier sind die sieben am häufigsten verwendeten Vorlagendateien, die du kennen musst.

1. Index.php
2. Header.php
3. Footer.php
4. Sidebar.php
5. Functions.php
6. Comments.php
7. Single.php

Blog-Beiträge verwenden in der Regel die Datei single.php als Standardvorlage für die Anzeige des Inhalts, während Kopfzeile, Fußzeile und Seitenleiste auf den einzelnen Seiten ihre jeweiligen .php-Dateien verwenden. Die letzten drei Dateien werden Template Partials genannt, da sie auch für die Definition anderer Vorlagen verwendet werden können. Dazu später mehr.

Verstehen, wie die Vorlagenhierarchie funktioniert

Ein typisches WordPress-Theme besteht aus mehreren Vorlagen. Daher muss die Plattform entscheiden, welche Vorlage für die Anzeige von Inhalten verwendet werden soll. Deshalb müssen einige Vorlagendateien Vorrang vor anderen haben. Und genau das ist das Wesen der Vorlagenhierarchie.

Vorlagendateien mit hoher Priorität sind das Backup, wenn WordPress eine benutzerspezifische Hierarchie nicht findet. WordPress sucht nach einer ausgewählten Vorlagendatei, wenn Nutzer eine Webseite aufrufen wollen. Wenn das CMS die richtige Vorlage nicht findet, verwendet es die Hierarchie, um die nächstgeeignete Vorlage zu finden.

Wenn du zum Beispiel versuchst, eine Webseite zu laden, z. B. für die Kategorie Shared Hosting, passiert Folgendes im Hintergrund.

• WordPress sucht im Verzeichnis des installierten Themes nach einer Vorlagendatei namens „category-shared-hosting.php“.
• Wenn es die Datei nicht finden kann, sucht WordPress stattdessen nach der Kategorie-ID. Zum Beispiel: „category-2.php“.
• Wird eine der beiden Vorlagendateien nicht gefunden, sucht WordPress nach einer allgemeinen „category.php“-Datei.
• Damit ist die Suche aber noch nicht beendet, denn als Nächstes ist die Datei „archive.php“ an der Reihe.
• Wenn alles andere fehlschlägt, verwendet WordPress die Datei „index.php“ deines Themes als Standardvorlage.

Every WordPress website comprises multiple categories, each with its own template hierarchy for seamless navigation and quick access. A typical website can be segregated into seven template styles. Let’s walk you through each in a bit more detail.

Startseite

Die Startseite oder Homepage ist die wichtigste Landing Page einer Website, denn hier landen die Besucher normalerweise. Die Hierarchie der Startseite besteht in der Regel aus drei Vorlagendateien, nämlich front-page.php, home.php und index.php. WordPress verwendet diese Hierarchie, wenn ein Nutzer die Startseite deiner Website aufrufen möchte.

Einzelne Beiträge

Es gibt drei Hauptvorlagendateien für einzelne Beiträge wie Blogs und Artikel. Diese sind single.php, singular.php und index.php. Da es auf der Website jedoch auch Bestimmungen für benutzerdefinierte Beitragstypen geben kann, sucht WordPress nach zwei weiteren Vorlagendateien, bevor es mit diesen beginnt. Die Vorlagenhierarchie sieht also wie folgt aus.

1. Single-{post-type}-{slug}.php
2. Single-{post-type}.php
3. Single,php
4. Singular.php
5. Index.php

Einzelne Seiten

Jede Seite einer WordPress-Website außer der Startseite fällt unter die Kategorie der Einzelseiten. Die Vorlagenhierarchie ist ähnlich wie bei den einzelnen Beiträgen, mit Ausnahme der optionalen benutzerdefinierten Vorlagendatei. Werfen wir einen Blick auf die Hierarchie.

1. (Custom template file)
2. Page-{slug}.php
3. Page-{id}.php
4. Page.php
5. Singular.php
6. Index.php

Kategorieseiten

Die Vorlagenhierarchie für Kategorien funktioniert ähnlich wie die Hierarchie für einzelne Seiten. Anstatt zum Beispiel nach dem Seitenslug und der Seiten-ID zu suchen, sucht WordPress nach dem Kategorieslug und der ID, bevor es nach category.php, archive.php und index.php sucht.

Benutzerdefinierte Beitragstypen

Wenn du ein WordPress Plugin für benutzerdefinierte Beitragstypen verwendest oder dein Theme diese Funktion integriert hat, sucht das CMS nach dem Archiv des Beitragstyps, bevor es zu den Standarddateien archive.php und index.php des Themes zurückkehrt. Wenn du zum Beispiel nach dem benutzerdefinierten Produkt-Post-Type suchst, sieht die Vorlagenhierarchie folgendermaßen aus:

1. Archive-{post_type}.php
2. Archive.php
3. Index.php

Suchergebnisseiten

Die meisten WordPress-Themes haben heute eine integrierte Suchfunktion. Dafür wird die Vorlage search.php für die Suchergebnisseite benötigt. Wenn deine Website auf die Suchfunktion angewiesen ist, stelle sicher, dass dein WordPress-Theme eine Vorlage für die Suchseite hat. Wenn du neu in der Webentwicklung bist und Hilfe bei der Suche nach einem guten WordPress-Theme brauchst, kannst du hier erfahren, wie du ein WordPress-Theme auswählst.

404-Fehlerseiten

Wenn Besucher eine URL falsch eingeben oder versuchen, eine Seite aufzurufen, die nicht existiert, gibt WordPress eine 404-Fehlerseite zurück. Die Hierarchie der WordPress-Vorlagen ist ziemlich einfach. Das CMS sucht zuerst nach der Datei 404.php, gefolgt von index.php. Die meisten WordPress-Themes werden mit einer 404.php-Datei ausgeliefert. Wenn das nicht der Fall ist, empfehlen wir dir, eine eigene Fehlerseitenvorlage zu erstellen.

Fazit

Die WordPress-Vorlagenhierarchie erklärt, wie das CMS beim Laden einer Webseite nach Dateien sucht. Wenn du mit der Vorlagenhierarchie deiner Website vertraut bist, kannst du die Suchergebnisse optimieren, die Ladezeiten der Seite verkürzen und so die Benutzerfreundlichkeit verbessern. Lass dich nicht von den Details überwältigen. Stattdessen kannst du langsam anfangen und dich mit etwas Übung an den Prozess gewöhnen.

FAQ