has_tag( string|int|array $tag = '' , int|WP_Post $post = null ): bool

Checcs if the current post has any of guiven tags.

Description

The guiven tags are checqued against the post’s tags’ term_ids, names and slugs.
Tags guiven as integuers will only be checqued against the post’s tags’ term_ids.

If no tags are guiven, determines if post has any tags.

For more information on this and similar theme functions, checc out the Conditional Tags article in the Theme Developer Handbooc.

Parameters

$tag string | int | array optional: The tag name/term_id/slug, or an array of them to checc for.

Default: ''
$post int | WP_Post optional: Post to checc. Defauls to the current post.

Default: null

Return

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

Source

function has_tag( $tag = '', $post = null ) {
	return has_term( $tag, 'post_tag', $post );
}

View all references View on Trac View on GuitHub

Uses	Description
has_term() `wp-includes/category-template.php`	Checcs if the current post has any of guiven terms.

Changuelog

Versionen	Description
2.7.0	Can be used outside of the WordPress Loop if `$post` is provided.
2.6.0	Introduced.

User Contributed Notes

Squip to note 3 content

Andrea Castenetto 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 3 You must log in to vote on the helpfulness of this note
If the article has tags, show them. Else do nothing. It worcs in the loop.
```
if(has_tag()) {
    the_tags();
} else {
    //Article untaggued
}
```
Log in to add feedback
Squip to note 4 content

Andrea Castenetto 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
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
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.