Faragiri

Themes lernen WordPress

Die Ausweichliste, die WordPress für jede Seitenart durchgeht, die zwei Theme-Formate und die eine Auflistung, die sie unterscheidet.

4Abschnitte
3Min. Lesezeit
5Tiefe

Eine URL, fünf Kandidaten

Die Reihenfolge, in der WordPress Dateien für einen Beitrag versucht

Die erste vorhandene Datei gewinnt, der Rest wird nie befragt, weshalb eine neue Datei das Design ändert und die falsche zu bearbeiten nichts bewirkt.

  1. single-{post_type}-{slug}.phpEin einzelner Beitrag. Unsichtbar, sobald der Slug sich ändert
  2. single-{post_type}.phpJeder Beitrag eines Typs. Die nützliche Überschreibung
  3. single.phpJeder einzelne Beitrag, gleich welchen Typs
  4. singular.phpGeteilt mit Seiten. Die Datei, die die meisten Themes haben sollten
  5. index.phpExistiert immer, denn ein Theme ohne sie ist keins

Ein Block-Theme geht dieselbe Liste mit .html-Dateien in einem templates-Verzeichnis durch. Die Schiene ist die Hierarchie, nicht das Dateiformat, weshalb Anleitungen zu einer Art meist auch für die andere gelten.

WordPress wählt eine Template-Datei, indem es eine Liste der Reihe nach durchgeht und die erste nimmt, die existiert. Für einen einzelnen Beitrag lautet die Liste single-{post_type}-{slug}.php, dann single-{post_type}.php, dann single.php, dann singular.php, dann index.php. Nichts wird geroutet und nichts angemeldet, der Dateiname ist das Routing.

index.php ist deshalb die einzige Datei, die ein Theme wirklich braucht, zusammen mit style.css für den Kopfkommentar, der es benennt. Jede weitere Datei ist eine Überschreibung, die die Liste früher abfängt, und eine neue Datei anzulegen ist der Weg, einen einzigen Inhaltstyp anders aussehen zu lassen, ohne etwas Bestehendes anzufassen.

Die Listen, die man auswendig kennt

  • Eine Seite: {custom}.php aus der eigenen Vorlagenwahl der Seite, dann page-{slug}.php, page-{id}.php, page.php, singular.php, index.php
  • Ein Archiv: archive-{post_type}.php, dann archive.php, dann index.php
  • Eine fehlende Seite: 404.php, dann index.php
  • singular.php ist die gemeinsame Ausweichdatei für einen Beitrag und eine Seite, und die meisten Themes haben sie nicht und sollten sie haben

Die Slug- und ID-Varianten oben sind der Notausgang, und sie sparsam einzusetzen lohnt sich: Eine Vorlage, benannt nach dem Slug einer einzelnen Seite, ist unsichtbar, bis jemand die Seite umbenennt, und dann fällt das Design still auf die nächste Stufe zurück.

Zwei weitere Tatsachen runden das Bild ab. Eine Template-Datei wird eingebunden, nicht aufgerufen, also steht alles zur Verfügung, was an dieser Stelle im Gültigkeitsbereich liegt: $post, die Abfrage, und was ein Plugin bei einem früheren Hook vorbereitet hat. Und die Schleife ist ausdrücklich vorhanden statt implizit, weshalb eine Vorlage, die the_post() vergisst, denselben Beitrag mehrfach oder gar nichts ausgibt.

Zwei Arten von Themes, und der Blick, der sie unterscheidet

Ein klassisches Theme besteht aus PHP-Vorlagen plus functions.php, und die Hierarchie oben ist das gesamte Routing. Ein Block-Theme besteht aus HTML-Dateien in einem Verzeichnis templates/ plus einer theme.json, bearbeitet im Website-Editor statt in einer Datei, und dieselbe Hierarchie gilt weiter, nur mit .html statt .php.

Der Unterschied zeigt sich in einer einzigen Verzeichnisauflistung: theme.json und templates/index.html vorhanden heißt Block-Theme, nur index.php und functions.php heißt klassisch. Sabine Runge betreut in Görlitz die Website eines Kulturvereins, dessen Theme klassisch ist, mit index.php, functions.php und style.css, ohne theme.json. Die meisten veröffentlichten Anleitungen behandeln eine der beiden Arten, ohne zu sagen, welche.

Was 2026 zum Einsatz kommt

Ein Child-Theme ist das Werkzeug, wenn das Theme jemand anderem gehört, kostenlos mit WordPress: ein Verzeichnis mit einer style.css, die das übergeordnete Theme benennt, und einer functions.php, und jede hinzugefügte Vorlagendatei überschreibt die Version des übergeordneten Themes. Es hat das Bearbeiten des übergeordneten Themes abgelöst, das bei der nächsten Aktualisierung verlorengeht, und es ist die nützlichste Konvention in WordPress.

Query Monitor nennt die Vorlage, die für die aktuelle Anfrage tatsächlich lief, kostenlos, und macht aus der Liste oben eine Beobachtung statt einer Vermutung. Es hat das Einbauen von Testausgaben in jede infrage kommende Datei ersetzt, und es nennt auch, aus welchem übergeordneten oder Child-Verzeichnis die Vorlage kam.

Wo die falsche Datei bearbeitet wird

Der Stall ist, eine Datei zu bearbeiten, die gar nicht läuft. Eine Änderung an single.php bewirkt nichts, weil eine single-post.php existiert, oder weil das Theme ein Child ist und die bearbeitete Datei dem übergeordneten Theme gehört. Nichts meldet einen Fehler, die Änderung hat einfach keine Wirkung, und die natürliche Reaktion ist eine noch größere Änderung.

Vor jeder Bearbeitung lohnt sich ein Blick darauf, welche Vorlage für diese URL läuft, eine Zeile in Query Monitor, die die ganze Fehlerklasse beseitigt. Wie ein Plugin in diese Vorlagen eingreift, statt in ihnen zu wohnen, ist die andere Hälfte der Schichtregel, und wie dieselbe Installation Inhalte über die REST-Schnittstelle statt über eine Vorlage ausliefert, ist die dritte.

Daneben

Darüber