# get_taxonomy_template()

URL: https://chugunov.pro/api-wordpress/functions/get_taxonomy_template/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.0.

## Сигнатура

```php
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’](https://developer.wordpress.org/reference/hooks/type_template_hierarchy/) and [‘$type_template’](https://developer.wordpress.org/reference/hooks/type_template/) dynamic hooks, where `$type` is ‘taxonomy’.[See also](#see-also)
- [get_query_template()](https://developer.wordpress.org/reference/functions/get_query_template/)

## Возвращаемое значение

`string`

## Исходный код

Файл: `wp-includes/template.php:349`

```php
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.

## Связанные

Использует: [`get_queried_object`](https://chugunov.pro/api-wordpress/functions/get_queried_object/), [`get_query_template`](https://chugunov.pro/api-wordpress/functions/get_query_template/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_taxonomy_template/