tag_template │ filter-hook │ WP 1.5.0

Filters the path of the queried template by type.

Usage

add_filter( 'tag_template', 'wp_kama_tag_template_filter', 10, 3 );

/**
 * Function for `tag_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_tag_template_filter( $template, $type, $templates ){

	// filter...
	return $template;
}

$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.

Changelog

Where the hook is called

return apply_filters( "{$type}_template", $template, $type, $templates );

Where the hook is used in WordPress