document_title
Позволяет изменить <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-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 );