WordPress.org (Svenska)
som diskuterats är mallfiler modulära, återanvändbara filer, som används för att generera webbsidor på din WordPress-webbplats. Vissa mallfiler (t.ex. mall för sidhuvud och sidfot) används på alla webbplatsens sidor, medan andra endast används under specifika förhållanden.
den här artikeln förklarar hur WordPress bestämmer vilken mallfil(er) som ska användas på enskilda sidor. Om du vill anpassa ett befintligt WordPress-tema hjälper det dig att bestämma vilken mallfil som behöver redigeras.,
hierarkin för mallfil #hierarkin för mallfil
översikt #översikt
WordPress använder frågesträngen för att bestämma vilken mall eller uppsättning mallar som ska användas för att visa sidan. Frågesträngen är information som finns i länken till varje del av din webbplats. Det kommer efter det ursprungliga frågetecknet och kan innehålla ett antal parametrar åtskilda av ampersands.,
enkelt uttryckt söker WordPress ner genom mallhierarkin tills den hittar en matchande mallfil. För att bestämma vilken mallfil som ska användas matchar WordPress:
- varje frågesträng till en frågetyp för att bestämma vilken sida som begärs (till exempel en söksida, en kategorisida etc.);
- väljer mallen i den ordning som bestäms av mallhierarkin;
- Letar efter mallfiler med specifika namn i det aktuella temaets katalog och använder den första matchande mallfilen enligt hierarkin.,
med undantag för den grundläggandeindex.php
mallfilen kan du välja om du vill implementera en viss mallfil eller inte.
Om WordPress inte kan hitta en mallfil med ett matchande namn, kommer den att hoppa till nästa fil i hierarkin. Om WordPress inte kan hitta någon matchande mallfil används tematsindex.php
– fil.,
topp
Exempel #Exempel
om din blogg är på och en besökare klickar på en länk till en kategori sida som
, WordPress letar efter en mallfil i det aktuella temaets katalog som matchar kategoriens ID för att generera rätt sida. Mer specifikt följer WordPress denna procedur:
- Letar efter en mallfil i det aktuella temaets katalog som matchar kategorins slug. Om kategorin slug är ”unicorns” söker WordPress efter en mallfil som heter
category-unicorns.php
., - Om
category-unicorns.php
saknas och kategoriens ID är 4, Letar WordPress efter en mallfil som hetercategory-4.php
. - Om
category-4.php
saknas kommer WordPress att leta efter en generisk kategorimallfil,category.php
. - Om
category.php
inte finns, kommer WordPress att leta efter en generisk arkivmall,archive.php
. - Om
archive.php
också saknas, kommer WordPress att falla tillbaka till huvudmallfilen,index.php
.,
topp
visuell översikt #visuell översikt
Följande diagram visar vilka mallfiler som kallas för att generera en WordPress-sida baserat på WordPress-mallhierarkin.
topp
Mallhierarkin i detalj #Mallhierarkin i detalj
medan mallhierarkin är lättare att förstå som ett diagram beskriver följande avsnitt den ordning i vilken mallfiler kallas av WordPress för ett antal frågetyper.
Top
visning av Startsida #visning av Startsida
som standard ställer WordPress in webbplatsens startsida för att visa dina senaste blogginlägg. Denna sida kallas blogginlägg index. Du kan också ställa in dina blogginlägg för att visa på en separat statisk sida., Mallfilen home.php
används för att göra blogginläggsindexet, oavsett om det används som förstasida eller på separat statisk sida. Omhome.php
inte finns kommer WordPress att användaindex.php
.
home.php
index.php
Obs: Omfront-page.php
existerar kommer den att åsidosätta mallenhome.php
.,
topp
förstasidesvisning #förstasidesvisning
mallfilenfront-page.php
används för att göra webbplatsens förstasida, oavsett om förstasidan visar blogginläggsindexet (ovan nämnda) eller en statisk sida. Den förstasidesmallen har företräde framför blogginlägg index (home.php
) Mall. Om filenfront-page.php
inte finns, kommer WordPress antingen att använda filenhome.php
ellerpage.php
beroende på inställningen i Inställningar → läsning., Om ingen av dessa filer finns kommer den att använda filen index.php
.
-
front-page.php
– används för både ”dina senaste inlägg” eller ”en statisk sida” som anges på framsidan visar avsnittet Inställningar → läsning. -
home.php
– om WordPress inte kan hittafront-page.php
och ”dina senaste inlägg” är inställt i avsnittet förstasida visar, kommer det att leta efterhome.php
. Dessutom kommer WordPress att leta efter den här filen när sidan inlägg är inställd på framsidan visar avsnittet., -
page.php
– när ”Front page” är inställt i avsnittet front page displays. -
index.php
– när ”dina senaste inlägg” är inställt i avsnittet förstasidesdisplayer menhome.php
inte existerar eller när förstasidan är inställd menpage.php
inte existerar.
som du kan se finns det många regler för vilken väg WordPress tar. Använda diagrammet ovan är det bästa sättet att avgöra vad WordPress kommer att visa.,
överst
sidvisning för Sekretesspolicy #siddisplay för Sekretesspolicy
mallfilenprivacy-policy.php
används för att göra webbplatsens integritetspolicy sida. Sidmallen för sekretesspolicy har företräde framför den statiska sidan (page.php
) Mall. Om filenprivacy-policy.php
inte finns kommer WordPress antingen att använda filernapage.php
ellersingular.php
beroende på tillgängliga mallar. Om ingen av dessa filer finns kommer den att använda filen index.php
.,
-
privacy-policy.php
– används för sidan sekretesspolicy som anges i avsnittet Ändra din sekretesspolicy i Inställningar → Sekretess. -
custom template file
– sidmallen som tilldelats sidan. Seget_page_templates()
. -
page-{slug}.php
– om sidsluggen ärprivacy
ser WordPress ut att användapage-privacy.php
. -
page-{id}.php
– om sid-ID är 6 ser WordPress ut att användapage-6.php
., page.php
singular.php
-
index.php
topp
enstaka inlägg #enstaka inlägg
mallfilen för enstaka inlägg används för att göra ett enda inlägg. WordPress använder följande sökväg:
topp
enkelsidig # enkelsidig
mallfilen som används för att göra en statisk sida (page
eftertyp).,är speciellt för WordPress och använder följande sökväg:
Top
Category #Category
Rendering category archive index pages använder följande sökväg i WordPress:
Top
Tag #Tag
För att visa en tag archive index page använder WordPress följande sökväg:
Top
anpassade taxonomier #anpassade taxonomier
anpassade taxonomier använder en något annorlunda mallfilsväg:
topp
anpassade posttyper #anpassade posttyper
anpassade posttyper använd följande sökväg för att återge lämplig arkivindexsida.,
-
archive-{post_type}.php
– om eftertypen ärproduct
, kommer WordPress leta efterarchive-product.php
. -
archive.php
-
index.php
(för att göra en enda posttyp Mall, se avsnittet single post display ovan.,s följ samma mönster som andra malltyper:
search.php
index.php
topp
404 (Hittades inte) #404 (Hittades inte)
likaså kallas 404 mallfiler i den här ordningen:
-
search.php
=”437290b6d8″> -
index.php
top
attachment #attachment
rendering av en bifogad sida (attachment
post-type) använder följande sökväg:
top
embeds #embeds
filen bädda in mall används för att göra ett inlägg som är inbäddad., Sedan 4,5 använder WordPress följande sökväg:
-
embed-{post-type}-{post_format}.php
– för det första söker WordPress efter en mall för det specifika inlägget. Till exempel, om dess posttyp ärpost
och det har ljudformatet, skulle WordPress leta efterembed-post-audio.php
. -
embed-{post-type}.php
– om eftertypen ärproduct
, skulle WordPress leta efterembed-product.php
. -
embed.php
– WordPress faller sedan tillbaka för att bädda in.php
., - slutligen faller WordPress slutligen tillbaka till sin egen
wp-includes/theme-compat/embed.php
Mall.
topp
non-ASCII character Handling #Non-ASCII Character Handling
eftersom WordPress 4.7, stöder någon dynamisk del av ett mallnamn som innehåller icke-ASCII-tecken i sitt namn faktiskt både den okodade och den kodade formen, i den ordningen. Du kan välja vilken du ska använda.,
här är sidmallhierarkin för en sida som heter ”Hello World” med ett ID på 6
:
page-hello-world-😀.php
page-hello-world-%f0%9f%98%80.php
page-6.php
page.php
singular.php
samma beteende gäller för post sniglar, term namn och författare nicenames.
topp
Filterhierarki #Filterhierarki
WordPress-mallsystemet låter dig filtrera hierarkin., Det innebär att du kan infoga och ändra saker på specifika punkter i hierarkin. Filtret (som finns i funktionen get_query_template()
) använder detta Filternamn: "{$type}_template"
där $type
är malltypen.,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., Detta möjliggör en begäran om / författare / användarnamn där Användarnamn har rollen som redaktör för att visa med hjälp av författare-editor.php om närvarande i den aktuella teman katalogen.