W3cubDocs

/WordPress

the_category_head( string $before = '', string $after = '' )

This function has been deprecated. Use get_the_category_by_ID() instead.

Prints a category with optional text before and after.

Description

See also

Parameters

$before

(string) (Optional) Text to display before the category.

Default value: ''

$after

(string) (Optional) Text to display after the category.

Default value: ''

Source

File: wp-includes/deprecated.php 

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

Uses

Uses Description
wp-includes/category-template.php: get_the_category()

Retrieves post categories.
wp-includes/category-template.php: get_the_category_by_ID()

Retrieves category name based on category ID.
wp-includes/functions.php: _deprecated_function()

Mark a function as deprecated and inform when it has been used.

Changelog

Version Description
0.71 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_category_head