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.phpnie 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.phpistnieje, zastąpihome.phpszablon.,
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.phplubpage.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.phpnie istnieje lub gdy ustawiona jest strona główna, alepage.phpnie 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.phplubsingular.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 (attachmentpost-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 topostI 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łasnegowp-includes/theme-compat/embed.phpszablonu.
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_templateauthor_templatedate_templatearchive_templateindex_templateTop
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.