A WordPress-centric search engine for devs and theme authors



the_category_head ›

Since0.71
Deprecated0.71.0
the_category_head ( $before = '', $after = '' )
Parameters: (2)
  • (string) $before Optional. Text to display before the category. Default empty.
    Required: No
    Default: (empty)
  • (string) $after Optional. Text to display after the category. Default empty.
    Required: No
    Default: (empty)
See:
  • get_the_category_by_ID()
Defined at:
Codex:

Prints a category with optional text before and after.



Source

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;
	}
}