WordPress的模板层次

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

万能的index.php

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

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

模板加载顺序

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

首页

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

文章页

首先被考虑的是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 模板

标签页

标签页模板加载顺序和分类页一样,只不过前缀不过 category 而是tag (如tag-{slug}.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 模板

搜索结果页

    首先被考虑的是 search.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)结构图。

1421995372_42

使用钩子修改模板

在某些使用场景(如插件),我们并不能直接修改模板文件,这时候我们可以使用钩子来实现修改模板文件,钩子名称是{$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() 则是判断文章页的条件标签,等等。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


我想将wordpress的默认接口路由改掉,愿意是默认的带一个 wp-json,我想换成 api,直接简单明了。默认路由https://www.xxzhuti.com/wp-json/wp/v2/posts/1新的路由https://www.xxzhuti.com/api/wp/v2/posts/1路由修改wordpress提供了一个钩子来修改 wp-json 的地址,代码入汛function r
wordpress自定义分类法之后,我看到链接都自动在后面添加了一个斜杠,如下图所示打开链接后都是先从一个链接301后到另外一个链接,我这个纳闷,然后一顿找原因,最后竟然是因为固定链接看我后台的固定链接是 /%post_id%/ 这么写的,然后每次都会301自动跳转。正确的写法是 /%post_id%.html 这样写才不会301跳转。一个小问题,往往一个小问题就会折腾好长时间,在这记录一下吧..
事情是这样的,我用 get_post_type 函数创建了一个自定义分类法类型,然后自定义了文件的访问路径代码如下。function tblog_chat_template( $template_path ){    if ( get_post_type() == 'aichat' ) {         if ( is_single() )         {             $temp
最近网站莫名其妙的被顶上了,过一个多小时,就注册一个账号,虽然不多,但是也挺烦,时间一长垃圾注册的就多了。由于我前台把注册关掉了,只允许用第三方登录,经过查找发现是通过后台注册的,后台无须邮箱验证即可注册,也是就想着在后台加个验证码。效果如下实现方法一将下面的代码加入到 function.php 中,刷新页面就会看到。//WordPress新用户注册随机数学验证码function add_s...
最近服务器要到期了,就想着把网站转移到另外一台服务器,本来打算要续费的,但是腾讯云的服务器有了新的规定,域名必须在腾讯云备案才能使用,在别的地方备案的域名需要转到腾讯云,在腾讯云在走一遍备案流程,若是备案简单,时间短也就无所谓了,就转一下,可是这个备案大家也知道,至少得一个月,于是就只能放弃腾讯云了,将站点转回备案的阿里云,以后就用阿里云了,贵点就贵点吧。这不网站迁移过去了,死活图片不显示,各..
今天在写wordpress的接口,然后碰到个奇怪的问题,怎么访问都提示 rest_no_route 的错误,然后就一直跟踪代码,终于找到原因所在。报错信息{'code': 'rest_no_route','message': '未找到匹配URL和请求方式的路由。','data': {'status': 404}}原因分析register_rest_route( string $namespace,
今天看到群友突然滴滴滴的找我QQ,好像出什么大事情一样。原来他由于误操作导致网站文章被删除。
今天遇到一个网友提示网站访问速度比较慢,然后通知日志看到有他的网站WordPress默认登录地址wp-login.php一直在被爬虫抓取,因为是有被破解后台账户信息,导致的占用数据库资源使得网站资源带宽不足后访问降低导致
今天老左在帮助客户升级WordPress的时候我看他网站也比较简单就直接在后台手工升级的。升级后打开网站有出现"There has been a critical error on your website."的错误提示。
我们在使用WordPress搭建的网站是否有留意查看源代码的时候看到标题中的原本"-",被转义成"&#8211"。其实这样并不影响用户阅读体验和搜索引擎,搜索引擎在收录后也会反向转义的。就是感觉看
WordPress默认是无法上传.webp格式的文件,如果要上传需要对上传文件限制进行解除后才能上传。
GTranslate 是一个流行的翻译插件,在免费和付费版本中提供不同的体验。 使用免费版本,您可以轻松提供任何语言的动态翻译,而付费版本提供可索引、可编辑的翻译版本,就像 Weglot 一样。
时下主流的浏览器都自带了广告屏蔽功能,还有ADSafe、ADB等软件插件,不断更新,屏蔽网站代码!
您是否正在寻找可用于显示数据的 WordPress 表格插件? WordPress 表格插件可让您以表格格式存储和呈现数据,以方便访问者阅读。
wordPress数据库除了本身的表以外,部分插件会增加表来存储数据。如果插件已经删除了,这些插件生成的表还在数据库中,那么怎么删除呢?
WordPress几乎是世界上最安全的开源程序,但其后台登录注册的地址始终是众所周知的,所以不少人觉得隐藏WordPress的登录地址后可能会更加安全。下面浩子就针对这个问题来简单说明一下方法。WordPress隐藏后台登录地址
自 WordPress 5.8 正式版发布 以后,后台的小工具就默认是块编辑器的界面样式,很多老用户还没有来得及学习就一脸茫然了,今天浩子就来教大家如何恢复WordPress经典小工具。
您想用您的语言翻译 WordPress 插件吗?许多 WordPress 插件是完全可翻译的,世界上任何人都可以轻松翻译。在本文中,我们将向您展示如何轻松地将 WordPress 插件翻译成您的语言(无需任何代码)。
WordPress新手不清楚WordPress调试模式怎么开启,今天来教大家认识和开启。什么是WordPress的调试模式
最近不少用户反馈说WordPress后台的外观-自定义点开后直接报错,错误信息如下: