get_the_category( int $post_id = false )
Retrieves post categories.
Description
This tag may be used outside The Loop by passing a post ID as the parameter.
Note: This function only returns results from the default "category" taxonomy.
For custom taxonomies use get_the_terms().
Parameters
- $post_id
-
(Optional) The post ID. Defaults to current post ID.
Default value: false
Return
(WP_Term[]) Array of WP_Term objects, one for each category assigned to the post.
Source
File: wp-includes/category-template.php
function get_the_category( $id = false ) {
$categories = get_the_terms( $id, 'category' );
if ( ! $categories || is_wp_error( $categories ) )
$categories = array();
$categories = array_values( $categories );
foreach ( array_keys( $categories ) as $key ) {
_make_cat_compat( $categories[$key] );
}
/**
* Filters the array of categories to return for a post.
*
* @since WP-3.1.0
* @since WP-4.4.0 Added `$id` parameter.
*
* @param array $categories An array of categories to return for the post.
* @param int $id ID of the post.
*/
return apply_filters( 'get_the_categories', $categories, $id );
}
Changelog
Version | Description |
---|---|
0.71 | Introduced. |