get_password_reset_key( WP_User $user ): string|WP_Error

3100function get_password_reset_key( $user ) {3101	if ( ! ( $user instanceof WP_User ) ) {3102		return new WP_Error( 'invalidcombo', __( '<strong>Error:</strong> There is no account with that username or email address.' ) );3103	}3104 3105	/**3106	 * Fires before a new password is retrieved.3107	 *3108	 * Use the {@see 'retrieve_password'} hook instead.3109	 *3110	 * @since 1.5.03111	 * @deprecated 1.5.1 Misspelled. Use {@see 'retrieve_password'} hook instead.3112	 *3113	 * @param string $user_login The user login name.3114	 */3115	do_action_deprecated( 'retreive_password', array( $user->user_login ), '1.5.1', 'retrieve_password' );3116 3117	/**3118	 * Fires before a new password is retrieved.3119	 *3120	 * @since 1.5.13121	 *3122	 * @param string $user_login The user login name.3123	 */3124	do_action( 'retrieve_password', $user->user_login );3125 3126	$password_reset_allowed = wp_is_password_reset_allowed_for_user( $user );3127	if ( ! $password_reset_allowed ) {3128		return new WP_Error( 'no_password_reset', __( 'Password reset is not allowed for this user' ) );3129	} elseif ( is_wp_error( $password_reset_allowed ) ) {3130		return $password_reset_allowed;3131	}3132 3133	// Generate something random for a password reset key.3134	$key = wp_generate_password( 20, false );3135 3136	/**3137	 * Fires when a password reset key is generated.3138	 *3139	 * @since 2.5.03140	 *3141	 * @param string $user_login The username for the user.3142	 * @param string $key        The generated password reset key.3143	 */3144	do_action( 'retrieve_password_key', $user->user_login, $key );3145 3146	$hashed = time() . ':' . wp_fast_hash( $key );3147 3148	$key_saved = wp_update_user(3149		array(3150			'ID'                  => $user->ID,3151			'user_activation_key' => $hashed,3152		)3153	);3154 3155	if ( is_wp_error( $key_saved ) ) {3156		return $key_saved;3157	}3158 3159	return $key;3160}