On this page
has_term( string|int|array $term = '', string $taxonomy = '', int|WP_Post $post = null ): bool
Checks 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
$termstring|int|array Optional-
The term name/term_id/slug, or an array of them to check for.
Default:
'' $taxonomystring Optional-
Taxonomy name.
Default:
'' $postint|WP_Post Optional-
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.
Source
File: wp-includes/category-template.php. View all references
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;
}
Related
Uses
| Uses | Description |
|---|---|
| is_object_in_term() wp-includes/taxonomy.php | Determines if the given object is associated with any of the given terms. |
| get_post() wp-includes/post.php | Retrieves post data given a post ID or post object. |
| is_wp_error() wp-includes/load.php | Checks whether the given variable is a WordPress Error. |
Used By
| Used By | Description |
|---|---|
| has_category() wp-includes/category-template.php | Checks if the current post has any of given category. |
| has_tag() wp-includes/category-template.php | Checks if the current post has any of given tags. |
| redirect_canonical() wp-includes/canonical.php | Redirects incoming links to the proper URL based on the site url. |
| has_post_format() wp-includes/post-formats.php | Check if a post has any of the given formats, or any format. |
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/has_term