Функция 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
).
Дополнительная информация
- Функцию используют внутри
head
для вывода заголовка страницы в тегеtitle
. - В качестве альтернативы с версии 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