wppaste
WordPress

apply_filters( 'illegal_user_logins', array $usernames )

Since
4.4.0
Filters the list of disallowed usernames.

Compatibility

WordPress
since 4.4.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$usernamesarray
Array of disallowed usernames.

Where this hook fires · 5

  • wp-admin/includes/user.php:205edit_user()
  • wp-includes/ms-functions.php:500wpmu_validate_user_signup()
  • wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php:1331WP_REST_Users_Controller::check_username()
  • wp-includes/user.php:2336wp_insert_user()
  • wp-includes/user.php:3572register_new_user()

Source code

View on Trac View on GitHub 

	 * Filters the list of disallowed usernames.	 *	 * @since 4.4.0	 *	 * @param array $usernames Array of disallowed usernames.	 */	$illegal_logins = (array) apply_filters( 'illegal_user_logins', array() ); 	if ( in_array( strtolower( $user_login ), array_map( 'strtolower', $illegal_logins ), true ) ) {		return new WP_Error( 'invalid_username', __( 'Sorry, that username is not allowed.' ) );	} 	/*

Changelog

Introduced in 4.4.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.