On this page
reset_password( WP_User $user, string $new_pass )
Handles resetting the user’s password.
Parameters
$userWP_User Required-
The user
$new_passstring Required-
New password for the user in plaintext
Source
File: wp-includes/user.php. View all references
function reset_password( $user, $new_pass ) {
/**
* Fires before the user's password is reset.
*
* @since 1.5.0
*
* @param WP_User $user The user.
* @param string $new_pass New user password.
*/
do_action( 'password_reset', $user, $new_pass );
wp_set_password( $new_pass, $user->ID );
update_user_meta( $user->ID, 'default_password_nag', false );
/**
* Fires after the user's password is reset.
*
* @since 4.4.0
*
* @param WP_User $user The user.
* @param string $new_pass New user password.
*/
do_action( 'after_password_reset', $user, $new_pass );
}
Hooks
- do_action( 'after_password_reset',
WP_User $user ,string $new_pass ) -
Fires after the user’s password is reset.
- do_action( 'password_reset',
WP_User $user ,string $new_pass ) -
Fires before the user’s password is reset.
Related
Uses
| Uses | Description |
|---|---|
| wp_set_password() wp-includes/pluggable.php | Updates the user’s password with a new encrypted one. |
| update_user_meta() wp-includes/user.php | Updates user meta field based on user ID. |
| do_action() wp-includes/plugin.php | Calls the callback functions that have been added to an action hook. |
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/reset_password