WordPress.org

Paginasjablonen zijn een specifiek type sjabloonbestand dat kan worden toegepast op een specifieke pagina of groepen paginas.

Aangezien een paginasjabloon een specifiek type sjabloonbestand is, zijn hier enkele onderscheidende kenmerken van paginasjablonen:

• Paginasjablonen worden gebruikt om het uiterlijk van een pagina te veranderen.
• Een paginasjabloon kan worden toegepast op een enkele pagina, een paginasectie of een paginaklasse .
• Paginasjablonen hebben over het algemeen een hoge mate van specificiteit en zijn gericht op een individuele pagina of een groep paginas. Een paginasjabloon met de naam page-about.php is bijvoorbeeld specifieker dan de sjabloonbestanden page.php of index.php aangezien het alleen een pagina met de slug “ongeveer” beïnvloedt.
• Als een paginasjabloon een sjabloonnaam heeft, hebben WordPress-gebruikers die de pagina bewerken, controle over welke sjabloon zal worden gebruikt om de pagina weer te geven.

Gebruikt voor paginasjablonen #Gebruik voor paginasjablonen

Paginasjablonen geven de dynamische inhoud van uw site weer op een pagina, bijv. berichten, nieuwsupdates, agenda-evenementen, mediabestanden , enz. U kunt besluiten dat u wilt dat uw startpagina er op een specifieke manier uitziet, die nogal verschilt van andere delen van uw site. Of u wilt misschien een uitgelichte afbeelding weergeven met een link naar een bericht op een deel van de pagina, een lijst met de nieuwste berichten ergens anders hebben en een aangepaste navigatie gebruiken. U kunt paginasjablonen gebruiken om deze dingen te bereiken.

In dit gedeelte ziet u hoe u paginasjablonen kunt maken die door uw gebruikers kunnen worden geselecteerd via hun admin-schermen.

U kunt bijvoorbeeld paginasjablonen maken voor:

• volledige breedte, één kolom
• twee kolommen met een zijbalk aan de rechterkant
• twee kolommen met een zijbalk aan de linkerkant
• drie kolommen

Boven

Paginasjablonen binnen de sjabloonhiërarchie #Page-sjablonen binnen de sjabloonhiërarchie

Wanneer een persoon naar uw website bladert, selecteert WordPress welk sjabloon moet worden gebruikt voor het weergeven van die pagina. Zoals we eerder in de sjabloonhiërarchie hebben geleerd, zoekt WordPress naar sjabloonbestanden in de volgende volgorde:

1. Paginasjabloon – Als de pagina een aangepaste sjabloon heeft toegewezen, zoekt WordPress naar dat bestand en, indien gevonden , gebruikt het.
2. page-{slug}.php – Als er geen aangepaste sjabloon is toegewezen, zoekt WordPress naar en gebruikt deze een gespecialiseerde sjabloon die de slug van de pagina bevat.
3. page-{id}.php – Als er geen gespecialiseerde sjabloon wordt gevonden die de slug van de pagina bevat, zoekt en gebruikt WordPress een gespecialiseerde sjabloon met de naam van de pagina-ID.
4. page.php – Als een gespecialiseerde sjabloon die de pagina-ID bevat niet wordt gevonden, zoekt en gebruikt WordPress de standaardpaginasjabloon van het thema.
5. singular.php – Als page.php niet wordt gevonden, zoekt en gebruikt WordPress de sjabloon van het thema dat voor één bericht wordt gebruikt, ongeacht het berichttype.
6. index.php – Indien niet specifiek paginasjablonen worden toegewezen of gevonden, WordPress gebruikt standaard het indexbestand van het thema om paginas weer te geven.

Top

Paginasjablonen Doel & Gebruikersbeheer #Paginasjablonen Doel & Gebruikersbeheer

Als u van plan bent om een aangepaste paginasjabloon voor uw thema te maken, moet u een aantal dingen beslissen voordat u verder gaat:

• Of de paginasjabloon voor één specifieke pagina of voor een pagina is; en
• Welk type gebruikerscontrole u beschikbaar wilt hebben voor de sjabloon.

