single_cat_title()

Функция single_cat_title() возвращает или выводит на экран заголовок страницы архива категории.

Параметры

  • $prefix string
    Текст перед заголовком
    По умолчанию: ''
  • $display bool
    Выводить или возвращать заголовок категории
    По умолчанию: true
single_cat_title( $prefix, $display );

Возвращает

string|void Если параметр $display имеет значение false, то возвращает string (заголовок страницы категории).

Дополнительная информация

  1. Функцию принято использовать в файлах архива категорий, меток и других таксономий.
  2. Функция используется вне цикла (loop) WordPress.

Примеры использования

Пример 1. Вывод заголовка категории

single_cat_title();

Пример 2. Вывод заголовка с префиксом

single_cat_title( 'Категория: ' );

Функция не добавляет пробел в конце префикса, его надо добавить вручную.

Пример 3. Запись заголовка в переменную и вывод

$cat_title = single_cat_title('', false);
echo $cat_title;

Хуки

single_cat_title

Информация о функции

Добавлена в версии 0.71

wp-includes/general-template.php

Исходный код в Github

Другие функции

is_time()

Определяет, является ли текущая страница архивной страницей за определенный час, минуту или секунду .

is_month()

Определяет, является ли текущая страница архивной страницей записей за месяц.

is_year()

Определяет, является ли текущая страница архивной страницей за определенный год.

is_date()

Определяет, является ли текущая страница архивной страницей по дате.

is_category()

Определяет, является ли текущая страница страницей категории.

is_tax()

Определяет, является ли текущая страница архивной страницей кастомной таксономии.

is_tag()

Определяет, является ли текущая страница архивной страницей метки.

is_day()

Определяет, является ли текущая страница архивной страницей по дню.

post_type_archive_title()

Выводит или возвращает заголовок архивной страницы любого типа поста.

single_month_title()

Возвращает или выводит на экран заголовок архивной страницы по месяцам.

get_the_archive_title()

Возвращает заголовок любой архивной страницы.

the_archive_title()

Выводит на экран заголовок архивной страницы.

single_term_title()

Возвращает или выводит на экран заголовок текущего элемента таксономии на архивной странице.

single_tag_title()

Возвращает или выводит на экран заголовок текущей метки на архивной странице.