Функция 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.