Описание функции is_tax()
Функция is_tax() проверяет, является ли текущая страница архивом для заданной таксономии и ее термина. Она полезна для настройки вывода контента, в зависимости от того, на какой странице находится пользователь.
Это позволяет разработчикам тем и плагинов адаптировать поведение в зависимости от контекста таксономий.
Параметры
$tax
Тип: string|array
Обязательный: Нет
По умолчанию: null
Описание: Имя таксономии или массив таксономий, которые нужно проверить
Возможные значения:
string: Имя таксономии (например, ‘category’, ‘post_tag’)
array: Массив имен таксономий для проверки
$term
Тип: string|int
Обязательный: Нет
По умолчанию: null
Описание: Имя или ID термина, который нужно проверить
Возможные значения:
string: Слаг термина (например, ‘news’)
int: ID термина
Возвращаемое значение
Тип: bool
Описание: Возвращает true или false в зависимости от проверки
Возможные значения:
• true — если текущая страница соответствует заданной таксономии и термину
• false — если не соответствует
Примеры использования
Базовый пример проверки на архив категории
if (is_tax('category')) {
echo 'Это архив категории';
}
Выводится сообщение, если на текущей странице архив категории
Проверка на архив категории с конкретным термином
if (is_tax('category', 'news')) {
echo 'Это архив категории новостей';
}
Выводится сообщение, если на текущей странице архив категории новостей
Проверка существования таксономии перед выполнением кода
if (is_tax('nonexistent_tax')) {
// ничего не делает, так как таксономия не существует
} else {
echo 'Таксономия не найдена';
}
Избегает выполнения кода, если таксономия не существует
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте правильные имена таксономий и термина для избежания ошибок
— Связанные функции
Проверяет, является ли текущая страница архивом категории
Проверяет, является ли текущая страница архивом меток
— Примечания
– Ограничения
Не работает с пользовательскими таксономиями, если они не зарегистрированы
– Частые проблемы
- Проблемы при проверке несуществующих таксономий или терминов
- Неверное поведение при использовании в неправильных контекстах
