当前浏览：首页 / WordPress钩子 / {$type}_template_hierarchy

apply_filters( "{$type}_template_hierarchy", string[] $templates )

过滤检索要使用的模板时搜索的模板文件名列表

template more...

{$type}_template 按类型过滤查询模板的路径
{$type}_template_hierarchy 过滤检索要使用的模板时搜索的模板文件名列表
comments_template 过滤用于评论模板的主题模板文件的路径
comments_template() 加载在$file中指定的评论模板
get_attachment_template() 在当前或父模板中检索附件模板的路径
get_page_template_slug() 获取给定文章的特定模板文件名
get_page_template() 在当前或父模板中检索页面模板的路径
get_page_templates() 获取此主题中可用的页面模板
get_query_template() 检索模板的路径
get_template_directory_uri() 检索启用的主题的模板目录URI

type more...

{$type}_template 按类型过滤查询模板的路径
{$type}_template_hierarchy 过滤检索要使用的模板时搜索的模板文件名列表
add_{$meta_type}_meta 在添加特定类型的meta之前立即触发
add_{$meta_type}_metadata 短路添加特定类型的meta数据
add_post_type_support() 注册文章类型的某些功能的支持
added_{$meta_type}_meta 添加特定类型的meta后立即触发
comment_type() 显示当前评论的评论类型
delete_{$meta_type}_meta 在删除特定类型的meta数据之前立即触发
delete_{$meta_type}_metadata 删除特定类型的meta数据时短路其结果
deleted_{$meta_type}_meta 删除特定类型的meta数据后立即触发

描述

钩子名称的动态部分$type指的是要加载的文件的文件名 - 去除文件扩展名和任何非字母数字字符定界词。数组中的最后一个元素应始终是此查询类型的回退模板。

可能的挂钩名称包括：

404_template_hierarchy
archive_template_hierarchy
attachment_template_hierarchy
author_template_hierarchy
category_template_hierarchy
date_template_hierarchy
embed_template_hierarchy
frontpage_template_hierarchy
home_template_hierarchy
index_template_hierarchy
page_template_hierarchy
paged_template_hierarchy
privacypolicy_template_hierarchy
search_template_hierarchy
single_template_hierarchy
singular_template_hierarchy
tag_template_hierarchy
taxonomy_template_hierarchy

参数

$templates: (string[]) 按优先级降序排列的模板候选列表。

源码

查看源码官方文档

更新日志

版本	描述
4.7.0	开始引入