如所讨论的，模板文件是模块化的，可重复使用的文件，用于在WordPress站点上生成网页。 一些模板文件（如页眉和页脚模板）用于所有网站的页面，而其他模板文件仅在特定条件下使用。 本文解释WordPress如何确定在单个页面上使用哪个模板文件。 如果要自定义现有的WordPress主题，它将帮助您确定需要编辑的模板文件。 >[warning] 提示：您还可以使用条件标签来控制在特定页面上加载哪些模板。 # 模板文件层次结构 ## 概述 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页面。  您也可以与[此图交互](https://wphierarchy.com)。 ## 模板层次详细 虽然模板层次结构更容易被理解为图表，但以下部分描述了WordPress为多种查询类型调用模板文件的顺序。 ## 主页显示 默认情况下，WordPress设置您的网站的主页以显示最新的博文。 这个页面被称为博客帖子索引。 您也可以将您的博客帖子设置为在单独的静态页面上显示。 模板文件home.php用于呈现博客帖子索引，无论是用作首页还是单独的静态页面。 如果home.php不存在，WordPress将使用index.php。 - home.php - index.php >[warning] 注意：如果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' ); ```