Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: wp_authenticate_user

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
147      /**
148       * Filter whether the given user can be authenticated with the provided $password.
149       *
150       * @since 2.5.0
151       *
152       * @param WP_User|WP_Error $user     WP_User or WP_Error object if a previous
153       *                                   callback failed authentication.
154       * @param string           $password Password to check against the user.
155       */
156      $user = apply_filters( 'wp_authenticate_user', $user, $password );
157      if ( is_wp_error($user) )
158           return $user;
159
160      if ( ! wp_check_password( $password, $user->user_pass, $user->ID ) ) {
161           return new WP_Error( 'incorrect_password',
162                sprintf(
163                     /* translators: %s: user name */
164                     __( '<strong>ERROR</strong>: The password you entered for the username %s is incorrect.' ),
165                     '<strong>' . $username . '</strong>'
 
Line Code
217           return new WP_Error( 'invalid_email',
218                __( '<strong>ERROR</strong>: Invalid email address.' ) .
219                ' <a href="' . wp_lostpassword_url() . '">' .
220                __( 'Lost your password?' ) .
221                '</a>'
222           );
223      }
224
225      /** This filter is documented in wp-includes/user.php */
226      $user = apply_filters( 'wp_authenticate_user', $user, $password );
227
228      if ( is_wp_error( $user ) ) {
229           return $user;
230      }
231
232      if ( ! wp_check_password( $password, $user->user_pass, $user->ID ) ) {
233           return new WP_Error( 'incorrect_password',
234                sprintf(
235                     /* translators: %s: email address */