document_titleхук-фильтрWP 5.8.0

Позволяет изменить <title> заголовок страницы.

Этот хук изменяет полностью сформированный заголовок - готовую строку. В отличии от аналогичного хука document_title_parts, который позволяет изменить отдельные части заголовка.

Хук работает только если:

  • Включена поддержка темы 'title-tag'.
  • И Не отключен хук add_action( 'wp_head', '_wp_render_title_tag', 1 );

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

add_filter( 'document_title', 'wp_kama_document_title_filter' );

/**
 * Function for `document_title` filter-hook.
 * 
 * @param string $title Document title.
 *
 * @return string
 */
function wp_kama_document_title_filter( $title ){

	// filter...
	return $title;
}
$title(строка)
Заголовок страницы (title).

Примеры

0

#1 Изменим заголовок главной страницы

Для главной страницы сайта по умолчанию WordPress в title генерирует название сайта + описание, которые указываются на странице "Настройки -> Общие". Например:

Мой тестовый сайт — Ещё один сайт на WordPress

Изменим заголовок только главной страницы:

add_filter( 'document_title', 'modify_document_title_for_front_page' );

/**
 * Изменяет заголовок главной страницы сайта.
 *
 * @param string $title
 *
 * @return string
 */
function modify_document_title_for_front_page( $title ) {
	return is_front_page() ? 'Это заголовок только для главной страницы' : $title;
}

Список изменений

С версии 5.8.0 Введена.

Где вызывается хук

wp_get_document_title()
document_title
wp-includes/general-template.php 1279
$title = apply_filters( 'document_title', $title );

Где используется хук в WordPress

wp-includes/default-filters.php 155
add_filter( $filter, 'wptexturize' );
wp-includes/default-filters.php 156
add_filter( $filter, 'convert_chars' );
wp-includes/default-filters.php 157
add_filter( $filter, 'esc_html' );
wp-includes/default-filters.php 162
add_filter( $filter, 'capital_P_dangit', 11 );