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

Parameters

$post_idintoptional

The Post ID. Does not default to the ID of the global $post. Default 0.Default: 0

$taxonomystring|string[]optional

The taxonomy slug or array of slugs for which to retrieve terms. Default 'post_tag'.Default: 'post_tag'

$argsarrayoptional

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

• $fieldsstringdefault: 'all'

  Term fields to retrieve.

Return

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.

Uses · 2

• wp_parse_args()Merges user defined arguments into defaults array.
• wp_get_object_terms()Retrieves the terms associated with the given object(s), in the supplied taxonomies.

Used by · 3

• WP_Customize_Nav_Menu_Item_Setting::populate_value()Ensure that the value is fully populated with the necessary properties.
• WP_REST_Menu_Items_Controller::get_menu_id()Gets the id of the menu that the given menu item belongs to.
• wp_get_post_tags()Retrieves the tags for a post.

Source

View on Trac ↗View on GitHub ↗

4250function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {4251	$post_id = (int) $post_id;4252 4253	$defaults = array( 'fields' => 'all' );4254	$args     = wp_parse_args( $args, $defaults );4255 4256	$tags = wp_get_object_terms( $post_id, $taxonomy, $args );4257 4258	return $tags;4259}

History

Introduced in 2.8.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/post.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.