wp_title()

Отображает или извлекает заголовок страницы для всех областей блога
Функция WordPress
INT 1.0.0
WordPress Icon

Описание функции

Функция wp_title() используется для отображения или получения заголовка страницы для всех областей блога. Она позволяет установить заголовок страницы, который будет отображаться в теге <title> в HTML-коде страницы.

Использование

wp_title( string $sep = '&raquo;', bool $display = true, string $seplocation = '' ) : string|void

Функция wp_title() принимает три параметра:

  • $sep (строка, необязательный) — символ или текст, который будет использоваться для разделения различных элементов в заголовке страницы. Значение по умолчанию: ‘&raquo;’.
  • $display (логическое значение, необязательный) — определяет, нужно ли отображать заголовок страницы или получить его значение. Значение по умолчанию: true.
  • $seplocation (строка, необязательный) — определяет расположение разделителя (‘left’ или ‘right’). Значение по умолчанию: ».

Функция возвращает строку, если параметр $display равен false, и ничего не возвращает в противном случае.

<?php
// Установка заголовка страницы
$title = wp_title( '&raquo;', false, 'right' );
?>
<title><?php echo $title; ?></title>

В данном примере мы используем функцию wp_title() для установки заголовка страницы. Разделитель между элементами заголовка установлен как ‘&raquo;’, а разделитель расположен справа. Результат функции сохраняется в переменной $title, а затем выводится в теге <title>.

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

Вывод заголовка страницы в шаблоне сайта


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

Для вывода заголовка страницы в шаблоне сайта используется функция wp_title(). Она автоматически выводит или извлекает заголовок страницы для всех областей блога. В данном примере кода функция wp_title() вызывается без параметров, поэтому будет использован разделитель по умолчанию — символ ‘»’. Результатом выполнения функции будет вывод заголовка страницы внутри тега <title>.

Изменение разделителя в заголовке страницы


<title><?php wp_title('-', true); ?></title>

Для изменения разделителя в заголовке страницы необходимо передать первым параметром функции wp_title() новый разделитель. В данном примере кода разделитель изменен на символ ‘-‘. Второй параметр функции установлен в значение true, что означает вывод заголовка страницы. Результатом выполнения функции будет вывод заголовка страницы с новым разделителем внутри тега <title>.

Скрытие заголовка страницы


<?php wp_title('', false); ?>

Для скрытия заголовка страницы необходимо установить второй параметр функции wp_title() в значение false. В данном примере кода первый параметр функции оставлен пустым, что означает использование разделителя по умолчанию. Результатом выполнения функции будет возврат заголовка страницы в виде строки.

Использование функции wp_title() в плагинах


function my_custom_title() {
    $title = wp_title('', false);
    return 'Custom Title - ' . $title;
}
add_filter('wp_title', 'my_custom_title');

Функцию wp_title() можно использовать в плагинах с помощью фильтра wp_title. В данном примере кода создается пользовательская функция my_custom_title(), которая получает заголовок страницы с помощью функции wp_title('', false) и добавляет к нему префикс ‘Custom Title — ‘. Затем функция my_custom_title() добавляется в качестве фильтра для хука wp_title. Результатом выполнения функции будет возврат измененного заголовка страницы.

Настройка местоположения разделителя в заголовке страницы


<title><?php wp_title('', true, 'right'); ?></title>

Для настройки местоположения разделителя в заголовке страницы необходимо передать третий параметр функции wp_title() со значением ‘right’ или ‘left’. В данном примере кода третий параметр установлен в значение ‘right’, что означает разделитель будет расположен справа от каждого элемента заголовка страницы. Результатом выполнения функции будет вывод заголовка страницы с разделителем справа внутри тега <title>.

Вопросы и ответы

Как изменить разделитель в названии страницы?

Для изменения разделителя в названии страницы, необходимо использовать функцию wp_title() с указанием нового разделителя в качестве первого параметра.

/**
 * Изменение разделителя в названии страницы.
 *
 * @param string $title Название страницы.
 * @return string Измененное название страницы.
 */
function custom_wp_title( $title ) {
    $new_sep = '|'; // Новый разделитель
    $title = str_replace( '»', $new_sep, $title );
    return $title;
}
add_filter( 'wp_title', 'custom_wp_title' );

Как скрыть название страницы на определенных страницах?

Для скрытия названия страницы на определенных страницах, можно использовать функцию wp_title() с указанием параметра $display в значении false.

/**
 * Скрытие названия страницы на определенных страницах.
 *
 * @param bool $display Опция отображения названия страницы.
 * @return bool Опция отображения названия страницы.
 */
function hide_title_on_pages( $display ) {
    if ( is_page( array( 'about', 'contact' ) ) ) { // Список страниц, на которых нужно скрыть название
        $display = false;
    }
    return $display;
}
add_filter( 'wp_title', 'hide_title_on_pages' );

Как добавить дополнительную информацию в название страницы?

