WordPress模板开发层次详细介绍

30次阅读
2024年09月12日 09:22:41

共计 3055 个字符,预计需要花费 8 分钟才能阅读完成。

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

万能的index.php

我们知道一个最简单的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默认的分类目录和标签我们还需要其它的分类方法,这时候我们就会注册一个新的分类法,那么在此之前知道分类法的模板加载顺序也是十分必要的。以下说明假设自定义分类法是 seo 这个名字:

  • 分类法分类页首先被考虑的是 taxonomy-{taxonomy}-{term}.php 别名模板(如分类别名 teacher 对应的文件名就是 taxonomy-seo-teacher.php )
  • 如果没有别名模板,则加载该分类法归档页(如 taxonomy-seo.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的模板层次结构图。

WordPress模板开发层次详细介绍

使用钩子修改模板

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

正文完
 0
鹿泽
版权声明:本站原创文章,本文由 鹿泽 于 2024年9月12日 09:22:41 发表,共计 3055 字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
本站所有文章,如无特殊说明或标注,均为本站原创发布。任何在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。
如若本站内容侵犯了原著者的合法权益,可联系我们邮箱:526009505@qq.com进行处理。
最新文章
网站优化seo推广服务如何做好内链?

网站优化seo推广服务如何做好内链?

在一个网站刚刚建设的初期,网站内链的建设工作尤为重要,可以说网站内链做得好SEO就成功了一半。今天就来讲讲网站...
WordPress博客主题二次元风-lolimeow主题更新10.1版,重构样式

WordPress博客主题二次元风-lolimeow主题更新10.1版,重构样式

一个WordPress博客主题二次元风主题,本站之前启用过,后面更换了,不过很好看,适合大家选择使用: 202...
专业优化公司seo是怎么做好404页面的?

专业优化公司seo是怎么做好404页面的?

404页面的目的是:告诉浏览者其所请求的页面不存在或链接错误,同时引导用户使用网站其它页面而不是关闭窗口离开。...
网站搜索优化seo如何做好内部链接优化?

网站搜索优化seo如何做好内部链接优化?

网站内部链接的布局很多做SEO的朋友都知道,非常重要。网站想做的越大,就要更加重视内部链接的布局。因为良好的内...
影响关键词优化根本的排序因素

影响关键词优化根本的排序因素

对于像百度搜索来说,并没有排序这一说法,搜索引擎认为排序是在特定的关键词下网站内容的位置,而关键词是由用户搜索...