the_category │ filter-hook │ WP 1.2.0

Filters the category or list of categories.

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)

List of categories for the current post.

$separator(string)

Separator used between the categories.

$parents(string)

How to display the category parents. Accepts 'multiple', 'single', or empty.

Changelog

Where the hook is called

return apply_filters( 'the_category', $thelist, $separator, $parents );

return apply_filters( 'the_category', '', $separator, $parents );

return apply_filters( 'the_category', __( 'Uncategorized' ), $separator, $parents );

esc_html( apply_filters( 'the_category', $category->name, '', '' ) ) . '</div>';

esc_html( apply_filters( 'the_category', $category->name, '', '' ) ) . '</label>';

echo esc_html( apply_filters( 'the_category', $term->name, '', '' ) );

$name    = esc_html( apply_filters( 'the_category', $category->name, '', '' ) );

'<strong>' . apply_filters( 'the_category', get_cat_name( get_option( 'default_category' ) ), '', '' ) . '</strong>'

Where the hook is used in WordPress