Code Bye

WordPress模板层次和加载模板文件的方式

WordPress定制模板很方便,本文介绍WordPress的模板层次,帮你了解WordPress是如何加载模板文件的,这对开发模板时合理利用资源及提高工作效率很有利。

index.php

一个最简单的WordPress主题只需要 style.css 和 index.php 文件即可。这说明 index.php 可以是任何一个页面的模板,无论是首页,文章页,还是分类页,或者是搜索结果页,它都能胜任。

就是说,当对应的模板不存在时, index.php 将是WordPress最后的选择。

模板加载顺序

下面来了解一下WordPress是如何加载模板的

首页

    1. 首先WordPress会先检查是否有静态首页,如果有静态首页,就会加载这个页面内容并通过 front-page.php 模板文件展示,如果没有这个模板文件,就会通过页面模板展示
    1. 如果没有静态首页,就会加载 home.php  
    1. 最新文章模板 如果没有 home.php 则加载 index.php模板

文章页

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

页面

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

分类页

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

标签页

    1. 标签页模板加载顺序和分类页一样,只不过前缀不过 category 而是 tag (如 tag-{slug}.php)。

自定义分类法

有时除了WordPress默认的分类目录和标签我们还需要其他的分类方法,这时我们就会注册一个新的分类法,那么在此之前知道分类法的模板加载顺序也是十分必要的。以下说明假设自定义分类法是 people 这个名字:

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

自定义文章类型

除了自定义分类法,有时候我们也需要自定义文章类型

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

作者归档页

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

日期归档页

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

搜索结果页

    1. 首先被考虑的是 search.php 搜索结果模板
    1. 如果没有搜索结果模板则加载 index.php模板

附件页

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

模板的加载方式已经介绍完毕,具体到实际应用还需要开发者实战才能体会到。


CodeBye 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权 , 转载请注明WordPress模板层次和加载模板文件的方式