wp_title()
Выводит/возвращает заголовок страницы.
Функция считается устаревшей с версии 4.4.
Вместо неё следует использовать поддержку темы 'title-tag':
/* * Let WordPress manage the document title. * By adding theme support, we declare that this theme does not use a * hard-coded <title> tag in the document head, and expect WordPress to * provide it for us. */ add_theme_support( 'title-tag' );
В основе работы 'title-tag' лежит функция wp_get_document_title().
В функции можно указать разделитель между названием страницы и дополнительными словами в заголовке. С версии 2.5, можно указать, с какой стороны заголовка разделитель должен находиться (справа, слева).
Этот Тег шаблона можно использовать повсеместно, как за пределами Цикла WordPress, так и внутри него. Обычно его используют для указания заголовка страницы в теге <title>
в <head> части страницы.
Хуки из функции
Возвращает
Строку|null
. Строку при получении, null – при отображении.
Использование
<title><?php wp_title( $sep, $echo, $seplocation ); ?></title>
- $sep(строка)
- Текст, который будет показан до или после заголовка (разделитель). По умолчанию сепаратором будет символ:
»
.
По умолчанию: » (») - $echo(логический)
- Выводить (true) или возвращать заголовок в переменную (false). По умолчанию заголовок выводится на экран.
По умолчанию: true - $seplocation(строка)
- Определяет расположение разделителя. Введено в версии 2.5. Если указать
right
, то разделитель будет расположен справа от заголовка, во всех остальных случаях слева.
По умолчанию: ''
Примеры
#1 Поменяем местами заголовки
Если нужно отобразить сначала заголовок страницы, а затем название блога используйте такой код:
<title><?php wp_title('|', true, 'right'); ?><?php bloginfo('name'); ?></title>
#2 Выведем заголовок блога
Выведем название блога (используя bloginfo()) и заголовок страницы (предположим, что мы находимся на странице поста).
<title><?php bloginfo('name'); ?> <?php wp_title(); ?></title>
Получим: Заголовок блога » Название поста
#3 Если нужно убрать разделитель, то вызываем функцию так:
<title><?php bloginfo('name'); ?> <?php wp_title("", true); ?></title>
#4 Отдельный заголовок для главной страницы
Если для главной страницы мы используем произвольный шаблон, с произвольный выводом (Циклом WordPress), то заголовок страницы может определяться не так как нам бы хотелось. Чтобы избежать этого используйте такой код:
<title><?php bloginfo('name'); ?> | <?php is_home() ? bloginfo('description') : wp_title(''); ?></title>
#5 Использование разделителей
Выведем название блога затем заголовок страницы и в качестве разделителя установим знак "|
".
<title><?php bloginfo('name'); ?><?php wp_title('|'); ?></title>
Получим: Заголовок блога | Заголовок страницы
Важно! Не используйте в качестве разделителя знаки "_
" и "--
". Это может вызвать ошибки.
Заметки
- Global. WP_Locale. $wp_locale WordPress date and time locale object.
Список изменений
С версии 1.0.0 | Введена. |