WordPress中文开发手册

  1. Home
  2. Docs
  3. WordPress中文开发手册
  4. WordPress主题开发
  5. WordPress主题基础
  6. 模板层级

模板层级

如所讨论的,模板文件是模块化的,可重复使用的文件,用于在WordPress站点上生成网页。 一些模板文件(如页眉和页脚模板)用于所有网站的页面,而其他模板文件仅在特定条件下使用。

本文解释WordPress如何确定在单个页面上使用哪个模板文件。 如果要自定义现有的WordPress主题,它将帮助您确定需要编辑的模板文件。

提示:您还可以使用条件标签来控制在特定页面上加载哪些模板。

模板文件层次结构

概述

WordPress使用查询字符串来决定哪个模板或一组模板应用于显示页面。查询字符串是指向您网站每个部分的链接中的信息。它来自初始问号,可能包含多个由&符号分隔的参数。

简单地说,WordPress通过模板层次结构搜索,直到找到匹配的模板文件。要确定使用哪个模板文件,WordPress:

  • 将每个查询字符串匹配到查询类型以确定正在请求哪个页面(例如,搜索页面,类别页面等);
  • 按照模板层次结构确定的顺序选择模板;
  • 在当前主题的目录中查找具有特定名称的模板文件,并使用层次结构指定的第一个匹配的模板文件。
  • 除了基本的index.php模板文件外,您可以选择是否要实现特定的模板文件。

如果WordPress找不到具有匹配名称的模板文件,它将跳到层次结构中的下一个文件。如果WordPress找不到任何匹配的模板文件,将使用主题的index.php文件。

示例

如果您的博客位于http://example.com/blog/ ,访问者点击链接到类别页面(例如http://example.com/blog/category/your-cat/) ,WordPress会查找模板 在当前主题的目录中匹配类别的ID以生成正确的页面。 更具体地说,WordPress遵循以下过程:

  • 在当前主题的目录中查找与该类别的插件匹配的模板文件。 如果类别slug是“unicorns”,则WordPress会查找名为category-unicorns.php的模板文件。
  • 如果category-unicorns.php缺少且类别的ID为4,则WordPress将查找名为category-4.php的模板文件。
  • 如果缺少类别4.php,WordPress将寻找一个通用类别模板文件category.php。
  • 如果category.php不存在,WordPress将寻找一个通用归档模板archive.php。
  • 如果archive.php也丢失,WordPress将回到主题模板文件index.php。

视觉概述

下图显示了哪些模板文件被调用以基于WordPress模板层次结构生成WordPress页面。

您也可以与此图交互。

模板层次详细

虽然模板层次结构更容易被理解为图表,但以下部分描述了WordPress为多种查询类型调用模板文件的顺序。

主页显示

默认情况下,WordPress设置您的网站的主页以显示最新的博文。 这个页面被称为博客帖子索引。 您也可以将您的博客帖子设置为在单独的静态页面上显示。 模板文件home.php用于呈现博客帖子索引,无论是用作首页还是单独的静态页面。 如果home.php不存在,WordPress将使用index.php。

  • home.php
  • index.php

注意:如果front-page.php存在,它将覆盖home.php模板。

首页

front-page.php模板文件用于呈现您网站的首页,首页是否显示博客帖子索引(如上所述)或静态页面。 首页模板优先于博客帖子索引(home.php)模板。 如果front-page.php文件不存在,WordPress将根据设置→阅读中的设置使用home.php或page.php文件。 如果这两个文件都不存在,它将使用index.php文件。

  • front-page.php - 用于首页显示设置→阅读部分中的“您的最新帖子”或“静态页面”。
  • home.php - 如果WordPress找不到front-page.php和“你的最新帖子”设置在首页显示部分,它将寻找home.php。 此外,当在首页显示部分中设置帖子页面时,WordPress将查找此文件。
  • page.php - 在首页显示部分设置“首页”时。
  • index.php - 在首页显示部分设置“您的最新帖子”,但home.php不存在或者当首页设置但page.php不存在时。

正如你所看到的,WordPress所采用的路径有很多规则。 使用上面的图表是确定WordPress将显示的最佳方式。

单页内容

单页内容模板文件用于呈现单页内容。 WordPress使用以下路径:

  • single-{post-type} - {slug} .php - (从4.4开始)首先,WordPress寻找特定内容的模板。 例如,如果内容类型是产品,并且post slug是dmc-12,则WordPress会查找单个产品dmc-12.php。
  • single- {post-type} .php - 如果帖子类型是产品,WordPress将寻找单一product.php。
  • single.php - WordPress然后回到single.php。
  • singular.php - 然后它回到singular.php。
  • index.php - 最后,如上所述,WordPress最终会回到index.php。

单页

用于呈现静态页面的模板文件(页面后置类型)。 请注意,与其他后期类型不同,页面特别适用于WordPress,并使用以下修补程序:

