WP_Query::is_category( mixed $category = '' )

Is the query for an existing category archive page?

Description Description

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

Parameters Parameters


(mixed) (Optional) Category ID, name, slug, or array of Category IDs, names, and slugs.

Default value: ''

Top ↑

Return Return


Top ↑

Source Source

File: wp-includes/class-wp-query.php

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

		if ( empty($category) )
			return true;

		$cat_obj = $this->get_queried_object();

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

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

		return false;

Top ↑

Changelog Changelog

Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.