single_term_title с версии 3.1.0

Описание

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

single_term_title() используется в: single_tag_title(), single_cat_title().

Функция возвращает текст, заголовок текущей таксономии (категории, метки и т.п.). Если заголовок получить не удалось, вернется 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_cat_title, single_tag_title и single_term_title, соответственно для каждого типа таксономии.

single_term_title()

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

	if ( !$term )
		return;

	if ( is_category() )
		$term_name = apply_filters( 'single_cat_title', $term->name );
	elseif ( is_tag() )
		$term_name = apply_filters( 'single_tag_title', $term->name );
	elseif ( is_tax() )
		$term_name = apply_filters( 'single_term_title', $term->name );
	else
		return;

	if ( empty( $term_name ) )
		return;

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

Связанные Функции

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.

Что в первую очередь нужно делать, когда вы решили развивать свой сайт? Разумеется, провести полный анализ сайта, на предмет его соответствия с SEO оптимизацией. Также не мало важно проверить юзабилити сайта. В таком анализе вам может помочь компания: mainspy.ru