add_new_user_to_blog

The timeline below displays how wordpress function add_new_user_to_blog has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.5

/**
 * Adds a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU (3.0.0)
 *
 * @see add_user_to_blog()
 *
 * @param int    $user_id  User ID.
 * @param string $password User password. Ignored.
 * @param array  $meta     Signup meta data.
 */
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);
        }
    }
}

WordPress Version: 5.4

/**
 * Adds a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU (3.0.0)
 * @see add_user_to_blog()
 *
 * @param int    $user_id  User ID.
 * @param string $password User password. Ignored.
 * @param array  $meta     Signup meta data.
 */
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);
        }
    }
}

WordPress Version: 4.9

/**
 * Adds a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU (3.0.0)
 * @see add_user_to_blog()
 *
 * @param int   $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
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);
        }
    }
}

WordPress Version: 4.7

/**
 * Adds a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU
 * @see add_user_to_blog()
 *
 * @param int   $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
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.
        add_user_to_blog($blog_id, $user_id, $role);
        update_user_meta($user_id, 'primary_blog', $blog_id);
    }
}

WordPress Version: 4.6

/**
 * Adds a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the {@see 'wpmu_activate_user'} action.
 *
 * @since MU
 * @see add_user_to_blog()
 *
 * @param int   $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
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_current_site()->blog_id);
        // remove user from main blog.
        add_user_to_blog($blog_id, $user_id, $role);
        update_user_meta($user_id, 'primary_blog', $blog_id);
    }
}

WordPress Version: 4.3

/**
 * Add a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the wpmu_activate_user action.
 *
 * @since MU
 * @see add_user_to_blog()
 *
 * @param int   $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
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_current_site()->blog_id);
        // remove user from main blog.
        add_user_to_blog($blog_id, $user_id, $role);
        update_user_meta($user_id, 'primary_blog', $blog_id);
    }
}

WordPress Version: 3.8

/**
 * Add a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the wpmu_activate_user action.
 *
 * @since MU
 * @see add_user_to_blog()
 *
 * @param int $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
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_current_site()->blog_id);
        // remove user from main blog.
        add_user_to_blog($blog_id, $user_id, $role);
        update_user_meta($user_id, 'primary_blog', $blog_id);
    }
}

WordPress Version: 3.7

/**
 * Add a newly created user to the appropriate blog
 *
 * To add a user in general, use add_user_to_blog(). This function
 * is specifically hooked into the wpmu_activate_user action.
 *
 * @since MU
 * @see add_user_to_blog()
 *
 * @param int $user_id
 * @param mixed $password Ignored.
 * @param array $meta
 */
function add_new_user_to_blog($user_id, $password, $meta)
{
    global $current_site;
    if (!empty($meta['add_to_blog'])) {
        $blog_id = $meta['add_to_blog'];
        $role = $meta['new_role'];
        remove_user_from_blog($user_id, $current_site->blog_id);
        // remove user from main blog.
        add_user_to_blog($blog_id, $user_id, $role);
        update_user_meta($user_id, 'primary_blog', $blog_id);
    }
}