WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

single_cat_title() WP 0.71

Выводит на экран заголовок рубрики или метки. Используется за пределами цикла. Предназначена для страниц архивов.

Если использовать эту функцию на страницах меток, то вместо заголовка категории будет выведен заголовок текущей метки.

Используется за пределами Цикла WordPress.

Работает на основе: single_term_title()

Хуков нет.

Возвращает

Строку: текст, заголовок рубрики. Или NULL, если заголовка нет или его не удалось получить.

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

<?php single_cat_title( $prefix, $display ); ?>
$prefix(строка)
Текст, который будет находится перед заголовком.
По умолчанию: ''
$display(логический)
Выводить на экран (1) или возвращать для обработки (0).
По умолчанию: 1 (true)

Примеры

#1 Выведем название рубрики или метки на странице архивов

Этот пример выведет текст "Вы просматриваете: WordPress", где WordPress - это название текущей категории:

<p><?php single_cat_title('Вы просматриваете: '); ?>.</p>

#2 Запишем название рубрики в переменную

Пример того, как можно записать название рубрики в переменную $current_category, т.е. не выводить его на экран (устанавливаем второй параметр на 0).

<?php $current_category = single_cat_title('', 0); ?>

Список изменений

С версии 0.71 Введена.

Код single_cat_title() WP 5.5.1

wp-includes/general-template.php
<?php
function single_cat_title( $prefix = '', $display = true ) {
	return single_term_title( $prefix, $display );
}

Cвязанные функции

Из раздела: Рубрики

Еще из тегов шаблона: Таксономии: рубрики, метки, ...

14 комментов