is_category

Is the query for an existing category archive page?.

Description

is_category( (string) $category = '' ); 

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

Parameters (1)

0. $category — Optional. (string) => ''
Category ID, name, slug, or array of Category IDs, names, and slugs.

Usage

  1. if ( !function_exists( 'is_category' ) ) { 
  2. require_once ABSPATH . WPINC . '/query.php'; 
  3.  
  4. // Optional. Category ID, name, slug, or array of Category IDs, names, and slugs. 
  5. $category = ''; 
  6.  
  7. // NOTICE! Understand what this does before running. 
  8. $result = is_category($category); 
  9.  

Defined (1)

The function is defined in the following location(s).

/wp-includes/query.php  
  1. function is_category( $category = '' ) { 
  2. global $wp_query; 
  3.  
  4. if ( ! isset( $wp_query ) ) { 
  5. _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' ); 
  6. return false; 
  7.  
  8. return $wp_query->is_category( $category );