Codex

Function Reference/has term

Contents

Description

Check if the current post has any of given terms.

The given terms are checked against the post's terms' term_ids, names and slugs. Terms given as integers will only be checked against the post's terms' term_ids.

If no terms are given, determines if post has any terms.

Usage

<?php has_term$term$taxonomy$post ?>

Parameters

$term
(string|integer|array) (optional) The term name/term_id/slug or array of them to check for.
Default: ''
$taxonomy
(string) (optional) Taxonomy name
Default: ''
$post
(integer|object) (optional) Post to check instead of the current post.
Default: null

Return Values

(boolean) 
True if the current post has any of the given terms (or any term, if no term specified).

Examples

if( has_term( 'jazz', 'genre' ) ) {
    // do something
}

Notes

Change Log

Since: 3.1.0

Source File

has_term() is located in /wp-includes/category-template.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()