WordPress.org

Languages: English • Italiano • 日本語 (Add your language)

Description

Check if the current post has any of the 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) (required) 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 is 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

• Article: Introduction to WordPress conditional functions
• Function: comments_open()
• Function: is_404()
• Function: is_admin()
• Function: is_admin_bar_showing()
• Function: is_archive()
• Function: is_attachment()
• Function: is_author()
• Function: is_category()
• Function: is_comments_popup()
• Function: is_date()
• Function: is_day()
• Function: is_feed()
• Function: is_front_page()
• Function: is_home()
• Function: is_local_attachment()
• Function: is_main_query
• Function: is_multi_author
• Function: is_month()
• Function: is_new_day()
• Function: is_page()
• Function: is_page_template()
• Function: is_paged()
• Function: is_plugin_active()
• Function: is_plugin_active_for_network()
• Function: is_plugin_inactive()
• Function: is_plugin_page()
• Function: is_post_type_archive()
• Function: is_preview()
• Function: is_search()
• Function: is_single()
• Function: is_singular()
• Function: is_sticky()
• Function: is_tag()
• Function: is_tax()
• Function: is_taxonomy_hierarchical()
• Function: is_time()
• Function: is_trackback()
• Function: is_year()
• Function: in_category()
• Function: in_the_loop()
• Function: is_active_sidebar()
• Function: is_active_widget()
• Function: is_blog_installed()
• Function: is_rtl()
• Function: is_dynamic_sidebar()
• Function: is_user_logged_in()
• Function: has_excerpt()
• Function: has_post_thumbnail()
• Function: has_tag()
• Function: pings_open()
• Function: email_exists()
• Function: post_type_exists()
• Function: taxonomy_exists()
• Function: term_exists()
• Function: username_exists()
• Function: wp_attachment_is_image()
• Function: wp_script_is()

• is_term()
• term_exists()
• get_objects_in_term()
• get_term()
• get_term_by()
• get_term_children()
• get_term_link()
• get_terms()
• get_the_terms()
• get_the_term_list()
• has_term()
• sanitize term()
• the_terms()
• get_object_taxonomies()
• is_object_in_taxonomy()
• the_taxonomies()
• wp_get_object_terms()
• wp_set_object_terms()
• wp_get_post_terms()
• wp_set_post_terms()
• wp_delete_object_term_relationships()
• wp_remove_object_terms()