Функция is_tag() — это условный тег в WordPress, который проверяет, является ли текущий запрос архивной страницей по меткам (тегам). Она возвращает значение true, если на экране отображается страница архива для одной или нескольких меток, и false, если это не так.
Также можно передать параметр в функцию, чтобы проверить конкретную метку по её ID, названию, или слагу (уникальному идентификатору в URL). Возможность проверки нескольких меток одновременно (с помощью массива) была добавлена в версии 3.7.
is_tag( int|string|int[]|string[] $tag = '' ): bool
Параметры
$tag(необязательно) — ID метки, её название, слаг (slug) или массив значений для проверки. Если параметр не указан, функция просто проверяет, является ли текущая страница архивом меток.
Возвращаемое значение
true— если текущий запрос соответствует архивной странице по меткам.false— если текущий запрос не относится к архиву меток.
Когда использовать
Функция is_tag() обычно используется в шаблонах тем, чтобы условно отображать контент на страницах архивов по меткам. Она полезна для настройки внешнего вида или логики отображения, когда пользователь просматривает записи, связанные с конкретными метками.
1. Проверка на любую страницу архива меток
Этот пример демонстрирует базовое использование функции, проверяющее, отображается ли сейчас страница архива по любой метке:
if ( is_tag() ) {
echo "Вы находитесь на странице архива меток!";
}
Если текущая страница — это архив меток, то будет выведено сообщение. Это полезно, если нужно изменить содержимое или стиль для всех страниц меток.
2. Проверка на архив конкретной метки по ID
Чтобы проверить, является ли текущая страница архивом для метки с определенным ID, можно использовать следующий код:
if ( is_tag( 42 ) ) {
echo "Вы просматриваете архив для метки с ID 42!";
}
В этом примере страница архива метки будет проверяться по её ID (42).
3. Проверка на архив по слагу метки
Вы также можете использовать слаг метки для проверки:
if ( is_tag( 'wordpress' ) ) {
echo "Это архив метки 'wordpress'!";
}
Здесь проверяется, отображается ли архив для метки со слагом 'wordpress'.
4. Проверка на метку по названию
Этот код демонстрирует проверку архива по названию метки:
if ( is_tag( 'Новости' ) ) {
echo "Это архив для метки 'Новости'!";
}
Функция вернёт true, если текущая страница — это архив метки с названием 'Новости'.
5. Проверка нескольких меток одновременно
Для проверки нескольких меток одновременно можно передать массив значений:
if ( is_tag( array( 30, 'wordpress', 'Новости' ) ) ) {
echo "Вы находитесь на архивной странице одной из меток: ID 30, слаг 'wordpress' или название 'Новости'.";
}
Этот код проверяет, является ли текущий запрос архивом для метки с ID 30, со слагом 'wordpress' или с названием 'Новости'. Если хоть одно из условий верно, функция вернёт true.
6. Условное отображение для страницы меток
Вы можете изменить стили или отображение для страниц архивов меток:
if ( is_tag() ) {
echo '<h2>Записи по метке:</h2>';
while ( have_posts() ) : the_post();
echo '<h3>' . get_the_title() . '</h3>';
the_excerpt();
endwhile;
}
Этот код выведет заголовок и список записей на страницах меток.
Заключение
Функция is_tag() предоставляет простой способ определить, отображается ли архив по меткам в WordPress. Она поддерживает гибкость в проверках, позволяя не только определить факт наличия архива меток, но и конкретные метки по ID, слагу или названию. Это полезный инструмент для настройки тем и управления отображением контента на страницах архивов по меткам.