wpmu_create_user

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

WordPress Version: 6.2

/**
 * Creates a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to {@see 'wpmu_new_user'} for events
 * that should affect all new users, but only on Multisite (otherwise
 * use {@see 'user_register'}).
 *
 * @since MU (3.0.0)
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success.
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU (3.0.0)
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 6.1

/**
 * Creates a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to {@see 'wpmu_new_user'} for events
 * that should affect all new users, but only on Multisite (otherwise
 * use {@see 'user_register'}).
 *
 * @since MU (3.0.0)
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU (3.0.0)
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 5.9

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to {@see 'wpmu_new_user'} for events
 * that should affect all new users, but only on Multisite (otherwise
 * use {@see 'user_register'}).
 *
 * @since MU (3.0.0)
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU (3.0.0)
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 4.9

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to {@see 'wpmu_new_user'} for events
 * that should affect all new users, but only on Multisite (otherwise
 * use {@see'user_register'}).
 *
 * @since MU (3.0.0)
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU (3.0.0)
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 4.6

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to {@see 'wpmu_new_user'} for events
 * that should affect all new users, but only on Multisite (otherwise
 * use {@see'user_register'}).
 *
 * @since MU
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 4.3

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to 'wpmu_new_user' for events
 * that should affect all new users, but only on Multisite (otherwise
 * use 'user_register').
 *
 * @since MU
 *
 * @param string $user_name The new user's login name.
 * @param string $password  The new user's password.
 * @param string $email     The new user's email address.
 * @return int|false Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 4.1

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to 'wpmu_new_user' for events
 * that should affect all new users, but only on Multisite (otherwise
 * use 'user_register').
 *
 * @since MU
 *
 * @param string $user_name The new user's login name.
 * @param string $password The new user's password.
 * @param string $email The new user's email address.
 * @return int|bool Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 3.8

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to 'wpmu_new_user' for events
 * that should affect all new users, but only on Multisite (otherwise
 * use 'user_register').
 *
 * @since MU
 * @uses wp_create_user()
 *
 * @param string $user_name The new user's login name.
 * @param string $password The new user's password.
 * @param string $email The new user's email address.
 * @return mixed Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    /**
     * Fires immediately after a new user is created.
     *
     * @since MU
     *
     * @param int $user_id User ID.
     */
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}

WordPress Version: 3.7

/**
 * Create a user.
 *
 * This function runs when a user self-registers as well as when
 * a Super Admin creates a new user. Hook to 'wpmu_new_user' for events
 * that should affect all new users, but only on Multisite (otherwise
 * use 'user_register').
 *
 * @since MU
 * @uses wp_create_user()
 *
 * @param string $user_name The new user's login name.
 * @param string $password The new user's password.
 * @param string $email The new user's email address.
 * @return mixed Returns false on failure, or int $user_id on success
 */
function wpmu_create_user($user_name, $password, $email)
{
    $user_name = preg_replace('/\s+/', '', sanitize_user($user_name, true));
    $user_id = wp_create_user($user_name, $password, $email);
    if (is_wp_error($user_id)) {
        return false;
    }
    // Newly created users have no roles or caps until they are added to a blog.
    delete_user_option($user_id, 'capabilities');
    delete_user_option($user_id, 'user_level');
    do_action('wpmu_new_user', $user_id);
    return $user_id;
}