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
154      /**
155       * Filters whether the given user can be authenticated with the provided $password.
156       *
157       * @since 2.5.0
158       *
159       * @param WP_User|WP_Error $user     WP_User or WP_Error object if a previous
160       *                                   callback failed authentication.
161       * @param string           $password Password to check against the user.
162       */
163      $user = apply_filters( 'wp_authenticate_user', $user, $password );
164      if ( is_wp_error($user) )
165           return $user;
166
167      if ( ! wp_check_password( $password, $user->user_pass, $user->ID ) ) {
168           return new WP_Error( 'incorrect_password',
169                sprintf(
170                     /* translators: %s: user name */
171                     __( '<strong>ERROR</strong>: The password you entered for the username %s is incorrect.' ),
172                     '<strong>' . $username . '</strong>'
 
Line Code
224           return new WP_Error( 'invalid_email',
225                __( '<strong>ERROR</strong>: Invalid email address.' ) .
226                ' <a href="' . wp_lostpassword_url() . '">' .
227                __( 'Lost your password?' ) .
228                '</a>'
229           );
230      }
231
232      /** This filter is documented in wp-includes/user.php */
233      $user = apply_filters( 'wp_authenticate_user', $user, $password );
234
235      if ( is_wp_error( $user ) ) {
236           return $user;
237      }
238
239      if ( ! wp_check_password( $password, $user->user_pass, $user->ID ) ) {
240           return new WP_Error( 'incorrect_password',
241                sprintf(
242                     /* translators: %s: email address */