Codex

Codex Resources

Template Tags/the category head

This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement if one exists.

Contents

Description

Displays the name of a category if it's different from the previous category. This tag must be used within The Loop.

Replace With

This tag was deprecated when multiple categories were added to WordPress, and there is no one-to-one correspondence with another tag.

To display the name of the category when on a category page, use: 

<?php echo get_the_category_by_ID($cat); ?>

To display category name(s) on a single post page, this code block (which would need to run in The Loop) provides an example: 

<?php
foreach(get_the_category() as $category) {
    echo $category->cat_name . ' '; 
}
?>

Usage

 <?php the_category_head('before', 'after'); ?> 

Example

Displays the text "Category: " followed by the name of the category. 

<h2><?php the_category_head('Category: '); ?></h2>

Parameters

before 
(string) Text to output before the category. Defaults to '' (no text).
after 
(string) Text to output after the category. Defaults to '' (no text).

Related

the_category, the_category_rss, single_cat_title, category_description, wp_dropdown_categories, wp_list_categories, in_category, get_category_parents, get_the_category get_category_link,

How to pass parameters to tags with PHP function-style parameters

Go to Template Tag index

Retrieved from "http://codex.wordpress.org/Template_Tags/the_category_head"