is_tax()

Функция is_tax() определяет, является ли текущая страница страницей архива кастомной таксономии (не категории или метки).

Параметры

• $taxonomy string|array
  Слаг или массив слагов кастомной таксономии.
  По умолчанию: ''
• $term int|string|array
  ID, имя или slug термина или их массив.
  По умолчанию: ''

is_tax( $taxonomy, $term );

Возвращает

bool true, если отображается архивная страница кастомной таксономии, false, если любая другая страница.

Данная функция всегда возвращает false на архивных страницах категорий (category) и меток (tag). Для определения этих страниц используйте функции is_category() и is_tag().

Дополнительная информация

1. Эта функция является условным тегом.
2. Без указания параметров возвращает true для любой архивной страницы кастомной таксономии.
3. Если указан параметр $taxonomy, вернет true только для архивных страниц терминов, относящихся к данной таксономии.
4. Если указан параметр $term, вернет true только для архивных страниц терминов указанных в данном параметре.

Примеры использования

Пример 1. Проверка, отображается ли архивная страница любой пользовательской таксономии

if( is_tax() ) {
    echo 'Страница пользовательской таксономии';
}

Пример 2. Проверка архивной страницы конкретной таксономии

// Проверка одной таксономии
if( is_tax( 'animal' ) ) {
    echo 'Вы на архивной странице таксономии animal';
}

// Проверка нескольких таксономий
if( is_tax( ['animal', 'fish'] ) ) {
    echo 'Вы на архивной странице таксономии animal или fish';
}

Пример 3. Проверка архивной страницы конкретного термина таксономии по названию или слагу

// Проверка по названию термина
if( is_tax( 'animal', 'Кошки' ) ) {
    echo 'Вы на архивной странице термина Кошки таксономии animal';
}

// Проверка по slug термина
if( is_tax( 'animal', 'dog' ) ) {
    echo 'Вы на архивной странице метки dog таксономии animal';
}

Пример 4. Проверка, является ли текущая страница архивной страницей одного из термина

// Проверка нескольких архивных страниц
if( is_tax( 'animal', [ 'Кошки', 'dog', 35 ] ) ) {
    echo 'Вы на архивной странице термина';
}

Данная конструкция проверит, является ли текущая страница архивной страницей термина пользовательской таксономии c названием Кошки или термина с ID=35 или термина со slug=dog. Если текущая страница подходит под одно из условий, то функция вернет true.

Хуки

Нет

Информация о функции