WordPress函数add_user_to_blog使用教程

add_user_to_blog函数是WordPress中用于将用户添加到指定博客的函数。它的详细用法如下：

add_user_to_blog( int $blog_id, string $user_login, string $role )

参数说明：
- $blog_id（必填）：指定要添加用户的博客ID。
- $user_login（必填）：要添加到博客的用户的登录名或邮箱。
- $role（必填）：要将用户添加到博客的角色。可以是WordPress默认角色（如 'subscriber', 'contributor', 'author', 'editor', 'administrator'），也可以是自定义角色。

函数返回值：
- 如果成功添加用户，则返回true；如果用户已经是博客成员，则返回false；如果指定的博客不存在，则返回WP_Error对象。

使用示例：

// 将用户'john'添加到博客ID为1的博客，并分配'author'角色
$result = add_user_to_blog( 1, 'john', 'author' );

if ( is_wp_error( $result ) ) {
echo $result->get_error_message(); // 打印错误信息
} else {
echo '用户添加成功！';
}

需要注意的是，函数add_user_to_blog仅在WordPress网络（Multisite）环境下可用，用于将用户添加到指定博客。在单站点模式下，可以使用其他函数（如wp_insert_user）来添加用户。