## IS_TAG() │ WP 2.3.0
### Что такое IS_TAG()?
Функция is_tag() в WordPress используется для проверки, является ли текущая страница архивом существующей метки (тега). Если вы укажете параметр $tag, эта функция также проверит, совпадает ли текущая метка с одной из указанных.
### Возвращаемое значение
Функция возвращает:
- true, если текущая страница — архив тега
- false, если это не так
### Использование функции
```php
is_tag( $tag );
Параметры
$tag(int | string | int[] | string[]): ID метки, имя, слаг (URL-формат) или массив таких значений для проверки.- По умолчанию:
''(пустая строка)
Примеры использования
Пример 1: Проверка для любой метки
is_tag();
// Возвращает true, если показывается любая страница архива меток.
Пример 2: Проверка по ID метки
is_tag( '30' );
// Возвращает true, если показывается страница с меткой ID 30.
Пример 3: Проверка по слагу метки
is_tag( 'metka' );
// Возвращает true, если показывается страница с меткой 'metka'.
Пример 4: Проверка по имени метки
is_tag( 'Tag' );
// Возвращает true, если показывается страница с именем метки 'Tag'.
Пример 5: Проверка по списку меток
is_tag( [ 30, 'metka', 'Tag' ] );
// Возвращает true, если показывается страница с постами с метками,
// которые имеют ID 30, слаг 'metka' или имя 'Tag'.
Примечания
- Глобальная переменная:
$wp_query— объект запроса WordPress. Убедитесь, что функция вызывается после инициализации запроса, иначе она всегда будет возвращатьfalse.
Изменения
- С версии 2.3.0: Функция была впервые введена.
Код функции
Функция is_tag() реализована следующим образом:
function is_tag( $tag = '' ) {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Условные теги не работают до выполнения запроса. До этого момента они всегда возвращают false.' ), '3.1.0' );
return false;
}
return $wp_query->is_tag( $tag );
}
Связанные функции
Существует множество других условных тегов, которые могут быть полезны:
is_404()is_admin()is_archive()is_category()is_single()
Эти функции помогут вам проверить различные условия и типы страниц в WordPress, улучшая взаимодействие с вашим сайтом.