WordPress.org (Deutsch)

Wie bereits erwähnt, sind Vorlagendateien modulare, wiederverwendbare Dateien, die zum Generieren der Webseiten auf Ihrer WordPress-Site verwendet werden. Einige Vorlagendateien (z. B. die Kopf-und Fußzeilenvorlage) werden auf allen Seiten Ihrer Website verwendet, während andere nur unter bestimmten Bedingungen verwendet werden.

Dieser Artikel erklärt, wie WordPress bestimmt, welche Vorlagendatei (en) auf einzelnen Seiten verwendet werden soll. Wenn Sie ein vorhandenes WordPress-Theme anpassen möchten, können Sie entscheiden, welche Vorlagendatei bearbeitet werden muss.,

Die Vorlagendateihierarchie #Die Vorlagendateihierarchie

Übersicht #Übersicht

WordPress verwendet die Abfragezeichenfolge, um zu entscheiden, welche Vorlage oder welcher Satz von Vorlagen zum Anzeigen der Seite verwendet werden soll. Die Abfragezeichenfolge enthält Informationen, die im Link zu jedem Teil Ihrer Website enthalten sind. Es kommt nach dem ersten Fragezeichen und kann eine Reihe von Parametern enthalten, die durch kaufmännische Zeichen getrennt sind.,

Einfach ausgedrückt, WordPress durchsucht die Vorlagenhierarchie, bis eine passende Vorlagendatei gefunden wird. Um zu bestimmen, welche Vorlagendatei verwendet werden soll, stimmt WordPress:

1. jede Abfragezeichenfolge mit einem Abfragetyp ab, um zu entscheiden, welche Seite angefordert wird (z. B. eine Suchseite, eine Kategorieseite usw.);
2. Wählt die Vorlage in der von der Vorlagenhierarchie festgelegten Reihenfolge aus;
3. Sucht nach Vorlagendateien mit bestimmten Namen im Verzeichnis des aktuellen Themas und verwendet die erste übereinstimmende Vorlagendatei, wie in der Hierarchie angegeben.,

Mit Ausnahme der Vorlagendatei basic index.php können Sie auswählen, ob Sie eine bestimmte Vorlagendatei implementieren möchten oder nicht.

Wenn WordPress eine Vorlagendatei mit einem passenden Namen nicht finden kann, springt sie zur nächsten Datei in der Hierarchie. Wenn WordPress keine passende Vorlagendatei finden kann, wird die index.php – Datei des Themas verwendet.,

Top

Beispiele #Beispiele

Wenn sich Ihr Blog unter befindet und ein Besucher auf einen Link zu einer Kategorieseite klickt, z. B. , sucht WordPress im Verzeichnis des aktuellen Themas nach einer Vorlagendatei, die der ID der Kategorie entspricht, um die richtige Seite zu generieren. Genauer gesagt folgt WordPress diesem Verfahren:

1. Sucht im Verzeichnis des aktuellen Themas nach einer Vorlagendatei, die dem Slug der Kategorie entspricht. Wenn die Kategorie Slug „unicorns“ ist, sucht WordPress nach einer Vorlagendatei mit dem Namen category-unicorns.php.,
2. Wenn category-unicorns.php fehlt und die ID der Kategorie 4 ist, sucht WordPress nach einer Vorlagendatei mit dem Namen category-4.php.
3. Wenn category-4.php fehlt, sucht WordPress nach einer generischen Kategorievorlagendatei, category.php.
4. Wenn nicht existiert, sucht WordPress nach einer generischen Archivvorlage, archive.php.
5. Wenn archive.php fehlt auch, WordPress zurückgreifen, um den Haupt-Thema Vorlage Datei index.php.,

Top

Visuelle Übersicht #Visuelle Übersicht

Das folgende Diagramm zeigt, welche Vorlagendateien aufgerufen werden, um eine WordPress-Seite basierend auf der WordPress-Vorlagenhierarchie zu generieren.

Top

Die Vorlagenhierarchie im Detail #Die Vorlagenhierarchie im Detail

