get_the_tags( int|WP_Post $post ): WP_Term[]|false|WP_Error

User Contributed Notes

1. Skip to note 9 content

   hearvox 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

   Print only the first tag name:

   $post_tags = get_the_tags();
   if ( $post_tags ) {
       echo $post_tags[0]->name; 
   }
2. Skip to note 10 content

   hearvox 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   This example prints the tags of current post:
   Code must be used in The Loop.

   $post_tags = get_the_tags();
   
   if ( $post_tags ) {
   	foreach( $post_tags as $tag ) {
       echo $tag->name . ', '; 
   	}
   }

   • As $id is a required parameter, in order to get the current post id is recommended to add the get_the_ID() function as follow:

      $post_tags = get_the_tags( get_the_ID() ); if ( $post_tags ) { foreach( $post_tags as $tag ) { echo __( $tag->name . ', ' ); } }

     giorgiocolombo 5 years ago
3. Skip to note 11 content

   marzian 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   // Show post tags with link and a custom separator

   function wpdocs_show_tags() {
       $post_tags = get_the_tags();
       $separator = ' | ';
       $output = '';
   
       if ( ! empty( $post_tags ) ) {
           foreach ( $post_tags as $tag ) {
               $output .= '<a href="' . esc_attr( get_tag_link( $tag->term_id ) ) . '">' . __( $tag->name ) . '</a>' . $separator;
           }
       }
   
       return trim( $output, $separator );
   }

   • Before running “if” statement you should define the $output variable.

     cristim 5 years ago
4. Skip to note 12 content

   hearvox 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Example using post ID to get tags:
   This doesn’t need to be in The Loop.

   $post_tags = get_the_tags( 24 );
   
   print_r( $post_tags );
   
   /*
   This above prints the tag objects for post ID #24 (if post has any tags):
   Array
   (
       [0] => WP_Term Object
           (
               [term_id] => 108
               [name] => tag-1
               [slug] => tag-1
               [term_group] => 0
               [term_taxonomy_id] => 109
               [taxonomy] => post_tag
               [description] => 
               [parent] => 0
               [count] => 1
               [filter] => raw
               [object_id] => 24
           )
   
       [1] => WP_Term Object
           (
               [term_id] => 109
               [name] => tag-2
               [slug] => tag-2
               [term_group] => 0
               [term_taxonomy_id] => 110
               [taxonomy] => post_tag
               [description] => 
               [parent] => 0
               [count] => 1
               [filter] => raw
               [object_id] => 24
           )
   
   )
   */
5. Skip to note 13 content

   exonfang 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Display tags with links to tag pages in an unordered list:

   $post_tags = get_the_tags();
   if ( ! empty( $post_tags ) ) {
   	echo '<ul>';
   	foreach( $post_tags as $post_tag ) {
   		echo '<li><a href="' . get_tag_link( $post_tag ) . '">' . $post_tag->name . '</a></li>';
   	}
   	echo '</ul>';
   }
6. Skip to note 14 content

   hearvox 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Execute code based on different tag values:
   This code displays different HTML for different tags. Add elseif statements as needed.

   <?php
   $post_tags = get_the_tags();
   foreach( $post_tags as $tag) :
   	if ( $tag->name === 'tag-1' ) :
   ?>
   
   <p>Display HTML for posts tagged with 'tag-1'.</p>
   
   <?php
   	elseif ( $tag->name === 'tag-2' ) :
   ?>
   
   <p>Display HTML for posts tagged with 'tag-2'.</p>
   
   <?php
   	else :
   	// Post has neither tag, do nothing.
   	endif; 
   endforeach;
   ?>
7. Skip to note 15 content

   hearvox 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Function to show tags in a dropdown:

   <?php
   function dropdown_tags(){
   	echo '<select name="tag" id="tag" class="postform">';
       foreach ( get_the_tags() as $tag ) {
           echo '<option value="' . $tag->name . '">' . $tag->name . "</option>\n";
       }
       echo '</select>';
   }
   ?>
   <h2><?php _e( 'Tags:', 'textdomain' ); ?></h2>
   <form id="tags-select" class="tags-select" action="<?php echo esc_url( home_url( '/' ) ); ?>" method="get">
       <?php dropdown_tags(); ?>
       <input type="submit" name="submit" value="view" />
   </form>
8. Skip to note 16 content

   tbluhm 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Loop with tag post by ID and Link to -> /tag/slug:

                                 // GET TAGS BY POST_ID
                                  $tags = get_the_tags($post->ID);  ?>
    
                                  <ul class="cloudTags">
   
                                       <?php foreach($tags as $tag) :  ?>
   
                                      <li>
   									  <a class="btn btn-warning"
                                             href="<?php bloginfo('url');?>/tag/<?php print_r($tag->slug);?>">
                                                   <?php print_r($tag->name); ?>
                                          </a>	
                                       </li>
                                       <?php endforeach; ?>
   						      </ul>