WordPress.org (Deutsch)

Seitenvorlagen sind eine bestimmte Art von Vorlagendatei, die auf eine bestimmte Seite oder Seitengruppen angewendet werden kann.

Da es sich bei einer Seitenvorlage um einen bestimmten Typ von Vorlagendatei handelt, sind hier einige Unterscheidungsmerkmale von Seitenvorlagen aufgeführt:

• Seitenvorlagen werden verwendet, um das Erscheinungsbild einer Seite zu ändern.
• Eine Seitenvorlage kann auf eine einzelne Seite, einen Seitenabschnitt oder eine Seitenklasse angewendet werden
• Seitenvorlagen weisen im Allgemeinen ein hohes Maß an Spezifität auf und zielen auf eine einzelne Seite oder eine Gruppe von Seiten ab. Beispielsweise ist eine Seitenvorlage mit dem Namen page-about.php spezifischer als die Vorlagendateien page.php oder index.php da dies nur eine Seite mit dem Slug „about“ betrifft.
• Wenn eine Seitenvorlage einen Vorlagennamen hat, haben WordPress-Benutzer, die die Seite bearbeiten, die Kontrolle darüber, welche Vorlage zum Rendern der Seite verwendet wird.

Verwendung für Seitenvorlagen #Verwendung für Seitenvorlagen

Seitenvorlagen zeigen den dynamischen Inhalt Ihrer Website auf einer Seite an, z. B. Beiträge, Nachrichtenaktualisierungen, Kalenderereignisse, Mediendateien usw. Sie können festlegen, dass Ihre Homepage auf eine bestimmte Art und Weise aussehen soll, die sich deutlich von anderen Teilen Ihrer Website unterscheidet. Oder Sie möchten möglicherweise ein Bild anzeigen, das auf einen Beitrag auf einem Teil der Seite verweist. Sie haben eine Liste der neuesten Beiträge an anderer Stelle und verwenden eine benutzerdefinierte Navigation. Sie können Seitenvorlagen verwenden, um diese Ziele zu erreichen.

In diesem Abschnitt erfahren Sie, wie Sie Seitenvorlagen erstellen, die von Ihren Benutzern über ihre ausgewählt werden können Administratorbildschirme.

Sie können beispielsweise Seitenvorlagen erstellen für:

• einspaltige
• zweispaltige Seite mit voller Breite und Seitenleiste rechts
• zweispaltig mit einer Seitenleiste links
• dreispaltig

Oben

Seitenvorlagen innerhalb der Vorlagenhierarchie #Seitenvorlagen innerhalb der Vorlagenhierarchie

Wenn eine Person zu Ihrer Website navigiert, wählt WordPress die Vorlage aus, die zum Rendern dieser Seite verwendet werden soll. Wie wir bereits in der Vorlagenhierarchie erfahren haben, sucht WordPress in der folgenden Reihenfolge nach Vorlagendateien:

1. Seitenvorlage – Wenn der Seite eine benutzerdefinierte Vorlage zugewiesen ist, sucht WordPress nach dieser Datei und, falls gefunden , verwendet es.
2. page-{slug}.php – Wenn keine benutzerdefinierte Vorlage zugewiesen wurde, sucht und verwendet WordPress eine spezielle Vorlage, die den Slug der Seite enthält.
3. page-{id}.php – Wenn eine spezielle Vorlage mit dem Slug der Seite nicht gefunden wird, sucht und verwendet WordPress eine spezielle Vorlage mit der ID der Seite.
4. page.php – Wenn eine spezielle Vorlage mit der Seiten-ID nicht gefunden wird, sucht und verwendet WordPress die Standardseitenvorlage des Themas.
5. singular.php – Wenn page.php nicht gefunden wird, sucht und verwendet WordPress die Vorlage des Themas, die für einen einzelnen Beitrag verwendet wird, unabhängig vom Beitragstyp.
6. index.php – Wenn nicht spezifisch Wenn Seitenvorlagen zugewiesen oder gefunden werden, verwendet WordPress standardmäßig die Indexdatei des Themas zum Rendern von Seiten.

Top

Seitenvorlagen Zweck & Benutzersteuerung # Seitenvorlagen Zweck & Benutzersteuerung

Wenn Sie eine benutzerdefinierte Seitenvorlage für Ihr Thema erstellen möchten, sollten Sie einige Dinge entscheiden bevor Sie fortfahren:

• Gibt an, ob die Seitenvorlage für eine bestimmte Seite oder für eine beliebige Seite bestimmt ist. und
• Welche Art von Benutzersteuerung für die Vorlage verfügbar sein soll.

Jede Seitenvorlage mit einem Vorlagennamen kann von einem Benutzer beim Erstellen oder Bearbeiten ausgewählt werden eine Seite. Die Liste der verfügbaren Vorlagen finden Sie unter Seiten > Neue > Attribute > Vorlage . Daher kann ein WordPress-Benutzer eine beliebige Seitenvorlage mit einem Vorlagennamen auswählen, was möglicherweise nicht Ihre Absicht ist.