Während die Vorlagenhierarchie als Diagramm leichter zu verstehen ist, beschreiben die folgenden Abschnitte die Reihenfolge, in der Vorlagendateien von WordPress für eine Reihe von Abfragetypen aufgerufen werden.

Top

Homepage anzeigen #Homepage anzeigen

Standardmäßig setzt WordPress die Startseite Ihrer Website so, dass Ihre neuesten Blog-Beiträge angezeigt werden. Diese Seite wird als Blog-Posts-Index bezeichnet. Sie können auch festlegen, dass Ihre Blog-Beiträge auf einer separaten statischen Seite angezeigt werden., Die Vorlagendatei home.php wird verwendet, um den Blog-Posts-Index zu rendern, unabhängig davon, ob er als Titelseite oder auf einer separaten statischen Seite verwendet wird. Wenn home.php nicht vorhanden ist, verwendet WordPress index.php.

1. home.php
2. index.php

Top

Front Page display #Front Page display

Die Vorlagendatei front-page.php dient zum Rendern der Titelseite Ihrer Website, unabhängig davon, ob auf der Titelseite der Blog-Posts-Index (oben erwähnt) oder eine statische Seite angezeigt wird. Die Titelseite Vorlage hat Vorrang vor der Blog-Beiträge Index (home.php) Vorlage. Wenn die Datei front-page.php nicht vorhanden ist, verwendet WordPress je nach Setup in Einstellungen → Lesen entweder die Dateien home.php oder page.php., Wenn keine dieser Dateien vorhanden ist, wird die index.php – Datei verwendet.

1. front-page.php – Wird sowohl für“ Ihre neuesten Beiträge „als auch für“ eine statische Seite „verwendet, wie im Abschnitt“ front page displays “ von Einstellungen → Lesen festgelegt.
2. home.php – Wenn WordPress front-page.php nicht finden kann und“ your latest posts“im Abschnitt“front page displays“ festgelegt ist, wird nach home.phpgesucht. Darüber hinaus wird WordPress nach dieser Datei suchen, wenn die Posts-Seite im Abschnitt front Page Displays festgelegt ist.,
3. page.php – Wenn“ front page “ im Abschnitt front page displays eingestellt ist.
4. index.php – Wenn“ Ihre neuesten Beiträge“im Abschnitt“front page displays“festgelegt ist, aber home.php nicht vorhanden ist oder wenn die Titelseite festgelegt ist, aber page.php nicht vorhanden ist.

Wie Sie sehen können, gibt es viele Regeln, welchen Pfad WordPress nimmt. Die Verwendung des obigen Diagramms ist der beste Weg, um zu bestimmen, was WordPress angezeigt wird.,

Top

Datenschutz Seite Anzeige #Datenschutz Seite Anzeige

Die privacy-policy.php Template-Datei wird verwendet, um die Datenschutz Seite Ihrer Website zu machen. Die Seitenvorlage für Datenschutzrichtlinien hat Vorrang vor der Vorlage für statische Seiten (page.php). Wenn die Datei privacy-policy.php nicht vorhanden ist, verwendet WordPress abhängig von den verfügbaren Vorlagen entweder die Dateien page.php oder singular.php. Wenn keine dieser Dateien vorhanden ist, wird die index.php – Datei verwendet.,

1. privacy-policy.php – Wird für die Seite Datenschutzerklärung verwendet, die im Abschnitt Datenschutzerklärung ändern unter Einstellungen → Datenschutz festgelegt ist.
2. custom template file – Die der Seite zugewiesene Seitenvorlage. Siehe get_page_templates().
3. page-{slug}.php – Wenn die Seitenschnecke privacy ist, wird WordPress versuchen, page-privacy.phpzu verwenden.
4. page-{id}.php – Wenn die Seiten-ID 6 ist, wird WordPress versuchen, page-6.phpzu verwenden.,
5. page.php
6. singular.php
7. index.php

Top

Einzelner Beitrag #Einzelner Beitrag

