single_cat_title

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

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

single_cat_title() можно использовать только за пределами Цикла WordPress.

Хуков нет.

Возвращает

Строку: текст, заголовок рубрики. Или 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); ?>

Заметки

  • С версии 3.1 использует функцию single_term_title()

Код из


wp-includes/general-template.php

WP 4.7.2

<?php
function single_cat_title( $prefix = '', $display = true ) {
	return single_term_title( $prefix, $display );
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *