On this page
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
$beforestring Optional-
Text to display before the category.
Default:
'' $afterstring Optional-
Text to display after the category.
Default:
''
Source
File: wp-includes/deprecated.php. View all references
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;
}
}
Related
Uses
| Uses | Description |
|---|---|
| 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. |
Changelog
| Version | Description |
|---|---|
| 0.71 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/the_category_head