WP_Query::is_category() │ public │ WP 3.1.0

Is the query for an existing category archive page?

If the $category parameter is specified, this function will additionally check if the query is for one of the categories specified.

Метод класса: WP_Query{}

Хуков нет.

Возвращает

true|false. Whether the query is for an existing category archive page.

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

global $wp_query;
$wp_query->is_category( $category );

$category(int|строка|int[]|string[])

Category ID, name, slug, or array of such to check against.
По умолчанию: ''

Список изменений

Код WP_Query::is_category() WP Query::is category ^{WP 6.1.1}

public function is_category( $category = '' ) {
	if ( ! $this->is_category ) {
		return false;
	}

	if ( empty( $category ) ) {
		return true;
	}

	$cat_obj = $this->get_queried_object();
	if ( ! $cat_obj ) {
		return false;
	}

	$category = array_map( 'strval', (array) $category );

	if ( in_array( (string) $cat_obj->term_id, $category, true ) ) {
		return true;
	} elseif ( in_array( $cat_obj->name, $category, true ) ) {
		return true;
	} elseif ( in_array( $cat_obj->slug, $category, true ) ) {
		return true;
	}

	return false;
}