single_term_title() WP 3.1.0

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

Предназначен для использования в файле шаблона элемента таксономии (термина) для отображения заголовка страницы (названия термина). Пробел между префиксом и заголовком нужно указывать в параметре $prefix, т.е. автоматически пробел не добавляется.

Возвращает

Строка/null. Заголовок текущего элемента таксономии (категории, метки и т.п.). Вернется null, если не удалось получить заголовок или когда результат выводиться на экран.

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

<?php single_term_title( $prefix, $display ); ?>

$prefix(строка)

Текст, который будет показан перед заголовком.
По умолчанию: ''

$display(логический)

Если установить этот параметр в 0 (false), то результат функции будет возвращен, а не выведен на экран.
По умолчанию: 1 (true)

Примеры

#1. Заголовок текущей таксономии

Выведем на экран заголовок текущей таксономии "Учебники для школьников" с предшествующем текстом "Вы просматриваете раздел: ". Под таксономией понимается произвольная таксономия, или это может быть раздел категории (рубрики), или метка:

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

Получим: Вы просматриваете раздел: Учебники для школьников

#2. Получим заголовок в переменную

Пример показывающий, как получить заголовок в переменную $term_title, а не выводить его на экран:

<?php $term_title = single_term_title('', 0); ?>

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

Код single term title: wp-includes/general-template.php ^{WP 5.2.2}

<?php
function single_term_title( $prefix = '', $display = true ) {
	$term = get_queried_object();

	if ( ! $term ) {
		return;
	}

	if ( is_category() ) {
		/**
		 * Filters the category archive page title.
		 *
		 * @since 2.0.10
		 *
		 * @param string $term_name Category name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_cat_title', $term->name );
	} elseif ( is_tag() ) {
		/**
		 * Filters the tag archive page title.
		 *
		 * @since 2.3.0
		 *
		 * @param string $term_name Tag name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_tag_title', $term->name );
	} elseif ( is_tax() ) {
		/**
		 * Filters the custom taxonomy archive page title.
		 *
		 * @since 3.1.0
		 *
		 * @param string $term_name Term name for archive being displayed.
		 */
		$term_name = apply_filters( 'single_term_title', $term->name );
	} else {
		return;
	}

	if ( empty( $term_name ) ) {
		return;
	}

	if ( $display ) {
		echo $prefix . $term_name;
	} else {
		return $prefix . $term_name;
	}
}

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

Из метки: title (заголовок)

Еще из раздела: Любые таксономии

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