has_term( string|int|array $term = '', string $taxonomy = '', int|WP_Post $post = null ): bool

Description

Parameters

$termstring|int|arrayoptional

The term name/term_id/slug, or an array of them to check for. Default empty.Default: ''

$taxonomystringoptional

Taxonomy name. Default empty.Default: ''

$postint|WP_Postoptional

Post to check. Defaults to the current post.Default: null

Return

bool

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

Uses · 3

• get_post()Retrieves post data given a post ID or post object.
• is_object_in_term()Determines if the given object is associated with any of the given terms.
• is_wp_error()Checks whether the given variable is a WordPress Error.

Used by · 4

• has_category()Checks if the current post has any of given category.
• has_post_format()Check if a post has any of the given formats, or any format.
• has_tag()Checks if the current post has any of given tags.
• redirect_canonical()Redirects incoming links to the proper URL based on the site url.

Source

View on Trac ↗View on GitHub ↗

1542function has_term( $term = '', $taxonomy = '', $post = null ) {1543	$post = get_post( $post );1544 1545	if ( ! $post ) {1546		return false;1547	}1548 1549	$r = is_object_in_term( $post->ID, $taxonomy, $term );1550	if ( is_wp_error( $r ) ) {1551		return false;1552	}1553 1554	return $r;1555}

History

Introduced in 3.1.0. One change between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/category-template.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.