get_the_terms() – Retrieve the terms of the taxonomy that are attached to the post.

You appear to be a bot. Output may be restricted

Description

Retrieves the terms of the taxonomy that are attached to the post.

Usage

$WP_Term[]|false|WP_Error = get_the_terms( $post, $taxonomy );

Parameters

$post
( int|WP_Post ) required – Post ID or object.
$taxonomy
( string ) required – Taxonomy name.

Returns

WP_Term[]|false|WP_Error Array of WP_Term objects on success, false if there are no terms or the post does not exist, WP_Error on failure.

Source

File name: wordpress/wp-includes/category-template.php
Lines:

1 to 32 of 32
function get_the_terms( $post, $taxonomy ) {
  $post = get_post( $post );
  if ( ! $post ) {
    return false;
  }

  $terms = get_object_term_cache( $post->ID, $taxonomy );
  if ( false === $terms ) {
    $terms = wp_get_object_terms( $post->ID, $taxonomy );
    if ( ! is_wp_error( $terms ) ) {
      $term_ids = wp_list_pluck( $terms, 'term_id' );
      wp_cache_add( $post->ID, $term_ids, $taxonomy . '_relationships' );
    }
  }

  
/**
 * Filters the list of terms attached to the given post.
 *
 * @since 3.1.0
 *
 * @param WP_Term[]|WP_Error $terms    Array of attached terms, or WP_Error on failure.
 * @param int                $post_id  Post ID.
 * @param string             $taxonomy Name of the taxonomy.
 */
  $terms = apply_filters( 'get_the_terms', $terms, $post->ID, $taxonomy );

  if ( empty( $terms ) ) {
    return false;
  }

  return $terms;
}
 

 View on GitHub View on Trac