has_term( string|int|array $term = '', string $taxonomy = '', int|object $post = null )

Check if the current post has any of given terms.

Description

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.

Parameters

$term

(Optional) The term name/term_id/slug or array of them to check for.

Default value: ''

$taxonomy

(Optional) Taxonomy name

Default value: ''

$post

(Optional) Post to check instead of the current post.

Default value: null

Return

(bool) True if the current post has any of the given tags (or any tag, if no tag specified).

Source

File: wp-includes/category-template.php

function has_term( $term = '', $taxonomy = '', $post = null ) {
	$post = get_post($post);

	if ( !$post )
		return false;

	$r = is_object_in_term( $post->ID, $taxonomy, $term );
	if ( is_wp_error( $r ) )
		return false;

	return $r;
}

Expand Source Code View on GitHub

Uses

Uses
Uses	Description
wp-includes/post.php: get_post()	Retrieves post data given a post ID or post object.
wp-includes/load.php: is_wp_error()	Check whether variable is a ClassicPress Error.
wp-includes/taxonomy.php: is_object_in_term()	Determine if the given object is associated with any of the given terms.

Used By

Used By
Used By	Description
wp-includes/post-formats.php: has_post_format()	Check if a post has any of the given formats, or any format.
wp-includes/category-template.php: has_category()	Check if the current post has any of given category.
wp-includes/category-template.php: has_tag()	Check if the current post has any of given tags.
wp-includes/canonical.php: redirect_canonical()	Redirects incoming links to the proper URL based on the site url.

Changelog

Changelog
Version	Description
WP-3.1.0	Introduced.