Хук single_cat_title позволяет разработчикам изменять заголовок страницы архива категории в WordPress. Это полезный инструмент для настройки отображения заголовков категорий, например, для их стилизации или добавления дополнительной информации.
apply_filters( 'single_cat_title', string $term_name );
Фильтр single_cat_title применяется к названию категории, которое выводится на странице архива категории. Он срабатывает в функции single_term_title(), которая используется в том числе для отображения заголовков в категориях через функцию single_cat_title().
Параметры
$term_name(string): Название категории (термина), которое будет использовано в заголовке страницы категории.
Пример 1: Обрезка длинных заголовков
Если ваш сайт не рассчитан на слишком длинные заголовки категорий, можно использовать фильтр для их обрезки. Например, можно ограничить длину заголовка до 20 символов, добавив многоточие в конце.
add_filter( 'single_cat_title', 'trim_category_title' );
function trim_category_title( $title ) {
return mb_strimwidth( $title, 0, 20, '...' );
}
Этот код обрежет заголовок категории, если он превышает 20 символов, добавив многоточие. Однако этот подход может привести к обрезанию заголовков в теге <title> для SEO. Чтобы этого избежать, можно применить фильтр в wp_head:
add_action( 'wp_head', function() {
add_filter( 'single_cat_title', 'trim_category_title' );
} );
function trim_category_title( $title ) {
return mb_strimwidth( $title, 0, 20, '...' );
}
Заключение
Фильтр single_cat_title предоставляет множество возможностей для настройки заголовков страниц категорий в WordPress. С его помощью можно легко изменять или стилизовать заголовки, добавлять дополнительную информацию или динамически настраивать их в зависимости от данных в базе. Это мощный инструмент для кастомизации вывода информации на архивных страницах категорий.