自定义模板文件 - 分配给页面的页面模板。 请参阅get_page_templates()。

  • page- {slug} .php - 如果该页面是最新消息,WordPress将会使用page-recent-news.php。
  • page- {id} .php - 如果页面ID为6,WordPress将使用page-6.php。
  • page.php
  • singular.php
  • index.php

类别

渲染类别归档索引页在WordPress中使用以下路径:

  • category- {slug} .php - 如果类别的lug lug是新闻,WordPress将会查找category-news.php。
  • category- {id} .php - 如果类别的ID为6,WordPress将寻找类别为6.php。
  • category.php
  • archive.php
  • index.php

标签

要显示标签归档索引页面,WordPress使用以下路径:

  • tag- {slug} .php - 如果标签的插件是某个标签,WordPress将会查找tag-sometag.php。
  • tag- {id} .php - 如果标签的ID为6,WordPress将寻找标签6.php。
  • tag.php
  • archive.php
  • index.php

自定义分类

自定义分类使用稍微不同的模板文件路径:

  • taxonomy-{taxonomy}-{term}.php – 如果分类是某种类型,而分类学术语是某种语言,则WordPress将寻找分类法。 在发布格式的情况下,分类是“post_format”,术语是“post-format- {format}”。 即链接后期格式的taxonomy-post_format-post-format-link.php。
  • taxonomy-{taxonomy}.php – 如果分类是多数,WordPress会寻找分类法 - sometax.php。
  • taxonomy.php
  • archive.php
  • index.php

自定义内容类型

自定义帖子类型使用以下路径呈现相应的归档索引页面。

  • archive- {post_type} .php - 如果帖子类型是产品,WordPress将寻找archive-product.php。
  • archive.php
  • index.php

(要渲染单个帖子类型模板,请参阅上面的单个帖子显示部分。)

作者显示

基于上述示例,渲染作者存档索引页面是相当明确的:

  • author- {nicename} .php - 如果作者的漂亮的名字是哑光,WordPress将寻找author-matt.php。
  • author- {id} .php - 如果作者的ID为6,WordPress将寻找author-6.php。
  • author.php
  • archive.php
  • index.php

日期

基于日期的归档索引页面按照您预期的方式呈现:

  • date.php
  • archive.php
  • index.php

搜索结果

搜索结果遵循与其他模板类型相同的模式:

  • search.php
  • index.php

404(找不到)

同样,404模板文件按以下顺序调用:

  • 404.php
  • index.php

附件

渲染附件页面(附件类型)需要遵循以下路径:

  • MIME_type.php - 它可以是任何MIME类型(例如:image.php,video.php,application.php)。 对于text / plain,使用以下路径(顺序):
  • text_plain.php
  • plain.php
  • text.php
  • attachment.php
  • single-attachment.php
  • single.php
  • index.php

嵌入模板

嵌入模板文件用于渲染正在嵌入的帖子。 自4.5以来,WordPress使用以下路径:

  • embed- {post-type} - {post_format} .php - 首先,WordPress寻找特定帖子的模板。 例如,如果其帖子类型是产品,并且具有音频格式,则WordPress将寻找embed-product-audio.php。
  • embed- {post-type} .php - 如果帖子类型是汽车,WordPress会寻找embed-car.php。
  • embed.php - WordPress然后回到embed.php。
  • 最后,WordPress最终还是回到wp-includes/theme-compat/embed.php

过滤层次结构

WordPress模板系统允许您过滤层次结构。 这意味着您可以在层次结构的特定点插入和更改东西。 过滤器(位于get_query_template()函数中)使用此过滤器名称:“{$ type} _template”其中$ type是没有.php扩展名的层次结构中的文件名。

以下是过滤器层次结构中所有模板类型的完整列表:

  • 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
  • embed_template

示例

例如,让我们采用默认的作者层次结构:

  • author-{nicename}.php
  • author-{id}.php
  • author.php

要在author.php之前添加author- {role} .php,我们可以使用'author_template'模板类型来操作实际的层次结构。 这允许对/ author/username的请求,其中username具有编辑器的作用,使用author-editor.php(如果存在于当前主题目录中)显示。

function author_role_template( $templates = '' ) {
    $author = get_queried_object();
    $role = $author->roles[0];
 
    if ( ! is_array( $templates ) && ! empty( $templates ) ) {
        $templates = locate_template( array( "author-$role.php", $templates ), false );
    } elseif ( empty( $templates ) ) {
        $templates = locate_template( "author-$role.php", false );
    } else {
        $new_template = locate_template( array( "author-$role.php" ) );
        if ( ! empty( $new_template ) ) {
            array_unshift( $templates, $new_template );
        }
    }
 
    return $templates;
}
add_filter( 'author_template', 'author_role_template' );
Tags ,