Для добавления дополнительной информации в название страницы, можно использовать функцию wp_title() с указанием параметра $display в значении false и добавить нужную информацию перед или после названия страницы.

/**
 * Добавление дополнительной информации в название страницы.
 *
 * @param bool $display Опция отображения названия страницы.
 * @return string Измененное название страницы с дополнительной информацией.
 */
function add_extra_info_to_title( $display ) {
    if ( is_single() ) { // Добавление информации только на страницах записей
        $extra_info = ' - ' . get_the_date(); // Дополнительная информация (дата публикации)
        $display = false;
        return wp_title( '', false ) . $extra_info;
    }
    return $display;
}
add_filter( 'wp_title', 'add_extra_info_to_title' );

Как изменить порядок элементов в названии страницы?

Функция wp_title() позволяет отобразить или получить название страницы для всех областей блога. По умолчанию, название страницы состоит из нескольких элементов, разделенных разделителем.

Чтобы изменить порядок элементов в названии страницы, нужно использовать фильтр document_title_parts. Этот фильтр позволяет изменить массив элементов, из которых формируется название страницы.

Пример кода:


add_filter( 'document_title_parts', 'custom_title_order' );
function custom_title_order( $title_parts ) {
    // Изменяем порядок элементов
    $title_parts['title'] = $title_parts['title'] . ' - ' . $title_parts['site'];
    unset( $title_parts['site'] );
    return $title_parts;
}

Как изменить расположение разделителя в названии страницы?

Функция wp_title() позволяет также изменить расположение разделителя в названии страницы. Для этого используется параметр $seplocation.

Если значение параметра $seplocation равно «left», разделитель будет расположен слева от элементов названия страницы. Если значение равно «right», разделитель будет расположен справа от элементов.

Пример кода:


// Разделитель слева от элементов
wp_title( '»', true, 'left' );
// Разделитель справа от элементов
wp_title( '»', true, 'right' );

Как добавить префикс или суффикс к названию страницы?

Функция wp_title() позволяет добавить префикс или суффикс к названию страницы. Для этого нужно изменить значение параметра $sep.

Пример кода:


// Добавление префикса к названию страницы
wp_title( 'My Site - ', true );
// Добавление суффикса к названию страницы
wp_title( '', true, ' - My Site' );

Как изменить название страницы для главной страницы сайта?

Для изменения названия страницы для главной страницы сайта в WordPress можно использовать функцию wp_title(). По умолчанию, название страницы для главной страницы сайта будет соответствовать значению, указанному в настройках WordPress.

Если необходимо изменить название страницы для главной страницы сайта, можно воспользоваться хуком wp_title. Этот хук позволяет изменить значение названия страницы перед его выводом.

Пример кода:

// Функция для изменения названия страницы для главной страницы сайта
function custom_wp_title( $title ) {
    if ( is_front_page() ) {
        $title = 'Новое название главной страницы';
    }
    return $title;
}
add_filter( 'wp_title', 'custom_wp_title' );

Как изменить название страницы для категорий или меток?

Для изменения названия страницы для категорий или меток в WordPress также можно использовать функцию wp_title(). По умолчанию, название страницы для категорий или меток будет соответствовать их названию.

Если необходимо изменить название страницы для категорий или меток, можно воспользоваться хуком wp_title. Этот хук позволяет изменить значение названия страницы перед его выводом.

Пример кода:

// Функция для изменения названия страницы для категорий или меток
function custom_wp_title( $title ) {
    if ( is_category() || is_tag() ) {
        $title = 'Новое название категории или метки';
    }
    return $title;
}
add_filter( 'wp_title', 'custom_wp_title' );

Как добавить название сайта в название страницы?

Для добавления названия сайта в название страницы в WordPress можно использовать функцию wp_title(). По умолчанию, название страницы будет отображаться без названия сайта.

Если необходимо добавить название сайта в название страницы, можно воспользоваться хуком wp_title. Этот хук позволяет изменить значение названия страницы перед его выводом и добавить название сайта.

Пример кода:

// Функция для добавления названия сайта в название страницы
function custom_wp_title( $title ) {
    if ( is_front_page() ) {
        $title .= ' | ' . get_bloginfo( 'name' );
    }
    return $title;
}
add_filter( 'wp_title', 'custom_wp_title' );

Функция wp_title() в WordPress позволяет отображать или получать название страницы для всех областей блога. С помощью различных параметров функции можно изменять разделители и добавлять название сайта в название страницы. Хуки wp_title позволяют изменять значение названия страницы перед его выводом, что дает возможность настраивать название страницы в соответствии с требованиями проекта.

Связанные элементы

  • Хук pre_get_document_title: позволяет изменить заголовок документа перед его выводом.
  • Хук document_title_separator: позволяет изменить разделитель между элементами заголовка документа.
  • Хук document_title_parts: позволяет изменить массив элементов заголовка документа.
Обсуждение