Description

Retrieves the terms for a post.

Usage

$array|WP_Error = wp_get_post_terms( $post_id, $taxonomy, $args );

Parameters

$post_id

( int ) optional – Optional. The Post ID. Does not default to the ID of the global $post. Default 0.

$taxonomy

( string|string[] ) optional default: post_tag – Optional. The taxonomy slug or array of slugs for which to retrieve terms. Default 'post_tag'.

$args

( array ) optional – { Optional. Term query parameters. See WP_Term_Query::__construct() for supported arguments.

$fields

( string ) optional – Term fields to retrieve. Default 'all'. }

Returns

array|WP_Error Array of WP_Term objects on success or empty array if no terms were found. WP_Error object if $taxonomy doesn't exist.

Source

File name: wordpress/wp-includes/post.php
Lines:

function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {
  $post_id = (int) $post_id;

  $defaults = array( 'fields' => 'all' );
  $args     = wp_parse_args( $args, $defaults );

  $tags = wp_get_object_terms( $post_id, $taxonomy, $args );

  return $tags;
}
 

 View on GitHub View on Trac