(type)_template хук-фильтрWP 1.5.0

Filters the path of the queried template by type.

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:

Использование

add_filter( '(type)_template', 'wp_kama_type_template_filter', 10, 3 );

/**
 * Function for `(type)_template` filter-hook.
 * 
 * @param string   $template  Path to the template. See locate_template().
 * @param string   $type      Sanitized filename without extension.
 * @param string[] $templates A list of template candidates, in descending order of priority.
 *
 * @return string
 */
function wp_kama_type_template_filter( $template, $type, $templates ){

	// filter...
	return $template;
}
$template(строка)
Path to the template. See locate_template().
$type(строка)
Sanitized filename without extension.
$templates(string[])
A list of template candidates, in descending order of priority.

Список изменений

С версии 1.5.0 Введена.
С версии 4.8.0 The $type and $templates parameters were added.

Где вызывается хук

get_query_template()
(type)_template
wp-includes/template.php 103
return apply_filters( "{$type}_template", $template, $type, $templates );

Где используется хук в WordPress

wp-includes/class-wp-customize-manager.php 682
add_filter( 'pre_option_template', array( $this, 'get_template' ) );
wp-includes/class-wp-customize-manager.php 720
remove_filter( 'pre_option_template', array( $this, 'get_template' ) );