функция
since 2.5.0
get_taxonomy_template()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_taxonomy_template(): stringОписание
Русский перевод этого описания пока проверяется. Показан оригинал.
The hierarchy for this template looks like:
- taxonomy-{taxonomy_slug}-{term_slug}.php
- taxonomy-{taxonomy_slug}-{term_id}.php
- taxonomy-{taxonomy_slug}.php
- taxonomy.php
An example of this is:
- taxonomy-location-texas.php
- taxonomy-location-67.php
- taxonomy-location.php
- taxonomy.php
The template hierarchy and template path are filterable via the ‘$type_template_hierarchy’ and ‘$type_template’ dynamic hooks, where $type is ‘taxonomy’.
Возвращаемое значение
string
Исходный код
wp-includes/template.php:349
function get_taxonomy_template() {
$term = get_queried_object();
$templates = array();
if ( ! empty( $term->slug ) ) {
$taxonomy = $term->taxonomy;
$slug_decoded = urldecode( $term->slug );
if ( $slug_decoded !== $term->slug ) {
$templates[] = "taxonomy-$taxonomy-{$slug_decoded}.php";
}
$templates[] = "taxonomy-$taxonomy-{$term->slug}.php";
$templates[] = "taxonomy-$taxonomy-{$term->term_id}.php";
$templates[] = "taxonomy-$taxonomy.php";
}
$templates[] = 'taxonomy.php';
return get_query_template( 'taxonomy', $templates );
}История изменений
| Версия | Описание |
|---|---|
| 6.9.0 | Added taxonomy-{taxonomy_slug}-{term_id}.php to the hierarchy. |
| 4.7.0 | The decoded form of taxonomy-{taxonomy_slug}-{term_slug}.php was added to the top of the template hierarchy when the term slug contains multibyte characters. |
| 2.5.0 | Introduced. |
