插入用户
要添加用户使用 ether wp_insert_user 或 wp_create_user 。wp_create_user 只能创建一个用户，不允许管理任何额外的用户字段。 wp_insert_user 允许填写所有用户字段。
<?php wp_insert_user( $userdata ); ?>
参数
$userdata：（必选）用户数据数组，stdClass 或 WP_User对象。Default: None
返回值
如果成功，返回新创建的用户的 user_id，否则返回一个WP_Error 对象。
例子
下面是一个示例，显示如何插入一个新的用户的网站配置文件字段填充。
<?php
$website = "http://example.com";
$userdata = array(
'user_login' => 'login_name',
'user_url' => $website,
'user_pass' => NULL // When creating an user, `user_pass` is expected.
);
$user_id = wp_insert_user( $userdata ) ;
//On success
if( !is_wp_error($user_id) ) {
echo "User created : ". $user_id;
} ?>
$ userdata 数组可以包含以下字段
| 字段名称 | 描述 | 关联过滤器 |
|---|---|---|
| ID | 将用于更新现有用户的整数。 | （没有） |
| user_pass | 一个包含用户明文密码的字符串。 | pre_user_pass |
| user_login | 包含用户登录用户名的字符串。 | pre_user_login |
| user_nicename | 包含用户的URL友好名称的字符串。 默认是用户的用户名。 | pre_user_nicename |
| user_url | 包含用户网站的用户URL的字符串。 | pre_user_url |
| user_email | 包含用户电子邮件地址的字符串。 | pre_user_email |
| display_name | 将在网站上显示的字符串。 默认为用户的用户名。 很可能您会想通过晦涩（即不使用和删除默认管理员用户）来改变外观和安全性。 | pre_user_display_name |
| nickname | 用户的昵称，默认为用户的用户名。 | pre_user_nickname |
| first_name | 用户的名字。 | pre_user_first_name |
| last_name | 用户的姓氏。 | pre_user_last_name |
| description | 包含用户内容的字符串。 | pre_user_description |
| rich_editing | 是否启用富编辑器的字符串。 假如不是空的话。 | (none) |
| user_registered | 用户注册的日期。 格式为Y-m-d H：i：s。 | (none) |
| role | 用于设置用户角色的字符串。 | (none) |
| jabber | 用户的Jabber帐户。 | (none) |
| aim | 用户的AOL IM帐号。 | (none) |
| yim | 用户的Yahoo IM帐号。 | (none) |
笔记
- 用途:
$wpdbWordPress数据库层。 - 用途:
apply_filters()调用大部分$ userdata字段的过滤器，前缀为'pre_user'。 见上述说明。 - 用途:
do_action()在更新时拨打“profile_update”钩子，提供用户的ID - 用途:
do_action()在创建提供用户ID的新用户时调用'user_register'钩子
如果没有ID，将创建一个新的用户。 如果您传递ID，则具有该ID的用户将被更新，并且如果在 $ userdata 中设置，则这些元字段将被更新，否则它们被设置为null：
- first_name,
- last_name,
- nickname,
- description,
- rich_editing,
- comment_shortcuts,
- admin_color,
- use_ssl,
- show_admin_bar_front
当使用wp_insert_user执行更新操作时，user_pass应为散列密码，而不是纯文本密码。
创建用户
<?php wp_create_user( $username, $password, $email ); ?>
描述
wp_create_user函数允许您将新用户插入WordPress数据库。 它使用 $ wpdb 类来转义变量值，准备将其插入到数据库中。 然后使用PHP compact（） 函数创建一个包含这些值的数组。 要创建具有附加参数的用户，请使用 wp_insert_user（） 。
例
如在wp-admin/upgrade-functions.php中使用的：
$user_id = username_exists( $user_name );
if ( !$user_id and email_exists($user_email) == false ) {
$random_password = wp_generate_password( $length=12, $include_standard_special_chars=false );
$user_id = wp_create_user( $user_name, $random_password, $user_email );
} else {
$random_password = __('User already exists. Password inherited.');
}
参数
$username：(必选) 要创建的用户的用户名。Default: None$password：(必选) 要创建的用户的密码。Default: None$email：(可选) 要创建的用户的电子邮件地址。Default: None
退货
成功后 - 此函数返回创建的用户的用户ID。 在失败（用户名或电子邮件已存在）的情况下，函数返回一个错误对象，带有这些可能的值和消息;
- empty_user_login, 无法创建具有空登录名的用户。
- existing_user_login, 此用户名已被注册。
- existing_user_email, 该邮箱地址已被注册。
更新用户
<?php wp_update_user( $userdata ) ?>
描述
此功能可更新数据库中的单个用户。 此更新可以包含多个用户元数据作为数组。
要更新单个用户元数据，请改用 update_user_meta()。
要创建新用户，请改用 wp_insert_user()。
注意：如果当前用户的密码正在更新，那么cookie将被清除！
参数
$userdata：(必选) 用户数据数组，stdClass或WP_User对象。Default: None- 返回值：如果成功，返回user_id，否则返回一个WP_Error对象。
例子
以下是一个示例，显示如何更新用户的网站配置文件字段：
<?php
$user_id = 1;
$website = 'http://wordpress.org';
$user_id = wp_update_user( array( 'ID' => $user_id, 'user_url' => $website ) );
if ( is_wp_error( $user_id ) ) {
// There was an error, probably that user doesn't exist.
} else {
// Success!
}
删除用户
<?php wp_delete_user( $id, $reassign ); ?></code>
描述
删除用户，并可选地将帖子和链接重新分配给另一个用户。
如果重新分配参数未分配给用户ID，则该用户的所有帖子将被删除。 传递被删除的用户ID的操作“delete_user”将在重新分配或删除帖子后运行。 用户元也将被删除用于该用户ID。
参数
$id：(integer) (必选) 用户ID。Default: None$reassign：(integer) (可选) 重新分配帖子和链接到新的用户ID。Default: null- 返回值：(boolean) 完成时为真。
例子
允许用户终止其用户帐户。
wp_delete_user( $user_id );
笔记
如果您希望在插件中使用此功能，则必须在插件函数中包含./wp-admin/includes/user.php文件，否则将抛出“未定义函数调用”错误。使用全局: (object) $wpdb 这是一个管理功能。