User Switching

FAQ

¿Este plugin funciona con PHP 8?

Yes, it’s actively tested and working up to PHP 8.4.

¿Qué significa «desconectar»?

Al apagar los registros, sales de tu cuenta, pero conservas tu ID de usuario en una cookie de identificación para que puedas volver atrás sin tener que volver a acceder de nuevo manualmente. Es similar a cambiar a ningún usuario y poder volver a cambiar.

The Switch Off link can be found in your profile menu in the WordPress toolbar. Once you’ve switched off you’ll see a Switch back link in a few places:

• In the footer of your site
• On the Log In screen
• In the «Meta» widget

¿Funciona este plugin con WordPress multisitio?

Sí, y también podrás cambiar de usuario desde la pantalla de usuarios en la administración de la red.

¿Este plugin funciona con WooCommerce?

Yes, and you’ll also be able to switch users from various WooCommerce administration screens while logged in as a Shop Manager or an administrative user.

¿Este plugin funciona con BuddyPress?

Sí, y también podrás cambiar entre usuarios desde las pantallas de perfil de miembro y la pantalla del listado de miembros.

¿Este plugin funciona con bbPress?

Sí, y también podrás cambiar usuarios desde las pantallas de los perfiles de miembros.

¿Funcionará este plugin si mi sitio está usando un plugin de identificación de dos factores?

Si, la mayoría de las veces.

Una excepción que conozco es Duo Security. Si estás utilizando este plugin, debes instalar el plugin complementario User Switching for Duo Security que evitará que aparezca la solicitud de identificación de dos factores cuando cambies de usuario.

¿Qué capacidad necesita un usuario para poder cambiar de cuenta?

A user needs the edit_users capability in order to switch user accounts. By default only Administrators have this capability, and with Multisite enabled only Super Admins have this capability.

Specifically, a user needs the ability to edit the target user in order to switch to them. This means if you have custom user capability mapping in place which uses the edit_users or edit_user capabilities to affect ability of users to edit others, then User Switching should respect that.

¿Pueden los administradores habituales en instalaciones multisitio cambiar de cuenta?

No. Esto puede ser activado mediante la instalación del plugin User Switching for Regular Admins.

¿Se puede otorgar la capacidad de cambiar de cuenta a otros usuarios o perfiles?

Sí. La meta capacidad switch_users se puede otorgar explícitamente a un usuario o una función para permitirles cambiar de usuario independientemente de si tienen o no la capacidad edit_users. A efectos prácticos, el usuario o perfil también necesitará la capacidad list_users para poder acceder al menú usuarios en el á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 );

Ten en cuenta que esto debe suceder antes de la propia capacidad de cambio del filtro del de usuario, de ahí la prioridad del 9.

¿Se puede denegar a los usuarios la posibilidad de cambiar de cuentas?

Sí. Las capacidades del usuario en WordPress se pueden configurar en false para denegarlas a un usuario. Negar la capacidad de switch_users evita que el usuario cambie usuarios, incluso si tiene la capacidad 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 );

Notes:

• This needs to happen before User Switching’s own capability filtering, hence the priority of 9.
• The ID of the target user can be found in $args[2].

¿Puedo añadir un enlace personalizado «Cambiar a» a mi propio plugin o tema?

Sí. Usa el método user_switching::maybe_switch_url() para esto. Se encarga de la identificación y devuelve una URL con nonce protegido para que el usuario actual cambie a la cuenta de usuario proporcionada.

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 )
        );
    }
}

If you want to specify the URL that the user gets redirected to after switching, add a redirect_to parameter to the URL like so:

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 )
        );
    }
}

The above code also works for displaying a link to switch back to the original user, but if you want an explicit link for this you can use the following code:

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 )
        );
    }
}

¿Puedo determinar si el usuario actual ha cambiado a su cuenta?

Yes. Use the current_user_switched() function for this. If the current user switched into their account from another then it returns a WP_User object for their originating user, otherwise it returns 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.
    }
}

Can I log each time a user switches to another account?

You can install an audit trail plugin such as Simple History, WP Activity Log, or Stream, all of which have built-in support for User Switching and all of which log an entry when a user switches into another account.

¿Este plugin permite que un usuario inculpe a otro por una acción?

Posiblemente sí, pero User Switching incluye algunas protecciones de seguridad para esto y hay más precauciones que puedes tomar como administrador del sitio:

• You can install an audit trail plugin such as Simple History, WP Activity Log, or Stream, all of which have built-in support for User Switching and all of which log an entry when a user switches into another account.
• User Switching stores the ID of the originating user in the new WordPress user session for the user they switch to. Although this session does not persist by default when they subsequently switch back, there will be a record of this ID if your database server has query logging enabled.
• El cambio de usuario almacena el nombre de acceso del usuario de origen en una cookie de identificación (consulta la declaración de privacidad para más información). Si los registros de acceso de tu servidor almacenan datos de cookies, habrá un registro de este nombre de acceso (junto con la dirección IP) para cada solicitud de acceso.
• User Switching desencadena una acción cuando un usuario cambia de cuenta, se desconecta o vuelve a cambiar (ver a continuación). Puedes usar estas acciones para realizar registros adicionales por motivos de seguridad, dependiendo de tus requisitos.

Uno o más de los anteriores deberían permitirte correlacionar una acción con el usuario de origen cuando un usuario cambia de cuenta, si te es necesario.

Ten en cuenta que incluso sin el plugin User Switching en uso, cualquier usuario que tenga la capacidad de editar a otro usuario aún puede seguir enmarcando a otro usuario para una acción, por ejemplo, cambiando su contraseña y accediendo manualmente en esa cuenta. Si te preocupa que los usuarios abusen de otros, debes tener mucho cuidado al otorgar derechos administrativos a los usuarios.

Does this plugin warn me if I attempt to switch into an account which somebody else is already switched into?

Yes. When this happens you’ll be shown a prompt asking you to confirm that you would like to continue switching to the affected account.

This feature is useful if you have multiple users on your site who may be switching into other user accounts at the same time, for example a team of support agents.

¿Puedo cambiar de usuario directamente desde la barra de herramientas de administración?

Yes, there’s a third party add-on plugin for this: Admin Bar User Switching.

¿Se llama a alguna acción del plugin cuando un usuario cambia de cuenta?

Sí. Cuando un usuario cambia a otra cuenta, se llama al 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 );

Cuando un usuario vuelve a su cuenta de origen, se llama al 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 );

Cuando un usuario se apaga, se llama al 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 );

When a user switches to another account, switches off, or switches back, the user_switching_redirect_to filter is applied to the location that they get redirected to:

/**
 * 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 );

Además, User Switching respeta los siguientes filtros del núcleo de WordPress cuando corresponde:

• login_redirect when switching to another user.
• logout_redirect when switching off.

How can I report a security bug?

You can report security bugs through the official User Switching Vulnerability Disclosure Program on Patchstack. The Patchstack team helps validate, triage, and handle any security vulnerabilities.

¿Aceptas donaciones?

Estoy aceptando patrocinios a través del programa de patrocinadores de GitHub y cualquier apoyo que puedas ofrecer me ayudará a mantener este plugin y que siga siendo gratis para todos.