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