Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: authenticate

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

Line Code
548       * If a non-null value is passed, the filter will effectively short-circuit
549       * authentication, returning an error instead.
550       *
551       * @since 2.8.0
552       *
553       * @param null|WP_User $user     User to authenticate.
554       * @param string       $username User login.
555       * @param string       $password User password
556       */
557      $user = apply_filters( 'authenticate', null, $username, $password );
558
559      if ( $user == null ) {
560           // TODO what should the error message be? (Or would these even happen?)
561           // Only needed if all authentication handlers fail to return anything.
562           $user = new WP_Error('authentication_failed', __('<strong>ERROR</strong>: Invalid username or incorrect password.'));
563      }
564
565      $ignore_codes = array('empty_username', 'empty_password');
566