与用户合作

添加用户

要添加用户，您可以使用wp_create_user()或wp_insert_user()。

wp_create_user()仅使用用户名、密码和电子邮件参数创建用户，同时wp_insert_user()接受描述用户及其属性的数组或对象。

创建用户

wp_create_user()允许您创建新的 WordPress 用户。

wp_create_user()有关所用参数的完整说明，请参阅函数参考。

创建示例

// check if the username is taken
$user_id = username_exists( $user_name );

// check that the email address does not belong to a registered user
if ( ! $user_id && email_exists( $user_email ) === false ) {
	// create a random password
	$random_password = wp_generate_password( 12, false );
	// create the user
	$user_id = wp_create_user(
		$user_name,
		$random_password,
		$user_email
	);
}

插入用户

wp_insert_user( $userdata );

笔记：该函数为大多数预定义属性调用过滤器。

user_register该函数在创建用户（用户 ID 不存在）时执行操作。

profile_update该函数在更新用户（用户 ID 存在）时执行操作。

wp_insert_user()有关所用参数的完整说明，请参阅函数参考。

插入示例

下面的示例显示了如何插入填写了网站配置文件字段的新用户。

$username  = $_POST['username'];
$password  = $_POST['password'];
$website   = $_POST['website'];
$user_data = [
	'user_login' => $username,
	'user_pass'  => $password,
	'user_url'   => $website,
];

$user_id = wp_insert_user( $user_data );

// success
if ( ! is_wp_error( $user_id ) ) {
	echo 'User created: ' . $user_id;
}

更新用户

wp_update_user()更新数据库中的单个用户。更新数据在数组/对象中传递$userdata。

要更新单个用户元数据，请update_user_meta()改用。要创建新用户，请wp_insert_user()改用。

笔记：如果当前用户的密码被更新，那么cookies将被清除！

wp_update_user()有关所用参数的完整说明，请参阅函数参考。

示例更新

下面的示例显示了如何更新用户的网站配置文件字段。

$user_id = 1;
$website = 'https://wordpress.org';

$user_id = wp_update_user(
	array(
		'ID'       => $user_id,
		'user_url' => $website,
	)
);

if ( is_wp_error( $user_id ) ) {
	// error
} else {
	// success
}

删除用户

wp_delete_user()删除用户并可选择将关联实体重新分配给另一个用户 ID。

笔记：deleted_user该函数在用户被删除后 执行操作。

警报：如果$reassign参数没有设置为有效的用户ID，那么属于被删除用户的所有实体都将被删除！

wp_delete_user()有关所用参数的完整说明，请参阅函数参考。