Wenn Sie beispielsweise eine bestimmte Vorlage für Ihre „Info“ -Seite haben möchten, ist dies möglicherweise nicht der Fall Benennen Sie diese Seitenvorlage „Über Vorlage“, da sie für alle Seiten global verfügbar ist (dh der Benutzer kann sie auf jede Seite anwenden). Erstellen Sie stattdessen eine Vorlage für den einmaligen Gebrauch, und WordPress rendert die Seite mit der entsprechenden Vorlage, wenn ein Benutzer die Seite „Info“ besucht.

Umgekehrt bieten viele Themen die Möglichkeit, die Anzahl der Spalten einer Seite auszuwählen Jede dieser Optionen ist eine Seitenvorlage, die global verfügbar ist.Um Ihren WordPress-Benutzern diese globale Option zu geben, müssen Sie für jede Option Seitenvorlagen erstellen und jeder einen Vorlagennamen geben.

Es wird übrigens festgelegt, ob eine Vorlage für die globale Verwendung oder für die einmalige Verwendung bestimmt ist Die Datei hat einen Namen und einen bestimmten Kommentar.

Top

Dateiorganisation von Seitenvorlagen #Dateiorganisation von Seitenvorlagen

Wie unter Organisieren von Themendateien erläutert, erkennt WordPress die Seitenvorlagen des Unterordners. Daher ist es eine gute Idee, Ihre globalen Seitenvorlagen in diesem Ordner zu speichern, um sie besser organisieren zu können.

Oben

Erstellen benutzerdefinierter Seitenvorlagen für den globalen Gebrauch #Erstellen benutzerdefinierter Seitenvorlagen für den globalen Gebrauch

Manchmal möchten Sie eine Vorlage, die von jeder Seite oder von mehreren Seiten global verwendet werden kann. Einige Entwickler gruppieren ihre Vorlagen mit einem Dateinamenpräfix, z. B. page_two-columns.php

Informationen zu Namenskonventionen und Dateinamen für Themendateien, die Sie nicht verwenden können, finden Sie unter reservierte Dateinamen für Themen.

Um eine globale Vorlage zu erstellen, schreiben Sie einen öffnenden PHP-Kommentar oben auf Die Datei, in der der Name der Vorlage angegeben ist.

<?php /* Template Name: Example Template */ ?>

Dies ist eine gute Idee Wählen Sie einen Namen, der beschreibt, was die Vorlage tut, da der Name für WordPress-Benutzer sichtbar ist, wenn sie die Seite bearbeiten. Sie können beispielsweise Ihre Vorlage Homepage, Blog oder Portfolio benennen.

In diesem Beispiel aus dem TwentyFourteen-Thema wird eine Seitenvorlage mit dem Namen „Full Width Page“ erstellt:

<?php/*** Template Name: Full Width Page** @package WordPress* @subpackage Twenty_Fourteen* @since Twenty Fourteen 1.0*/

Sobald Sie die Datei in den Ordner Ihres Themas hochgeladen haben (z. Vorlagen), gehen Sie zum Bildschirm Seite > Bearbeiten in Ihrem Admin-Dashboard.

On the right hand side under attributes you"ll see template. This is where users are able to access your global page templates.

Tip: The select list has a maximum width of 250px, so longer names may be cut off.

Oben

Erstellen einer benutzerdefinierten Seitenvorlage für eine bestimmte Seite #Erstellen einer benutzerdefinierten Seitenvorlage für eine bestimmte Seite

Wie auf der Seite Vorlagenhierarchie erwähnt, können Sie eine Vorlage für eine bestimmte Seite erstellen. Um eine Vorlage für eine bestimmte Seite zu erstellen, kopieren Sie Ihre vorhandene page.php -Datei und benennen Sie sie mit dem Slug oder der ID Ihrer Seite um:

1. page-{slug}.php
2. page-{ID}.php

Beispiel: Ihre About-Seite enthält einen Slug von about. und eine ID von 6. Wenn der Ordner Ihres aktiven Themas eine Datei mit dem Namen page-about.php oder page-6.php enthält, findet und verwendet WordPress diese Datei automatisch

Um verwendet zu werden, müssen sich spezielle Seitenvorlagen im Ordner Ihres Themas befinden (z. B. / wp-content / theme / my-theme-name /).

Oben

Seitenvorlagen für bestimmte Beitragstypen erstellen # Seitenvorlagen für bestimmte Beitragstypen erstellen

Standardmäßig ist eine benutzerdefinierte Seitenvorlage für den Beitragstyp „Seite“ verfügbar.

Um eine Seitenvorlage für bestimmte Beitragstypen zu erstellen, fügen Sie unter dem Vorlagennamen eine Zeile mit den Beitragstypen hinzu, die die Vorlage unterstützen soll.

