WordPress页面模板层次结构

七种页面类型

WordPress主要有七种页面类型,我们将逐一进行讨论。

网站首页(Site Front Page)
文章页面(Single Posts)
单页页面(Single Pages)
自定义文章类型(Custom Post Types)
搜索结果页面(Search Results Pages)
类别和标签页(Category and Tag Pages)
404错误页面(404 Error Pages)

首页模板文件

对于网站首页,WordPress将按先后顺序查找这三个模板文件:

front-page.php
home.php
index.php
如果WordPress主题中不包含front-page.php模板文件,则继续查找home.php模板文件,如果依然没有,则使用index.php模板文件。

文章页面

WordPress文章页面按照如下的模板层次结构查找模板文件:

single-{post-type}-{slug}.php
single-{post-type}.php
single.php
singular.php
index.php
一般情况下,文章页面的模板层次结构是single.php > singular.php > index.php,

也就是按照自前往后的顺序来查找模板文件。但是有时,我们可能会为某个文章分类的页面,定制单独的模板文件,这时就会从1开始执行的模板层次结构。比如,我们为分类别名为“features”的分类内的文章别名为“Apple-phone”的文章页面创建single-features-Apple-phone.php这个模板文件。同样,如果我们为分类别名为“features”的分类创建统一的文章模板文件,则可以创建single-features.php模板文件。

单页页面

单页页面的模板层次结构为:

Custom template file
page–{slug}.php
page-{id}.php
page.php
singular.php
index.php
单页页面安装从1到6的层次结构,来查找模板文件。对于别名为“about-us”,ID为“19”的单页页面。WordPress先查找名为page-about-us.php的模板文件,如果没有则查询名为page-19.php的模板文件,如果仍然没有,则依次查找page.php > singular.php > index.php模板文件。

自定义文章类型

有的时候,我们可能想要创建区别于文章和页面的内容类型,这时候我们可以按照如下的模板层次结构:

archive- {post_type} .php
archive.php
index.php

搜索结果页面

WordPress用于搜索结果页面的模板层次结构:

search.php
index.php
分类页和标签页
文章分类页的模板层次结构如下所示:

category–{slug}.php
category-{id}.php
category.php
archive.php
index.php
相对应的标签页的模板层次结构:

搜索结果页面

tag–{slug}.php
tag-{id}.php
tag.php
archive.php
index.php
404错误页面
404错误页面的模板层次结构如下:

404.php
index.php
随着网站的发展,用户遇到404错误的情况也会越来越多。错误页面可以告知访问者为何页面无法加载,并将他们引导到其他的页面。

QR:WordPress页面模板层次结构