wp_authenticate_email_password()
Authenticates a user using the email and password.
Хуки из функции
Возвращает
WP_User|WP_Error
. WP_User on success, WP_Error on failure.
Использование
wp_authenticate_email_password( $user, $email, $password );
- $user(WP_User|WP_Error|null) (обязательный)
- WP_User or WP_Error object if a previous callback failed authentication.
- $email(строка) (обязательный)
- Email address for authentication.
- $password(строка) (обязательный)
- Password for authentication.
Список изменений
С версии 4.5.0 | Введена. |
Код wp_authenticate_email_password() wp authenticate email password WP 6.2.2
function wp_authenticate_email_password( $user, $email, $password ) { if ( $user instanceof WP_User ) { return $user; } if ( empty( $email ) || empty( $password ) ) { if ( is_wp_error( $user ) ) { return $user; } $error = new WP_Error(); if ( empty( $email ) ) { // Uses 'empty_username' for back-compat with wp_signon(). $error->add( 'empty_username', __( '<strong>Error:</strong> The email field is empty.' ) ); } if ( empty( $password ) ) { $error->add( 'empty_password', __( '<strong>Error:</strong> The password field is empty.' ) ); } return $error; } if ( ! is_email( $email ) ) { return $user; } $user = get_user_by( 'email', $email ); if ( ! $user ) { return new WP_Error( 'invalid_email', __( 'Unknown email address. Check again or try your username.' ) ); } /** This filter is documented in wp-includes/user.php */ $user = apply_filters( 'wp_authenticate_user', $user, $password ); if ( is_wp_error( $user ) ) { return $user; } if ( ! wp_check_password( $password, $user->user_pass, $user->ID ) ) { return new WP_Error( 'incorrect_password', sprintf( /* translators: %s: Email address. */ __( '<strong>Error:</strong> The password you entered for the email address %s is incorrect.' ), '<strong>' . $email . '</strong>' ) . ' <a href="' . wp_lostpassword_url() . '">' . __( 'Lost your password?' ) . '</a>' ); } return $user; }