document_title_separator
Позволяет изменить разделитель в заголовке страницы (выводится в 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 Изменим разделитель меджду частями заголовка страницы
По умолчанию разделитель - это тире -. Давайте заменим его ::.
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-includes/general-template.php 1267
$sep = apply_filters( 'document_title_separator', '-' );