WordPress.org (Polski)
jak wspomniano, pliki szablonów są modułowymi plikami wielokrotnego użytku, używanymi do generowania stron internetowych w witrynie WordPress. Niektóre pliki szablonów (takie jak szablon nagłówka i stopki) są używane na wszystkich stronach witryny, podczas gdy inne są używane tylko w określonych warunkach.
Ten artykuł wyjaśnia, w jaki sposób WordPress określa pliki szablonów do użycia na poszczególnych stronach. Jeśli chcesz dostosować istniejący motyw WordPress, pomoże Ci zdecydować, który plik szablonu należy edytować.,
hierarchia plików szablonów #hierarchia plików szablonów
Przegląd #Przegląd
WordPress używa ciągu zapytania, aby zdecydować, który szablon lub zestaw szablonów powinien zostać użyty do wyświetlenia strony. Ciąg zapytania to Informacje zawarte w linku do każdej części witryny. Pojawia się po początkowym znaku zapytania i może zawierać szereg parametrów oddzielonych ampersandami.,
mówiąc prościej, WordPress przeszukuje hierarchię szablonów, aż znajdzie pasujący plik szablonu. Aby określić, którego pliku szablonu użyć, WordPress:
- dopasowuje każdy ciąg zapytania do typu zapytania, aby zdecydować, która strona jest żądana (na przykład strona wyszukiwania, Strona kategorii itp.);
- wybiera szablon w kolejności określonej przez hierarchię szablonów;
- szuka plików szablonów o określonych nazwach w katalogu bieżącego motywu i używa pierwszego pasującego pliku szablonu określonego przez hierarchię.,
z wyjątkiem podstawowego pliku szablonu index.php
możesz wybrać, czy chcesz zaimplementować konkretny plik szablonu, czy nie.
Jeśli WordPress nie może znaleźć pliku szablonu o pasującej nazwie, przejdzie do następnego pliku w hierarchii. Jeśli WordPress nie może znaleźć pasującego pliku szablonu, zostanie użyty plik index.php
.,
Góra
przykłady #przykłady
Jeśli twój blog znajduje się pod adresem I odwiedzający kliknie link do strony kategorii, takiej jak
, WordPress szuka pliku szablonu w katalogu bieżącego motywu, który pasuje do identyfikatora kategorii, aby wygenerować poprawną stronę. Dokładniej, WordPress postępuje zgodnie z tą procedurą:
- szuka pliku szablonu w katalogu bieżącego motywu, który pasuje do ślimaka kategorii. Jeśli Kategoria slug to „jednorożce”, to WordPress szuka pliku szablonu o nazwie
category-unicorns.php
., - Jeśli brakuje
category-unicorns.php
, a identyfikator kategorii wynosi 4, WordPress szuka pliku szablonu o nazwiecategory-4.php
. - Jeśli brakuje
category-4.php
, WordPress będzie szukał ogólnego pliku szablonu kategorii,category.php
. - Jeśli
category.php
nie istnieje, WordPress będzie szukał ogólnego szablonu archiwum,archive.php
. - Jeśli brakuje
archive.php
, WordPress powróci do głównego pliku szablonu motywu,index.php
.,
Top
przegląd wizualny #przegląd wizualny
poniższy diagram pokazuje, które pliki szablonów są wywoływane do generowania strony WordPress na podstawie hierarchii szablonów WordPress.
Top
hierarchia szablonów w szczegółach #hierarchia szablonów w szczegółach
podczas gdy hierarchia szablonów jest łatwiejsza do zrozumienia jako diagram, poniższe sekcje opisują kolejność, w jakiej pliki szablonów są wywoływane przez WordPress dla wielu typów zapytań.
Top
wyświetlanie strony głównej #Wyświetlanie strony głównej
domyślnie WordPress ustawia stronę główną Twojej witryny, aby wyświetlała najnowsze posty na blogu. Ta strona nazywa się blog posts index. Możesz również ustawić wyświetlanie postów na blogu na oddzielnej stronie statycznej., Plik szablonu home.php
służy do renderowania indeksu postów na blogu, niezależnie od tego, czy jest używany jako Strona główna, czy na oddzielnej stronie statycznej. Jeśli home.php
nie istnieje, WordPress użyje index.php
.
home.php
index.php
Uwaga: jeślifront-page.php
istnieje, zastąpihome.php
szablon.,
Top
wyświetlanie pierwszej strony #wyświetlanie pierwszej strony
plik szablonu front-page.php
jest używany do wyświetlania pierwszej strony witryny, niezależnie od tego, czy na pierwszej stronie wyświetlany jest indeks postów na blogu (wspomniany powyżej), czy strona statyczna. Szablon strony głównej ma pierwszeństwo przed szablonem indeksu postów na blogu (home.php
). Jeśli plik front-page.php
nie istnieje, WordPress użyje plików home.php
lubpage.php
w zależności od konfiguracji w Ustawieniach → Czytanie., Jeśli żaden z tych plików nie istnieje, użyje pliku index.php
.
-
front-page.php
– Używany zarówno dla „Twoich ostatnich postów”, jak i „strony statycznej” ustawionej w sekcji Ustawienia → Czytanie. -
home.php
– jeśli WordPress nie może znaleźćfront-page.php
, a” twoje ostatnie posty”jest ustawione w sekcji wyświetlania pierwszej strony, będzie szukałhome.php
. Dodatkowo WordPress będzie szukał tego pliku, gdy strona postów jest ustawiona w sekcji Wyświetlanie strony głównej., -
page.php
– gdy” front page ” jest ustawione w sekcji front page displays. -
index.php
– gdy ustawiona jest opcja „Twoje ostatnie posty” w sekcji wyświetlenia strony głównej, alehome.php
nie istnieje lub gdy ustawiona jest strona główna, alepage.php
nie istnieje.
Jak widać, istnieje wiele zasad do tego, co ścieżka WordPress. Korzystanie z powyższego wykresu jest najlepszym sposobem określenia, co WordPress wyświetli.,
Top
wyświetlanie strony Polityki Prywatności #Wyświetlanie strony Polityki Prywatności
plik szablonuprivacy-policy.php
służy do wyświetlania strony Polityki Prywatności witryny. Szablon strony Polityki Prywatności ma pierwszeństwo przed szablonem strony statycznej (page.php
). Jeśli plik privacy-policy.php
nie istnieje, WordPress użyje plików page.php
lubsingular.php
w zależności od dostępnych szablonów. Jeśli żaden z tych plików nie istnieje, użyje pliku index.php
.,
-
privacy-policy.php
– używany do strony Polityki Prywatności ustawionej w sekcji Zmień swoją Politykę prywatności w Ustawieniach → Prywatność. -
custom template file
– szablon strony przypisany do strony. Zobaczget_page_templates()
. -
page-{slug}.php
– jeśli slug strony jestprivacy
, WordPress będzie wyglądać używaćpage-privacy.php
. -
page-{id}.php
– jeśli ID strony wynosi 6, WordPress będzie szukał użyciapage-6.php
., page.php
singular.php
-
index.php
Góra
pojedynczy Post #pojedynczy Post
plik szablonu pojedynczego postu służy do renderowania pojedynczego posta. WordPress używa następującej ścieżki:
Top
Pojedyncza strona #Pojedyncza strona
plik szablonu używany do renderowania statycznej strony (page
post-type).,es, page
jest specjalny dla WordPressa i używa następującej ścieżki:
Top
Category #Category
Rendering category archive Index pages używa następującej ścieżki w WordPress:
Top
Tag #Tag
aby wyświetlić stronę indeksu archiwum tagów, WordPress używa następującej ścieżki:
Top p
taksonomie niestandardowe #taksonomie niestandardowe
taksonomie niestandardowe używają nieco innej ścieżki do pliku szablonu:
top
niestandardowe typy postów #niestandardowe typy postów
niestandardowe typy postów użyj następującej ścieżki, aby wygenerować odpowiednią stronę indeksu archiwum.,
-
archive-{post_type}.php
– jeśli Typ posta toproduct
, WordPress będzie szukałarchive-product.php
. archive.php
index.php
(aby renderować szablon typu pojedynczego posta, zobacz sekcję wyświetlania pojedynczego postu powyżej.,s postępuj zgodnie z tym samym wzorem co inne typy szablonów:
search.php
index.php
Góra
404 (Nie znaleziono) #404 (Nie znaleziono)
podobnie, 404 pliki szablonów są wywoływane w tej kolejności:
404.php
index.php
top
załącznik #załącznik
renderowanie strony załącznika (attachment
post-type) używa następująca ścieżka:
top
embeds #embeds
osadzony plik szablonu służy do renderowania osadzanego posta., Od wersji 4.5 WordPress używa następującej ścieżki:
-
embed-{post-type}-{post_format}.php
– najpierw WordPress szuka szablonu dla konkretnego posta. Na przykład, jeśli jego typ posta topost
I ma format audio, WordPress szukałbyembed-post-audio.php
. -
embed-{post-type}.php
– jeśli Typ posta toproduct
, WordPress szukałbyembed-product.php
. -
embed.php
– WordPress wraca do osadzenia.php
., - wreszcie WordPress ostatecznie wraca do własnego
wp-includes/theme-compat/embed.php
szablonu.
Top
obsługa znaków innych niż ASCII #obsługa znaków innych niż ASCII
od wersji WordPress 4.7 każda dynamiczna część nazwy szablonu, która zawiera znaki inne niż ASCII w swojej nazwie, obsługuje zarówno niezakodowaną, jak i zakodowaną formę, w tej kolejności. Możesz wybrać, którego użyć.,
hierarchia szablonów stron dla strony o nazwie „Hello World 😀” o ID 6
:
page-hello-world-😀.php
page-hello-world-%f0%9f%98%80.php
page-6.php
page.php
singular.php
to samo zachowanie odnosi się do słupków, nazw terminów i nazw autorów.
Top
hierarchia filtrów #hierarchia filtrów
system szablonów WordPress umożliwia filtrowanie hierarchii., Oznacza to, że można wstawiać i zmieniać rzeczy w określonych punktach hierarchii. Filtr (znajdujący się w funkcji get_query_template()
) używa tej nazwy filtra: "{$type}_template"
gdzie$type
jest typem szablonu.,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., Pozwala to na żądanie /author / username, gdzie username ma rolę edytora do wyświetlenia przy użyciu autor-edytor.php, jeśli znajduje się w bieżącym katalogu themes.