4 * Checks whether the given username exists.
5 * @param string $username Username.
6 * @return mixed The user's ID on success, and null on failure.
8 function username_exists( $username ) {
9 if ( $user = get_userdatabylogin( sanitize_user( $username ) ) ) {
17 * Checks whether the given email exists.
18 * @global object $wpdb WordPress database layer.
19 * @param string $email Email.
20 * @return mixed The user's ID on success, and false on failure.
22 function email_exists( $email ) {
24 $email = $wpdb->escape( $email );
25 return $wpdb->get_var( "SELECT ID FROM $wpdb->users WHERE user_email = '$email'" );
29 * Checks whether an username is valid.
30 * @param string $username Username.
31 * @return bool A filtered boolean.
33 function validate_username( $username ) {
34 $sanitized = sanitize_user( $username, true );
35 $valid = ( $sanitized == $username );
36 return apply_filters( 'validate_username', $valid, $username );
40 * Insert an user into the database.
41 * @global object $wpdb WordPress database layer.
42 * @param array $userdata An array of user data.
43 * @return int The newly created user's ID.
45 function wp_insert_user($userdata) {
48 extract($userdata, EXTR_SKIP);
50 // Are we updating or creating?
56 // Password is not hashed when creating new user.
57 $user_pass = md5($user_pass);
60 $user_login = sanitize_user($user_login, true);
61 $user_login = apply_filters('pre_user_login', $user_login);
63 if ( empty($user_nicename) )
64 $user_nicename = sanitize_title( $user_login );
65 $user_nicename = apply_filters('pre_user_nicename', $user_nicename);
67 if ( empty($user_url) )
69 $user_url = apply_filters('pre_user_url', $user_url);
71 if ( empty($user_email) )
73 $user_email = apply_filters('pre_user_email', $user_email);
75 if ( empty($display_name) )
76 $display_name = $user_login;
77 $display_name = apply_filters('pre_user_display_name', $display_name);
79 if ( empty($nickname) )
80 $nickname = $user_login;
81 $nickname = apply_filters('pre_user_nickname', $nickname);
83 if ( empty($first_name) )
85 $first_name = apply_filters('pre_user_first_name', $first_name);
87 if ( empty($last_name) )
89 $last_name = apply_filters('pre_user_last_name', $last_name);
91 if ( empty($description) )
93 $description = apply_filters('pre_user_description', $description);
95 if ( empty($rich_editing) )
96 $rich_editing = 'true';
98 if ( empty($user_registered) )
99 $user_registered = gmdate('Y-m-d H:i:s');
102 $query = "UPDATE $wpdb->users SET user_pass='$user_pass', user_email='$user_email', user_url='$user_url', user_nicename = '$user_nicename', display_name = '$display_name' WHERE ID = '$ID'";
103 $query = apply_filters('update_user_query', $query);
104 $wpdb->query( $query );
105 $user_id = (int) $ID;
107 $query = "INSERT INTO $wpdb->users
108 (user_login, user_pass, user_email, user_url, user_registered, user_nicename, display_name)
110 ('$user_login', '$user_pass', '$user_email', '$user_url', '$user_registered', '$user_nicename', '$display_name')";
111 $query = apply_filters('create_user_query', $query);
112 $wpdb->query( $query );
113 $user_id = (int) $wpdb->insert_id;
116 update_usermeta( $user_id, 'first_name', $first_name);
117 update_usermeta( $user_id, 'last_name', $last_name);
118 update_usermeta( $user_id, 'nickname', $nickname );
119 update_usermeta( $user_id, 'description', $description );
120 update_usermeta( $user_id, 'jabber', $jabber );
121 update_usermeta( $user_id, 'aim', $aim );
122 update_usermeta( $user_id, 'yim', $yim );
123 update_usermeta( $user_id, 'rich_editing', $rich_editing);
125 if ( $update && isset($role) ) {
126 $user = new WP_User($user_id);
127 $user->set_role($role);
131 $user = new WP_User($user_id);
132 $user->set_role(get_option('default_role'));
135 wp_cache_delete($user_id, 'users');
136 wp_cache_delete($user_login, 'userlogins');
139 do_action('profile_update', $user_id);
141 do_action('user_register', $user_id);
147 * Update an user in the database.
148 * @global object $wpdb WordPress database layer.
149 * @param array $userdata An array of user data.
150 * @return int The updated user's ID.
152 function wp_update_user($userdata) {
155 $ID = (int) $userdata['ID'];
157 // First, get all of the original fields
158 $user = get_userdata($ID);
160 // Escape data pulled from DB.
161 $user = add_magic_quotes(get_object_vars($user));
163 // If password is changing, hash it now.
164 if ( ! empty($userdata['user_pass']) ) {
165 $plaintext_pass = $userdata['user_pass'];
166 $userdata['user_pass'] = md5($userdata['user_pass']);
169 // Merge old and new fields with new fields overwriting old ones.
170 $userdata = array_merge($user, $userdata);
171 $user_id = wp_insert_user($userdata);
173 // Update the cookies if the password changed.
174 $current_user = wp_get_current_user();
175 if ( $current_user->id == $ID ) {
176 if ( isset($plaintext_pass) ) {
178 wp_setcookie($userdata['user_login'], $plaintext_pass);
186 * A simpler way of inserting an user into the database.
187 * See also: wp_insert_user().
188 * @global object $wpdb WordPress database layer.
189 * @param string $username The user's username.
190 * @param string $password The user's password.
191 * @param string $email The user's email (optional).
192 * @return int The new user's ID.
194 function wp_create_user($username, $password, $email = '') {
197 $user_login = $wpdb->escape($username);
198 $user_email = $wpdb->escape($email);
199 $user_pass = $password;
201 $userdata = compact('user_login', 'user_email', 'user_pass');
202 return wp_insert_user($userdata);
206 * An alias of wp_create_user().
207 * @param string $username The user's username.
208 * @param string $password The user's password.
209 * @param string $email The user's email (optional).
210 * @return int The new user's ID.
213 function create_user($username, $password, $email) {
214 return wp_create_user($username, $password, $email);