Cum să schimbi separatorul în titlu

Modul în care este generat titlul documentului s-a schimbat începând cu WordPress v4.4.0. Acum wp_get_document_title dictează cum este generat titlul:

/**
 * Afișează tag-ul de titlu cu conținut.
 *
 * @ignore
 * @since 4.1.0
 * @since 4.4.0 Îmbunătățire a afișării titlului, înlocuind `wp_title()`.
 * @access private
 */
function _wp_render_title_tag() {
    if ( ! current_theme_supports( 'title-tag' ) ) {
        return;
    }

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

Iată codul din versiunea v5.4.2. Iată filtrele pe care le puteți utiliza pentru a manipula tag-ul de titlu:

function wp_get_document_title() {
    /**
    * Filtrează titlul documentului înainte de a fi generat.
    *
    * Transmiterea unei valori non-goale va scurta circuitul wp_get_document_title(),
    * returnând acea valoare în schimb.
    *
    * @since 4.4.0
    *
    * @param string $title Titlul documentului. Valoare implicită string gol.
    */
    $title = apply_filters( 'pre_get_document_title', '' );
    if ( ! empty( $title ) ) {
        return $title;
    }
    // --- tăiat ---
    /**
    * Filtrează separatorul pentru titlul documentului.
    *
    * @since 4.4.0
    *
    * @param string $sep Separator pentru titlul documentului. Valoare implicită '-'.
    */
    $sep = apply_filters( 'document_title_separator', '-' );

    /**
    * Filtrează părțile titlului documentului.
    *
    * @since 4.4.0
    *
    * @param array $title {
    *     Părțile titlului documentului.
    *
    *     @type string $title   Titlul paginii vizualizate.
    *     @type string $page    Opțional. Numărul paginii dacă este paginat.
    *     @type string $tagline Opțional. Descrierea site-ului când este pe pagina principală.
    *     @type string $site    Opțional. Titlul site-ului când nu este pe pagina principală.
    * }
    */
    $title = apply_filters( 'document_title_parts', $title );
    // --- tăiat ---
    return $title;
}

Deci, iată două modalități prin care puteți face acest lucru.

Prima utilizează filtrul pre_get_document_title care scurtează generarea titlului și, prin urmare, este mai performant dacă nu intenționați să faceți modificări la titlul curent:

function custom_document_title( $title ) {
    return 'Acesta este noul titlu';
}
add_filter( 'pre_get_document_title', 'custom_document_title', 10 );

A doua metodă utilizează hook-urile document_title_separator și document_title_parts pentru titlu și separatorul de titlu care sunt executate mai târziu în funcție, după ce titlul este generat folosind funcții precum single_term_title sau post_type_archive_title în funcție de pagină și este pe cale să fie afișat:

// Funcția personalizată trebuie să returneze un string
function custom_seperator( $sep ) {
   return '>';
}
add_filter( 'document_title_separator', 'custom_seperator', 10 );

// Funcția personalizată trebuie să returneze un array
function custom_html_title( $title ) {
   return array(
     'title' => 'Titlu Personalizat',
     'site'  => 'Site Personalizat'
    );
}
add_filter( 'document_title_parts', 'custom_html_title', 10 );