wp_get_post_tags() WordPress Function

The wp_get_post_tags() function is used to retrieve the tags for a given post. The function accepts a single parameter, the ID of the post for which you wish to retrieve the tags. The function returns an array of tag objects.

wp_get_post_tags( int $post_id, array $args = array() ) #

Retrieve the tags 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().


Top ↑

Parameters

$post_id

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

$args

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

Default value: array()


Top ↑

Return

(array|WP_Error) Array of WP_Term objects on success or empty array if no tags were found. WP_Error object if 'post_tag' taxonomy doesn't exist.


Top ↑

Source

File: wp-includes/post.php

function wp_get_post_tags( $post_id = 0, $args = array() ) {
	return wp_get_post_terms( $post_id, 'post_tag', $args );
}


Top ↑

Changelog

Changelog
VersionDescription
2.3.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More
Show More