has_tag() WordPress Function
The has_tag() WordPress function is used to check if a post has a specific tag. This function can be used in conjunction with the get_the_tags() function to check if a post has a specific tag.
has_tag( string|int|array $tag = '', int|object $post = null ) #
Checks if the current post has any of given tags.
Description
The given tags are checked against the post’s tags’ term_ids, names and slugs. Tags given as integers will only be checked against the post’s tags’ term_ids.
If no tags are given, determines if post has any tags.
For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.
Parameters
- $tag
(string|int|array)(Optional) The tag name/term_id/slug, or an array of them to check for.
Default value: ''
- $post
(int|object)(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). False otherwise.
Source
File: wp-includes/category-template.php
function has_tag( $tag = '', $post = null ) {
return has_term( $tag, 'post_tag', $post );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Can be used outside of the WordPress Loop if $post is provided. |
| 2.6.0 | Introduced. |