Описание функции wp_get_document_title()
Функция wp_get_document_title() используется для получения заголовка документа, который будет отображаться в заголовке HTML-страницы. Она объединяет заголовок записи, название сайта и другие элементы, если они заданы. Эта функция полезна для создания динамических заголовков страниц, соответствующих текущему контексту.
Функция может быть использована в темах и плагинах для отображения правильного заголовка в зависимости от типа контента
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки заголовка
Возможные значения:
title: Строка с заголовком документа
site_name: Строка с названием сайта
page_title: Строка с заголовком страницы
Возвращаемое значение
Тип: string
Описание: Строка, представляющая заголовок документа
Возможные значения:
• Строка с заголовком страницы и названием сайта
• Пустая строка если заголовок не задан
Примеры использования
Получение заголовка документа без дополнительных параметров
$title = wp_get_document_title();
// Вывод заголовка страницы
echo $title;
Выводит заголовок текущей страницы
Получение заголовка документа с заданными параметрами
$args = array(
'title' => 'Мой Заголовок',
'site_name' => 'Мой Сайт'
);
$title = wp_get_document_title($args);
Выводит ‘Мой Заголовок — Мой Сайт’
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: WordPress автоматически очищает выходные данные
Рекомендации: При выводе данных используйте esc_html() для заголовка документа
— Связанные функции
Получает заголовок страницы для отображения в заголовке HTML
Получает информацию о сайте, включая название
— Хуки
Фильтрует заголовок документа перед его отображением
— Примечания
– Ограничения
Не возвращает заголовок, если не задано название сайта или страницы
– Частые проблемы
- Пустой заголовок при отсутствии информации о сайте
- Некорректное отображение заголовка в зависимости от контекста
