Question

is_category( mixed $category = '' )

Is the query for an existing category archive page?

---

description

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

---

参数

$category

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

Default value: ''

---

返回值

(bool)

---

源代码

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

---

更新日志

Version	description
1.5.0	Introduced.

---

More Information

• See also is_archive() and Category Templates.
• For Custom Taxonomies use is_tax()

---

相关函数

Uses

• wp-includes/l10n.php: __()
• wp-includes/class-wp-query.php: WP_Query::is_category()
• wp-includes/functions.php: _doing_it_wrong()

---

Used By

• wp-includes/general-template.php: wp_get_document_title()
• wp-includes/general-template.php: get_the_archive_title()
• wp-includes/category-template.php: term_description()
• wp-includes/category-template.php: wp_dropdown_categories()
• wp-includes/category-template.php: wp_list_categories()
• wp-includes/general-template.php: feed_links_extra()
• wp-includes/general-template.php: wp_title()
• wp-includes/general-template.php: single_term_title()
• wp-includes/class-wp.php: WP::handle_404()
• wp-includes/post-template.php: get_body_class()
• wp-includes/canonical.php: redirect_canonical()
Show 6 more used by Hide more used by

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note Contributed by Codex

   Examples

   
   is_category();
   // When any Category archive page is being displayed.
   
   is_category( '9' );
   // When the archive page for Category 9 is being displayed.
   
   is_category( 'Stinky Cheeses' );
   // When the archive page for the Category with Name "Stinky Cheeses" is being displayed.
   
   is_category( 'blue-cheese' );
   // When the archive page for the Category with Category Slug "blue-cheese" is being displayed.
   
   is_category( array( 9, 'blue-cheese', 'Stinky Cheeses' ) );
   // Returns true when the category of posts being displayed is either term_ID 9,
   // or slug "blue-cheese", or name "Stinky Cheeses".
   // Note: the array ability was added in version 2.5.