WordPress Blok Tema Şablon Hiyerarşisi

Tam blok tema (FSE) şablon hiyerarşisi: her istek türü için WordPress'in aradığı, en özelden başlayıp index.html'e düşen sıralı şablon listesi. Klasik hiyerarşi tablosunun blok dönemindeki karşılığı.

Her istek için WordPress bu şablonları sırayla arar — önce en özel olanı — ve temanızın /templates klasöründe var olan ilk şablonda durur. Zincir her zaman index.html ile sona erer.

Ön sayfa

Sitenin ön sayfası; ister en son yazılarınız ister statik bir sayfa olarak ayarlanmış olsun.

front-page.html

home.html

index.html

Ayarlar → Okuma seçiminden bağımsız olarak front-page.html kazanır. Ön sayfa statik bir sayfaysa ve front-page.html yoksa, home.html'e değil statik sayfa zincirine düşer.

Blog yazıları dizini

En son yazılarınızı listeleyen sayfa (Ayarlar → Okuma'daki \"yazılar sayfası\").

home.html

index.html

Tekil yazı

Tek bir blog yazısı.

single-post-{slug}.html

single-post.html

single.html

singular.html

index.html

Tekil özel yazı türü

Özel bir yazı türünün tek bir kaydı (örneğin bir \"kitap\").

single-{post-type}-{slug}.html

single-{post-type}.html

single.html

singular.html

index.html

Slug'ı \"dune\" olan \"book\" yazı türü için: önce single-book-dune.html, sonra single-book.html, ardından single.html.

Statik sayfa

Sıradan bir WordPress sayfası.

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Özel şablonlu sayfa

Düzenleyicinin Şablon panelinde özel bir şablon atanmış bir sayfa.

{custom-template}.html

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Özel şablonlar theme.json'daki customTemplates dizisinde tanımlanır ve /templates içinde bulunur. Atanan şablon, tüm sayfa zincirine üstün gelir.

Kategori arşivi

Bir kategorideki yazıları listeleyen arşiv.

category-{slug}.html

category-{id}.html

category.html

archive.html

index.html

Etiket arşivi

Belirli bir etikete sahip yazıları listeleyen arşiv.

tag-{slug}.html

tag-{id}.html

tag.html

archive.html

index.html

Özel taksonomi arşivi

Özel bir taksonomideki bir terimin arşivi.

taxonomy-{taxonomy}-{term}.html

taxonomy-{taxonomy}.html

taxonomy.html

archive.html

index.html

Yazar arşivi

Tek bir yazarın yazılarının arşivi.

author-{nicename}.html

author-{id}.html

author.html

archive.html

index.html

Tarih arşivi

Yıl / ay / gün arşivi.

date.html

archive.html

index.html

Yazı türü arşivi

has_archive özelliği ayarlanmış bir özel yazı türünün arşiv dizini.

archive-{post-type}.html

archive.html

index.html

Arama sonuçları

Site içi bir aramanın sonuç sayfası.

search.html

index.html

404 (bulunamadı)

URL ile eşleşen bir içerik olmadığında gösterilir.

404.html

index.html

Ek sayfası

Tek bir medya ekinin sayfası.

attachment.html

single.html

singular.html

index.html

Birçok site ek sayfalarını tamamen devre dışı bırakır (zayıf içerikli olurlar). Bunları koruyorsanız zincir şöyledir.

Gizlilik politikası sayfası

Ayarlar'da sitenin gizlilik politikası olarak belirlenen sayfa.

page-privacy-policy.html

privacy-policy.html

page.html

singular.html

index.html

Bunun klasik (PHP) hiyerarşisinden farkı

Şablonlar, tema kök dizinindeki .php dosyaları değil, /templates içindeki .html dosyalarıdır. single.php diye bir şey yoktur; single.html vardır.
Yeniden kullanılabilir bölgeler (üst bilgi, alt bilgi), get_header() / get_footer() PHP çağrılarıyla değil, /parts içinde bulunan ve wp:template-part bloğuyla referans verilen şablon PARÇALARIDIR.
get_template_part() zinciri yoktur ve get_header()/get_footer() yoktur. Kompozisyon, .html dosyaları içindeki Şablon Parçası bloğuyla yapılır.
index.html ZORUNLUDUR. templates/index.html içermeyen bir block theme geçerli bir block theme değildir; yukarıdaki her rota için zorunlu son yedektir.
Tema, herhangi bir başlık bayrağıyla değil, templates/index.html'in VARLIĞI ve bir theme.json ile block theme olarak tanımlanır.
Bu şablonların herhangi birini Site Düzenleyici'de (Görünüm → Düzenleyici) düzenleyip değişiklikleri veritabanına kaydedebilirsiniz; bu değişiklikler, siz özelleştirmeyi temizleyene kadar temanın dosyalarını GEÇERSİZ KILAR. \"Şablon değişikliğim neden hiçbir şey yapmıyor\" diye hata ayıklayan kişileri şaşırtan durum budur.