{$type}_template_hierarchy WordPress Filter Hook
The {$type}_template_hierarchy hook is used to specify the template hierarchy for a given post type. This hook is fired for every post type, both public and private, during the template_include action.
apply_filters( "{$type}_template_hierarchy", string[] $templates ) #
Filters the list of template filenames that are searched for when retrieving a template to use.
Description
The dynamic portion of the hook name, $type, refers to the filename — minus the file extension and any non-alphanumeric characters delimiting words — of the file to load. The last element in the array should always be the fallback template for this query type.
Possible hook names include:
404_template_hierarchyarchive_template_hierarchyattachment_template_hierarchyauthor_template_hierarchycategory_template_hierarchydate_template_hierarchyembed_template_hierarchyfrontpage_template_hierarchyhome_template_hierarchyindex_template_hierarchypage_template_hierarchypaged_template_hierarchyprivacypolicy_template_hierarchysearch_template_hierarchysingle_template_hierarchysingular_template_hierarchytag_template_hierarchytaxonomy_template_hierarchy
Parameters
- $templates
(string[])A list of template candidates, in descending order of priority.
Source
File: wp-includes/template.php
Changelog
| Version | Description |
|---|---|
| 4.7.0 | Introduced. |