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.5.2
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 );
}