A WordPress-centric search engine for devs and theme authors



wp_get_post_categories ›

Since2.1.0
Deprecatedn/a
wp_get_post_categories ( $post_id = 0, $args = array() )
Parameters: (2)
  • (int) $post_id Optional. The Post ID. Does not default to the ID of the global $post. Default 0.
    Required: No
    Default:
  • (array) $args Optional. Category query parameters. Default empty array. See WP_Term_Query::__construct() for supported arguments.
    Required: No
    Default: array()
See:
Returns:
  • (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.
Defined at:
Codex:

Retrieve the list of categories for a post.

Compatibility layer for themes and plugins. Also an easy layer of abstraction away from the complexity of the taxonomy layer.



Source

function wp_get_post_categories( $post_id = 0, $args = array() ) {
	$post_id = (int) $post_id;

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

	$cats = wp_get_object_terms( $post_id, 'category', $args );
	return $cats;
}