Codex

Function Reference/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. See also wp-includes/deprecated.php.

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 (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 ); ?> 

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).

Example

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

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

Change Log

  • Since: 0.71
  • Deprecated: ?
  • Replace By: none

Related

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

See also index of Function Reference and index of Template Tags.
Retrieved from "http://codex.wordpress.org/Function_Reference/the_category_head"

Codex Resources