函数文档

add_user()

💡 云策文档标注

概述

add_user() 函数用于基于 $_POST 信息从“用户”表单创建新用户。它实际上是 edit_user() 函数的包装器,返回用户 ID 或 WP_Error 对象。

关键要点

  • 函数通过 $_POST 数据创建新用户,常用于用户注册或管理界面。
  • 返回值是整数类型的用户 ID 或 WP_Error 对象,便于错误处理。
  • 内部实现直接调用 edit_user() 函数,简化了用户创建逻辑。
  • 自 WordPress 2.0.0 版本引入,是核心用户管理功能的一部分。

注意事项

  • 使用前需确保 $_POST 数据已正确设置,例如包含用户名、邮箱等必要字段。
  • 错误处理应检查返回值是否为 WP_Error,以确保操作成功。

📄 原文内容

Creates a new user from the “Users” form using $_POST information.

Return

int|WP_Error WP_Error or User ID.

Source

function add_user() {
	return edit_user();
}

Changelog

Version Description
2.0.0 Introduced.