WordPress at a glance

get_the_category() WP 1.0

Retrieve post categories.

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().

Is the basis for: get_the_category_list()
Works based on: get_the_terms()
Hooks from function:
Return

Array. Array of WP_Term objects, one for each category assigned to the post.

Usage

get_the_category( $id );
$id(int)
The post ID.
Default: current post ID

Code of get_the_category: wp-includes/category-template.php VER 4.9.8

<?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 3.1.0
	 * @since 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 );
}

Related Functions

From category: For posts

No comments
    Hello, !     Log In . Register