Die Vorlagendatei eines einzelnen Beitrags wird zum Rendern eines einzelnen Beitrags verwendet. WordPress verwendet den folgenden Pfad:

Top

Einzelne Seite #Einzelne Seite

Die Vorlagendatei zum Rendern einer statischen Seite (page post-type).,es, page ist speziell für WordPress und verwendet den folgenden Pfad:

Top

Category #Category

Rendering category archive index pages verwendet den folgenden Pfad in WordPress:

Top

Tag #Tag

Um eine Tag-Archiv-Indexseite anzuzeigen, verwendet WordPress den folgenden Pfad:

Top

Custom Taxonomies #Custom Taxonomien

Benutzerdefinierte Taxonomien verwenden einen etwas anderen Vorlagendateipfad:

Top

Benutzerdefinierte Beitragstypen #Benutzerdefinierte Beitragstypen

Benutzerdefinierte Beitragstypen Verwenden Sie den folgenden Pfad, um die entsprechende Archivindexseite zu rendern.,

1. archive-{post_type}.php – Wenn der Beitragstyp product ist, sucht WordPress nach archive-product.php.
2. archive.php
3. index.php

(Für rendering eine einzelne post typ vorlage, beziehen sich auf die einzelnen post display abschnitt oben.,s folgen Sie dem gleichen Muster wie andere Vorlagentypen:

1. search.php
2. index.php

Top

404 (nicht gefunden) #404 (nicht gefunden)

Ebenso werden 404 Vorlagendateien in dieser Reihenfolge aufgerufen:

1. 404.php
2. index.php

Top

Attachment #Attachment

Das Rendern einer Anhangsseite (attachment post-type) verwendet den folgenden Pfad:

Top

Bettet #Bettet

Die Einbettungsvorlagendatei wird verwendet, um einen Beitrag zu rendern, der eingebettet wird., Seit 4.5 verwendet WordPress den folgenden Pfad:

1. embed-{post-type}-{post_format}.php – Zunächst sucht WordPress nach einer Vorlage für den jeweiligen Beitrag. Wenn der Post-Typ beispielsweise post und das Audioformat hat, sucht WordPress nach embed-post-audio.php.
2. embed-{post-type}.php – Wenn der Beitragstyp product ist, würde WordPress nach suchen.
3. embed.php – WordPress greift dann auf embed zurück.php.,
4. Schließlich greift WordPress letztendlich auf seine eigenewp-includes/theme-compat/embed.php Vorlage zurück.

Top

Nicht-ASCII-Zeichenbehandlung #Nicht-ASCII-Zeichenbehandlung

Seit WordPress 4.7 unterstützt jeder dynamische Teil eines Vorlagennamens, der Nicht-ASCII-Zeichen in seinem Namen enthält, sowohl die nicht codierte als auch die codierte Form in dieser Reihenfolge. Sie können wählen, welche zu verwenden.,

Hier ist die Seitenvorlagenhierarchie für eine Seite mit dem Namen „Hello World 😀“ mit der ID 6:

• page-hello-world-😀.php
• page-hello-world-%f0%9f%98%80.php
• page-6.php
• page.php
• singular.php

Das gleiche Verhalten gilt für Post-Schnecken, Begriffsnamen und Autorennamen.

Top

Filterhierarchie #Filterhierarchie

Mit dem WordPress-Vorlagensystem können Sie die Hierarchie filtern., Dies bedeutet, dass Sie Dinge an bestimmten Punkten der Hierarchie einfügen und ändern können. Der Filter (befindet sich in der Funktion ) verwendet diesen Filternamen: "{$type}_template" wobei $type der Vorlagentyp ist.,category_template

Top

Example #Example

For example, let’s take the default author hierarchy:

• author-{nicename}.php
• author-{id}.php
• author.php

To add author-{role}.php before author.php, we can manipulate the actual hierarchy using the ‘author_template’ template type., Dies ermöglicht eine Anforderung für / author / username, bei der username die Rolle des Editors hat, der mit author-editor angezeigt werden soll.php, falls im aktuellen Themenverzeichnis vorhanden.