How to display the description of a WordPress category.

Description

Returns the description of a category defined in the category settings screen for the current category (Posts > Categories).

Usage

<?php echo category_description( $category ); ?>

Parameters

$category (integer) – The numeric ID of the category for which the tag is to return the description. Defaults to the current category, if one is not set.

Examples

Default Usage

Displays the description of a category, given its id, by echoing the return value of the tag. If no category given and used on a category page, it returns the description of the current category.

<div><?php echo category_description(3); ?></div> 

*Note* – if there is no category description, the function returns a br tag

Using Category Slug

Displays the description of a category, using a category slug.

<?php echo category_description(get_category_by_slug('category-slug')->term_id); ?>

With Category Title

<div><strong><?php single_cat_title('Currently browsing'); ?>
</strong>: <?php echo category_description(); ?></div>

Tags: How To

This entry was posted on Friday, January 8th, 2010 at 10:25 am and is filed under Wordpress. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.