single_tag_title

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

С версии 3.1+ эта функция абсолютно идентична функциям: single_cat_title() и single_term_title(). Более правильно использовать single_term_title() для получения заголовка страниц архивов меток, категорий или других таксономий.

Хуков нет.

Возвращает

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

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

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

Примеры

  1. Выведем на экран заголовок текущей метки (предполагается, что мы просматриваем страницу метки “Продвижение сайтов”) с предшествующем текстом “Вы просматриваете метку: “:
<p><?php single_tag_title('Вы просматриваете метку: '); ?>.</p>

Получим: Вы просматриваете метку: Продвижение сайтов

  1. Этот пример показывает как получить заголовок в переменную $current_tag, а не выводить его на экран:
<?php $current_tag = single_tag_title("", 0); ?>

Заметки

  • С версии 3.1.0 использует функция single_term_title()

Код из


wp-includes/general-template.php

WP 4.7.2

<?php
function single_tag_title( $prefix = '', $display = true ) {
	return single_term_title( $prefix, $display );
}