Templates¶
TWtheme ist ein Block-Theme. Die Templates liegen als HTML-Dateien im Theme und sind im Site-Editor bearbeitbar. Änderungen dort landen in der Datenbank und überschreiben die Datei aus dem Theme, bis man sie zurücksetzt.
Block-Templates¶
Diese Dateien liegen in templates/. WordPress wählt sie nach seiner
Template-Hierarchie automatisch aus.
| Datei | Greift bei |
|---|---|
index.html |
Rückfall, wenn nichts anderes passt |
page.html |
Seiten |
single.html |
Beiträge |
archive.html |
Archive |
search.html |
Suchergebnisse |
404.html |
Nicht gefundene Adressen |
Für die Inhaltstypen aus Modulen:
| Datei | Greift bei | Modul |
|---|---|---|
single-foreignword.html |
einzelnes Fremdwort | foreignwords |
archive-foreignword.html |
Fremdwort-Archiv | foreignwords |
taxonomy-foreignword-category.html |
Fremdwort-Kategorie | foreignwords |
single-tw_news.html |
einzelner News-Eintrag | news |
Seitenvorlagen¶
Diese Vorlagen wählt man beim Bearbeiten einer Seite selbst aus, im Seitenpanel unter Vorlage.
| Vorlage | Beschriftung im Backend | Für |
|---|---|---|
page-with-toc |
Page with table of contents | Seiten |
single-with-toc |
Single post with table of contents | Beiträge |
blank |
Blank | Seiten |
page-blank |
Blank (custom heading) | Seiten |
blank-no-header |
Blank without header | Seiten |
archive-foreignword |
Glossary archive | Fremdwörter |
single-foreignword |
Single foreign word | Fremdwörter |
taxonomy-foreignword-category |
Foreign word category | alle |
Die drei leeren Vorlagen unterscheiden sich darin, was sie weglassen: blank
liefert ein nacktes Grundgerüst, page-blank erlaubt eine eigene Überschrift,
und blank-no-header verzichtet zusätzlich auf den Kopfbereich. Sie sind für
Landingpages gedacht, die nicht in die normale Seitenstruktur passen.
Template-Parts¶
Die wiederverwendbaren Bereiche liegen in parts/. Im Site-Editor stehen sie
unter Muster → Template-Teile.
| Name | Beschriftung | Bereich |
|---|---|---|
header |
Header | Kopfbereich |
footer |
Footer | Fußbereich |
header-maintenance |
Maintenance header | Kopfbereich |
footer-maintenance |
Maintenance footer | Fußbereich |
sidebar-post |
Post sidebar | ohne Zuordnung |
Die beiden Wartungs-Parts werden nur eingesetzt, wenn der Wartungsmodus aktiv ist und die passende Option gesetzt wurde — siehe Wartungsmodus.
PHP-Template-Parts¶
Neben den Block-Template-Parts gibt es Bausteine in PHP unter
template-parts/. Sie werden nicht im Site-Editor bearbeitet, sondern aus Code
aufgerufen.
| Datei | Zweck |
|---|---|
loops/loop-default.php |
Standardvorlage einer Beitragsliste |
loops/loop-search.php |
Liste in Suchergebnissen |
loops/loop-404.php |
Vorschläge auf der 404-Seite |
cards/card-post.php |
einzelne Beitragskarte |
download/download-default.php |
Darstellung eines Downloads |
menus/topbar.php |
Topbar über dem Kopfbereich |
Die drei loop-*.php sind gleichzeitig die Auswahl im Block TW Loop und
erzeugen je eine Blockvorlage. Legt man dort eine weitere Datei nach demselben
Muster ab, erscheint sie automatisch in der Auswahl.
Klassische PHP-Templates¶
Im Theme-Wurzelverzeichnis liegen weiterhin PHP-Templates. Sie greifen nur, wenn für einen Fall kein Block-Template vorhanden ist, und sind vor allem Rückfall für Sonderfälle:
404.php, archive.php, page.php, page-simple.php, page-with-toc.php,
search.php, single.php, header.php, header-base.php,
header-checkout.php, footer.php, comments.php
Für neue Projekte sind die Block-Templates der Weg. Wer eines der PHP-Templates im Child überschreibt, sollte prüfen, ob nicht ohnehin ein Block-Template zuständig ist.
Was das Child überschreiben darf¶
Ein Child-Theme darf jedes Template und jeden Template-Part durch eine Datei mit
gleichem Namen ersetzen. Das ist der zweite von vier vorgesehenen
Anpassungswegen — vor eigenem CSS und vor PHP-Hooks, aber nach der theme.json.
Details unter Child-Theme und Templates überschreiben.