Question

wp_get_post_terms( int $post_id,  string $taxonomy = 'post_tag',  array $args = array() )

Retrieve the terms for a post.

---

description

There is only one default for this function, called ‘fields’ and by default is set to ‘all’. There are other defaults that can be overridden in wp_get_object_terms().

---

参数

$post_id

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

$taxonomy

(string) (Optional) The taxonomy for which to retrieve terms.

Default value: 'post_tag'

$args

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

Default value: array()

---

返回值

(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.

---

源代码

File: wp-includes/post.php

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;
}

---

更新日志

Version	description
2.8.0	Introduced.

---

相关函数

Uses

• wp-includes/functions.php: wp_parse_args()
• wp-includes/taxonomy.php: wp_get_object_terms()

---

Used By

• wp-includes/customize/class-wp-customize-nav-menu-item-setting.php: WP_Customize_Nav_Menu_Item_Setting::populate_value()
• wp-includes/post.php: wp_get_post_tags()

---

User Contributed Notes

1. Skip to note content 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 Contributed by Codex

   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 );