IS_CATEGORY() │ WP 1.5.0

Общее описание

Функция is_category() — это условный тег в WordPress. Она проверяет, отображается ли страница категории.

Эту функцию можно назвать логической, так как она возвращает true (истина), если условие выполнено, и false (ложь) — если нет.

Если задан параметр $category, функция дополнительно проверит, соответствует ли запрос одной из указанных категорий.

Для подробной информации об этой и других подобных функциях смотрите статью о Условных тегах в документации WordPress.

Использует: WP_Query::is_category()

Время выполнения

• 1 раз — 0.000013 сек (очень быстро)
• 50000 раз — 0.01 сек (скорость света)

PHP версия:

• 7.0.2, WP 4.4.1

Хуки:

• Нет.

Результат

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

Использование

if ( is_category( $category ) ) {
    // ваш код...
}

Параметр

• $category (строка/число/массив) — ID кате��ории, имя, слаг (виртуальное имя) или массив ID, имен и слагов категорий.
• По умолчанию: ''.

Примеры

is_category(); // возвращает true, если отображается любая страница категории.

is_category('9'); // возвращает true, если отображается страница категории с ID 9.

is_category(9); // то же самое, что и выше, идентификатор может быть числом.

is_category('Out there'); // возвращает true, если отображается категория с именем 'Out there'.

is_category('out-there'); // возвращает true, если отображается категория с слагом 'out-there'.

is_category(array(9, 'blue-cheese', 'Stinky Cheeses')); // возвращает true, если отображается категория с ID 9, именем 'blue-cheese' или слагом 'Stinky Cheeses'.

Заметки

• Глобальный объект WP_Query: $wp_query — это объект запроса WordPress.

История изменений

• С версии 1.5.0 — добавлена в WordPress.

Код функции

function is_category( $category = '' ) {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные теги не работают до выполнения запроса. До этого момента они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_category( $category );
}

Связанные функции с условными тегами

• is_404()
• is_admin()
• is_archive()
• is_attachment()
• is_author()
• is_single()
• is_tag()
• И многие другие...

Эти функции помогают проверять различные условия, чтобы сделать ваш сайт более динамичным и адаптивным.