2006-06-08 02:22:16 +00:00
< ? php
2008-09-12 04:29:09 +00:00
/**
* WordPress User API
*
* @ package WordPress
*/
/**
* Authenticate user with remember capability .
*
* The credentials is an array that has 'user_login' , 'user_password' , and
* 'remember' indices . If the credentials is not given , then the log in form
* will be assumed and used if set .
*
* The various authentication cookies will be set by this function and will be
* set for a longer period depending on if the 'remember' credential is set to
* true .
*
* @ since 2.5 . 0
*
* @ param array $credentials Optional . User info in order to sign on .
* @ param bool $secure_cookie Optional . Whether to use secure cookie .
* @ return object Either WP_Error on failure , or WP_User on success .
*/
2008-06-11 17:25:55 +00:00
function wp_signon ( $credentials = '' , $secure_cookie = '' ) {
2008-01-22 19:35:19 +00:00
if ( empty ( $credentials ) ) {
if ( ! empty ( $_POST [ 'log' ]) )
$credentials [ 'user_login' ] = $_POST [ 'log' ];
if ( ! empty ( $_POST [ 'pwd' ]) )
$credentials [ 'user_password' ] = $_POST [ 'pwd' ];
if ( ! empty ( $_POST [ 'rememberme' ]) )
$credentials [ 'remember' ] = $_POST [ 'rememberme' ];
}
if ( ! empty ( $credentials [ 'remember' ]) )
$credentials [ 'remember' ] = true ;
else
$credentials [ 'remember' ] = false ;
2009-01-24 22:38:19 +00:00
// TODO do we deprecate the wp_authentication action?
2008-04-16 04:49:19 +00:00
do_action_ref_array ( 'wp_authenticate' , array ( & $credentials [ 'user_login' ], & $credentials [ 'user_password' ]));
2008-06-11 17:25:55 +00:00
if ( '' === $secure_cookie )
$secure_cookie = is_ssl () ? true : false ;
2008-08-09 05:36:14 +00:00
2009-01-24 22:38:19 +00:00
global $auth_secure_cookie ; // XXX ugly hack to pass this to wp_authenticate_cookie
$auth_secure_cookie = $secure_cookie ;
2008-01-22 19:35:19 +00:00
2009-01-24 22:38:19 +00:00
add_filter ( 'authenticate' , 'wp_authenticate_cookie' , 30 , 3 );
2008-06-11 17:25:55 +00:00
2009-01-24 22:38:19 +00:00
$user = wp_authenticate ( $credentials [ 'user_login' ], $credentials [ 'user_password' ]);
2008-01-22 19:35:19 +00:00
2009-01-24 22:38:19 +00:00
if ( is_wp_error ( $user ) )
return $user ;
wp_set_auth_cookie ( $user -> ID , $credentials [ 'remember' ], $secure_cookie );
do_action ( 'wp_login' , $credentials [ 'user_login' ]);
return $user ;
}
/**
* Authenticate the user using the username and password .
*/
add_filter ( 'authenticate' , 'wp_authenticate_username_password' , 20 , 3 );
function wp_authenticate_username_password ( $user , $username , $password ) {
if ( is_a ( $user , 'WP_User' ) ) { return $user ; }
2009-01-28 22:11:49 +00:00
// TODO slight hack to handle initial load of wp-login.php
2009-01-24 22:38:19 +00:00
if ( ( empty ( $username ) && empty ( $password )) && $GLOBALS [ 'pagenow' ] == 'wp-login.php' ) {
return $user ;
2008-01-22 19:35:19 +00:00
}
2009-01-24 22:38:19 +00:00
if ( empty ( $username ) || empty ( $password ) ) {
2008-01-22 19:35:19 +00:00
$error = new WP_Error ();
2009-01-24 22:38:19 +00:00
if ( empty ( $username ) )
2008-01-22 19:35:19 +00:00
$error -> add ( 'empty_username' , __ ( '<strong>ERROR</strong>: The username field is empty.' ));
2009-01-24 22:38:19 +00:00
if ( empty ( $password ) )
2008-01-22 19:35:19 +00:00
$error -> add ( 'empty_password' , __ ( '<strong>ERROR</strong>: The password field is empty.' ));
2009-01-24 22:38:19 +00:00
2008-01-22 19:35:19 +00:00
return $error ;
}
2009-01-24 22:38:19 +00:00
$userdata = get_userdatabylogin ( $username );
if ( ! $userdata || ( $userdata -> user_login != $username ) ) {
return new WP_Error ( 'invalid_username' , __ ( '<strong>ERROR</strong>: Invalid username.' ));
}
$user = apply_filters ( 'wp_authenticate_user' , $user , $password );
if ( is_wp_error ( $user ) ) {
2008-01-22 19:35:19 +00:00
return $user ;
2009-01-24 22:38:19 +00:00
}
if ( ! wp_check_password ( $password , $userdata -> user_pass , $userdata -> ID ) ) {
return new WP_Error ( 'incorrect_password' , __ ( '<strong>ERROR</strong>: Incorrect password.' ));
}
$user = new WP_User ( $userdata -> ID );
return $user ;
}
/**
* Authenticate the user using the WordPress auth cookie .
*/
function wp_authenticate_cookie ( $user , $username , $password ) {
if ( is_a ( $user , 'WP_User' ) ) { return $user ; }
if ( empty ( $username ) && empty ( $password ) ) {
$user_id = wp_validate_auth_cookie ();
if ( $user_id )
return new WP_User ( $user_id );
global $auth_secure_cookie ;
if ( $auth_secure_cookie )
$auth_cookie = SECURE_AUTH_COOKIE ;
else
$auth_cookie = AUTH_COOKIE ;
if ( ! empty ( $_COOKIE [ $auth_cookie ]) )
return new WP_Error ( 'expired_session' , __ ( 'Please log in again.' ));
// If the cookie is not set, be silent.
}
2008-01-22 19:35:19 +00:00
return $user ;
}
2008-09-12 04:29:09 +00:00
/**
* Retrieve user data based on field .
*
* Use get_profile () will make a database query to get the value of the table
* column . The value might be cached using the query cache , but care should be
* taken when using the function to not make a lot of queries for retrieving
* user profile information .
*
* If the $user parameter is not used , then the user will be retrieved from a
* cookie of the user . Therefore , if the cookie does not exist , then no value
* might be returned . Sanity checking must be done to ensure that when using
* get_profile () that empty / null / false values are handled and that something is
* at least displayed .
*
* @ since 1.5 . 0
* @ uses $wpdb WordPress database object to create queries .
*
* @ param string $field User field to retrieve .
* @ param string $user Optional . User username .
* @ return string The value in the field .
*/
2006-06-08 02:22:16 +00:00
function get_profile ( $field , $user = false ) {
global $wpdb ;
if ( ! $user )
$user = $wpdb -> escape ( $_COOKIE [ USER_COOKIE ]);
2008-04-14 16:13:25 +00:00
return $wpdb -> get_var ( $wpdb -> prepare ( " SELECT $field FROM $wpdb->users WHERE user_login = %s " , $user ) );
2006-06-08 02:22:16 +00:00
}
2008-09-12 04:29:09 +00:00
/**
* Number of posts user has written .
*
* @ since 0.71
* @ uses $wpdb WordPress database object for queries .
*
* @ param int $userid User ID .
* @ return int Amount of posts user has written .
*/
2006-06-08 02:22:16 +00:00
function get_usernumposts ( $userid ) {
global $wpdb ;
2007-03-14 07:40:56 +00:00
$userid = ( int ) $userid ;
2008-09-27 21:26:57 +00:00
$count = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT COUNT(*) FROM $wpdb->posts WHERE post_author = %d AND post_type = 'post' AND " , $userid ) . get_private_posts_cap_sql ( 'post' ));
return apply_filters ( 'get_usernumposts' , $count , $userid );
2006-06-08 02:22:16 +00:00
}
2008-09-12 04:29:09 +00:00
/**
* Check that the user login name and password is correct .
*
* @ since 0.71
* @ todo xmlrpc only . Maybe move to xmlrpc . php .
*
* @ param string $user_login User name .
* @ param string $user_pass User password .
* @ return bool False if does not authenticate , true if username and password authenticates .
*/
function user_pass_ok ( $user_login , $user_pass ) {
2008-01-22 19:35:19 +00:00
$user = wp_authenticate ( $user_login , $user_pass );
if ( is_wp_error ( $user ) )
return false ;
return true ;
2006-06-08 02:22:16 +00:00
}
//
// User option functions
//
2008-09-12 04:29:09 +00:00
/**
* Retrieve user option that can be either global , user , or blog .
*
* If the user ID is not given , then the current user will be used instead . If
* the user ID is given , then the user data will be retrieved . The filter for
* the result , will also pass the original option name and finally the user data
* object as the third parameter .
*
* The option will first check for the non - global name , then the global name ,
* and if it still doesn ' t find it , it will try the blog option . The option can
* either be modified or set by a plugin .
*
* @ since 2.0 . 0
* @ uses $wpdb WordPress database object for queries .
* @ uses apply_filters () Calls 'get_user_option_$option' hook with result ,
* option parameter , and user data object .
*
* @ param string $option User option name .
* @ param int $user Optional . User ID .
2008-12-07 03:53:28 +00:00
* @ param bool $check_blog_options Whether to check for an option in the options table if a per - user option does not exist . Default is true .
2008-09-12 04:29:09 +00:00
* @ return mixed
*/
2008-12-07 03:53:28 +00:00
function get_user_option ( $option , $user = 0 , $check_blog_options = true ) {
2006-06-08 02:22:16 +00:00
global $wpdb ;
2008-02-18 20:16:02 +00:00
$option = preg_replace ( '|[^a-z0-9_]|i' , '' , $option );
2006-06-08 02:22:16 +00:00
if ( empty ( $user ) )
$user = wp_get_current_user ();
else
$user = get_userdata ( $user );
if ( isset ( $user -> { $wpdb -> prefix . $option } ) ) // Blog specific
2008-03-11 21:37:23 +00:00
$result = $user -> { $wpdb -> prefix . $option };
2006-06-08 02:22:16 +00:00
elseif ( isset ( $user -> { $option } ) ) // User specific and cross-blog
2008-03-11 21:37:23 +00:00
$result = $user -> { $option };
2008-12-07 03:53:28 +00:00
elseif ( $check_blog_options ) // Blog global
2008-03-11 21:37:23 +00:00
$result = get_option ( $option );
2008-11-25 18:33:04 +00:00
else
$result = false ;
2008-08-09 05:36:14 +00:00
2008-03-11 21:37:23 +00:00
return apply_filters ( " get_user_option_ { $option } " , $result , $option , $user );
2006-06-08 02:22:16 +00:00
}
2008-09-12 04:29:09 +00:00
/**
* Update user option with global blog capability .
*
* User options are just like user metadata except that they have support for
* global blog options . If the 'global' parameter is false , which it is by false
* it will prepend the WordPress table prefix to the option name .
*
* @ since 2.0 . 0
* @ uses $wpdb WordPress database object for queries
*
* @ param int $user_id User ID
* @ param string $option_name User option name .
* @ param mixed $newvalue User option value .
* @ param bool $global Optional . Whether option name is blog specific or not .
* @ return unknown
*/
2006-06-08 02:22:16 +00:00
function update_user_option ( $user_id , $option_name , $newvalue , $global = false ) {
global $wpdb ;
if ( ! $global )
$option_name = $wpdb -> prefix . $option_name ;
return update_usermeta ( $user_id , $option_name , $newvalue );
}
2008-09-12 04:29:09 +00:00
/**
* Get users for the blog .
*
* For setups that use the multi - blog feature . Can be used outside of the
* multi - blog feature .
*
* @ since 2.2 . 0
* @ uses $wpdb WordPress database object for queries
* @ uses $blog_id The Blog id of the blog for those that use more than one blog
*
* @ param int $id Blog ID .
* @ return array List of users that are part of that Blog ID
*/
2007-02-01 01:19:36 +00:00
function get_users_of_blog ( $id = '' ) {
global $wpdb , $blog_id ;
if ( empty ( $id ) )
2007-03-23 00:59:21 +00:00
$id = ( int ) $blog_id ;
2007-02-02 07:43:59 +00:00
$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 " );
2007-02-01 01:19:36 +00:00
return $users ;
}
2006-06-08 02:22:16 +00:00
//
// User meta functions
//
2008-09-12 04:29:09 +00:00
/**
* Remove user meta data .
*
* @ since 2.0 . 0
* @ uses $wpdb WordPress database object for queries .
*
* @ param int $user_id User ID .
* @ param string $meta_key Metadata key .
* @ param mixed $meta_value Metadata value .
* @ return bool True deletion completed and false if user_id is not a number .
*/
2006-06-08 02:22:16 +00:00
function delete_usermeta ( $user_id , $meta_key , $meta_value = '' ) {
global $wpdb ;
if ( ! is_numeric ( $user_id ) )
return false ;
$meta_key = preg_replace ( '|[^a-z0-9_]|i' , '' , $meta_key );
if ( is_array ( $meta_value ) || is_object ( $meta_value ) )
$meta_value = serialize ( $meta_value );
$meta_value = trim ( $meta_value );
if ( ! empty ( $meta_value ) )
2008-11-15 18:10:35 +00:00
$wpdb -> query ( $wpdb -> prepare ( " DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s AND meta_value = %s " , $user_id , $meta_key , $meta_value ) );
2006-06-08 02:22:16 +00:00
else
2008-04-14 16:13:25 +00:00
$wpdb -> query ( $wpdb -> prepare ( " DELETE FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s " , $user_id , $meta_key ) );
2006-06-08 02:22:16 +00:00
wp_cache_delete ( $user_id , 'users' );
return true ;
}
2008-09-12 04:29:09 +00:00
/**
* Retrieve user metadata .
*
* If $user_id is not a number , then the function will fail over with a 'false'
* boolean return value . Other returned values depend on whether there is only
* one item to be returned , which be that single item type . If there is more
* than one metadata value , then it will be list of metadata values .
*
* @ since 2.0 . 0
* @ uses $wpdb WordPress database object for queries .
*
* @ param int $user_id User ID
* @ param string $meta_key Optional . Metadata key .
* @ return mixed
*/
2006-06-08 02:22:16 +00:00
function get_usermeta ( $user_id , $meta_key = '' ) {
global $wpdb ;
$user_id = ( int ) $user_id ;
2007-08-04 03:58:42 +00:00
if ( ! $user_id )
return false ;
2006-06-08 02:22:16 +00:00
if ( ! empty ( $meta_key ) ) {
2006-12-01 22:44:50 +00:00
$meta_key = preg_replace ( '|[^a-z0-9_]|i' , '' , $meta_key );
2008-04-18 19:00:07 +00:00
$user = wp_cache_get ( $user_id , 'users' );
// Check the cached user object
if ( false !== $user && isset ( $user -> $meta_key ) )
$metas = array ( $user -> $meta_key );
else
$metas = $wpdb -> get_col ( $wpdb -> prepare ( " SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s " , $user_id , $meta_key ) );
2006-06-08 02:22:16 +00:00
} else {
2008-04-18 19:00:07 +00:00
$metas = $wpdb -> get_col ( $wpdb -> prepare ( " SELECT meta_value FROM $wpdb->usermeta WHERE user_id = %d " , $user_id ) );
2006-06-08 02:22:16 +00:00
}
2008-04-18 20:06:46 +00:00
2006-06-08 02:22:16 +00:00
if ( empty ( $metas ) ) {
if ( empty ( $meta_key ) )
return array ();
else
return '' ;
}
2008-04-18 19:00:07 +00:00
$metas = array_map ( 'maybe_unserialize' , $metas );
2006-06-08 02:22:16 +00:00
2008-04-18 19:00:07 +00:00
if ( count ( $metas ) == 1 )
return $metas [ 0 ];
2006-06-08 02:22:16 +00:00
else
2008-04-18 19:00:07 +00:00
return $metas ;
2006-06-08 02:22:16 +00:00
}
2008-09-12 04:29:09 +00:00
/**
* Update metadata of user .
*
* There is no need to serialize values , they will be serialized if it is
* needed . The metadata key can only be a string with underscores . All else will
* be removed .
*
* Will remove the metadata , if the meta value is empty .
*
* @ since 2.0 . 0
* @ uses $wpdb WordPress database object for queries
*
* @ param int $user_id User ID
* @ param string $meta_key Metadata key .
* @ param mixed $meta_value Metadata value .
* @ return bool True on successful update , false on failure .
*/
2006-06-08 02:22:16 +00:00
function update_usermeta ( $user_id , $meta_key , $meta_value ) {
global $wpdb ;
if ( ! is_numeric ( $user_id ) )
return false ;
$meta_key = preg_replace ( '|[^a-z0-9_]|i' , '' , $meta_key );
2008-09-12 04:29:09 +00:00
/** @todo Might need fix because usermeta data is assumed to be already escaped */
2006-10-14 05:35:50 +00:00
if ( is_string ( $meta_value ) )
$meta_value = stripslashes ( $meta_value );
2006-10-13 00:23:25 +00:00
$meta_value = maybe_serialize ( $meta_value );
2006-06-08 02:22:16 +00:00
if ( empty ( $meta_value )) {
return delete_usermeta ( $user_id , $meta_key );
}
2008-04-16 18:23:48 +00:00
$cur = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s " , $user_id , $meta_key ) );
2006-06-08 02:22:16 +00:00
if ( ! $cur ) {
2008-04-16 18:23:48 +00:00
$wpdb -> query ( $wpdb -> prepare ( " INSERT INTO $wpdb->usermeta ( user_id, meta_key, meta_value )
2006-06-08 02:22:16 +00:00
VALUES
2008-04-16 18:23:48 +00:00
( % d , % s , % s ) " , $user_id , $meta_key , $meta_value ) );
2006-06-08 02:22:16 +00:00
} else if ( $cur -> meta_value != $meta_value ) {
2008-04-14 16:13:25 +00:00
$wpdb -> query ( $wpdb -> prepare ( " UPDATE $wpdb->usermeta SET meta_value = %s WHERE user_id = %d AND meta_key = %s " , $meta_value , $user_id , $meta_key ) );
2006-06-08 02:22:16 +00:00
} else {
return false ;
}
wp_cache_delete ( $user_id , 'users' );
return true ;
}
//
// Private helper functions
//
2008-09-12 04:29:09 +00:00
/**
* Setup global user vars .
*
* Used by set_current_user () for back compat . Might be deprecated in the
* future .
*
* @ since 2.0 . 4
* @ global string $userdata User description .
* @ global string $user_login The user username for logging in
* @ global int $user_level The level of the user
* @ global int $user_ID The ID of the user
* @ global string $user_email The email address of the user
* @ global string $user_url The url in the user ' s profile
* @ global string $user_pass_md5 MD5 of the user ' s password
* @ global string $user_identity The display name of the user
*
* @ param int $user_id Optional . User ID to setup global data .
*/
2006-06-08 02:22:16 +00:00
function setup_userdata ( $user_id = '' ) {
global $user_login , $userdata , $user_level , $user_ID , $user_email , $user_url , $user_pass_md5 , $user_identity ;
if ( '' == $user_id )
$user = wp_get_current_user ();
2006-11-19 07:56:05 +00:00
else
2006-06-08 02:22:16 +00:00
$user = new WP_User ( $user_id );
if ( 0 == $user -> ID )
return ;
$userdata = $user -> data ;
$user_login = $user -> user_login ;
2008-02-02 18:42:09 +00:00
$user_level = ( int ) isset ( $user -> user_level ) ? $user -> user_level : 0 ;
2007-03-23 00:59:21 +00:00
$user_ID = ( int ) $user -> ID ;
2006-06-08 02:22:16 +00:00
$user_email = $user -> user_email ;
$user_url = $user -> user_url ;
$user_pass_md5 = md5 ( $user -> user_pass );
$user_identity = $user -> display_name ;
}
2008-09-12 04:29:09 +00:00
/**
* Create dropdown HTML content of users .
*
* The content can either be displayed , which it is by default or retrieved by
* setting the 'echo' argument . The 'include' and 'exclude' arguments do not
* need to be used ; all users will be displayed in that case . Only one can be
* used , either 'include' or 'exclude' , but not both .
*
* The available arguments are as follows :
* < ol >
* < li > show_option_all - Text to show all and whether HTML option exists .</ li >
* < li > show_option_none - Text for show none and whether HTML option exists .
* </ li >
* < li > orderby - SQL order by clause for what order the users appear . Default is
* 'display_name' .</ li >
* < li > order - Default is 'ASC' . Can also be 'DESC' .</ li >
* < li > include - User IDs to include .</ li >
* < li > exclude - User IDs to exclude .</ li >
2008-12-09 18:03:31 +00:00
* < li > multi - Default is 'false' . Whether to skip the ID attribute on the 'select' element .</ li >
2008-10-25 20:40:58 +00:00
* < li > show - Default is 'display_name' . User table column to display . If the selected item is empty then the user_login will be displayed in parentesis </ li >
2008-09-12 04:29:09 +00:00
* < li > echo - Default is '1' . Whether to display or retrieve content .</ li >
* < li > selected - Which User ID is selected .</ li >
* < li > name - Default is 'user' . Name attribute of select element .</ li >
* < li > class - Class attribute of select element .</ li >
* </ ol >
*
* @ since 2.3 . 0
* @ uses $wpdb WordPress database object for queries
*
* @ param string | array $args Optional . Override defaults .
* @ return string | null Null on display . String of HTML content on retrieve .
*/
2007-05-29 04:28:10 +00:00
function wp_dropdown_users ( $args = '' ) {
global $wpdb ;
$defaults = array (
'show_option_all' => '' , 'show_option_none' => '' ,
'orderby' => 'display_name' , 'order' => 'ASC' ,
2008-09-30 10:30:56 +00:00
'include' => '' , 'exclude' => '' , 'multi' => 0 ,
2007-05-29 04:28:10 +00:00
'show' => 'display_name' , 'echo' => 1 ,
'selected' => 0 , 'name' => 'user' , 'class' => ''
);
2007-06-14 02:25:30 +00:00
2007-05-29 04:28:10 +00:00
$defaults [ 'selected' ] = is_author () ? get_query_var ( 'author' ) : 0 ;
2007-06-14 02:25:30 +00:00
2007-05-29 04:28:10 +00:00
$r = wp_parse_args ( $args , $defaults );
2007-06-14 22:45:40 +00:00
extract ( $r , EXTR_SKIP );
2007-05-29 04:28:10 +00:00
$query = " SELECT * FROM $wpdb->users " ;
$query_where = array ();
if ( is_array ( $include ) )
$include = join ( ',' , $include );
$include = preg_replace ( '/[^0-9,]/' , '' , $include ); // (int)
if ( $include )
$query_where [] = " ID IN ( $include ) " ;
if ( is_array ( $exclude ) )
$exclude = join ( ',' , $exclude );
$exclude = preg_replace ( '/[^0-9,]/' , '' , $exclude ); // (int)
if ( $exclude )
$query_where [] = " ID NOT IN ( $exclude ) " ;
if ( $query_where )
$query .= " WHERE " . join ( ' AND' , $query_where );
$query .= " ORDER BY $orderby $order " ;
$users = $wpdb -> get_results ( $query );
$output = '' ;
if ( ! empty ( $users ) ) {
2008-09-30 10:30:56 +00:00
$id = $multi ? " " : " id=' $name ' " ;
$output = " <select name=' $name ' $id class=' $class '> \n " ;
2007-05-29 04:28:10 +00:00
if ( $show_option_all )
$output .= " \t <option value='0'> $show_option_all </option> \n " ;
if ( $show_option_none )
$output .= " \t <option value='-1'> $show_option_none </option> \n " ;
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $users as $user ) {
2007-05-29 04:28:10 +00:00
$user -> ID = ( int ) $user -> ID ;
$_selected = $user -> ID == $selected ? " selected='selected' " : '' ;
2008-10-25 20:40:58 +00:00
$display = ! empty ( $user -> $show ) ? $user -> $show : '(' . $user -> user_login . ')' ;
$output .= " \t <option value=' $user->ID ' $_selected > " . wp_specialchars ( $display ) . " </option> \n " ;
2007-05-29 04:28:10 +00:00
}
$output .= " </select> " ;
}
$output = apply_filters ( 'wp_dropdown_users' , $output );
if ( $echo )
echo $output ;
return $output ;
}
2008-09-12 04:29:09 +00:00
/**
* Add user meta data as properties to given user object .
*
* The finished user data is cached , but the cache is not used to fill in the
* user data for the given object . Once the function has been used , the cache
* should be used to retrieve user data . The purpose seems then to be to ensure
* that the data in the object is always fresh .
*
* @ access private
* @ since 2.5 . 0
* @ uses $wpdb WordPress database object for queries
*
* @ param object $user The user data object .
*/
2007-11-27 22:14:53 +00:00
function _fill_user ( & $user ) {
global $wpdb ;
2007-12-16 21:38:24 +00:00
$show = $wpdb -> hide_errors ();
2007-11-27 22:14:53 +00:00
$metavalues = $wpdb -> get_results ( $wpdb -> prepare ( " SELECT meta_key, meta_value FROM $wpdb->usermeta WHERE user_id = %d " , $user -> ID ));
2007-12-16 21:38:24 +00:00
$wpdb -> show_errors ( $show );
2007-11-27 22:14:53 +00:00
if ( $metavalues ) {
2008-08-06 20:31:54 +00:00
foreach ( ( array ) $metavalues as $meta ) {
2007-11-27 22:14:53 +00:00
$value = maybe_unserialize ( $meta -> meta_value );
$user -> { $meta -> meta_key } = $value ;
}
}
$level = $wpdb -> prefix . 'user_level' ;
if ( isset ( $user -> { $level } ) )
$user -> user_level = $user -> { $level };
// For backwards compat.
if ( isset ( $user -> first_name ) )
$user -> user_firstname = $user -> first_name ;
if ( isset ( $user -> last_name ) )
$user -> user_lastname = $user -> last_name ;
if ( isset ( $user -> description ) )
$user -> user_description = $user -> description ;
wp_cache_add ( $user -> ID , $user , 'users' );
wp_cache_add ( $user -> user_login , $user -> ID , 'userlogins' );
wp_cache_add ( $user -> user_email , $user -> ID , 'useremail' );
}
2007-02-02 07:43:59 +00:00
?>