get_tag_template() WordPress Function
The get_tag_template() function is used to retrieve the path of the template file for displaying a tag archive. This function is located in the WordPress core (include/template.php) and is not meant to be called directly.
get_tag_template() #
Retrieve path of tag template in current or parent template.
Description
The hierarchy for this template looks like:
- tag-{slug}.php
- tag-{id}.php
- tag.php
An example of this is:
- tag-wordpress.php
- tag-3.php
- tag.php
The template hierarchy and template path are filterable via the ‘$type_template_hierarchy’ and ‘$type_template’ dynamic hooks, where $type is ‘tag’.
See also
Return
(string) Full path to tag template file.
Source
File: wp-includes/template.php
function get_tag_template() {
$tag = get_queried_object();
$templates = array();
if ( ! empty( $tag->slug ) ) {
$slug_decoded = urldecode( $tag->slug );
if ( $slug_decoded !== $tag->slug ) {
$templates[] = "tag-{$slug_decoded}.php";
}
$templates[] = "tag-{$tag->slug}.php";
$templates[] = "tag-{$tag->term_id}.php";
}
$templates[] = 'tag.php';
return get_query_template( 'tag', $templates );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 4.7.0 | The decoded form of tag-{slug}.php was added to the top of the template hierarchy when the tag slug contains multibyte characters. |
| 2.3.0 | Introduced. |