Функция wp_title() в WordPress с примерами

Главная - WordPress Codex - Функция wp_title() в WordPress с примерами
Доступна с версии: 1.0
Раздел: Тема
Написал: Александр Сокирка

Функция wp_title() используется для вывода или возвращения заголовка текущей страницы с разделителем. Она устарела с версии 4.4, и рекомендуется использовать поддержку темы 'title-tag' вместо этой функции.

wp_title( string $sep = ‘»’, bool $display = true, string $seplocation = ” ): string|void

Параметры

  • $sep (строка) (по умолчанию: '»'): Разделитель, который отображается до или после заголовка страницы.
  • $display (логический) (по умолчанию: true): Определяет, выводить заголовок сразу на экран или вернуть его как строку. Если false, функция возвращает строку.
  • $seplocation (строка) (по умолчанию: ''): Определяет расположение разделителя. Значение 'right' размещает разделитель справа от заголовка, любое другое значение — слева.

Возвращаемое значение

  • Строка: Заголовок страницы, если $display = false.
  • null: Если заголовок выводится напрямую.

Основная цель

Функция помогает вывести заголовок страницы в теге <title> внутри <head>, используя настраиваемый разделитель. Вы можете управлять расположением разделителя (слева или справа от заголовка) и выводить заголовок как в шаблоне темы, так и в админке WordPress.

Устаревание

С версии WordPress 4.4 функция wp_title() считается устаревшей. Вместо неё рекомендуется использовать встроенную поддержку 'title-tag' в темах, которая управляется функцией wp_get_document_title().

Пример для использования title-tag

// Добавляем поддержку тега title
add_theme_support( 'title-tag' );

Пример 1: Вывод заголовка блога и страницы

<title><?php bloginfo('name'); ?> <?php wp_title(); ?></title>

Результат:
Заголовок блога » Название поста

Пример 2: Заголовок страницы слева, а название блога справа

<title><?php wp_title('|', true, 'right'); ?> <?php bloginfo('name'); ?></title>

Результат:
Название поста | Заголовок блога

Пример 3: Убираем разделитель

<title><?php bloginfo('name'); ?> <?php wp_title('', true); ?></title>

Результат:
Заголовок блога Название поста

Пример 4: Отдельный заголовок для главной страницы

<title><?php bloginfo('name'); ?> | 
<?php is_home() ? bloginfo('description') : wp_title(''); ?></title>

Результат для главной страницы:
Заголовок блога | Описание сайта

Пример 5: Использование разделителя «|»

<title><?php bloginfo('name'); ?><?php wp_title('|'); ?></title>

Результат:
Заголовок блога | Заголовок страницы

Важно

  • Не рекомендуется использовать символы разделителей вроде » _ » и «—«, так как это может вызвать ошибки.

Альтернатива: wp_get_document_title()

С версии WordPress 4.4, для управления заголовками страниц, рекомендуется использовать функцию wp_get_document_title(), которая полностью заменяет функционал wp_title().

Заключение

Функция wp_title() устарела и больше не используется в современных темах WordPress. Для управления заголовками рекомендуется использовать поддержку title-tag через add_theme_support(), что делает управление заголовками страниц более универсальным и интегрированным в ядро WordPress.

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема