云策 WordPress 开发者社区

钩子文档

illegal_user_logins

查看官方原文 ↗
💡 云策文档标注

概述

illegal_user_logins 是一个 WordPress 过滤器钩子，用于过滤不允许的用户名列表。开发者可以通过此钩子自定义或扩展系统默认的禁用用户名数组。

关键要点

  • 过滤器名称：illegal_user_logins
  • 参数：$usernames，一个数组，包含当前不允许的用户名列表
  • 用途：允许开发者修改或添加不允许注册的用户名，常用于增强安全性或符合特定命名规则
  • 相关函数：在多个核心函数中调用，如 register_new_user()、wp_insert_user() 等，影响用户注册和管理的验证过程
  • 引入版本：WordPress 4.4.0
📄 原文内容

Filters the list of disallowed usernames.

Parameters

$usernamesarray
Array of disallowed usernames.

Source

$illegal_logins = (array) apply_filters( 'illegal_user_logins', array() );

View all references View on Trac View on GitHub

Used by Description
WP_REST_Users_Controller::check_username()wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

Check a username for the REST API.
edit_user()wp-admin/includes/user.php

Edit user settings based on contents of $_POST
register_new_user()wp-includes/user.php

Handles registering a new user.
wp_insert_user()wp-includes/user.php

Inserts a user into the database.
wpmu_validate_user_signup()wp-includes/ms-functions.php

Sanitizes and validates data required for a user sign-up.

Changelog

Version Description
4.4.0 Introduced.