wordpress模板的定义非常方便,但是在定制模板之前,我们有必要知道wordpress的模板层次,了解wordpress是如何加载模板文件的,这将有利于开发模板时合理利用资源及提高工作效率。
万能的index.PHP
通过“wordpress主题构成”这篇文章,我们已知道一个最简单的wordpress主题只需要 style.css 和 index.PHP 文件即可。这代表着 index.PHP 可以是任何一个页面的模板,无论是首页,还是文章页,或是分类页,再或者是搜索结果页面,它都能完美胜任。
也就是说,当对应的模板不存在时,index.PHP 将是wordpress最后的底牌。
模板加载顺序
下面让我们来了解一下wordpress都是怎么加载模板的
首页
文章页
首先被考虑的是single-{post_type}.PHP 这样一个模板文件(如文章类型是 product 那么对应的文件名就是 single-product.PHP )如果找不到,那么就会加载single.PHP 模板如果连single.PHP 模板都没有则加载index.PHP 模板。
页面
首先被考虑的是自定义模板,也就是编辑页面时所选择的模板如果没有自定义模板,则查找page-{slug}.PHP 别名模板(如页面别名是 about 对应的文件名就是 page-about.PHP )如果别名模板也没有就查找page-{id}.PHP ID模板(如页面ID是 2对应的文件名就是 page-2.PHP )如果ID模板也没有那就是 page.PHP 模板了如果连 page.PHP 模板都没有则加载index.PHP 模板
分类页
首先被考虑的是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 模板
标签页
自定义分类法
有时候除了wordpress默认的分类目录和标签我们还需要其他的分类方法,这时候我们就会注册一个新的分类法,那么在此之前知道分类法的模板加载顺序也是十分必要的。以下说明假设自定义分类法是 people 这个名字:
分类法分类页首先被考虑的是taxonomy-{taxonomy}-{term}.PHP 别名模板(如分类别名 teacher 对应的文件名就是taxonomy-people-teacher.PHP)如果没有别名模板,则加载该分类法归档页(如 taxonomy-people.PHP )如果分类法归档页模板也没有则加载 archive.PHP通用归档模板如果连 archive.PHP通用归档模板都没有则加载index.PHP 模板
自定义文章类型
自定义文章类型归档页首先被考虑的是archive-{post_type}.PHP 别名模板(如文章类型是 product 那么对应的文件名就是archive-product.PHP )如果没有别名模板则加载 archive.PHP通用归档模板如果连 archive.PHP通用归档模板都没有则加载index.PHP 模板
作者归档页
首先被考虑的是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模板
日期归档页
首先被考虑的是 date.PHP 日期归档模板如果日期归档模板没有则加载 archive.PHP通用归档模板如果连 archive.PHP通用归档模板都没有则加载index.PHP 模板
搜索结果页
附件页
首先会按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 模板
模板层次图
上面用文字详细讲述了wordpress模板的加载顺序,尽管详细,但还不如一张信息图更为直观,以下就是wordpress的模板层次(2)结构图。
使用钩子修改模板
在某些使用场景(如插件),我们并不能直接修改模板文件,这时候我们可以使用钩子来实现修改模板文件,钩子名称是{$type}_template 这样的格式,以下是对应的完整的钩子名称列表:
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
以下是一个使用例子(让页面加载single.PHP 文章页的模板):
function page_template_filter( $templates=''){
$templates=locate_template("single.PHP",false);
return $templates;
}
add_filter('page_template','page_template_filter');
模板页面判断
一般情况下,在一个特定的模板中我们能清楚知道应该怎么输出特定的样式和内容,但在一些通用模板中(如 header.PHP )我们想要知道用户当前访问的是哪个页面模板就需要借助wordpress内置的条件判断函数了,这些函数可以帮助我们判断当前是什么页面以方便加载不同的模板内容,如 is_home() 则是判断首页的条件标签,is_single() 则是判断文章页的条件标签,等等。
原文链接:https://www.f2er.com/wordpress/15181.html