the_category │ filter-hook │ WP 1.2.0

Allows changing a category or the formatted list of post categories.

The filter is applied after the get_the_category_list() function generates the HTML. WordPress also applies it to category names in some admin elements.

Usage

add_filter( 'the_category', 'wp_kama_the_category_filter', 10, 3 );

/**
 * Function for `the_category` filter-hook.
 * 
 * @param string $thelist   List of categories for the current post.
 * @param string $separator Separator used between the categories.
 * @param string $parents   How to display the category parents. Accepts 'multiple', 'single', or
 *                          empty.
 *
 * @return string
 */
function wp_kama_the_category_filter( $thelist, $separator, $parents ){
	// filter...
	return $thelist;
}

$thelist(string)

Category or list of categories for the current post. Usually contains ready-made HTML markup.
It may be an empty string if the post type does not support categories, or the text Uncategorized if no categories are found.

$separator(string)

Separator between categories.
An empty string means that the list is generated as <ul class="post-categories">.

$parents(string)

How to display parent categories.
Allowed values: multiple, single, or an empty string.

Examples

#1 Replace a category name in the formatted list

add_filter( 'the_category', 'wp_kama_replace_category_name' );

function wp_kama_replace_category_name( $categories ) {
	return str_replace( 'Tools', 'All tools', $categories );
}