WordPress.org (Nederlands)
zoals besproken, zijn sjabloonbestanden modulaire, herbruikbare bestanden die worden gebruikt om de webpagina ‘ s op uw WordPress site te genereren. Sommige sjabloonbestanden (zoals de kop-en voettekstsjabloon) worden op alle pagina ‘ s van uw site gebruikt, terwijl andere alleen onder specifieke voorwaarden worden gebruikt.
Dit artikel legt uit hoe WordPress bepaalt welke template bestand (en) te gebruiken op individuele pagina ‘ s. Als u wilt een bestaande WordPress thema aan te passen zal het u helpen beslissen welke template bestand moet worden bewerkt.,
de sjabloon Bestandshiërarchie #de sjabloon Bestandshiërarchie
Overzicht #Overzicht
WordPress gebruikt de query string om te bepalen welke sjabloon of set sjablonen gebruikt moeten worden om de pagina weer te geven. De query string is informatie die is opgenomen in de link naar elk deel van uw website. Het komt na het eerste vraagteken en kan een aantal parameters gescheiden door ampersands bevatten.,
simpel gezegd, WordPress zoekt door de sjabloonhiërarchie totdat het een passend sjabloonbestand vindt. Om te bepalen welk sjabloonbestand gebruikt moet worden, koppelt WordPress:
- elke query string aan een query type om te bepalen welke pagina wordt gevraagd (bijvoorbeeld een zoekpagina, een categoriepagina, enz.);
- selecteert de sjabloon in de volgorde bepaald door de sjabloonhiërarchie;
- zoekt naar sjabloonbestanden met specifieke namen in de map van het huidige thema en gebruikt het eerste overeenkomende sjabloonbestand zoals gespecificeerd door de hiërarchie.,
met uitzondering van het basic index.php
template bestand, kunt u kiezen of u een bepaald template bestand wilt implementeren of niet.
als WordPress geen sjabloonbestand met een overeenkomende naam kan vinden, gaat het naar het volgende bestand in de hiërarchie. Als WordPress geen passend sjabloonbestand kan vinden, wordt het index.php
– bestand van het thema gebruikt.,
Top
voorbeelden # voorbeelden
als uw blog zich op bevindt en een bezoeker klikt op een link naar een categoriepagina zoals
, zoekt WordPress naar een sjabloonbestand in de map van het huidige thema dat overeenkomt met de ID van de categorie om de juiste pagina te genereren. Meer specifiek volgt WordPress deze procedure:
- zoekt naar een sjabloonbestand in de map van het huidige thema dat overeenkomt met de slug van de categorie. Als de categorie slug “unicorns” is, dan zoekt WordPress naar een sjabloonbestand met de naam
category-unicorns.php
., - als
category-unicorns.php
ontbreekt en de ID van de categorie 4 is, zoekt WordPress naar een sjabloonbestand met de naamcategory-4.php
. - als
category-4.php
ontbreekt, zal WordPress zoeken naar een generiek categorie template bestand,category.php
. - als
category.php
niet bestaat, zal WordPress zoeken naar een generiek archiefsjabloon,archive.php
. - als
archive.php
ook ontbreekt, zal WordPress terugvallen op het hoofdthema template bestand,index.php
.,
Top
visueel overzicht #visueel overzicht
het volgende diagram laat zien welke templatebestanden worden aangeroepen om een WordPress-pagina te genereren op basis van de WordPress template-hiërarchie.
Top
de Sjabloonhiërarchie in Detail #de Sjabloonhiërarchie in Detail
hoewel de sjabloonhiërarchie gemakkelijker te begrijpen is als een diagram, beschrijven de volgende secties de volgorde waarin sjabloonbestanden door WordPress worden aangeroepen voor een aantal query-typen.
Top
homepage display #homepage display
standaard stelt WordPress de homepage van uw site in om uw laatste blogberichten weer te geven. Deze pagina heet de blog posts index. U kunt ook uw blog posts om weer te geven op een aparte statische pagina., Het template bestand home.php
wordt gebruikt om de blog posts index weer te geven, of het nu wordt gebruikt als de voorpagina of op een aparte statische pagina. Als home.php
niet bestaat, zal WordPress index.php
gebruiken.
home.php
index.php
Opmerking: Als front-page.php
bestaat, zal het de home.php
overschrijven.,
Top
Front page display # Front Page display
hetfront-page.php
template bestand wordt gebruikt om de voorpagina van uw site weer te geven, of de voorpagina de blog posts index (hierboven genoemd) of een statische pagina weergeeft. De voorpagina sjabloon heeft voorrang op de blog posts index (home.php
) sjabloon. Als hetfront-page.php
bestand niet bestaat, zal WordPress ofwel dehome.php
ofpage.php
bestanden gebruiken, afhankelijk van de instellingen in Instellingen → lezen., Als geen van deze bestanden bestaat, zal het index.php
bestand gebruiken.
-
front-page.php
– gebruikt voor zowel” uw laatste berichten “of” een statische pagina ” zoals ingesteld in de front page displays sectie van instellingen → lezen. -
home.php
– als WordPressfront-page.php
niet kan vinden en” your latest posts”is ingesteld in de front page displays sectie, zal het zoeken naarhome.php
. Daarnaast zal WordPress op zoek naar dit bestand wanneer de berichten pagina is ingesteld in de voorpagina displays sectie., -
page.php
– wanneer” front page ” is ingesteld in de sectie front page displays. -
index.php
– wanneer” uw laatste berichten”is ingesteld in de sectie front page displays maarhome.php
bestaat niet of wanneer front page is ingesteld maarpage.php
bestaat niet.
zoals u kunt zien, zijn er veel regels voor het pad dat WordPress neemt. Met behulp van de bovenstaande grafiek is de beste manier om te bepalen wat WordPress wordt weergegeven.,
Top
Privacybeleid paginaweergave # Privacybeleid paginaweergave
het privacy-policy.php
templatebestand wordt gebruikt om de pagina over het Privacybeleid van uw site weer te geven. Het Privacybeleid paginasjabloon heeft voorrang op het statische paginasjabloon (page.php
). Als hetprivacy-policy.php
bestand niet bestaat, zal WordPress depage.php
ofsingular.php
bestanden gebruiken, afhankelijk van de beschikbare sjablonen. Als geen van deze bestanden bestaat, zal het index.php
bestand gebruiken.,
-
privacy-policy.php
– wordt gebruikt voor de pagina Privacybeleid ingesteld in de pagina uw Privacybeleid wijzigen sectie Van Instellingen → Privacy. -
custom template file
– het paginasjabloon dat aan de pagina is toegewezen. Zieget_page_templates()
. -
page-{slug}.php
– als de pagina slugprivacy
is, zal WordPresspage-privacy.php
gebruiken. -
page-{id}.php
– als de pagina-ID 6 is, zal WordPresspage-6.php
gebruiken., page.php
singular.php
-
index.php
Top
Single Post #Single Post
Het single post template bestand wordt gebruikt om een enkele post weer te geven. WordPress gebruikt het volgende pad:
Top
enkele pagina #Enkele pagina
het sjabloonbestand dat wordt gebruikt om een statische pagina weer te geven (page
post-type).,es, page
is speciaal voor WordPress en wordt het volgende pad:
Top
Category #Categorie
Rendering categorie archief index pagina ‘ s wordt het volgende pad in WordPress:
Top
Tag #Tag
Om een tag archief index pagina, WordPress maakt gebruik van de volgende pad:
Top
Custom Taxonomies #Custom Taxonomies
Custom taxonomies gebruik een iets andere template file path:
Top
Custom Post Types #Custom Post Types
Custom Post Types gebruik het volgende pad voor het maken van de juiste archief index pagina.,
-
archive-{post_type}.php
– als het posttypeproduct
is, zal WordPress zoeken naararchive-product.php
. archive.php
index.php
(Voor het weergeven van een single post type template, refereer je naar de single post display sectie hierboven.,s volgen hetzelfde patroon als andere sjabloon typen:
search.php
index.php
Top
404 (Niet Gevonden) #404 (Niet Gevonden)
Ook, 404 template bestanden worden genoemd in deze volgorde:
404.php
index.php
Top
Attachment #Attachment
het Renderen van een bijlage pagina (‘attachment
post-type) wordt het volgende pad:
Top
Sluit #Sluit
De embed-template-bestand wordt gebruikt voor het weergeven van een post die is ingesloten., Sinds 4.5 gebruikt WordPress het volgende pad:
-
embed-{post-type}-{post_format}.php
– eerst zoekt WordPress naar een sjabloon voor de specifieke post. Bijvoorbeeld, als het posttypepost
is en het heeft het audioformaat, zou WordPress zoeken naarembed-post-audio.php
. -
embed-{post-type}.php
– als het posttypeproduct
is, zou WordPress zoeken naarembed-product.php
. -
embed.php
– WordPress valt dan terug naar embed.php
., - uiteindelijk valt WordPress terug op zijn eigen
wp-includes/theme-compat/embed.php
template.
Top
non-ASCII Character Handling # Non-ASCII Character Handling
sinds WordPress 4.7 ondersteunt elk dynamisch deel van een sjabloonnaam dat niet-ASCII-tekens in zijn naam bevat, in die volgorde zowel de niet-gecodeerde als de gecodeerde vorm. U kunt kiezen welke te gebruiken.,
Hier is het sjabloon voor de pagina hiërarchie voor een pagina met de naam “Hello World 😀” met een ID 6
:
page-hello-world-😀.php
page-hello-world-%f0%9f%98%80.php
page-6.php
page.php
singular.php
hetzelfde gedrag is van toepassing op post slakken, term namen, en auteur nicenames.
Top
Filterhiërarchie # Filterhiërarchie
met het WordPress template systeem kunt u de hiërarchie filteren., Dit betekent dat je dingen kunt invoegen en wijzigen op specifieke punten van de hiërarchie. Het filter (bevindt zich in de functie get_query_template()
) gebruikt deze Filternaam: "{$type}_template"
waarbij $type
het template type is.,category_template
tag_template
author_template
date_template
archive_template
index_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., Dit staat een verzoek toe voor/author / username waarbij gebruikersnaam de rol van editor heeft om te tonen met behulp van author-editor.php indien aanwezig in de huidige thema ‘ s directory.