wp_get_document_title()

Возвращает заголовок документа для текущей страницы
Функция WordPress
INT 4.4.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Получение заголовка текущей страницы
  4. Установка кастомного заголовка
  5. Добавление префикса к заголовку
  6. Удаление префикса из заголовка
  7. Изменение заголовка в зависимости от условий
  8. Создание динамического заголовка документа на основе данных из базы данных
  9. Добавление дополнительной информации в заголовок документа
  10. Использование фильтров для настройки заголовка документа
  11. Вопросы и ответы
  12. Как установить одинаковый заголовок для всех страниц сайта?
  13. Как изменить заголовок документа для конкретной страницы?
  14. Как добавить дополнительную информацию в заголовок документа?
  15. Как удалить разделитель из заголовка документа?
  16. Как использовать переменные в заголовке документа?
  17. Как изменить форматирование заголовка документа?
  18. Как добавить динамический заголовок документа на основе контента страницы?
  19. Как использовать многоязычные заголовки документа?
  20. Как изменить порядок элементов в заголовке документа?
  21. Как добавить кастомный разделитель в заголовок документа?
  22. Связанные элементы

Описание функции

Функция wp_get_document_title() возвращает заголовок документа для текущей страницы в формате строки. Она используется для получения заголовка документа, который будет отображаться в HTML-теге <title> в шапке страницы.

Заголовок документа является важным элементом для оптимизации поисковых систем и улучшения пользовательского опыта. Он отображается во вкладке браузера и в результатах поиска, и помогает пользователям понять содержание страницы.

Использование

wp_get_document_title(): string

Функция wp_get_document_title() не принимает никаких аргументов. Она вызывается без параметров, и возвращает заголовок документа в виде строки.

Пример использования:

$title = wp_get_document_title();
echo $title;

В этом примере функция wp_get_document_title() вызывается без аргументов, и возвращаемое значение сохраняется в переменной $title. Затем заголовок документа выводится на экран с помощью функции echo.

Функция wp_get_document_title() возвращает заголовок документа в виде строки. Заголовок документа обычно заключается в HTML-тег <title> и используется для отображения названия страницы во вкладке браузера и в результатах поиска.

Пример возвращаемого значения:

string Tag with the document title.

Примеры использования

Получение заголовка текущей страницы


$title = wp_get_document_title();
echo $title;

Функция wp_get_document_title() возвращает заголовок текущей страницы. В данном примере мы сохраняем заголовок в переменную $title и выводим его на экран.

Установка кастомного заголовка


add_filter( 'pre_get_document_title', function() {
    return 'Мой кастомный заголовок';
});

С помощью хука pre_get_document_title мы можем изменить заголовок текущей страницы на кастомный. В данном примере мы используем анонимную функцию, которая возвращает строку «Мой кастомный заголовок».

Добавление префикса к заголовку


add_filter( 'pre_get_document_title', function( $title ) {
    return 'Префикс - ' . $title;
});

С помощью хука pre_get_document_title мы можем добавить префикс к заголовку текущей страницы. В данном примере мы используем анонимную функцию, которая добавляет строку «Префикс — » перед текущим заголовком.

Удаление префикса из заголовка


add_filter( 'document_title_parts', function( $title_parts ) {
    $title_parts['title'] = str_replace( 'Префикс - ', '', $title_parts['title'] );
    return $title_parts;
});

С помощью хука document_title_parts мы можем изменить массив с заголовком текущей страницы. В данном примере мы используем анонимную функцию, которая удаляет строку «Префикс — » из текущего заголовка.

Изменение заголовка в зависимости от условий


add_filter( 'pre_get_document_title', function( $title ) {
    if ( is_front_page() ) {
        return 'Главная страница';
    } elseif ( is_archive() ) {
        return 'Архив';
    } else {
        return $title;
    }
});

С помощью хука pre_get_document_title мы можем изменить заголовок текущей страницы в зависимости от условий. В данном примере мы используем анонимную функцию, которая возвращает разные заголовки в зависимости от типа страницы: «Главная страница» для главной страницы сайта и «Архив» для архивных страниц. В остальных случаях заголовок остается без изменений.

Создание динамического заголовка документа на основе данных из базы данных


