Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: illegal_user_logins

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
1453      }
1454
1455      /**
1456       * Filters the list of blacklisted usernames.
1457       *
1458       * @since 4.4.0
1459       *
1460       * @param array $usernames Array of blacklisted usernames.
1461       */
1462      $illegal_logins = (array) apply_filters( 'illegal_user_logins', array() );
1463
1464      if ( in_array( strtolower( $user_login ), array_map( 'strtolower', $illegal_logins ) ) ) {
1465           return new WP_Error( 'invalid_username', __( 'Sorry, that username is not allowed.' ) );
1466      }
1467
1468      /*
1469       * If a nicename is provided, remove unsafe user characters before using it.
1470       * Otherwise build a nicename from the user_login.
1471       */
 
Line Code
2279           $errors->add( 'empty_username', __( '<strong>ERROR</strong>: Please enter a username.' ) );
2280      } elseif ( ! validate_username( $user_login ) ) {
2281           $errors->add( 'invalid_username', __( '<strong>ERROR</strong>: This username is invalid because it uses illegal characters. Please enter a valid username.' ) );
2282           $sanitized_user_login = '';
2283      } elseif ( username_exists( $sanitized_user_login ) ) {
2284           $errors->add( 'username_exists', __( '<strong>ERROR</strong>: This username is already registered. Please choose another one.' ) );
2285
2286      } else {
2287           /** This filter is documented in wp-includes/user.php */
2288           $illegal_user_logins = array_map( 'strtolower', (array) apply_filters( 'illegal_user_logins', array() ) );
2289           if ( in_array( strtolower( $sanitized_user_login ), $illegal_user_logins ) ) {
2290                $errors->add( 'invalid_username', __( '<strong>ERROR</strong>: Sorry, that username is not allowed.' ) );
2291           }
2292      }
2293
2294      // Check the email address
2295      if ( $user_email == '' ) {
2296           $errors->add( 'empty_email', __( '<strong>ERROR</strong>: Please type your email address.' ) );
2297      } elseif ( ! is_email( $user_email ) ) {