is_tag()

Функция is_tag() определяет, является ли текущая страница архивной страницей метки.

Параметры

  • $tag int|string|array
    ID, название или слаг метки или массив этих данных.
    По умолчанию: ''
is_tag( $tag );

Возвращает

bool true, если архивная страница метки, false, если любая другая страница.

Дополнительная информация

  1. Эта функция является условным тегом.
  2. При указании параметра, вернет true только для архивной страницы конкретной (конкретных – при массиве параметров) метки.

Примеры использования

Пример 1. Проверка, отображается ли архивная страница метки

if( is_tag() ) {
    echo 'Страница метки';
}

Пример 2. Проверка архивной страницы конкретной метки по ID

if( is_tag( 34 ) ) {
    echo 'Вы на архивной странице метки с ID=34';
}

Пример 3. Проверка архивной страницы конкретной метки по названию или слагу

// Проверка по названию метки
if( is_tag( 'WordPress' ) ) {
    echo 'Вы на архивной странице метки WordPress';
}

// Проверка по slug метки
if( is_tag( 'wordpress' ) ) {
    echo 'Вы на архивной странице метки WordPress';
}

Пример 4. Проверка, является ли текущая страница архивной страницей одной из меток

// Проверка нескольких архивных страниц
if( is_tag( [ 'WordPress', 34, 'news' ] ) ) {
    echo 'Вы на архивной странице метки';
}

Данная конструкция проверит, является ли текущая страница архивной страницей метки c названием WordPress или метки с ID=34 или метки со slug=news. Если текущая страница подходит под одно из условий, то функция вернет true.

Хуки

Нет

Информация о функции

Добавлена в версии 2.3.0

wp-includes/query.php

Исходный код в Github

 

Другие функции

is_time()

Определяет, является ли текущая страница архивной страницей за определенный час, минуту или секунду .

is_month()

Определяет, является ли текущая страница архивной страницей записей за месяц.

is_year()

Определяет, является ли текущая страница архивной страницей за определенный год.

is_date()

Определяет, является ли текущая страница архивной страницей по дате.

is_category()

Определяет, является ли текущая страница страницей категории.

is_tax()

Определяет, является ли текущая страница архивной страницей кастомной таксономии.

is_day()

Определяет, является ли текущая страница архивной страницей по дню.

post_type_archive_title()

Выводит или возвращает заголовок архивной страницы любого типа поста.

single_month_title()

Возвращает или выводит на экран заголовок архивной страницы по месяцам.

get_the_archive_title()

Возвращает заголовок любой архивной страницы.

the_archive_title()

Выводит на экран заголовок архивной страницы.

single_term_title()

Возвращает или выводит на экран заголовок текущего элемента таксономии на архивной странице.

single_tag_title()

Возвращает или выводит на экран заголовок текущей метки на архивной странице.

single_cat_title()

Возвращает или выводит на экран заголовок страницы архива категории.