Template Hierarchy ng WordPress Block Theme

Ang buong block-theme (FSE) na template hierarchy: para sa bawat uri ng request, ang nakaayos na listahan ng mga template na hinahanap ng WordPress, pinaka-espesipiko muna, na babagsak sa index.html. Ang katumbas sa block-era ng klasikong hierarchy chart.

Para sa bawat kahilingan, hinahanap ng WordPress ang mga template na ito ayon sa pagkakasunod-sunod — pinakatiyak muna — at hihinto sa unang umiiral sa /templates folder ng iyong tema. Palaging nagtatapos ang chain sa index.html.

Unang pahina

Ang unang pahina ng site, maging naka-set man ito sa iyong mga pinakabagong post o sa isang static na pahina.

front-page.html

home.html

index.html

Nananaig ang front-page.html anuman ang piliin sa Settings → Reading. Kung ang unang pahina ay isang static na pahina at walang front-page.html, bumabagsak ito sa static-page chain, hindi sa home.html.

Index ng mga blog post

Ang pahinang naglilista ng iyong mga pinakabagong post (ang "posts page" sa Settings → Reading).

home.html

index.html

Iisang post

Isang indibidwal na blog post.

single-post-{slug}.html

single-post.html

single.html

singular.html

index.html

Iisang custom post type

Isang indibidwal na entry ng isang custom post type (hal. isang "book").

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

single-{post-type}.html

single.html

singular.html

index.html

Para sa post type na "book" na may slug na "dune": single-book-dune.html, tapos single-book.html, tapos single.html.

Static na pahina

Isang karaniwang WordPress page.

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Pahinang may custom template

Isang pahinang binigyan ng custom template sa Template panel ng editor.

{custom-template}.html

page-{slug}.html

page-{id}.html

page.html

singular.html

index.html

Ang mga custom template ay idineklara sa customTemplates array ng theme.json at nakalagay sa /templates. Nananaig ang naka-assign na template sa buong page chain.

Archive ng category

Ang archive na naglilista ng mga post sa isang category.

category-{slug}.html

category-{id}.html

category.html

archive.html

index.html

Archive ng tag

Ang archive na naglilista ng mga post na may isang tag.

tag-{slug}.html

tag-{id}.html

tag.html

archive.html

index.html

Archive ng custom taxonomy

Ang archive para sa isang term sa isang custom taxonomy.

taxonomy-{taxonomy}-{term}.html

taxonomy-{taxonomy}.html

taxonomy.html

archive.html

index.html

Archive ng author

Ang archive ng mga post ng isang author.

author-{nicename}.html

author-{id}.html

author.html

archive.html

index.html

Archive ng petsa

Isang archive ng taon / buwan / araw.

date.html

archive.html

index.html

Archive ng post type

Ang archive index para sa isang custom post type na may naka-set na has_archive.

archive-{post-type}.html

archive.html

index.html

Mga resulta ng paghahanap

Ang pahina ng mga resulta para sa paghahanap sa site.

search.html

index.html

404 (hindi natagpuan)

Ipinapakita kapag walang content na tumutugma sa URL.

404.html

index.html

Attachment page

Ang pahina para sa isang media attachment.

attachment.html

single.html

singular.html

index.html

Maraming site ang ganap na nag-di-disable ng attachment pages (thin content ang mga ito). Kung pananatilihin mo ang mga ito, ito ang chain.

Pahina ng privacy policy

Ang pahinang naka-set bilang privacy policy ng site sa Settings.

page-privacy-policy.html

privacy-policy.html

page.html

singular.html

index.html

Kung paano ito naiiba sa klasikong (PHP) hierarchy

Ang mga template ay .html files sa /templates, hindi .php files sa theme root. Walang single.php — ito ay single.html.
Ang mga reusable na region (header, footer) ay mga template PART sa /parts, tinutukoy gamit ang wp:template-part block, hindi ang get_header() / get_footer() na PHP calls.
Walang get_template_part() chain at walang get_header()/get_footer(). Ginagawa ang komposisyon gamit ang Template Part block sa loob ng mga .html files.
REQUIRED ang index.html. Ang isang block theme na walang templates/index.html ay hindi isang valid na block theme — ito ang mandatory na huling fallback para sa bawat route sa itaas.
Idineklarang block theme ang tema batay sa PRESENSYA ng templates/index.html kasama ang isang theme.json, hindi sa anumang header flag.
Maaari mong i-edit ang alinman sa mga template na ito sa Site Editor (Appearance → Editor) at i-save ang mga pagbabago sa database — na pagkatapos ay NAG-O-OVERRIDE sa mga file ng tema hanggang sa i-clear mo ang customization. Nakakagulat ito sa mga taong nagde-debug ng "bakit walang epekto ang pagbabago ko sa template".