is_category()

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

Параметры

  • $category int|string|array
    ID, имя или slug категории или их массив.
    По умолчанию: '' 
is_category( $category );

Возвращает

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

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

  1. Эта функция является условным тегом.
  2. Без указания параметров возвращает true для любой архивной страницы категории.
  3. Если указан параметр $category, вернет true только для тех категории, которые указаны в параметре.
  4. Для определения страницы пользовательской таксономии или страницы метки используйте функции is_tax() и is_tag().

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

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

if( is_category() ) {
    echo 'Страница категории';
}

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

// Проверка одной категории
if( is_category( 'news' ) ) {
    echo 'Вы на странице категории news';
}

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

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

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

// Проверка по ID категории
if( is_category( 15 ) ) {
    echo 'Вы на архивной странице категории ID=15';
}

Хуки

Нет

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

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

wp-includes/query.php

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

 

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

is_time()

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

is_month()

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

is_year()

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

is_date()

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

is_tax()

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

is_tag()

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

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()

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