关于WordPress的模板层次
WordPress模板的定义非常方便,但是在定制模板之前,我们有必要知道WordPress的模板层次,了解WordPress是如何加载模板文件的,这将有利于开发模板时合理利用资源及提高工作效率。
WordPress模版中最主要的Index.Php
一个最简单的WordPress主题,甚至只需要一个 style.css 和 index.php 文件即可实现。这代表着 index.php 可以是任何一个页面的模板,无论是首页,还是文章页,或是分类页,再或者是搜索结果页面,它都能完美胜任。 也就是说,当对应的模板不存在时,index.php 将是WordPress最后的底牌。
WordPress模板的加载顺序
在WordPress中,加载主题文件可都是有顺序之分的,先加载哪个后加在哪个我们得搞清楚,下面让我们来了解一下WordPress都是怎么加载模板的
WordPress模版加载顺序之一:首页
- 首先WordPress会先检查是否有静态首页,如果有静态首页,就会加载这个页面内容并通过 front-page.php 模板文件展示,如果没有这个模板文件,就会通过页面模板展示
- 如果没有静态首页,就会加载 home.php 最新文章模板
- 如果没有 home.php 则加载 index.php 模板
WordPress模版加载顺序之一:文章页
- 首先被考虑的是 single-{post_type}.php 这样一个模板文件(如文章类型是 product 那么对应的文件名就是 single-product.php )
- 如果找不到,那么就会加载 single.php 模板
- 如果连 single.php 模板都没有则加载 index.php 模板。
WordPress模版加载顺序之一:独立页面
- 首先被考虑的是自定义模板,也就是编辑页面时所选择的模板
- 如果没有自定义模板,则查找 page-{slug}.php 别名模板(如页面别名是 about 对应的文件名就是page-about.php )
- 如果别名模板也没有就查找 page-{id}.php ID模板(如页面ID是 2 对应的文件名就是 page-2.php)
- 如果ID模板也没有那就是 page.php 模板了
- 如果连 page.php 模板都没有则加载 index.php 模板
WordPress模版加载顺序之一:分类页面
- 首先被考虑的是 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模版加载顺序之一:标签页面
标签页模板加载顺序和上面的分类页是一样的,只不过前缀不过 category 而是 tag (如 tag-{slug}.php)。
WordPress模版加载顺序之一:自定义分类
有时候除了WordPress默认的分类目录和标签我们还需要其他的分类方法,这时候我们就会注册一个新的分类法,那么在此之前知道分类法的模板加载顺序也是十分必要的。以下说明假设自定义分类法是 people 这个名字:
- 分类法分类页首先被考虑的是 taxonomy-{taxonomy}-{term}.php 别名模板(如分类别名 teacher对应的文件名就是 taxonomy-people-teacher.php )
- 如果没有别名模板,则加载该分类法归档页(如 taxonomy-people.php )
- 如果分类法归档页模板也没有则加载 archive.php 通用归档模板
- 如果连 archive.php 通用归档模板都没有则加载 index.php 模板
WordPress模版加载顺序之一:自定义文章类型
除了自定义分类法,有时候我们也需要自定义文章类型
- 自定义文章类型归档页首先被考虑的是 archive-{post_type}.php 别名模板(如文章类型是product 那么对应的文件名就是 archive-product.php )
- 如果没有别名模板则加载 archive.php 通用归档模板
- 如果连 archive.php 通用归档模板都没有则加载 index.php 模板
WordPress模版加载顺序之一:作者归档页
- 首先被考虑的是 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 模板
WordPress模版加载顺序之一:日期归档页
- 首先被考虑的是 date.php 日期归档模板
- 如果日期归档模板没有则加载 archive.php 通用归档模板
- 如果连 archive.php 通用归档模板都没有则加载 index.php 模板
WordPress模版加载顺序之一:搜索结果页
- 首先被考虑的是 search.php 搜索结果模板
- 如果没有搜索结果模板则加载 index.php 模板
WordPress模版加载顺序之一:附件页
- 首先会按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模版层次图
WordPress模版加载顺序之一:构成代码
在WordPress主题中编码你可以和PHP混写(事实上就是写PHP代码,只是预设了大量常用变量和函数让你几乎不用自己写代码,只需要按规则调用即可),需要注意的是,实现一个功能之前最好先查阅一次官方文档确认WordPress没有内置再自定义,最大程度精简代码。
同时,WordPress使用循环加载主要内容,使用模板标签加载指定内容,使用 Action (动作)机制插入处理代码,使用 Filter (钩子)机制过滤数据。
转载请注明:有客帮 » 详细介绍一下WordPress模板文件的层次关系