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 1294
$title = apply_filters( 'document_title', $title );
Где используется хук в WordPress
wp-includes/default-filters.php 164
add_filter( $filter, 'wptexturize' );
wp-includes/default-filters.php 165
add_filter( $filter, 'convert_chars' );
wp-includes/default-filters.php 166
add_filter( $filter, 'esc_html' );
wp-includes/default-filters.php 171
add_filter( $filter, 'capital_P_dangit', 11 );