Описание функции has_term()
Функция has_term() проверяет, назначен ли заданный термин (категория, метка и т.д.) для записи, страницы или пользовательского типа записи. Она полезна для условного отображения контента на основе присвоенных терминов.
Функция может использоваться в шаблонах, плагинах и других местах, где необходимо определить наличие термина у определенного объекта
Параметры
$term
Тип: mixed
Обязательный: Да
По умолчанию: null
Описание: Термин или массив терминов для проверки
Возможные значения:
0: Строка с именем термина
1: ID термина (число)
2: Массив строк или чисел
$tax
Тип: string
Обязательный: Нет
По умолчанию: ‘category’
Описание: Таксономия, к которой относится термин
Возможные значения:
0: ‘category’
1: ‘post_tag’
2: имя пользовательской таксономии
$object_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID объекта (записи), для которого проверяется наличие термина
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если термин назначен объекту, иначе false
Возможные значения:
• true — если термин найден
• false — если термин не найден
Примеры использования
Базовый пример проверки наличия категории ‘news’
$has_term = has_term('news', 'category');
// Вывод: true или false
some_function($has_term);
Проверяет, назначена ли категория ‘news’ записи
Проверка наличия категории ‘special’ для записи с ID 42
$post_id = 42;
if (has_term('special', 'category', $post_id)) {
echo 'Эта запись имеет специальную категорию';
}
Убедитесь, что ID существующей записи
Безопасность
Валидация входных данных: Функция проверяет, что переданные параметры являются допустимыми
Санитизация: Параметры обрабатываются внутри функции
Рекомендации: Используйте правильные типы данных для параметров, чтобы избежать неожиданных результатов
— Связанные функции
Получает термины для объекта
Проверяет наличие категории у записи
— Примечания
– Ограничения
Работает только с публичными терминами
– Частые проблемы
- Возвращает false, если термин не существует или не назначен объекту
- Ошибки при передаче неправильных типов данных
