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

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

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

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

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

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 (рядок)
  Опис сайту на будь-якій сторінці, крім домашньої.

Приклади

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

	return $title;
}

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

	return $parts;
});

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

	return $title;
});

Додати свій приклад

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

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

Використання не знайдено.