single_post_title() │ WP 0.71

Выводит заголовок поста. Предназначен для использования на отдельных страницах записей.

Эта функция пригодится, когда нужно вывести заголовок записи за пределами Цикла WordPress.

Основа для: wp_get_document_title()
1 раз — 0.00001 сек (скорость света) | 50000 раз — 0.3093 сек (очень быстро)
Хуки из функции

Возвращает

Строку|null. Выводит на экран строку: заголовок записи. Если указать второй параметр $display=false, то функция вернет результат для обработки.

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

single_post_title( $prefix, $display );
$prefix(строка)
Текст, который будет расположен перед заголовком.
По умолчанию: null
$display(логический)
true — выводит на экран, false — возвращает строку.
По умолчанию: true

Примеры

0

#1 Вывод заголовка записи

Выведем заголовок записи в теге H2 с предшествующим текстом "Текущий пост: ":

<h2><?php single_post_title('Текущий пост: '); ?></h2>

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

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

Код single_post_title() WP 6.1.1

wp-includes/general-template.php 
function single_post_title( $prefix = '', $display = true ) {
	$_post = get_queried_object();

	if ( ! isset( $_post->post_title ) ) {
		return;
	}

	/**
	 * Filters the page title for a single post.
	 *
	 * @since 0.71
	 *
	 * @param string  $_post_title The single post page title.
	 * @param WP_Post $_post       The current post.
	 */
	$title = apply_filters( 'single_post_title', $_post->post_title, $_post );
	if ( $display ) {
		echo $prefix . $title;
	} else {
		return $prefix . $title;
	}
}

title (заголовок)

Записи: посты, страницы, ...

Записи: посты, страницы, ...