# single_post_title()

URL: https://chugunov.pro/api-wordpress/functions/single_post_title/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 0.71.

## Сигнатура

```php
single_post_title( string $prefix = '', bool $display = true ): string|null
```

## Описание

Оптимизировано для файла шаблона single.php для отображения заголовка записи.
Размещение разделителя после заголовка не поддерживается, но, оставив параметр prefix пустым, можно задать разделитель заголовка вручную. Prefix не добавляет пробел автоматически, поэтому, если пробел нужен, его следует указать в конце значения параметра.

## Параметры

- `$prefix` `string` — необязательный, по умолчанию `''`. Что отображать перед заголовком.
- `$display` `bool` — необязательный, по умолчанию `true`. Отображать или получать заголовок.

## Возвращаемое значение

`string|null`

## Исходный код

Файл: `wp-includes/general-template.php:1494`

```php
function single_post_title( $prefix = '', $display = true ) {
	$_post = get_queried_object();

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

	/**
	 * 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;
	}
}
```

## История изменений

- 0.71 — Introduced.

## Связанные

Использует: [`get_queried_object`](https://chugunov.pro/api-wordpress/functions/get_queried_object/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`wp_get_document_title`](https://chugunov.pro/api-wordpress/functions/wp_get_document_title/), [`wp_title`](https://chugunov.pro/api-wordpress/functions/wp_title/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/single_post_title/
