Функция wp_get_document_title() получает заголовок текущей страницы. Заголовок обычно выводится в теге <title> в разделе head документа.
Параметры
Нет.
wp_get_document_title();Возвращает
string Заголовок текущей страницы.
Дополнительная информация
- Функция введена для замены устаревшей
wp_title(). - Если в теме добавлена поддержка
add_theme_support( 'title-tag' ), то функция автоматически сработает в<head>документа и выведет заголовок страницы. Это значит, что тег<title>и функцию не нужно добавлять в файлheader.php, но при условии, что внутри тега<head>вызвана функцияwp_head(). - На всех страницах кроме главной в конце заголовка автоматически будет добавлено:
– название сайта. - На главной после заголовка будет добавлено:
– описание сайта. - На страницах пагинации в конце будет добавлен номер страницы:
– Страница 4.
Примеры использования
Пример 1. Вывод заголовка страницы в <head>
<head>
<title><?php echo wp_get_document_title() ?></title>
</head>Используйте этот пример, только если у вас в теме не включена поддержка
title-tag.
Пример 2. Изменение заголовка с помощью фильтра
add_filter( 'pre_get_document_title', 'replace_title_page' );
function replace_title_page( $title ) {
global $post;
if( $post->ID == 31 ) {
$title = 'Страница портфолио';
}
return $title;
}Для страницы с ID=31 изменили заголовок на Страница портфолио.
Пример 3. Замена разделителя в заголовке
add_filter( 'document_title_separator', function() {
return ' | ';
} );Каждый заголовок содержит разделитель, его можно заменить с помощью хука document_title_separator.
Хуки
pre_get_document_title document_title_separator document_title_parts document_title
Информация о функции