WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

document_title_parts хук-фильтр . WP 4.4.0

Позволяет изменить заголовок (title) страницы сайта на WordPress.

Это фильтр для функции wp_get_document_title(), которая по умолчанию должна выводить заголовок страницы на фронте в HEAD части HTML.

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

add_filter( 'document_title_parts', 'filter_function_name_4438' );
function filter_function_name_4438( $title ){
	// filter...

	return $title;
}
$title(массив)

Ассоциативный массив со всеми частями заголовка. Части затем объединяются через разделитель -. Разделитель можно изменить через фильтр document_title_separator.

Элементы массива:

  • title (строка)
    Заголовок просматриваемой страницы.

  • page (строка)
    Текст для страницы пагинации. Создается на основе одной из глобальных переменных: global $page, $paged.

  • tagline (строка)
    Описание сайта на домашней странице - is_front_page().

  • site (строка)
    Описание сайта на любой странице, кроме домашней.

Примеры

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

add_filter( 'document_title_parts', 'filter_function_name_2114' );
function filter_function_name_2114( $title ){
	if( is_page('portfolio') )
		$title['title'] = 'Моя страница портфолио — Декстер Морган';

	return $title;
}

#2 Удаление названия сайта в конце заголовка

Ко всем заголовкам на отдельных страницах is_singular() добавляется название сайта, через разделитель. Это не всегда хорошо, давайте поправим этот момент. Для этого используем фильтр: document_title_parts:

add_filter( 'document_title_parts', function( $parts ){
	if( isset($parts['site']) )
		unset($parts['site']);

	return $parts;
});

#3 Удаление описания сайта из заголовка главной страницы

На главной странице выводиться "Название сайта - описание сайта". Чтобы удалить описание и выводить только называние, используйте такой хук:

// удалим описание из заголовка для главной страницы
add_filter( 'document_title_parts', function( $title ){
	if( isset($title['tagline']) )
		unset( $title['tagline'] );

	return $title;
});

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

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

Где используется хук (в ядре WP)

Использование не найдено.
Комментариев нет
    Здравствуйте, !     Войти . Зарегистрироваться