Описание функции single_post_title()
Функция single_post_title() выводит заголовок текущего поста в одиночном представлении. Она используется для отображения заголовка поста на страницах, где загружается только один пост, таких как страницы записей и страниц записей в блогах.
Функция поддерживает возможность добавления дополнительного текста перед заголовком, что позволяет кастомизировать вывод
Параметры
$display
Тип: boolean
Обязательный: Нет
По умолчанию: true
Описание: Определяет, нужно ли выводить заголовок или вернуть его
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string|void
Описание: Возвращает заголовок поста в виде строки или ничего, если параметр display равен true
Возможные значения:
• Строка с заголовком поста при display=false
• Ничего не возвращается при display=true
Примеры использования
Базовый пример вывода заголовка текущего поста
single_post_title();
Выводит, например, ‘Заголовок поста’
Получить заголовок поста в переменную без вывода
$title = single_post_title('', false);
// $title теперь содержит заголовок поста
Используйте display=false для получения строки
Безопасность
Валидация входных данных: Параметры не требуют внешней валидации, так как только boolean
Санитизация: Выводимый заголовок автоматически очищается WordPress
Рекомендации: При использовании заголовка в HTML используйте esc_html() для безопасного вывода
— Связанные функции
Выводит заголовок текущего поста в цикле
Получает заголовок поста по ID
— Примечания
– Ограничения
Работает только в контексте одиночного поста
– Частые проблемы
- Не выводит заголовок, если нет текущего поста
- Ошибки при использовании в неправильных контекстах
