WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

the_category_head()

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

In this article

Back to top

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

$beforestringoptional
Text to display before the category.

Default:''

$afterstringoptional
Text to display after the category.

Default:''

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

View all references View on Trac View on GitHub

UsesDescription
get_the_category()wp-includes/category-template.php

Retrieves post categories.

get_the_category_by_ID()wp-includes/category-template.php

Retrieves category name based on category ID.

_deprecated_function()wp-includes/functions.php

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

Show 1 moreShow less

Changelog

VersionDescription
0.71Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.