# IS_TAX() - Функция для проверки произвольной таксономии в WordPress
Функция is_tax()
появилась в версии WordPress 2.5.0 и используется для проверки, находимся ли мы на странице архива определенной произвольной таксономии (категории).
## Что такое таксономия?
Таксономия в WordPress — это способ классификации контента. По сути, это группы, такие как категории и метки, которые позволяют организовать посты.
## Как работает is_tax()
?
Функция возвращает true
, если:
- Зарегистрирована новая таксономия.
- Пользователь находится на странице элемента этой таксономии (например, странице с постами определенной категории).
Примечание: is_tax()
работает только с новыми произвольными таксономиями и не заменяет функции is_category()
и is_tag()
. Эта функция вернет false
на страницах стандартных таксономий, таких как категория или метка.
### Возвращаемые значения
Функция возвращает false
, если таксономия не видима на фронтэнде. Это происходит, если при регистрации таксономии установлен параметр query_var = false
.
Если вы передадите параметр $taxonomy
, функция дополнительно проверит, соответствует ли запрос указанной таксономии.
Если вы также укажете параметр $term
, функция проверит, соответствует ли запрос одному из указанных терминов.
### Пример использования
```php
if ( is_tax( 'taxonomy_name', 'term_name' ) ) {
// код, выполняемый если мы находимся на странице архива данной таксономии
}
Параметры функции
- $taxonomy (строка/массив) — Слаг (уникальное имя) таксономии. Можно передать несколько таксономий в виде массива.
- $term (число/строка/массив) — ID, имя, слаг термина или массив ID, имен и слагов терминов.
Примеры
-
Проверка конкретного формата поста
if ( is_tax( 'post_format' ) ) { // это страница архива для любого формата поста. } if ( is_tax( 'post_format', 'post-format-aside' ) ) { // это страница архива для формата поста "Aside". }
-
Проверка на странице архива таксономии
if ( is_tax() ) { // Выводим сообщение для пользовательской страницы архива таксономии. } if ( is_tax( 'channel' ) ) { // Выводим сообщение, если это страница архива для таксономии "channel". } if ( is_tax( 'channel', 'BBC1' ) ) { // Выводим сообщение для страницы архива 'channel' с термином 'BBC1'. }
Важные примечания
- Эта функция полагается на глобальный объект
$wp_query
в WordPress. - Убедитесь, что функция не вызывается до выполнения основного за��роса, иначе она всегда вернет
false
.
Изменения
- Функция была введена в версии 2.5.0.