IS_TAX() – Функция для проверки произвольной таксономии в WordPress

# 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, имен и слагов терминов.

Примеры

  1. Проверка конкретного формата поста

    if ( is_tax( 'post_format' ) ) {
       // это страница архива для любого формата поста.
    }
    
    if ( is_tax( 'post_format', 'post-format-aside' ) ) {
       // это страница архива для формата поста "Aside".
    }
  2. Проверка на странице архива таксономии

    if ( is_tax() ) {
       // Выводим сообщение для пользовательской страницы архива таксономии.
    }
    
    if ( is_tax( 'channel' ) ) {
       // Выводим сообщение, если это страница архива для таксономии "channel".
    }
    
    if ( is_tax( 'channel', 'BBC1' ) ) {
       // Выводим сообщение для страницы архива 'channel' с термином 'BBC1'.
    }

Важные примечания

  • Эта функция полагается на глобальный объект $wp_query в WordPress.
  • Убедитесь, что функция не вызывается до выполнения основного за��роса, иначе она всегда вернет false.

Изменения

  • Функция была введена в версии 2.5.0.

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *