User Switching

Preguntas frecuentes

Este plugin funciona con PHP 8?

Si, está probado activamente e funciona ata PHP 8.5.

Que significa «Switch off»?

Desconectar o cambio péchache a sesión da túa conta pero conserva o teu ID de usuario nunha cookie de identificación para que poidas volver directamente sen ter que iniciar sesión de novo manualmente. É semellante a cambiar a ningún usuario e poder volver.

A ligazón Switch Off atópase no menú do teu perfil na barra de ferramentas de WordPress. Unha vez que desconectes o cambio, verás unha ligazón Switch back en varios lugares:

• No pé de páxina do teu sitio
• Na pantalla de acceso
• No widget «Meta»

Funciona este plugin con WordPress Multisite?

Si, e tamén poderás cambiar de usuario desde a pantalla Usuarios da administración da rede.

Funciona este plugin con WooCommerce?

Si, e tamén poderás cambiar de usuario desde varias pantallas de administración de WooCommerce coa sesión iniciada como Shop Manager ou como usuario administrador.

Funciona este plugin con BuddyPress?

Si, e tamén poderás cambiar de usuario desde as pantallas de perfil dos membros e da lista de membros.

Funciona este plugin con bbPress?

Si, e tamén poderás cambiar de usuario desde as pantallas de perfil dos membros.

Funciona este plugin se o meu sitio usa un plugin de identificación de dous factores?

Si, na súa maioría.

Unha excepción que coñezo é Duo. Se usas Duo Universal ou Duo Security, deberías instalar o plugin complementario User Switching for Duo, que evitará que apareza a solicitude de identificación de dous factores cando cambies entre usuarios.

Que capacidade necesita un usuario para cambiar de conta?

Un usuario necesita a capacidade edit_users para cambiar de conta de usuario. Por defecto só os administradores teñen esta capacidade e, con Multisite activado, só a teñen os Super Admins.

Concretamente, un usuario necesita a capacidade de editar o usuario de destino para poder cambiar á súa conta. Isto significa que, se tes unha asignación de capacidades de usuario personalizada que usa as capacidades edit_users ou edit_user para afectar á capacidade dos usuarios de editar a outros, User Switching debería respectala.

Poden os administradores normais de instalacións Multisite cambiar de conta?

Non. Non obstante, pódese activar instalando o plugin User Switching for Regular Admins.

Pódese conceder a capacidade de cambiar de conta a outros usuarios ou perfís?

Si. A capacidade meta switch_users pódese conceder explicitamente a un usuario ou a un perfil para permitirlles cambiar de usuario independentemente de que teñan ou non a capacidade edit_users. Para fins prácticos, o usuario ou perfil tamén necesitará a capacidade list_users para poder acceder ao menú Usuarios na área de administración de WordPress.

add_filter( 'user_has_cap', function( $allcaps, $caps, $args, $user ) {
    if ( 'switch_to_user' === $args[0] ) {
        if ( my_condition( $user ) ) {
            $allcaps['switch_users'] = true;
        }
    }
    return $allcaps;
}, 9, 4 );

Notas:

• Isto ten que ocorrer antes do filtrado de capacidades propio de User Switching, de aí a prioridade de 9.
• O parámetro $user é o usuario que ten a sesión iniciada actualmente.
• O ID do usuario de destino pódese atopar en $args[2].

Pódese denegar a capacidade de cambiar de conta a certos usuarios?

Si. As capacidades de usuario en WordPress pódense establecer en false para denegalas a un usuario. Denegar a capacidade switch_users impide que o usuario cambie de usuario, aínda que teña a capacidade edit_users.

add_filter( 'user_has_cap', function( $allcaps, $caps, $args, $user ) {
    if ( 'switch_to_user' === $args[0] ) {
        if ( my_condition( $user ) ) {
            $allcaps['switch_users'] = false;
        }
    }
    return $allcaps;
}, 9, 4 );

Notas:

• Isto ten que ocorrer antes do filtrado de capacidades propio de User Switching, de aí a prioridade de 9.
• O parámetro $user é o usuario que ten a sesión iniciada actualmente.
• O ID do usuario de destino pódese atopar en $args[2].

Podo engadir unha ligazón «Switch To» personalizada ao meu propio plugin ou tema?

Si. Usa o método user_switching::maybe_switch_url() para isto. Encárgase da identificación e devolve unha URL protexida con nonce para que o usuario actual cambie á conta de usuario indicada.

if ( method_exists( 'user_switching', 'maybe_switch_url' ) ) {
    $url = user_switching::maybe_switch_url( $target_user );
    if ( $url ) {
        printf(
            '<a href="%1$s">Switch to %2$s</a>',
            esc_url( $url ),
            esc_html( $target_user->display_name )
        );
    }
}

Se queres especificar a URL á que se redirixe o usuario despois de cambiar, engade un parámetro redirect_to á URL así:

if ( method_exists( 'user_switching', 'maybe_switch_url' ) ) {
    $url = user_switching::maybe_switch_url( $target_user );
    if ( $url ) {
        // Redirect to the home page after switching:
        $redirect_to = home_url();
        printf(
            '<a href="%1$s">Switch to %2$s</a>',
            esc_url( add_query_arg(
                'redirect_to',
                rawurlencode( $redirect_to ),
                $url
            ) ),
            esc_html( $target_user->display_name )
        );
    }
}

O código anterior tamén serve para mostrar unha ligazón para volver ao usuario orixinal, pero se queres unha ligazón explícita para isto, podes usar o seguinte código:

if ( method_exists( 'user_switching', 'get_old_user' ) ) {
    $old_user = user_switching::get_old_user();
    if ( $old_user ) {
        printf(
            '<a href="%1$s">Switch back to %2$s</a>',
            esc_url( user_switching::switch_back_url( $old_user ) ),
            esc_html( $old_user->display_name )
        );
    }
}

Podo determinar se o usuario actual cambiou á súa conta?

Si. Usa a función current_user_switched() para isto. Se o usuario actual cambiou á súa conta desde outra, devolve un obxecto WP_User do usuario de orixe; se non, devolve false.

if ( function_exists( 'current_user_switched' ) ) {
    $switched_user = current_user_switched();
    if ( $switched_user ) {
        // User is logged in and has switched into their account.
        // $switched_user is the WP_User object for their originating user.
    }
}

Podo rexistrar cada vez que un usuario cambia a outra conta?

Podes instalar un plugin de rexistro de auditoría como Simple History, WP Activity Log ou Stream; todos eles son compatibles de forma nativa con User Switching e rexistran unha entrada cando un usuario cambia a outra conta.

Permite este plugin que un usuario incrimine a outro por unha acción?

Potencialmente si, pero User Switching inclúe algunhas proteccións de seguranza para isto e hai outras precaucións que podes tomar como administrador do sitio:

• Podes instalar un plugin de rexistro de auditoría como Simple History, WP Activity Log ou Stream; todos eles son compatibles de forma nativa con User Switching e rexistran unha entrada cando un usuario cambia a outra conta.
• User Switching almacena o ID do usuario de orixe na nova sesión de usuario de WordPress do usuario ao que cambia. Aínda que esta sesión non persiste por defecto cando posteriormente volve, haberá un rexistro deste ID se o servidor da base de datos ten activado o rexistro de consultas.
• User Switching almacena o nome de acceso do usuario de orixe nunha cookie de identificación (consulta a Declaración de privacidade para máis información). Se os rexistros de acceso do teu servidor almacenan datos de cookies, haberá un rexistro deste nome de acceso (xunto co enderezo IP) en cada solicitude de acceso.
• User Switching activa unha acción cando un usuario cambia de conta, desconecta o cambio ou volve (ver abaixo). Podes usar estas accións para rexistrar información adicional por motivos de seguranza segundo as túas necesidades.

Un ou máis dos anteriores deberían permitirche correlacionar unha acción co usuario de orixe cando un usuario cambia de conta, se o necesitas.

Ten en conta que, aínda sen usar o plugin User Switching, calquera usuario que poida editar a outro usuario pode incriminalo por unha acción, por exemplo, cambiando o seu contrasinal e accedendo manualmente a esa conta. Se che preocupa que uns usuarios abusen doutros, debes ter moito coidado ao conceder dereitos de administración.

Este plugin avísame se tento cambiar a unha conta á que outra persoa xa cambiou?

Si. Cando isto ocorre, mostrarase unha solicitude para que confirmes que queres continuar co cambio á conta afectada.

Esta característica é útil se tes varios usuarios no teu sitio que poden cambiar a outras contas de usuario ao mesmo tempo, por exemplo un equipo de axentes de soporte.

Podo cambiar de usuario directamente desde a barra de ferramentas de administración?

Si, na paleta de comandos de WordPress podes buscar un usuario e cambiar á súa conta de inmediato. Desde aí tamén podes desconectar o cambio e volver.

Chámase a algunha acción do plugin cando un usuario cambia de conta?

Si. Cando un usuario cambia a outra conta, chámase ao gancho switch_to_user:

/**
 * Fires when a user switches to another user account.
 *
 * @since 0.6.0
 * @since 1.4.0 The `$new_token` and `$old_token` parameters were added.
 *
 * @param int    $user_id     The ID of the user being switched to.
 * @param int    $old_user_id The ID of the user being switched from.
 * @param string $new_token   The token of the session of the user being switched to. Can be an empty string
 *                            or a token for a session that may or may not still be valid.
 * @param string $old_token   The token of the session of the user being switched from.
 */
do_action( 'switch_to_user', $user_id, $old_user_id, $new_token, $old_token );

Cando un usuario volve á súa conta de orixe, chámase ao gancho switch_back_user:

/**
 * Fires when a user switches back to their originating account.
 *
 * @since 0.6.0
 * @since 1.4.0 The `$new_token` and `$old_token` parameters were added.
 *
 * @param int       $user_id     The ID of the user being switched back to.
 * @param int|false $old_user_id The ID of the user being switched from, or false if the user is switching back
 *                               after having been switched off.
 * @param string    $new_token   The token of the session of the user being switched to. Can be an empty string
 *                               or a token for a session that may or may not still be valid.
 * @param string    $old_token   The token of the session of the user being switched from.
 */
do_action( 'switch_back_user', $user_id, $old_user_id, $new_token, $old_token );

Cando un usuario desconecta o cambio, chámase ao gancho switch_off_user:

/**
 * Fires when a user switches off.
 *
 * @since 0.6.0
 * @since 1.4.0 The `$old_token` parameter was added.
 *
 * @param int    $old_user_id The ID of the user switching off.
 * @param string $old_token   The token of the session of the user switching off.
 */
do_action( 'switch_off_user', $old_user_id, $old_token );

Cando un usuario cambia a outra conta, desconecta o cambio ou volve, aplícase o filtro user_switching_redirect_to á localización á que se redirixe:

/**
 * Filters the redirect location after a user switches to another account or switches off.
 *
 * @since 1.7.0
 *
 * @param string       $redirect_to   The target redirect location, or an empty string if none is specified.
 * @param string|null  $redirect_type The redirect type, see the `user_switching::REDIRECT_*` constants.
 * @param WP_User|null $new_user      The user being switched to, or null if there is none.
 * @param WP_User|null $old_user      The user being switched from, or null if there is none.
 */
return apply_filters( 'user_switching_redirect_to', $redirect_to, $redirect_type, $new_user, $old_user );

Ademais, User Switching respecta os seguintes filtros do núcleo de WordPress cando procede:

• login_redirect ao cambiar a outro usuario.
• logout_redirect ao desconectar o cambio.

Como podo informar dun fallo de seguranza?

Podes enviar un informe privado de vulnerabilidade de seguranza a User Switching a través da pestana Security do repositorio de GitHub. O proceso de GitHub Security Advisory facilita a colaboración privada en problemas de seguranza. Recibirás o crédito por un informe válido e un CVE se fose necesario.

Non informes de problemas de seguridade nos foros de soporte de WordPress.org nin por correo electrónico. Grazas.

Aceptades doazóns?

Acepto patrocinios a través do programa GitHub Sponsors e calquera axuda que poidas dar axudarame a manter este plugin e a mantelo gratuíto para todos.