WordPress как на ладони
rgbcode is looking for WordPress developers.

single_term_title()WP 3.1.0

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

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

1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.02 сек (скорость света) | PHP 7.1.11, WP 4.9.7

Возвращает

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

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

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

Примеры

1

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

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

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

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

0

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

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

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

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

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

Код single_term_title() WP 6.4.3

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;
	}
}
9 комментариев
    Войти