add_new_user_to_blog() WordPress Function
This function allows you to add a new user to your blog. You will need to provide the user's email address and their desired role on the blog. The user will be sent an email with a link to set their password.
add_new_user_to_blog( int $user_id, string $password, array $meta ) #
Adds a newly created user to the appropriate blog
Description
To add a user in general, use add_user_to_blog(). This function is specifically hooked into the ‘wpmu_activate_user’ action.
See also
Parameters
- $user_id
(int)(Required)User ID.
- $password
(string)(Required)User password. Ignored.
- $meta
(array)(Required)Signup meta data.
Source
File: wp-includes/ms-functions.php
function add_new_user_to_blog( $user_id, $password, $meta ) {
if ( ! empty( $meta['add_to_blog'] ) ) {
$blog_id = $meta['add_to_blog'];
$role = $meta['new_role'];
remove_user_from_blog( $user_id, get_network()->site_id ); // Remove user from main blog.
$result = add_user_to_blog( $blog_id, $user_id, $role );
if ( ! is_wp_error( $result ) ) {
update_user_meta( $user_id, 'primary_blog', $blog_id );
}
}
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| MU (3.0.0) | Introduced. |