single_cat_title │ хук-фільтр │ WP 2.0.10

Дозволяє змінити заголовок архівної сторінки рубрики (категорії).

Фільтр спрацьовує функції single_cat_title() .

Фільтр спрацьовує тільки на сторінках рубрик – коли виконується умовний мітка is_category() .

Використання

add_filter( 'single_cat_title', 'wp_kama_single_cat_title_filter');

/**
 * Function for `single_cat_title` filter-hook.
 *
 * @param string $term_name Category name for archive being displayed.
 *
 * @return string
 */
function wp_kama_single_cat_title_filter( $term_name ){

	// Filter...
	return $term_name;
}

$term_name (рядок): Ім’я рубрики, яке буде використано у заголовку сторінки рубрики.

Приклади

#1 Обріжемо довгий заголовок

Допустимо, наш сайт не розрахований на занадто довгі заголовки і нам потрібно обрізати їх до 20 символів, а в кінці додати крапку:

add_filter( 'single_cat_title', 'strim_cat_title');
function strim_cat_title( $title ) {
	return mb_strimwidth($title, 0, 23, '...');
}

Мінус такого підходу: обріжеться текст у тезі <title> . Рішення: підключити фільтр після виведення title:

add_action( 'wp_head', function() {
	add_filter( 'single_cat_title', 'trim_cat_title');
} );

function trim_cat_title( $title ) {
	return mb_strimwidth($title, 0, 23, '...');
}

#2 Управління виведенням заголовка через опції теми

Завдяки цьому фільтру можна налаштувати зміну заголовка в налаштуваннях теми. Наприклад, задавати колір заголовка та колір кордону навколо нього.

Уривок коду нижче взятий з теми ColorMag, хоча майже 1 в 1 використовується також у темах з репозиторію: ColorNews, The NewsMag, Creative Blog, Madar. Код наведено частково і показує лише принцип!

/**
 * Використання хуків для кольору категорії в заголовках архіву
 */
function colormag_colored_category_title( $title ) {

	$color_value = colormag_category_color( get_cat_id( $title ) );
	$color_border_value = colormag_category_color( get_cat_id( $title ) );

	if ( ! empty( $color_value ) ) {
		return '<h1 class="page-title" style="border-bottom-color: ' . $color_border_value . '">' . '<span style="background-color: ' . $color_value . '">' . $title . '</span></h1>';
	}
	else {
		return '<h1 class="page-title"><span>' . $title . '</span></h1>';
	}
}

function colormag_category_title_function( $category_title ) {
	add_filter( 'single_cat_title', 'colormag_colored_category_title');
}