Elke paginasjabloon met een sjabloonnaam kan door een gebruiker worden geselecteerd bij het maken of bewerken een pagina. De lijst met beschikbare sjablonen is te vinden op Paginas > Nieuwe > Kenmerken > Sjabloon toevoegen . Daarom kan een WordPress-gebruiker elke paginasjabloon kiezen met een sjabloonnaam, wat misschien niet uw bedoeling is.

Als u bijvoorbeeld een specifieke sjabloon wilt hebben voor uw “Over” -pagina, is dit misschien niet uw bedoeling. geschikt zijn om dat paginasjabloon “Over sjabloon” te noemen, aangezien het wereldwijd beschikbaar zou zijn voor alle paginas (dwz de gebruiker zou het op elke pagina kunnen toepassen). Maak in plaats daarvan een sjabloon voor eenmalig gebruik en WordPress geeft de pagina weer met de juiste sjabloon wanneer een gebruiker de “Over” -pagina bezoekt.

Omgekeerd omvatten veel themas de mogelijkheid om te kiezen hoeveel kolommen een pagina zal weergeven Elk van deze opties is een paginasjabloon die wereldwijd beschikbaar is.Om uw WordPress-gebruikers deze algemene optie te geven, moet u voor elke optie paginasjablonen maken en ze een sjabloonnaam geven.

Overigens wordt bepaald of een sjabloon voor algemeen gebruik of voor enkelvoudig gebruik is bedoeld. het bestand heeft een naam en of het al dan niet een specifieke opmerking heeft.

Top

Bestandsorganisatie van paginasjablonen # Bestandsorganisatie van paginasjablonen

Zoals besproken in Themabestanden organiseren, herkent WordPress de submap paginasjablonen. Daarom is het een goed idee om uw algemene paginasjablonen in deze map op te slaan om ze overzichtelijk te houden.

Boven

Aangepaste paginasjablonen maken voor wereldwijd gebruik #Creating Custom Page Templates voor wereldwijd gebruik

Soms wilt u een sjabloon die wereldwijd door elke pagina of door meerdere paginas kan worden gebruikt. Sommige ontwikkelaars groeperen hun sjablonen met een voorvoegsel voor de bestandsnaam, zoals page_two-columns.php

Voor informatie over naamgevingsconventies voor themabestanden en bestandsnamen die u niet kunt gebruiken, zie gereserveerde themabestandsnamen.

Om een globale sjabloon te maken, schrijft u een PHP-openingscommentaar bovenaan het bestand met de naam van de sjabloon.

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

Het is een goed idee om kies een naam die beschrijft wat de sjabloon doet, aangezien de naam zichtbaar is voor WordPress-gebruikers wanneer ze de pagina bewerken. U kunt uw sjabloon bijvoorbeeld Homepage, Blog of Portfolio noemen.

In dit voorbeeld uit het TwentyFourteen-thema wordt een paginasjabloon gemaakt met de naam Pagina met volledige breedte:

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

Zodra u het bestand uploadt naar de map van uw thema (bijv. pagina- sjablonen), ga naar het pagina > bewerkingsscherm in uw beheerdersdashboard.

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.

Boven

Een aangepaste paginasjabloon maken voor een specifieke pagina # Een aangepaste paginasjabloon maken voor een specifieke pagina

Zoals vermeld op de pagina Sjabloonhiërarchie, kunt u een sjabloon voor een specifieke pagina maken. Om een sjabloon voor een specifieke pagina te maken, kopieert u uw bestaande page.php -bestand en hernoemt u het met de slug of ID van uw pagina:

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

Bijvoorbeeld: uw Over-pagina bevat een stukje ongeveer en een ID van 6. Als de map van je actieve thema een bestand heeft met de naam page-about.php of page-6.php, dan zal WordPress dat bestand automatisch zoeken en gebruiken om de About-pagina weer te geven.

Om te worden gebruikt, moeten gespecialiseerde paginasjablonen in de map van uw thema staan (dwz / wp-content / themes / my-theme-name /).

Top

Paginasjablonen maken voor specifieke berichttypen #Paginasjablonen maken voor specifieke berichttypen

Standaard is een aangepaste paginasjabloon beschikbaar voor het berichttype “pagina”.

