3 function wp_signon( $credentials = '' ) {
4 if ( empty($credentials) ) {
5 if ( ! empty($_POST['log']) )
6 $credentials['user_login'] = $_POST['log'];
7 if ( ! empty($_POST['pwd']) )
8 $credentials['user_password'] = $_POST['pwd'];
9 if ( ! empty($_POST['rememberme']) )
10 $credentials['remember'] = $_POST['rememberme'];
13 if ( !empty($credentials['user_login']) )
14 $credentials['user_login'] = sanitize_user($credentials['user_login']);
15 if ( !empty($credentials['user_password']) )
16 $credentials['user_password'] = trim($credentials['user_password']);
17 if ( !empty($credentials['remember']) )
18 $credentials['remember'] = true;
20 $credentials['remember'] = false;
22 do_action_ref_array('wp_authenticate', array(&$credentials['user_login'], &$credentials['user_password']));
24 // If no credential info provided, check cookie.
25 if ( empty($credentials['user_login']) && empty($credentials['user_password']) ) {
26 $user = wp_validate_auth_cookie();
28 return new WP_User($user);
30 if ( !empty($_COOKIE[AUTH_COOKIE]) )
31 return new WP_Error('expired_session', __('Please log in again.'));
33 // If the cookie is not set, be silent.
34 return new WP_Error();
37 if ( empty($credentials['user_login']) || empty($credentials['user_password']) ) {
38 $error = new WP_Error();
40 if ( empty($credentials['user_login']) )
41 $error->add('empty_username', __('<strong>ERROR</strong>: The username field is empty.'));
42 if ( empty($credentials['user_password']) )
43 $error->add('empty_password', __('<strong>ERROR</strong>: The password field is empty.'));
47 $user = wp_authenticate($credentials['user_login'], $credentials['user_password']);
48 if ( is_wp_error($user) )
51 wp_set_auth_cookie($user->ID, $credentials['remember']);
52 do_action('wp_login', $credentials['user_login']);
56 function get_profile($field, $user = false) {
59 $user = $wpdb->escape($_COOKIE[USER_COOKIE]);
60 return $wpdb->get_var("SELECT $field FROM $wpdb->users WHERE user_login = '$user'");
63 function get_usernumposts($userid) {
65 $userid = (int) $userid;
66 return $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->posts WHERE post_author = '$userid' AND post_type = 'post' AND " . get_private_posts_cap_sql('post'));
69 // TODO: xmlrpc only. Maybe move to xmlrpc.php.
70 function user_pass_ok($user_login,$user_pass) {
71 $user = wp_authenticate($user_login, $user_pass);
72 if ( is_wp_error($user) )
79 // User option functions
82 function get_user_option( $option, $user = 0 ) {
85 $option = preg_replace('|[^a-z0-9_]|i', '', $option);
87 $user = wp_get_current_user();
89 $user = get_userdata($user);
91 if ( isset( $user->{$wpdb->prefix . $option} ) ) // Blog specific
92 $result = $user->{$wpdb->prefix . $option};
93 elseif ( isset( $user->{$option} ) ) // User specific and cross-blog
94 $result = $user->{$option};
96 $result = get_option( $option );
98 return apply_filters("get_user_option_{$option}", $result, $option, $user);
101 function update_user_option( $user_id, $option_name, $newvalue, $global = false ) {
104 $option_name = $wpdb->prefix . $option_name;
105 return update_usermeta( $user_id, $option_name, $newvalue );
108 // Get users with capabilities for the current blog.
109 // For setups that use the multi-blog feature.
110 function get_users_of_blog( $id = '' ) {
111 global $wpdb, $blog_id;
113 $id = (int) $blog_id;
114 $users = $wpdb->get_results( "SELECT user_id, user_login, display_name, user_email, meta_value FROM $wpdb->users, $wpdb->usermeta WHERE " . $wpdb->users . ".ID = " . $wpdb->usermeta . ".user_id AND meta_key = '" . $wpdb->prefix . "capabilities' ORDER BY {$wpdb->usermeta}.user_id" );
119 // User meta functions
122 function delete_usermeta( $user_id, $meta_key, $meta_value = '' ) {
124 if ( !is_numeric( $user_id ) )
126 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
128 if ( is_array($meta_value) || is_object($meta_value) )
129 $meta_value = serialize($meta_value);
130 $meta_value = trim( $meta_value );
132 if ( ! empty($meta_value) )
133 $wpdb->query("DELETE FROM $wpdb->usermeta WHERE user_id = '$user_id' AND meta_key = '$meta_key' AND meta_value = '$meta_value'");
135 $wpdb->query("DELETE FROM $wpdb->usermeta WHERE user_id = '$user_id' AND meta_key = '$meta_key'");
137 wp_cache_delete($user_id, 'users');
142 function get_usermeta( $user_id, $meta_key = '') {
144 $user_id = (int) $user_id;
149 if ( !empty($meta_key) ) {
150 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
151 $user = wp_cache_get($user_id, 'users');
152 // Check the cached user object
153 if ( false !== $user && isset($user->$meta_key) )
154 $metas = array($user->$meta_key);
156 $metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );
158 $metas = $wpdb->get_col( $wpdb->prepare("SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d", $user_id) );
161 if ( empty($metas) ) {
162 if ( empty($meta_key) )
168 $metas = array_map('maybe_unserialize', $metas);
170 if ( count($metas) == 1 )
176 function update_usermeta( $user_id, $meta_key, $meta_value ) {
178 if ( !is_numeric( $user_id ) )
180 $meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);
182 // FIXME: usermeta data is assumed to be already escaped
183 if ( is_string($meta_value) )
184 $meta_value = stripslashes($meta_value);
185 $meta_value = maybe_serialize($meta_value);
186 $meta_value = $wpdb->escape($meta_value);
188 if (empty($meta_value)) {
189 return delete_usermeta($user_id, $meta_key);
192 $cur = $wpdb->get_row("SELECT * FROM $wpdb->usermeta WHERE user_id = '$user_id' AND meta_key = '$meta_key'");
194 $wpdb->query("INSERT INTO $wpdb->usermeta ( user_id, meta_key, meta_value )
196 ( '$user_id', '$meta_key', '$meta_value' )");
197 } else if ( $cur->meta_value != $meta_value ) {
198 $wpdb->query("UPDATE $wpdb->usermeta SET meta_value = '$meta_value' WHERE user_id = '$user_id' AND meta_key = '$meta_key'");
203 wp_cache_delete($user_id, 'users');
209 // Private helper functions
212 // Setup global user vars. Used by set_current_user() for back compat.
213 function setup_userdata($user_id = '') {
214 global $user_login, $userdata, $user_level, $user_ID, $user_email, $user_url, $user_pass_md5, $user_identity;
216 if ( '' == $user_id )
217 $user = wp_get_current_user();
219 $user = new WP_User($user_id);
221 if ( 0 == $user->ID )
224 $userdata = $user->data;
225 $user_login = $user->user_login;
226 $user_level = (int) isset($user->user_level) ? $user->user_level : 0;
227 $user_ID = (int) $user->ID;
228 $user_email = $user->user_email;
229 $user_url = $user->user_url;
230 $user_pass_md5 = md5($user->user_pass);
231 $user_identity = $user->display_name;
234 function wp_dropdown_users( $args = '' ) {
237 'show_option_all' => '', 'show_option_none' => '',
238 'orderby' => 'display_name', 'order' => 'ASC',
239 'include' => '', 'exclude' => '',
240 'show' => 'display_name', 'echo' => 1,
241 'selected' => 0, 'name' => 'user', 'class' => ''
244 $defaults['selected'] = is_author() ? get_query_var( 'author' ) : 0;
246 $r = wp_parse_args( $args, $defaults );
247 extract( $r, EXTR_SKIP );
249 $query = "SELECT * FROM $wpdb->users";
251 $query_where = array();
253 if ( is_array($include) )
254 $include = join(',', $include);
255 $include = preg_replace('/[^0-9,]/', '', $include); // (int)
257 $query_where[] = "ID IN ($include)";
259 if ( is_array($exclude) )
260 $exclude = join(',', $exclude);
261 $exclude = preg_replace('/[^0-9,]/', '', $exclude); // (int)
263 $query_where[] = "ID NOT IN ($exclude)";
266 $query .= " WHERE " . join(' AND', $query_where);
268 $query .= " ORDER BY $orderby $order";
270 $users = $wpdb->get_results( $query );
273 if ( !empty($users) ) {
274 $output = "<select name='$name' id='$name' class='$class'>\n";
276 if ( $show_option_all )
277 $output .= "\t<option value='0'>$show_option_all</option>\n";
279 if ( $show_option_none )
280 $output .= "\t<option value='-1'>$show_option_none</option>\n";
282 foreach ( $users as $user ) {
283 $user->ID = (int) $user->ID;
284 $_selected = $user->ID == $selected ? " selected='selected'" : '';
285 $output .= "\t<option value='$user->ID'$_selected>" . wp_specialchars($user->$show) . "</option>\n";
288 $output .= "</select>";
291 $output = apply_filters('wp_dropdown_users', $output);
299 function _fill_user( &$user ) {
302 $show = $wpdb->hide_errors();
303 $metavalues = $wpdb->get_results($wpdb->prepare("SELECT meta_key, meta_value FROM $wpdb->usermeta WHERE user_id = %d", $user->ID));
304 $wpdb->show_errors($show);
307 foreach ( $metavalues as $meta ) {
308 $value = maybe_unserialize($meta->meta_value);
309 $user->{$meta->meta_key} = $value;
313 $level = $wpdb->prefix . 'user_level';
314 if ( isset( $user->{$level} ) )
315 $user->user_level = $user->{$level};
317 // For backwards compat.
318 if ( isset($user->first_name) )
319 $user->user_firstname = $user->first_name;
320 if ( isset($user->last_name) )
321 $user->user_lastname = $user->last_name;
322 if ( isset($user->description) )
323 $user->user_description = $user->description;
325 wp_cache_add($user->ID, $user, 'users');
326 wp_cache_add($user->user_login, $user->ID, 'userlogins');
327 wp_cache_add($user->user_email, $user->ID, 'useremail');