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)来添加用户。