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