Beispiel:

<?php/*Template Name: Full-width layoutTemplate Post Type: post, page, event*/// Page code here...

Wenn für einen Post-Typ mindestens eine Vorlage vorhanden ist, wird das Meta-Feld „Post-Attribute“ im Back-End angezeigt. ohne dass Post-Type-Unterstützung für Seitenattribute oder irgendetwas anderes hinzugefügt werden muss. Das Label „Post-Attribute“ kann bei der Registrierung eines Post-Typs mithilfe des Labels „Attribute“ pro Post-Typ angepasst werden.

Abwärtskompatibilität:

Angenommen, Sie möchten ein Thema öffentlich veröffentlichen mit Unterstützung für Post-Type-Vorlagen. WordPress-Versionen vor 4.7 ignorieren den Header „Template Post Type“ und zeigen die Vorlage in der Liste der Seitenvorlagen an, obwohl dies nur für reguläre Posts funktioniert.Um dies zu verhindern, können Sie sich in den Filter theme_page_templates einbinden, um ihn von der Liste auszuschließen. Hier ein Beispiel:

Vollständigen Quellcode erweiternKollaps des vollständigen Quellcodes

Auf diese Weise können Sie benutzerdefinierte Beiträge unterstützen Geben Sie Vorlagen in WordPress 4.7 und höher ein, während Sie die vollständige Abwärtskompatibilität beibehalten.

Beachten Sie, dass theme_page_templates tatsächlich ein dynamischer Filter für das Thema _ {$ post_type} _templates ist. Der dynamische Teil des Hook-Namens $ post_type bezieht sich auf den von den Vorlagen unterstützten Beitragstyp. Z.B. Sie können sich in theme_product_templates einbinden, um die Liste der Vorlagen für den Produktposttyp zu filtern.

Top

Verwenden von bedingten Tags in Seitenvorlagen #Verwenden von bedingten Tags in Seitenvorlagen

Sie können kleinere, seitenspezifische Änderungen mit bedingten Tags in der Datei page.php Ihres Themas vornehmen. Der folgende Beispielcode lädt beispielsweise die Datei header-home.php für Ihre Startseite, lädt jedoch eine andere Datei (header-about.php) für Ihre Info-Seite. und wendet dann die Standardeinstellung header.php für alle anderen Seiten an.

if ( is_front_page() ) :get_header( "home" );elseif ( is_page( "About" ) ) :get_header( "about" );else:get_header();endif;

Weitere Informationen zu bedingten Tags finden Sie hier.

Oben

Identifizieren einer Seitenvorlage # Identifizieren einer Seitenvorlage

Wenn Ihre Vorlage verwendet die Funktion body_class(). WordPress druckt Klassen im Tag body für den Klassennamen des Posttyps (page), die Seiten-ID (page-id-{ID}) und die verwendete Seitenvorlage. Für die Standardeinstellung page.php lautet der generierte Klassenname page-template-default:

<body class="page page-id-6 page-template-default">

Bei Verwendung einer benutzerdefinierten Seitenvorlage wird die Klasse page-template verwendet Drucken, zusammen mit einer Klasse, die die spezifische Vorlage benennt. Wenn Ihre benutzerdefinierte Seitenvorlagendatei beispielsweise wie folgt benannt ist:

<?php/* Template Name: My Custom Page */?gt;

Dann wird gerendertes HTML wie folgt generiert:

<body class="page page-id-6 page-template page-template-my-custom-page-php">

Beachten Sie die page-template-my-custom-page-php -Klasse, die auf das body -Tag angewendet wird.

Top

Seitenvorlagenfunktionen # Seitenvorlagenfunktionen

Diese integrierten WordPress-Funktionen und -Methoden können Ihnen beim Arbeiten mit Seitenvorlagen helfen:

• get_page_template() gibt zurück Der Pfad der Seitenvorlage, die zum Rendern der Seite verwendet wird.
• wp_get_theme()->get_page_templates() gibt alle benutzerdefinierten Seitenvorlagen zurück, die für das aktuell aktive Thema verfügbar sind ( ist eine Methode der Klasse WP_Theme.
• is_page_template() gibt abhängig davon true oder false zurück ob eine benutzerdefinierte Seitenvorlage zum Rendern der Seite verwendet wurde.
• get_page_template_slug() r Gibt den Wert des benutzerdefinierten Felds _wp_page_template zurück (null, wenn der Wert leer oder „Standard“ ist). Wenn einer Seite eine benutzerdefinierte zugewiesen wurde Vorlage, der Dateiname dieser Vorlage wird als Wert eines benutzerdefinierten Felds mit dem Namen "_wp_page_template" (in der Datenbanktabelle wp_postmeta) gespeichert. (Benutzerdefinierte Felder, die mit einem Unterstrich beginnen, werden im Modul für benutzerdefinierte Felder des Bearbeitungsbildschirms nicht angezeigt.)