WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

is_category() WP 1.5.0

Проверяет показывается ли страница категорий или нет. Условный тэг.

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(array(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() WP 5.5.1

wp-includes/query.php
<?php
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 );
}

Cвязанные функции

Из метки: Условные теги (типов страниц и запросов)

Еще из метки: Условные теги (все)

Еще из раздела: Запросы

Еще из тегов шаблона: Основные

9 комментов