Om een paginasjabloon voor specifieke berichttypen te maken, voegt u een regel toe onder de sjabloonnaam met de berichttypen die u door de sjabloon wilt laten ondersteunen.

Voorbeeld:

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

Wanneer er ten minste één sjabloon bestaat voor een berichttype, wordt de metabox Postattributen weergegeven in het backend, zonder de noodzaak om posttype-ondersteuning toe te voegen voor page-attributes of iets anders. Het label Postattributen kan per posttype worden aangepast met behulp van het label attributen bij het registreren van een posttype.

Achterwaartse compatibiliteit:

Stel dat u een thema openbaar wilt uitbrengen met ondersteuning voor posttypetemplates. WordPress-versies ouder dan 4.7 negeren de koptekst van het sjabloonposttype en tonen de sjabloon in de lijst met paginasjablonen, ook al werkt het alleen voor reguliere berichten.Om dat te voorkomen, kunt u het filter theme_page_templates gebruiken om het van de lijst uit te sluiten. Hier is een voorbeeld:

Volledige broncode uitvouwen Volledige broncode samenvouwen

Op die manier kun je aangepast bericht ondersteunen typ sjablonen in WordPress 4.7 en hoger met behoud van volledige achterwaartse compatibiliteit.

Merk op dat theme_page_templates eigenlijk een dynamisch thema is _ {$ post_type} _templates filter. Het dynamische gedeelte van de haaknaam, $ post_type, verwijst naar het berichttype dat door de sjablonen wordt ondersteund. Bijv. u kunt inhaken op theme_product_templates om de lijst met sjablonen voor het productposttype te filteren.

Top

Voorwaardelijke tags gebruiken in paginasjablonen # Voorwaardelijke tags gebruiken in paginasjablonen

U kunt kleinere, paginaspecifieke wijzigingen aanbrengen met Conditional Tags in het page.php -bestand van uw thema. De onderstaande voorbeeldcode laadt bijvoorbeeld het bestand header-home.php voor uw voorpagina, maar laadt een ander bestand (header-about.php) voor uw Over-pagina, en past vervolgens de standaard header.php toe op alle andere paginas.

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

U kunt hier meer leren over voorwaardelijke tags.

Boven

Een paginasjabloon identificeren #Identificeren van een paginasjabloon

Als je sjabloon gebruikt de functie body_class(), WordPress drukt klassen af in de body -tag voor het posttype klassenaam (page), de pagina-ID (page-id-{ID}) en de gebruikte paginasjabloon. Voor de standaard page.php is de gegenereerde klassenaam page-template-default:

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

Wanneer u een aangepaste paginasjabloon gebruikt, zal de klasse page-template print, samen met een klasse die de specifieke sjabloon een naam geeft. Als uw aangepaste paginasjabloonbestand bijvoorbeeld de volgende naam heeft:

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

De gegenereerde gegenereerde HTML zal er dan als volgt uitzien:

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

Let op page-template-my-custom-page-php klasse die wordt toegepast op de body -tag.

Bovenkant

Paginasjabloonfuncties #Page Template Functions

Deze ingebouwde WordPress-functies en -methoden kunnen u helpen bij het werken met paginasjablonen:

• get_page_template() retourneert het pad van de paginasjabloon die is gebruikt om de pagina weer te geven.
• wp_get_theme()->get_page_templates() retourneert alle aangepaste paginasjablonen die beschikbaar zijn voor het momenteel actieve thema (get_page_templates() is een methode van de WP_Theme klasse).
• is_page_template() retourneert waar of onwaar, afhankelijk van of een aangepaste paginasjabloon is gebruikt om de pagina weer te geven.
• get_page_template_slug() r retourneert de waarde van het aangepaste veld _wp_page_template (null wanneer de waarde leeg of “standaard” is). Als aan een pagina een aangepaste sjabloon, wordt de bestandsnaam van die sjabloon opgeslagen als de waarde van een aangepast veld met de naam "_wp_page_template" (in de wp_postmeta databasetabel). (Aangepaste velden die beginnen met een onderstrepingsteken worden niet weergegeven in de aangepaste veldenmodule van het bewerkingsscherm.)