# Функция WP_TITLE() │ WP 1.0.0
Функция wp_title() отображает или получает заголовок страницы.
**Важно:** Эта функция устарела с версии WP 4.4. Вместо неё рекомендуется использовать поддержку темы с помощью add_theme_support('title-tag').
## Поддержка темы 'title-tag'
Чтобы WordPress мог управлять заголовком документа, необходимо добавить поддержку темы. Это делается следующим образом:
```php
add_theme_support( 'title-tag' );Функция 'title-tag' работает на основе wp_get_document_title().
Настройка заголовка
Вы можете задать разделитель между заголовком страницы и дополнительными словами. Начиная с версии 2.5, можно также указать направление разделителя: справа или слева (по умолчанию без указания).
Этот шаблон можно использовать в любом месте: как внутри, так и вне цикла The Loop. Обычно его используют для отображения тега <title> в <head> страницы.
Примеры использования функции
// Простой пример без разделителя
<?php bloginfo('name'); ?> <?php wp_title('', true); ?>
// Пример для главной страницы
<?php bloginfo('name'); ?> | <?php is_home() ? bloginfo('description') : wp_title(''); ?>
// Пример с кастомным разделителем
<?php bloginfo('name'); ?><?php wp_title('|'); ?> Вывод: Заголовок блога | Заголовок страницы
Важно: Не используйте _ и -- в качестве разделителей, это может вызвать ошибки.
Возвращаемые значения
Функция wp_title() возвращает либо строку, либо null. Она возвращает строку, когда параметр $display установлен в false, в противном случае ничего не возвращает.
Параметры функции
wp_title( $sep, $display, $seplocation );$sep(string) — Как разделять различные элементы заголовка страницы. По умолчанию:'»'.$display(bool) — Нужно ли отображать или получать заголовок. По умолчанию:true.$seplocation(string) — Направление для отображения разделителя. Если указатьright, разделитель ��удет справа от заголовка, в противном случае — слева. По умолчанию:''.
Шаблон и функции
В случае, если вам нужно получить заголовок в других ситуациях, используйте соответствующие функции, такие как:
is_single()— для вывода заголовка одной записи.is_category()— для вывода заголовка категории и т.д.
Примеры использования функции в коде
// Выводим заголовок блога и заголовок страницы
$title = wp_title('|', true, 'right') . bloginfo('name');Примечания
- Для работы с локализацией даты и времени используйте объект
WP_Locale.
Изменения
- Версия 1.0.0 — функция была введена.
Структура функции WP_TITLE()
Функция wp_title() располагается в файле wp-includes/general-template.php.
Код функции
function wp_title( $sep = '»', $display = true, $seplocation = '' ) {
global $wp_locale;
// Логика определения, какой заголовок выводить...
// и другие необходимые операции
// Возврат результата
if ( $display ) {
echo $title;
} else {
return $title;
}
}Эта функция проверяет различные условия (например, если это страница, запись, архив и т.д.) и формирует заголовок для вывода.
Завершение
Разделитель и способ отображения заголовка — важные аспекты, которые помогут вам улучшить SEO и пользовательский опыт на вашем сайте. Настройте эту функцию под свои нужды, чтобы сделать ваш сайт более привлекательным для посетителей и поисковых систем.