Come modificare programmaticamente il nome utente (user_login)?

Potresti considerare di modificare anche lo user_nicename tramite la query SQL. Una volta fatto, tutti i permalink e le altre funzionalità funzioneranno perfettamente.

Oltre alla risposta di Krzysiek Dróżdż.

Se non vuoi disconnettere gli utenti dopo aver modificato user_login, devi fare quanto segue per mantenere l'utente connesso con i nuovi dati:

clean_user_cache($user->ID);
wp_clear_auth_cookie();
wp_set_current_user($user->ID);
wp_set_auth_cookie($user->ID, true);
update_user_caches($user);

Devi utilizzare il filtro per modificare il $data quando l'utente viene aggiornato, non puoi agire con l'azione a cui ti collegheresti normalmente per un aggiornamento utente.

Inoltre, devi integrare diverse misure di sicurezza e controlli che WordPress applica nel suo codice nella tua nuova funzione.

Cosa puoi fare:

1. Collegati al filtro wp_pre_insert_user_data. Assicurati di farlo solo con i permessi corretti: add_filter( 'wp_pre_insert_user_data', 'prefix_change_user_login', 10, 4 );
2. Ora crea una funzione prefix_change_user_login dove prendi il $data, il user_login dal $_POST e lo sottoponi a una serie di validazioni e sanificazioni (vedi https://github.com/WordPress/wordpress-develop/blob/bb27ffce6c3b10738008f9a054782945a0744960/src/wp-includes/user.php#L2076-L2498 per maggiori dettagli)
3. Inoltre, ovviamente, dovrai consentire la modifica effettiva del campo di login utente nella schermata di modifica utente di WP Admin, oppure passare quel valore in qualche altro modo al tuo codice.

Un esempio di tale funzione:

    /**
     * Aggiorna il nome di login dell'utente
     *
     * @since x.x.x
     * @param array    $data {
     *     Valori e chiavi per l'utente.
     *
     *     @type string $user_login      Il login dell'utente. Incluso solo se $update == false
     *     @type string $user_pass       La password dell'utente.
     *     @type string $user_email      L'email dell'utente.
     *     @type string $user_url        L'URL dell'utente.
     *     @type string $user_nicename   Il nome "nice" dell'utente. Di default una versione URL-safe del login
     *     @type string $display_name    Il nome visualizzato dell'utente.
     *     @type string $user_registered Timestamp MySQL che descrive il momento della registrazione. Default
     *                                   al timestamp UTC corrente.
     * }
     * @param bool     $update   Indica se l'utente viene aggiornato anziché creato.
     * @param int|null $user_id  ID dell'utente da aggiornare, o NULL se l'utente viene creato.
     * @param array    $userdata L'array grezzo di dati passato a wp_insert_user().
     */
    function prefix_change_user_login( $data, $update, $user_id, $userdata ){

        // NON DIMENTICARE DI AGGIUNGERE QUI LA VALIDAZIONE DEL NONCE E DEL REFERRER!!!!

        $sanitized_user_login = sanitize_user( wp_unslash( $_POST['user_login'] ), true );// Nel nostro caso otteniamo il nuovo user login dal valore POST del form in WP Admin. Se il tuo caso d'uso è diverso, adattalo!!

        /**
         * Filtra un username dopo che è stato sanificato.
         *
         * Questo filtro viene chiamato prima che l'utente venga creato o aggiornato.
         *
         * @since 2.0.3
         *
         * @param string $sanitized_user_login Username dopo la sanificazione.
         */
        $pre_user_login = apply_filters( 'pre_user_login', $sanitized_user_login );
        $illegal_logins = (array) apply_filters( 'illegal_user_logins', array() );

        // Rimuovi qualsiasi carattere non stampabile dalla stringa di login per verificare se abbiamo ottenuto un username vuoto.
        $user_login = trim( $pre_user_login );

        if ( empty( $user_login )
            || mb_strlen( $user_login ) > 60
            || username_exists( $user_login )
            || in_array( strtolower( $user_login ), array_map( 'strtolower', $illegal_logins ), true )
        ) {
            return $data;
        }

        $data['user_login'] = $user_login;
        $user_nicename = sanitize_title( mb_substr( $user_login, 0, 50 ) );// Chi sa cosa avessero fumato gli sviluppatori di WP quando hanno deciso di rendere il nicename 10 caratteri più corto del nome di login?
        global $wpdb;
        $user_nicename_check = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->users WHERE user_nicename = %s AND user_login != %s LIMIT 1", $user_nicename, $user_login ) );

        if ( $user_nicename_check ) {
            $suffix = 2;
            while ( $user_nicename_check ) {
                // user_nicename permette 50 caratteri. Sottrai uno per il trattino, più la lunghezza del suffisso.
                $base_length         = 49 - mb_strlen( $suffix );
                $alt_user_nicename   = mb_substr( $user_nicename, 0, $base_length ) . "-$suffix";
                $user_nicename_check = $wpdb->get_var( $wpdb->prepare( "SELECT ID FROM $wpdb->users WHERE user_nicename = %s AND user_login != %s LIMIT 1", $alt_user_nicename, $user_login ) );
                $suffix++;
            }
            $user_nicename = $alt_user_nicename;
        }
        $data['user_nicename'] = $user_nicename;

        return $data;

    }

Questo ti permetterà di aggiornare il nome di login dell'utente, e aggiornerà anche il user nicename (usato negli archivi per esempio) Ovviamente questo richiede ancora di "abilitare" la modifica nell'area di amministrazione di WP, ma non dovrebbe essere troppo difficile

Nota che se si verifica qualsiasi errore nel codice sopra (username già esistente, ecc.) NON viene mostrato alcun errore, invece l'utente viene semplicemente aggiornato e torna al valore precedente.

Nota che, sebbene questo codice sia testato, sta a te decidere cosa farne, e ci sono MOTIVI per cui wp non permette di aggiornare il login utente