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

Позволяет изменить разделитель в заголовке страницы (выводится в head документа).

Заголовок страницы в WordPress выводится функцией wp_get_document_title().

Пример заголовка и разделителя:

<!doctype html>
<head>
	...
	<title>Hello world! - My Awesome Site</title>

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

add_filter( 'document_title_separator', 'wp_kama_document_title_separator_filter' );

/**
 * Function for `document_title_separator` filter-hook.
 * 
 * @param string $sep Document title separator.
 *
 * @return string
 */
function wp_kama_document_title_separator_filter( $sep ){

	// filter...
	return $sep;
}
$sep(строка)
Document title separator.
По умолчанию: '-'

Примеры

1

#1 Изменим разделитель меджду частями заголовка страницы

По умолчанию разделитель - это тире -. Давайте заменим его ::.

add_filter( 'document_title_separator', 'change_document_title_separator' );
function change_document_title_separator( $sep ){
	return ' :: ';
}

С версии PHP 7.4 можно записать короче, используя стрелочные функции:

add_filter( 'document_title_separator', fn() => '::' );

Список изменений

С версии 4.4.0 Введена.

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

wp_get_document_title()
document_title_separator
wp-includes/general-template.php 1257
$sep = apply_filters( 'document_title_separator', '-' );

Где используется хук в WordPress

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