wp_title()

Функция wp_title() выводит или возвращает заголовок страницы, который принято использовать в теге <title></title>.

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

Параметры

  • $sep string
    Разделитель между частями заголовка (например, | ).
    По умолчанию: '»'
  • $display bool
    Выводить (true) или просто вернуть (false) заголовок.
    По умолчанию: true
  • $seplocation string
    Определяет местоположение разделителя в заголовке. Если right, разделитель будет добавлен справа от заголовка, при любом другом значении разделитель будет слева.
    По умолчанию: ''
wp_title( $sep, $display, $seplocation );

Возвращает

string|void Выведет на экран заголовок (void) или вернет заголовок страницы (string).

Дополнительная информация

  1. Функцию используют внутри head для вывода заголовка страницы в теге title.
  2. В качестве альтернативы с версии 4.4 используется функция wp_get_document_title(), которая заменяет функционал функции wp_title().

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

Пример 1. Стандартный вывод заголовка страницы

<title><?php echo wp_title() ?></title>

Пример 2. Вывод заголовка с другим разделителем

<title><?php echo wp_title( '|' ) ?></title>

Во избежания ошибок не используйте в качестве разделителя символы _ и --.

Пример 3. Вывод заголовка без разделителя

<title><?php echo wp_title( '' ) ?></title>

Пример 4. Запись заголовка в переменную и проверка

$title = wp_title('', false);
if( empty( $title ) ) {
   $title = 'Заголовка нет';
}

echo $title;

Хуки

wp_title_parts wp_title

Информация о функции

Добавлена в версии 1.0.0

wp-includes/post-template.php

Исходный код в Github

Другие функции

is_404()

Определяет, является ли текущая страница страницей ошибки 404.

the_title_attribute()

Выводит заголовок записи в html атрибутах.

wp_get_document_title()

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

single_post_title()

Выводит или возвращает заголовок текущего поста (записи, страницы, кастомного типа).

get_the_title()

Возвращает заголовок записи/страницы.

the_title()

Используется для вывода на экран или получения заголовка текущей записи/страницы.