document_title_parts │ хук-фільтр │ WP 4.4.0

Дозволяє змінити заголовок (title) сторінки сайту WordPress.

Це фільтр для функції add_theme_support( ‘title-tag’ ) .

Цей фільтр дозволяє змінити частини заголовка – заголовок будується зі складових частин.

Використовуйте хук document_title для зміни повністю сформованого заголовка.

Використання

add_filter( 'document_title_parts', 'wp_kama_document_title_parts_filter');

/**
 * Function for `document_title_parts` filter-hook.
 *
 * @param array $title The document title parts.
 *
 * @return array
 */
function wp_kama_document_title_parts_filter( $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() додається назва сайту через роздільник. Це не завжди добре, давайте поправимо цей момент:

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

	return $parts;
});

#3 Видалення опису сайту із заголовка головної сторінки

На головній сторінці title за промовчанням виводиться за шаблоном “Назва сайту – опис сайту”. Щоб видалити опис сайту, скористайтесь кодом:

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

	return $title;
});