the_category_head() │ WP 0.71

Prints a category with optional text before and after.

No Hooks.

Returns

null. Nothing (null).

Usage

the_category_head( $before, $after );

$before(string)

Text to display before the category.
Default: ''

$after(string)

Text to display after the category.
Default: ''

Notes

• See: get_the_category_by_ID()

Changelog

the_category_head() the category head code ^{WP 6.9}

function the_category_head( $before = '', $after = '' ) {
	global $currentcat, $previouscat;

	_deprecated_function( __FUNCTION__, '0.71', 'get_the_category_by_ID()' );

	// Grab the first cat in the list.
	$categories = get_the_category();
	$currentcat = $categories[0]->category_id;
	if ( $currentcat != $previouscat ) {
		echo $before;
		echo get_the_category_by_ID($currentcat);
		echo $after;
		$previouscat = $currentcat;
	}
}