Описание функции has_tag()
Функция has_tag() проверяет, имеет ли текущая запись указанный тег. Она используется в основном в шаблонах тем и плагинов для условной логики, позволяя выполнять разные действия в зависимости от наличия тегов у записи. Это позволяет динамически изменять вывод контента в зависимости от меток.
Функция полезна для создания более целевых и персонализированных интерфейсов для пользователей
Параметры
$tag
Тип: mixed
Обязательный: Нет
По умолчанию: null
Описание: Тег или массив тегов для проверки
Возможные значения:
string: Название тега
array: Массив названий тегов
int: ID тега
$post_id
Тип: int
Обязательный: Нет
По умолчанию: null
Описание: ID записи для проверки. Если не указан, используется текущий пост
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если тег присутствует, иначе false
Возможные значения:
• true — если тег найден
• false — если тег не найден
Примеры использования
Базовый пример проверки наличия тега ‘news’
if (has_tag('news')) {
echo 'Эта запись относится к новостям';
}
Выводит сообщение, если тег ‘news’ присутствует
Проверка наличия хотя бы одного из тегов из массива
if (has_tag(array('news', 'updates'))) {
echo 'Эта запись содержит теги новостей или обновлений';
}
Сообщение выводится, если хотя бы один тег найден
Безопасность
Валидация входных данных: Функция проверяет корректность переданных параметров
Санитизация: Входные параметры автоматически очищаются WordPress
Рекомендации: Для вывода данных используйте esc_html() для защиты от XSS
— Связанные функции
Получает теги текущей записи
Проверяет наличие категории у записи
— Хуки
Фильтрует результат проверки наличия тега
— Примечания
– Ограничения
Не работает для таксономий, отличных от тегов
– Частые проблемы
- Возвращает false, если тег не существует или неправильно указан
- Проблемы могут возникнуть при использовании с кастомными таксономиями
