get_the_terms() – Retrieves 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 34 of 34
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; }