Функция wp_get_document_title() возвращает заголовок документа для текущей страницы. Этот заголовок обычно выводится в HTML-теге <title>, который отображается в заголовке браузера. Данная функция является заменой устаревшей функции wp_title().
wp_get_document_title(): stringВозвращаемое значение:
Возвращает строку, содержащую заголовок текущей страницы.
Базовое использование
Чтобы использовать функцию wp_get_document_title(), можно добавить следующий код в раздел <head> вашего файла header.php:
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width" />
<title><?php echo wp_get_document_title(); ?></title>
<?php wp_head(); ?>
</head>
Как работает
Функция wp_get_document_title() получает заголовок текущей страницы, добавляя в конце название сайта. Для главной страницы вместо названия будет выводиться описание сайта. Главная страница определяется как is_home() && is_front_page(). Для страниц пагинации в конце добавляется номер страницы, например: – Страница 2.
Если тема поддерживает автоматическую генерацию заголовка, заголовок будет добавлен в <head> с помощью функции _wp_render_title_tag(), которая сработает на хуке wp_head().
Переопределение заголовка
Работу функции wp_get_document_title() можно переопределить с помощью хука pre_get_document_title. Например:
$title = apply_filters( 'pre_get_document_title', '' );
if ( ! empty( $title ) ) {
return $title;
}
Использование фильтров
Вы можете использовать следующие фильтры для изменения частей заголовка:
document_title_parts— для изменения любой части заголовка.document_title— для изменения итоговой строки заголовка.
Изменение заголовка для конкретной страницы
Чтобы на странице с ID 123 вывести свой заголовок «Новое название»:
add_filter( 'pre_get_document_title', function() {
global $post;
if ( $post->ID != 123 )
return '';
return 'Новое название';
} );Изменение разделителя
Чтобы изменить разделитель между заголовком и названием сайта, используйте:
add_filter( 'document_title_separator', function() {
return ' | ';
} );
Заключение
Функция wp_get_document_title() является полезным инструментом для динамического управления заголовками страниц в WordPress. С ее помощью вы можете настраивать заголовки, чтобы они соответствовали нуждам вашего сайта, используя простые фильтры и хуки.