Codex

Function Reference/is tax

Languages: English • (Add your language)

Contents

Description

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

Note that when used without the $taxonomy parameter, is_tax() returns false on category archives and tag archives. You should use is_category() and is_tag() respectively when checking for category and tag archives.

To check for a taxonomy term on a specific post, use has_term()

Usage

<?php is_tax( $taxonomy, $term ); ?>

Parameters

$taxonomy
(string, array) (optional) Taxonomy slug or slugs
Default: None
$term
(int, array, string) (optional) A single or array of, The term's ID, Name or Slug
Default: None

Return Values

(boolean) 
True on success, false on failure.

Examples

is_tax();
// When any custom taxonomy archive page is being displayed.

is_tax( 'channel' );
// When the archive page for taxonomy of 'channel' is being displayed.

is_tax( 'channel', 'BBC1' );
// When the archive page for taxonomy of 'channel' is being displayed and the 'channel' taxonomy term is 'BBC1'.

Post Formats

The taxonomy slug for Post Formats differs from the Post Format slug. The register_taxonomy() function appends a post-format- base to the Post Format slug. So, e.g. while the "Aside" Post Format type has a slug of aside, the post_format taxonomy term "Aside" has a slug of post-format-aside. 

is_tax( 'post_format' );
// When the archive page for any Post Format term is being displayed.

is_tax( 'post_format', 'post-format-aside' );
// When the archive page for Post Format type 'aside' is being displayed.

Notes

Source File

is_tax() 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_tax"

Codex Resources