Как изменить разделитель в заголовке

Способ генерации заголовка документа изменился, начиная с WordPress версии 4.4.0. Теперь wp_get_document_title определяет, как формируется заголовок:

/**
 * Отображает тег title с содержимым.
 *
 * @ignore
 * @since 4.1.0
 * @since 4.4.0 Улучшен вывод заголовка, заменена функция `wp_title()`.
 * @access private
 */
function _wp_render_title_tag() {
    if ( ! current_theme_supports( 'title-tag' ) ) {
        return;
    }

    echo '<title>' . wp_get_document_title() . '</title>' . "\n";
}

Вот код из версии 5.4.2. Доступные фильтры для изменения тега title:

function wp_get_document_title() {
    /**
    * Фильтр заголовка документа перед его генерацией.
    *
    * Передача непустого значения прервет выполнение wp_get_document_title(),
    * вернув это значение вместо стандартного.
    *
    * @since 4.4.0
    *
    * @param string $title Заголовок документа. По умолчанию пустая строка.
    */
    $title = apply_filters( 'pre_get_document_title', '' );
    if ( ! empty( $title ) ) {
        return $title;
    }
    // --- пропущено ---
    /**
    * Фильтр разделителя для заголовка документа.
    *
    * @since 4.4.0
    *
    * @param string $sep Разделитель заголовка документа. По умолчанию '-'.
    */
    $sep = apply_filters( 'document_title_separator', '-' );

    /**
    * Фильтр частей заголовка документа.
    *
    * @since 4.4.0
    *
    * @param array $title {
    *     Части заголовка документа.
    *
    *     @type string $title   Заголовок просматриваемой страницы.
    *     @type string $page    Опционально. Номер страницы, если есть пагинация.
    *     @type string $tagline Опционально. Описание сайта на главной странице.
    *     @type string $site    Опционально. Название сайта на других страницах.
    * }
    */
    $title = apply_filters( 'document_title_parts', $title );
    // --- пропущено ---
    return $title;
}

Существует два способа изменения заголовка.

Первый использует фильтр pre_get_document_title, который прерывает генерацию заголовка и более производителен, если вам не нужно изменять текущий заголовок:

function custom_document_title( $title ) {
    return 'Новый заголовок';
}
add_filter( 'pre_get_document_title', 'custom_document_title', 10 );

Второй способ использует хуки document_title_separator и document_title_parts для заголовка и разделителя, которые выполняются позже в функции, после генерации заголовка с помощью функций типа single_term_title или post_type_archive_title в зависимости от страницы и перед выводом:

// Пользовательская функция должна возвращать строку
function custom_seperator( $sep ) {
   return '>';
}
add_filter( 'document_title_separator', 'custom_seperator', 10 );

// Пользовательская функция должна возвращать массив
function custom_html_title( $title ) {
   return array(
     'title' => 'Пользовательский заголовок',
     'site'  => 'Пользовательский сайт'
    );
}
add_filter( 'document_title_parts', 'custom_html_title', 10 );