wp_get_post_categories( int $post_id = 0, array $args = array() ): array|WP_Error

Description

Parameters

$post_idintoptional

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

$argsarrayoptional

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

Return

array|WP_Error

List of categories. If the $fields argument passed via $args is 'all' or 'all_with_object_id', an array of WP_Term objects will be returned. If $fields is 'ids', an array of category IDs. If $fields is 'names', an array of category names. WP_Error object if 'category' 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 · 9

• bulk_edit_posts()Processes the post data for the bulk editing of posts.
• wp_get_post_cats()Retrieves a list of post categories.
• wp_xmlrpc_server::_prepare_page()Prepares page data for return in an XML-RPC object.
• wp_xmlrpc_server::blogger_getPost()Retrieves a post.
• wp_xmlrpc_server::blogger_getRecentPosts()Retrieves the list of recent posts.
• wp_xmlrpc_server::mt_getPostCategories()Retrieves post categories.
• wp_xmlrpc_server::mt_publishPost()Sets a post's publish status to 'publish'.
• wp_xmlrpc_server::mw_getPost()Retrieves a post.
• wp_xmlrpc_server::mw_getRecentPosts()Retrieves list of recent posts.

Source

View on Trac ↗View on GitHub ↗

4203function wp_get_post_categories( $post_id = 0, $args = array() ) {4204	$post_id = (int) $post_id;4205 4206	$defaults = array( 'fields' => 'ids' );4207	$args     = wp_parse_args( $args, $defaults );4208 4209	$cats = wp_get_object_terms( $post_id, 'category', $args );4210	return $cats;4211}

History

Introduced in 2.1.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.