$title = wp_get_document_title();
$title .= ' - ' . get_bloginfo( 'name' );
echo $title;

В этом примере мы сначала используем функцию wp_get_document_title() для получения текущего заголовка документа. Затем мы добавляем к нему название сайта, полученное с помощью функции get_bloginfo(). В результате получается динамический заголовок документа, который содержит и название страницы, и название сайта.

Добавление дополнительной информации в заголовок документа


$title = wp_get_document_title();
$title .= ' - ' . get_bloginfo( 'description' );
echo $title;

В этом примере мы сначала используем функцию wp_get_document_title() для получения текущего заголовка документа. Затем мы добавляем к нему описание сайта, полученное с помощью функции get_bloginfo(). В результате получается заголовок документа, который содержит и название страницы, и описание сайта.

Использование фильтров для настройки заголовка документа


function custom_document_title( $title ) {
    $title .= ' - Custom Text';
    return $title;
}
add_filter( 'document_title', 'custom_document_title' );

В этом примере мы создаем функцию custom_document_title(), которая принимает текущий заголовок документа в качестве аргумента и добавляет к нему свой собственный текст. Затем мы используем функцию add_filter() для добавления нашей функции в качестве фильтра для хука document_title. В результате заголовок документа будет изменен с добавлением нашего собственного текста.

Вопросы и ответы

Как установить одинаковый заголовок для всех страниц сайта?

Функция wp_get_document_title() возвращает заголовок документа для текущей страницы. Это полезно, когда требуется установить одинаковый заголовок для всех страниц сайта.

Для установки одинакового заголовка для всех страниц сайта, можно использовать фильтр document_title_parts. Этот фильтр позволяет изменить массив с данными о заголовке документа.


function custom_document_title_parts( $title ) {
    $title['title'] = 'Мой заголовок';
    return $title;
}
add_filter( 'document_title_parts', 'custom_document_title_parts' );

В приведенном выше примере мы определяем функцию custom_document_title_parts(), которая изменяет значение ключа 'title' в массиве $title на ‘Мой заголовок’. Затем мы добавляем эту функцию в качестве фильтра с помощью функции add_filter().

Как изменить заголовок документа для конкретной страницы?

Для изменения заголовка документа для конкретной страницы в WordPress можно использовать функцию add_filter() и хук document_title_parts. В этом случае, заголовок документа будет изменен только для указанной страницы.

function custom_document_title( $title ) {
    if ( is_page( 'about' ) ) {
        $title['title'] = 'О нас';
    }
    return $title;
}
add_filter( 'document_title_parts', 'custom_document_title' );

Как добавить дополнительную информацию в заголовок документа?

Для добавления дополнительной информации в заголовок документа в WordPress можно использовать функцию add_filter() и хук document_title_parts. В этом случае, дополнительная информация будет добавлена ко всем заголовкам документа на сайте.

function add_custom_info_to_title( $title ) {
    $title['title'] .= ' - Дополнительная информация';
    return $title;
}
add_filter( 'document_title_parts', 'add_custom_info_to_title' );

Как удалить разделитель из заголовка документа?

Для удаления разделителя из заголовка документа в WordPress можно использовать функцию add_filter() и хук document_title_separator. В этом случае, разделитель будет удален из всех заголовков документа на сайте.

function remove_title_separator( $separator ) {
    return '';
}
add_filter( 'document_title_separator', 'remove_title_separator' );

Как использовать переменные в заголовке документа?

Функция wp_get_document_title() возвращает заголовок документа для текущей страницы. Заголовок документа можно использовать для отображения информации о странице в браузере или в поисковой выдаче.

Для использования переменных в заголовке документа, вы можете передать их в функцию wp_get_document_title() в качестве аргументов. Например:


$title = 'My Custom Title';
$document_title = wp_get_document_title( $title );

В этом примере мы передаем переменную $title в функцию wp_get_document_title() и сохраняем результат в переменную $document_title.

Как изменить форматирование заголовка документа?

Функция wp_get_document_title() возвращает заголовок документа в виде строки. Если вам нужно изменить форматирование заголовка, вы можете использовать фильтр document_title_parts.

Пример кода:


add_filter( 'document_title_parts', 'custom_document_title_parts' );
function custom_document_title_parts( $title_parts ) {
    $title_parts['title'] = 'Custom Title';
    return $title_parts;
}

