Функция single_cat_title() │ WP 0.71

Функция single_cat_title() позволяет отобразить или получить заголовок страницы архива для категории. Это полезно при создании шаблонов для страниц категорий, так как она помогает предлагать пользователю понятный заголовок.

Важно: Если вы хотите добавить пробел после префикса, не забудьте добавить его в конце значения параметра.

Как это работает

Использует: single_term_title()

Нет хуков.

ПАРАМЕТРЫ

• $prefix (строка): текст, который будет отображаться перед заголовком.
  • По умолчанию: ''
• $display (логический): определяет, нужно ли отображать заголовок или вернуть его.
  • По умолчанию: true

РЕЗУЛЬТАТ

Возвращает строку или null. Заголовок при его получении.

ПРИМЕРЫ

Пример 1: Отображение имени категории или тега на странице архива

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

.

Пример 2: Запись имени категории в переменной

В этом примере имя категории записывается в переменную $current_cat_name, то есть оно не выводится на экран (второй параметр установле�� в 0):

$current_cat_name = single_cat_title( '', 0 );
echo $current_cat_name;

ИСТОРИЯ ИЗМЕНЕНИЙ

• С версии 0.71: Функция была введена.

КОД ФУНКЦИИ

Ниже вы можете увидеть реализацию функции single_cat_title() в файле wp-includes/general-template.php:

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

СВЯЗАННЫЕ ФУНКЦИИ

Вот несколько связанных функций, которые могут быть полезны для работы с категориями и таксономиями в WordPress:

• cat_is_ancestor_of()
• category_description()
• category_exists()
• get_cat_ID()
• get_cat_name()
• get_categories()
• get_category()
• get_category_by_slug()
• get_category_link()
• get_category_parents()
• get_the_category_by_ID()
• in_category()
• wp_create_category()
• wp_dropdown_categories()
• wp_insert_category()
• wp_list_categories()

Для работы с таксономиями (категориями и тегами) также могут быть полезны следующие функции:

• get_the_term_list()
• single_tag_title()
• single_term_title()
• tag_description()
• term_description()
• the_taxonomies()
• the_terms()
• wp_generate_tag_cloud()
• wp_tag_cloud()

Теперь, когда вы знаете, как использовать функцию single_cat_title(), вы сможете легко управлять заголовками категорий на вашем сайте WordPress!