Codex

Function Reference/is category

Languages: English • 日本語 • Русский • (Add your language)

Contents

Description

This Conditional Tag checks if a Category archive page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE.

To test if a post is in a category use in_category().

Usage

<?php is_category( $category ); ?>

Parameters

$category
(mixed) (optional) Category ID, Category Title, Category Slug or Array of IDs, names, and slugs.
Default: None

Return Values

(boolean) 
True on success, false on failure.

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 at Version 2.5.

Notes

Change Log

Since: 1.5.0

Source File

is_category() is located in wp-includes/query.php.

Related

Conditional Tags: comments_open(), is_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network(), is_plugin_inactive(), is_plugin_page(), is_post_type_archive(), is_preview(), is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed(), is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email exists(), post_type_exists(), taxonomy_exists(), term_exists(), username exists(), wp_attachment_is_image(), wp_script_is()

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/is_category"

Codex Resources