the_category │ хук-фильтр │ WP 1.2.0

Позволяет изменить категорию или готовый список категорий записи.

Фильтр применяется после формирования HTML функцией get_the_category_list(). Также WordPress применяет его к названиям рубрик в некоторых элементах админки.

Использование

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(строка)

Категория или список категорий текущей записи. Обычно содержит готовую HTML-разметку.
Может содержать пустую строку, если тип записи не поддерживает рубрики, или текст Uncategorized, если рубрики не найдены.

$separator(строка)

Разделитель между рубриками.
Пустая строка означает, что список формируется как <ul class="post-categories">.

$parents(строка)

Способ отображения родительских рубрик.
Допустимые значения: multiple, single или пустая строка.

Примеры

#1 Заменим название рубрики в готовом списке

add_filter( 'the_category', 'wp_kama_replace_category_name' );

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