wp-includes/registration.php

   1 <?php
   2
   3 /**
   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.
   7  */
   8 function username_exists( $username ) {
   9         if ( $user = get_userdatabylogin( sanitize_user( $username ) ) ) {
  10                 return $user->ID;
  11         } else {
  12                 return null;
  13         }
  14 }
  15
  16 /**
  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.
  21  */
  22 function email_exists( $email ) {
  23         global $wpdb;
  24         $email = $wpdb->escape( $email );
  25         return $wpdb->get_var( "SELECT ID FROM $wpdb->users WHERE user_email = '$email'" );
  26 }
  27
  28 /**
  29  * Checks whether an username is valid.
  30  * @param string $username Username.
  31  * @return bool A filtered boolean.
  32  */
  33 function validate_username( $username ) {
  34         $sanitized = sanitize_user( $username, true );
  35         $valid = ( $sanitized == $username );
  36         return apply_filters( 'validate_username', $valid, $username );
  37 }
  38
  39 /**
  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.
  44  */
  45 function wp_insert_user($userdata) {
  46         global $wpdb;
  47
  48         extract($userdata, EXTR_SKIP);
  49
  50         // Are we updating or creating?
  51         if ( !empty($ID) ) {
  52                 $ID = (int) $ID;
  53                 $update = true;
  54         } else {
  55                 $update = false;
  56                 // Password is not hashed when creating new user.
  57                 $user_pass = md5($user_pass);
  58         }
  59
  60         $user_login = sanitize_user($user_login, true);
  61         $user_login = apply_filters('pre_user_login', $user_login);
  62
  63         if ( empty($user_nicename) )
  64                 $user_nicename = sanitize_title( $user_login );
  65         $user_nicename = apply_filters('pre_user_nicename', $user_nicename);
  66
  67         if ( empty($user_url) )
  68                 $user_url = '';
  69         $user_url = apply_filters('pre_user_url', $user_url);
  70
  71         if ( empty($user_email) )
  72                 $user_email = '';
  73         $user_email = apply_filters('pre_user_email', $user_email);
  74
  75         if ( empty($display_name) )
  76                 $display_name = $user_login;
  77         $display_name = apply_filters('pre_user_display_name', $display_name);
  78
  79         if ( empty($nickname) )
  80                 $nickname = $user_login;
  81         $nickname = apply_filters('pre_user_nickname', $nickname);
  82
  83         if ( empty($first_name) )
  84                 $first_name = '';
  85         $first_name = apply_filters('pre_user_first_name', $first_name);
  86
  87         if ( empty($last_name) )
  88                 $last_name = '';
  89         $last_name = apply_filters('pre_user_last_name', $last_name);
  90
  91         if ( empty($description) )
  92                 $description = '';
  93         $description = apply_filters('pre_user_description', $description);
  94
  95         if ( empty($rich_editing) )
  96                 $rich_editing = 'true';
  97
  98         if ( empty($user_registered) )
  99                 $user_registered = gmdate('Y-m-d H:i:s');
 100
 101         if ( $update ) {
 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;
 106         } else {
 107                 $query = "INSERT INTO $wpdb->users
 108                 (user_login, user_pass, user_email, user_url, user_registered, user_nicename, display_name)
 109         VALUES
 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;
 114         }
 115
 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);
 124
 125         if ( $update && isset($role) ) {
 126                 $user = new WP_User($user_id);
 127                 $user->set_role($role);
 128         }
 129
 130         if ( !$update ) {
 131                 $user = new WP_User($user_id);
 132                 $user->set_role(get_option('default_role'));
 133         }
 134
 135         wp_cache_delete($user_id, 'users');
 136         wp_cache_delete($user_login, 'userlogins');
 137
 138         if ( $update )
 139                 do_action('profile_update', $user_id);
 140         else
 141                 do_action('user_register', $user_id);
 142
 143         return $user_id;
 144 }
 145
 146 /**
 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.
 151  */
 152 function wp_update_user($userdata) {
 153         global $wpdb;
 154
 155         $ID = (int) $userdata['ID'];
 156
 157         // First, get all of the original fields
 158         $user = get_userdata($ID);
 159
 160         // Escape data pulled from DB.
 161         $user = add_magic_quotes(get_object_vars($user));
 162
 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']);
 167         }
 168
 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);
 172
 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) ) {
 177                         wp_clearcookie();
 178                         wp_setcookie($userdata['user_login'], $plaintext_pass);
 179                 }
 180         }
 181
 182         return $user_id;
 183 }
 184
 185 /**
 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.
 193  */
 194 function wp_create_user($username, $password, $email = '') {
 195         global $wpdb;
 196
 197         $user_login = $wpdb->escape($username);
 198         $user_email = $wpdb->escape($email);
 199         $user_pass = $password;
 200
 201         $userdata = compact('user_login', 'user_email', 'user_pass');
 202         return wp_insert_user($userdata);
 203 }
 204
 205 /**
 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.
 211  * @deprecated
 212  */
 213 function create_user($username, $password, $email) {
 214         return wp_create_user($username, $password, $email);
 215 }
 216
 217 ?>