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.
Prior to v2.7 of WordPress, tags given as integers would also be checked against the post’s tags’ names and slugs (in addition to term_ids) Prior to v2.7, this function could only be used in the WordPress Loop. As of 2.7, the function can be used anywhere if it is provided a post ID or post object.
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 array of them to check for.
Default value: ''
- $post
-
(int|object) (Optional) Post to check instead of the current post. (since 2.7.0)
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_tag( $tag = '', $post = null ) {
return has_term( $tag, 'post_tag', $post );
}
Changelog
| Version | Description |
|---|---|
| 2.6.0 | Introduced. |
If the article has tags, show them. Else do nothing. It works in the loop.
if(has_tag()) { the_tags(); } else { //Article untagged }If Post has tag, show them. Else if Post has category, show category. Otherwise do other.
if(has_tag()) { the_tags(); //show tags } elseif(has_category()) { the_category(); //show category } else { //do something different }