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

Filters the path of the queried template by type.

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. This hook also applies to various types of files loaded as part of the Template Hierarchy.

Possible hook names include:

  • 404_template
  • archive_template
  • attachment_template
  • author_template
  • category_template
  • date_template
  • embed_template
  • frontpage_template
  • home_template
  • index_template
  • page_template
  • paged_template
  • privacypolicy_template
  • search_template
  • single_template
  • singular_template
  • tag_template
  • taxonomy_template

Parameters

$template

(string) Path to the template. See locate_template().

$type

(string) Sanitized filename without extension.

$templates

(string[]) A list of template candidates, in descending order of priority.

More Information

If you need more granular control over the template selection and loading system of WordPress, consider using template_include instead.

Source

File: wp-includes/template.php

View on Trac

Used By

Used By Description
wp-includes/template.php: get_query_template()

Retrieve path to a template

Changelog

Version Description
4.8.0 The $type and $templates parameters were added.
1.5.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/type_template