WordPress的模板层次

霜下雪 發表於 2023-12-8 00:00:00

WordPress模板的定义非常方便，但是在定制模板之前，我们有必要知道WordPress的模板层次，了解WordPress是如何加载模板文件的，这将有利于开发模板时合理利用资源及提高工作效率。

万能的index.php

通过“WordPress主题构成”这篇文章，我们已知道一个最简单的WordPress主题只需要 style.css 和 index.php 文件即可。这代表着 index.php 可以是任何一个页面的模板，无论是首页，还是文章页，或是分类页，再或者是搜索结果页面，它都能完美胜任。

也就是说，当对应的模板不存在时， index.php 将是WordPress最后的底牌。

模板加载顺序

下面让我们来了解一下WordPress都是怎么加载模板的

首页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>
<ol style="margin: 0px 0px 0px 25px; padding: 0.3em 0px 0.3em 15px; outline: none; list-style-position: initial; list-style-image: initial; line-height: 25px; word-break: break-word;">
首先WordPress会先检查是否有静态首页，如果有静态首页，就会加载这个页面内容并通过 front-page.php 模板文件展示，如果没有这个模板文件，就会通过页面模板展示如果没有静态首页，就会加载 home.php 最新文章模板如果没有 home.php 则加载 index.php模板
</ol>
</blockquote>

文章页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先被考虑的是 single-{post_type}.php 这样一个模板文件（如文章类型是 product 那么对应的文件名就是 single-product.php ）如果找不到，那么就会加载 single.php 模板如果连 single.php 模板都没有则加载 index.php 模板。
</blockquote>

页面
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先被考虑的是自定义模板，也就是编辑页面时所选择的模板如果没有自定义模板，则查找 page-{slug}.php 别名模板（如页面别名是 about 对应的文件名就是 page-about.php ）如果别名模板也没有就查找 page-{id}.php ID模板（如页面ID是 2 对应的文件名就是 page-2.php ）如果ID模板也没有那就是 page.php 模板了如果连 page.php 模板都没有则加载 index.php 模板
</blockquote>

分类页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先被考虑的是 category-{slug}.php 别名模板（如分类别名是 news 对应的文件名就是 category-news.php ）如果没有别名模板则查找 category-{id}.php ID模板（如分类ID是 1 对应的文件名就是 category-1.php ）如果ID模板也没有那就是 category.php 分类模板了如果 category.php 分类模板也没有则加载 archive.php 通用归档模板如果连 archive.php 通用归档模板都没有则加载 index.php 模板
</blockquote>

标签页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

标签页模板加载顺序和分类页一样，只不过前缀不过 category 而是 tag （如 tag-{slug}.php）。
</blockquote>

自定义分类法

有时候除了WordPress默认的分类目录和标签我们还需要其他的分类方法，这时候我们就会注册一个新的分类法，那么在此之前知道分类法的模板加载顺序也是十分必要的。以下说明假设自定义分类法是 people 这个名字：
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

分类法分类页首先被考虑的是 taxonomy-{taxonomy}-{term}.php 别名模板（如分类别名 teacher 对应的文件名就是 taxonomy-people-teacher.php ）如果没有别名模板，则加载该分类法归档页（如 taxonomy-people.php ）如果分类法归档页模板也没有则加载 archive.php 通用归档模板如果连 archive.php 通用归档模板都没有则加载 index.php 模板
</blockquote>

自定义文章类型

除了自定义分类法，有时候我们也需要自定义文章类型
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

自定义文章类型归档页首先被考虑的是 archive-{post_type}.php 别名模板（如文章类型是 product 那么对应的文件名就是 archive-product.php ）如果没有别名模板则加载 archive.php 通用归档模板如果连 archive.php 通用归档模板都没有则加载 index.php 模板
</blockquote>

作者归档页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先被考虑的是 author-{nicename}.php 别名模板（如作者用户名是 steven 那么对应的文件名就是 author-steven.php ）如果没有别名模板则加载 author-{id}.php ID模板（如作者ID是 1 对应的文件名就是 author-1.php ）如果ID模板没有则加载 author.php 通用作者模板如果通用作者模板也没有则加载 archive.php 通用归档模板如果连 archive.php 通用归档模板都没有则加载 index.php模板
</blockquote>

日期归档页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先被考虑的是 date.php 日期归档模板如果日期归档模板没有则加载 archive.php 通用归档模板如果连 archive.php 通用归档模板都没有则加载 index.php 模板
</blockquote>

搜索结果页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>
<ol style="margin: 0px 0px 0px 25px; padding: 0.3em 0px 0.3em 15px; outline: none; list-style-position: initial; list-style-image: initial; line-height: 25px; word-break: break-word;">
首先被考虑的是 search.php 搜索结果模板如果没有搜索结果模板则加载 index.php模板
</ol>
</blockquote>

附件页
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

首先会按MIME类型加载模板（如 image.php, video.php, application.php，而 text/plain 类型则按顺序尝试加载 text.php, plain.php, text_plain.php 这三个文件。如果没有对应的MIME类型模板则 attachment.php 附件模板（如没有 attachment.php 则加载 single-attachment.php ）如果没有附件模板则加载 single.php 文章页模板如果连 single.php 文章页模板都没有则加载 index.php 模板
</blockquote>

模板层次图

上面用文字详细讲述了WordPress模板的加载顺序，尽管详细，但还不如一张信息图更为直观，以下就是WordPress的模板层次(2)结构图。

<img title="WordPress的模板层次" alt="WordPress的模板层次" src="https://zhuji.jb51.net/uploads/img/202305/c1f56b2694976362935499d8f81d9b93.jpg" style="max-width:100%!important;height:auto!important;border: 1px solid rgb(204, 204, 204); vertical-align: middle; padding: 1px; overflow: hidden; max-width: 696px; width: 600px; height: 596px;">

使用钩子修改模板

在某些使用场景（如插件），我们并不能直接修改模板文件，这时候我们可以使用钩子来实现修改模板文件，钩子名称是 {$type}_template 这样的格式，以下是对应的完整的钩子名称列表：
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

index_template

404_template

archive_template

author_template

category_template

tag_template

taxonomy_template

date_template

home_template

front_page_template

page_template

paged_template

search_template

single_template

text_template, plain_template, text_plain_template (all mime types)

attachment_template

comments_popup
</blockquote>

以下是一个使用例子（让页面加载 single.php 文章页的模板）：
<blockquote style='margin: 0px auto 10px; padding: 4px 4px 4px 10px; outline: none; background: rgb(244, 249, 251); border-left: 4px solid rgb(116, 205, 230); width: 665px; font-family: tahoma, arial, "Microsoft YaHei"; font-size: 14px;'>

function page_template_filter( $templates=''){

$templates=locate_template("single.php",false);

return $templates;

}

add_filter('page_template','page_template_filter');
</blockquote>

模板页面判断

一般情况下，在一个特定的模板中我们能清楚知道应该怎么输出特定的样式和内容，但在一些通用模板中（如 header.php ）我们想要知道用户当前访问的是哪个页面模板就需要借助WordPress内置的条件判断函数了，这些函数可以帮助我们判断当前是什么页面以方便加载不同的模板内容，如 is_home() 则是判断首页的条件标签，is_single() 则是判断文章页的条件标签，等等。

頁: [1]

琼殿技术论坛's Archiver

WordPress的模板层次