Функция single_cat_title() в WordPress используется для отображения или получения заголовка архивов категорий. Это полезный инструмент для шаблонов категорий, который позволяет динамически выводить название текущей категории или метки на страницах архивов.
single_cat_title( string $prefix = '', bool $display = true ): string|void
Параметры
- $prefix (string) (необязательный)
Текст, который будет отображен перед заголовком. По умолчанию пусто. - $display (bool) (необязательный)
Определяет, следует ли выводить заголовок на экран (true) или вернуть его в качестве строки (false). По умолчанию —true.
Возврат
- Функция возвращает строку с заголовком категории, если
displayустановлен наfalse, иvoid, если заголовок выводится на экран.
Пример 1: Вывод заголовка категории
Этот пример выводит текст «Вы просматриваете: » перед заголовком текущей категории:
<p><?php single_cat_title('Вы просматриваете: '); ?>.</p>
Результат:
Если текущая категория «WordPress», будет выведено:
Вы просматриваете: WordPress.Пример 2: Запись заголовка в переменную
Чтобы сохранить название текущей категории в переменную, установите второй параметр на false:
<?php $current_category = single_cat_title('', false); ?>
Теперь вы можете использовать переменную $current_category для дальнейших манипуляций в вашем коде.
Пример 3: Удаление префикса «Категория» из заголовка
Если вы хотите убрать префикс «Категория:» из заголовков страниц категорий, вы можете использовать следующий код в вашем файле functions.php:
function wporg_remove_category_title( $title ) {
if ( is_category() ) {
$title = single_cat_title( '', false );
}
return $title;
}
add_filter( 'get_the_archive_title', 'wporg_remove_category_title' );
Этот код заменяет заголовок категории на просто название без префикса.
Пример 4: Добавление поддержки перевода
Чтобы сделать строки переводимыми, вы можете использовать функцию __() следующим образом:
<p><?php single_cat_title( __( 'Вы просматриваете: ', 'textdomain' ) ); ?>.</p>
Таким образом, вы добавите поддержку локализации для вашего текста.
Заключение
Функция single_cat_title() — это простой и удобный способ динамически отображать названия категорий на страницах архивов. С помощью параметров вы можете настроить вывод заголовка по своему усмотрению и использовать его в различных контекстах вашего WordPress-сайта. Не забудьте использовать функцию перевода для обеспечения мультиязычности вашего контента.