single_post_title() WP 0.71

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

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

Возвращает

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

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

single_post_title( $prefix, $display );

$prefix(строка)

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

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

true — выводит на экран, false — возвращает строку.
По умолчанию: true

Примеры

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

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

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

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

Код single_post_title() single post title ^{WP 5.7.2}

<?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;
	}
}

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

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

Еще из раздела: Записи: посты, страницы, ...

Еще из тегов шаблона: Записи: посты, страницы, ...