is_category()
Проверяет показывается ли страница категории или нет. Условный тэг.
Представляет собой логическую функцию, т.е. возвращает правду (true), если условие совпадает и ложь (false), если не совпадает.
Работает на основе: 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, названий или ярлыков.
По умолчанию: ''
Примеры
#1 Пример разного рода проверок:
is_category(); // функция вернет true, если показывается любая страница категорий. is_category('9'); // true, если показана страница категории с ID 9. is_category('Выход есть'); // true, если показана категория с названием 'Выход есть'. is_category('vihod-est'); // true, если показана категория с названием 'vihod-est'. is_category( [ 9, 'blue-cheese', 'Stinky Cheeses' ] ); // Вернет true, если показана категория с ID 9 или с названием // 'blue-cheese', или со слагом 'Stinky Cheeses'.
Заметки
- Global. WP_Query. $wp_query WordPress Query object.
Список изменений
С версии 1.5.0 | Введена. |
Код is_category() is category WP 6.4.3
function is_category( $category = '' ) { global $wp_query; if ( ! isset( $wp_query ) ) { _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' ); return false; } return $wp_query->is_category( $category ); }