В этом примере мы используем фильтр document_title_parts для изменения заголовка документа. Функция custom_document_title_parts() принимает массив $title_parts, изменяет значение ключа ‘title’ и возвращает измененный массив.

Как добавить динамический заголовок документа на основе контента страницы?

Чтобы добавить динамический заголовок документа на основе контента страницы, вы можете использовать хук pre_get_document_title.

Пример кода:


add_filter( 'pre_get_document_title', 'custom_pre_get_document_title' );
function custom_pre_get_document_title( $title ) {
    if ( is_singular() ) {
        $post_id = get_the_ID();
        $post_title = get_the_title( $post_id );
        $title = $post_title . ' - ' . $title;
    }
    return $title;
}

В этом примере мы используем хук pre_get_document_title для изменения заголовка документа. Функция custom_pre_get_document_title() проверяет, является ли текущая страница отдельным постом или страницей, получает заголовок текущего поста с помощью функции get_the_title() и добавляет его к существующему заголовку.

Как использовать многоязычные заголовки документа?

Функция wp_get_document_title() возвращает заголовок документа для текущей страницы. Если вы хотите использовать многоязычные заголовки, вам потребуется использовать плагин или код, который будет менять заголовок в зависимости от выбранного языка.

Для этого вы можете использовать плагин, такой как WPML или Polylang, которые предоставляют возможность задавать разные заголовки для каждого языка. Например, вы можете использовать функцию pll_current_language() из плагина Polylang, чтобы получить текущий язык и затем использовать условные операторы для вывода соответствующего заголовка.


if (function_exists('pll_current_language')) {
    $current_language = pll_current_language();
    if ($current_language == 'en') {
        echo 'English Title';
    } elseif ($current_language == 'fr') {
        echo 'Titre en français';
    } else {
        echo 'Default Title';
    }
}

Как изменить порядок элементов в заголовке документа?

Функция wp_get_document_title() возвращает заголовок документа в виде строки. Если вы хотите изменить порядок элементов в заголовке, вы можете использовать хук document_title_parts.

Хук document_title_parts позволяет вам изменить массив, содержащий различные части заголовка, такие как название сайта и заголовок страницы. Вы можете изменить порядок элементов в массиве, чтобы изменить порядок, в котором они выводятся в заголовке документа.


function custom_document_title_parts($title_parts) {
    $title_parts['site'] = 'My Custom Site Name';
    $title_parts['title'] = 'My Custom Page Title';
    return $title_parts;
}
add_filter('document_title_parts', 'custom_document_title_parts');

Как добавить кастомный разделитель в заголовок документа?

Функция wp_get_document_title() возвращает заголовок документа в виде строки. Если вы хотите добавить кастомный разделитель между элементами заголовка, вы можете использовать хук document_title_separator.

Хук document_title_separator позволяет вам изменить разделитель, который используется между элементами заголовка. Вы можете задать свой собственный разделитель, например, дефис или вертикальную черту.


function custom_document_title_separator($separator) {
    $separator = '|';
    return $separator;
}
add_filter('document_title_separator', 'custom_document_title_separator');

Функция wp_get_document_title() позволяет получить заголовок документа для текущей страницы. Вы можете использовать многоязычные заголовки, изменять порядок элементов в заголовке и добавлять кастомный разделитель с помощью соответствующих хуков. Это полезные функции для настройки заголовков страниц в WordPress.

Связанные элементы

  • Функция wp_title(): выводит заголовок текущей страницы.
  • Функция add_theme_support(): добавляет поддержку определенных функций в тему.
  • Функция is_page(): проверяет, является ли текущая страница страницей.
  • Функция get_the_title(): возвращает заголовок текущего поста.
  • Функция the_title(): выводит заголовок текущего поста.
  • Функция get_bloginfo(): возвращает информацию о блоге или сайте.
  • Функция get_the_archive_title(): возвращает заголовок текущего архива.
  • Функция the_archive_title(): выводит заголовок текущего архива.
  • Хук document_title_separator: позволяет изменить разделитель в заголовке документа.
  • Хук document_title_parts: позволяет изменить части заголовка документа.
Обсуждение