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).

Приклади

#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()

pre_get_document_title

document_title_separator

document_title_parts

document_title

wp-includes/general-template.php 1274

$title = apply_filters('document_title', $title);

Де використовується хук у WordPress

wp-includes/default-filters.php 147

add_filter($filter, 'wptexturize');

wp-includes/default-filters.php 148

add_filter($filter, 'convert_chars');

wp-includes/default-filters.php 149

add_filter( $filter, 'esc_html');

wp-includes/default-filters.php 154

add_filter($filter, 'capital_P_dangit', 11);