has_tag

Check if the current post has any of given tags.

Description

has_tag( (string) $tag = '', (null) $post = null ); 

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.

Parameters (2)

0. $tag — Optional. (string) => ''
The tag name/term_id/slug or array of them to check for.
1. $post — Optional. (null) => null
Post to check instead of the current post. (since 2.7.0)

Usage

  1. if ( !function_exists( 'has_tag' ) ) { 
  2. require_once ABSPATH . WPINC . '/category-template.php'; 
  3.  
  4. // Optional. The tag name/term_id/slug or array of them to check for. 
  5. $tag = ''; 
  6.  
  7. // Optional. Post to check instead of the current post. (since 2.7.0) 
  8. $post = null; 
  9.  
  10. // NOTICE! Understand what this does before running. 
  11. $result = has_tag($tag, $post); 
  12.  

Defined (1)

The function is defined in the following location(s).

/wp-includes/category-template.php  
  1. function has_tag( $tag = '', $post = null ) { 
  2. return has_term( $tag, 'post_tag', $post );