wp_get_post_terms( int $post_id, string|string[] $taxonomy = 'post_tag', array $args = array() ): array|WP_Error

User Contributed Notes

1. Skip to note 6 content

   Dustin Falgout 7 years ago

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

   The difference between this function and get_the_terms() is that this function’s results are not cached (thus, it’ll hit the database every time its called).

   • This is not entirely true. Another key distinction is that get_the_terms() does not allow the third parameter: $args.

     Joshua Fredrickson 5 years ago
2. Skip to note 7 content

   Codex 10 years ago

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

   Examples

   //Returns All Term Items for "my_taxonomy".
   $term_list = wp_get_post_terms( $post->ID, 'my_taxonomy', array( 'fields' => 'all' ) );
   print_r( $term_list );
   
   // Returns Array of Term Names for "my_taxonomy".
   $term_list = wp_get_post_terms( $post->ID, 'my_taxonomy', array( 'fields' => 'names' ) );
   print_r( $term_list );
   
   // Returns Array of Term ID's for "my_taxonomy".
   $term_list = wp_get_post_terms( $post->ID, 'my_taxonomy', array( 'fields' => 'ids' ) );
   print_r( $term_list );
3. Skip to note 8 content

   tradesouthwest 4 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

   Get term category to only run function if the post (CPT) has that category:

   /**
    * Get category and add text to that page, only.
    * 
    * @param  string $terms Get post terms
    * @return string        Text
    */
   function wpdocs_additional_measurements() {
        global $post;
   
       $innertext = "Hemmed tarps have seatbelt material woven into the hems.";
       $terms = wp_get_post_terms( $post->ID, 'product_cat' );
   
       foreach ( $terms as $term ) {
           $categories[] = $term->slug;
       }
               
       // Look for term/category by slug	
       if ( in_array( 'custom-tarps', $categories ) ) {
           printf( '<p>%s</p>',
                   esc_html__( $innertext, 'woocommerce' )
           );
      }
           
   } 
   add_action( 'woocommerce_before_add_to_cart_button', 'wpdocs_additional_measurements', 9 ); 

   Use curly brackets recommended but not needed on one expression of foreach
4. Skip to note 9 content

   Mehedi Foysal 4 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

   Get all taxonomy slug of a post

   function post_taxonomy_slug_array( $tax_name = 'category' ) {
   
       $terms = wp_get_post_terms( get_the_ID(), $tax_name, array( "fields" => "slugs" ) );
       if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
   
           $term_array = array();
   
           foreach ( $terms as $term ) {
               $term_array[] = $term;
           }
   
           return $term_array;
       }
   
       return '';
   }
5. Skip to note 10 content

   awaismushtaq 3 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

   You can get the taxonomy terms HTML using this function am_get_post_term

   function am_get_post_terms( $post_id = 0, $taxonomy = 'category', $custom_html = ['ul','li','a'] ) 
   {
   	$post_terms = wp_get_post_terms( $post_id, $taxonomy );
   
   	$custom_html[0] = isset($custom_html[0]) ? $custom_html[0] : 'ul';
   	$custom_html[1] = isset($custom_html[1]) ? $custom_html[1] : 'li';
   	$custom_html[2] = isset($custom_html[2]) ? $custom_html[2] : 'a'; 
   
   	$post_term_html = '';
   	$post_term_html .= '<' . $custom_html[0] . '>';
   	foreach( $post_terms as $p_term ) {
   		$post_term_html .= '<' . $custom_html[1] . '><' . $custom_html[2] . ' href="'. get_term_link( $p_term->term_id, $taxonomy ) .'">'. $p_term->name .'</' . $custom_html[2]  . '></' . $custom_html[1] . '>';
   	}
   	$post_term_html .= '</' . $custom_html[0] . '>';
   
   	return $post_term_html;
   
   }
   
   Call the function in single.php file work for all CPT:
   
   echo am_get_post_terms( get_the_ID(), 'category',['div','span','a'] );