X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/11be8dc178e77d0b46189bbd8e33a216a9b90942..refs/tags/wordpress-4.3:/wp-admin/includes/user.php?ds=sidebyside diff --git a/wp-admin/includes/user.php b/wp-admin/includes/user.php index 5709cc18..132ea6d7 100644 --- a/wp-admin/includes/user.php +++ b/wp-admin/includes/user.php @@ -9,116 +9,116 @@ /** * Creates a new user from the "Users" form using $_POST information. * - * {@internal Missing Long Description}} + * @since 2.0.0 * - * @since unknown - * - * @param int $user_id Optional. User ID. - * @return null|WP_Error|int Null when adding user, WP_Error or User ID integer when no parameters. + * @return int|WP_Error WP_Error or User ID. */ function add_user() { - if ( func_num_args() ) { // The hackiest hack that ever did hack - global $current_user, $wp_roles; - $user_id = (int) func_get_arg( 0 ); - - if ( isset( $_POST['role'] ) ) { - if( $user_id != $current_user->id || $wp_roles->role_objects[$_POST['role']]->has_cap( 'edit_users' ) ) { - $user = new WP_User( $user_id ); - $user->set_role( $_POST['role'] ); - } - } - } else { - add_action( 'user_register', 'add_user' ); // See above - return edit_user(); - } + return edit_user(); } /** - * {@internal Missing Short Description}} + * Edit user settings based on contents of $_POST * - * {@internal Missing Long Description}} + * Used on user-edit.php and profile.php to manage and process user options, passwords etc. * - * @since unknown + * @since 2.0.0 * * @param int $user_id Optional. User ID. - * @return unknown + * @return int|WP_Error user id of the updated user */ function edit_user( $user_id = 0 ) { - global $current_user, $wp_roles, $wpdb; - if ( $user_id != 0 ) { + $wp_roles = wp_roles(); + $user = new stdClass; + if ( $user_id ) { $update = true; $user->ID = (int) $user_id; $userdata = get_userdata( $user_id ); - $user->user_login = $wpdb->escape( $userdata->user_login ); + $user->user_login = wp_slash( $userdata->user_login ); } else { $update = false; - $user = ''; } - if ( isset( $_POST['user_login'] )) - $user->user_login = wp_specialchars( trim( $_POST['user_login'] )); + if ( !$update && isset( $_POST['user_login'] ) ) + $user->user_login = sanitize_user($_POST['user_login'], true); $pass1 = $pass2 = ''; - if ( isset( $_POST['pass1'] )) + if ( isset( $_POST['pass1'] ) ) $pass1 = $_POST['pass1']; - if ( isset( $_POST['pass2'] )) + if ( isset( $_POST['pass2'] ) ) $pass2 = $_POST['pass2']; if ( isset( $_POST['role'] ) && current_user_can( 'edit_users' ) ) { - if( $user_id != $current_user->id || $wp_roles->role_objects[$_POST['role']]->has_cap( 'edit_users' )) - $user->role = $_POST['role']; + $new_role = sanitize_text_field( $_POST['role'] ); + $potential_role = isset($wp_roles->role_objects[$new_role]) ? $wp_roles->role_objects[$new_role] : false; + // Don't let anyone with 'edit_users' (admins) edit their own role to something without it. + // Multisite super admins can freely edit their blog roles -- they possess all caps. + if ( ( is_multisite() && current_user_can( 'manage_sites' ) ) || $user_id != get_current_user_id() || ($potential_role && $potential_role->has_cap( 'edit_users' ) ) ) + $user->role = $new_role; + + // If the new role isn't editable by the logged-in user die with error + $editable_roles = get_editable_roles(); + if ( ! empty( $new_role ) && empty( $editable_roles[$new_role] ) ) + wp_die(__('You can’t give users that role.')); } if ( isset( $_POST['email'] )) - $user->user_email = wp_specialchars( trim( $_POST['email'] )); + $user->user_email = sanitize_text_field( wp_unslash( $_POST['email'] ) ); if ( isset( $_POST['url'] ) ) { - $user->user_url = clean_url( trim( $_POST['url'] )); - $user->user_url = preg_match('/^(https?|ftps?|mailto|news|irc|gopher|nntp|feed|telnet):/is', $user->user_url) ? $user->user_url : 'http://'.$user->user_url; + if ( empty ( $_POST['url'] ) || $_POST['url'] == 'http://' ) { + $user->user_url = ''; + } else { + $user->user_url = esc_url_raw( $_POST['url'] ); + $protocols = implode( '|', array_map( 'preg_quote', wp_allowed_protocols() ) ); + $user->user_url = preg_match('/^(' . $protocols . '):/is', $user->user_url) ? $user->user_url : 'http://'.$user->user_url; + } } - if ( isset( $_POST['first_name'] )) - $user->first_name = wp_specialchars( trim( $_POST['first_name'] )); - if ( isset( $_POST['last_name'] )) - $user->last_name = wp_specialchars( trim( $_POST['last_name'] )); - if ( isset( $_POST['nickname'] )) - $user->nickname = wp_specialchars( trim( $_POST['nickname'] )); - if ( isset( $_POST['display_name'] )) - $user->display_name = wp_specialchars( trim( $_POST['display_name'] )); - if ( isset( $_POST['description'] )) + if ( isset( $_POST['first_name'] ) ) + $user->first_name = sanitize_text_field( $_POST['first_name'] ); + if ( isset( $_POST['last_name'] ) ) + $user->last_name = sanitize_text_field( $_POST['last_name'] ); + if ( isset( $_POST['nickname'] ) ) + $user->nickname = sanitize_text_field( $_POST['nickname'] ); + if ( isset( $_POST['display_name'] ) ) + $user->display_name = sanitize_text_field( $_POST['display_name'] ); + + if ( isset( $_POST['description'] ) ) $user->description = trim( $_POST['description'] ); - if ( isset( $_POST['jabber'] )) - $user->jabber = wp_specialchars( trim( $_POST['jabber'] )); - if ( isset( $_POST['aim'] )) - $user->aim = wp_specialchars( trim( $_POST['aim'] )); - if ( isset( $_POST['yim'] )) - $user->yim = wp_specialchars( trim( $_POST['yim'] )); - if ( !$update ) - $user->rich_editing = 'true'; // Default to true for new users. - else if ( isset( $_POST['rich_editing'] ) ) - $user->rich_editing = $_POST['rich_editing']; - else - $user->rich_editing = 'true'; - - $user->comment_shortcuts = isset( $_POST['comment_shortcuts'] )? $_POST['comment_shortcuts'] : ''; + + foreach ( wp_get_user_contact_methods( $user ) as $method => $name ) { + if ( isset( $_POST[$method] )) + $user->$method = sanitize_text_field( $_POST[$method] ); + } + + if ( $update ) { + $user->rich_editing = isset( $_POST['rich_editing'] ) && 'false' == $_POST['rich_editing'] ? 'false' : 'true'; + $user->admin_color = isset( $_POST['admin_color'] ) ? sanitize_text_field( $_POST['admin_color'] ) : 'fresh'; + $user->show_admin_bar_front = isset( $_POST['admin_bar_front'] ) ? 'true' : 'false'; + } + + $user->comment_shortcuts = isset( $_POST['comment_shortcuts'] ) && 'true' == $_POST['comment_shortcuts'] ? 'true' : ''; $user->use_ssl = 0; if ( !empty($_POST['use_ssl']) ) $user->use_ssl = 1; - if ( !$update ) - $user->admin_color = 'fresh'; // Default to fresh for new users. - else if ( isset( $_POST['admin_color'] ) ) - $user->admin_color = $_POST['admin_color']; - else - $user->admin_color = 'fresh'; - $errors = new WP_Error(); /* checking that username has been typed */ if ( $user->user_login == '' ) - $errors->add( 'user_login', __( 'ERROR: Please enter a username.' )); + $errors->add( 'user_login', __( 'ERROR: Please enter a username.' ) ); /* checking the password has been typed twice */ - do_action_ref_array( 'check_passwords', array ( $user->user_login, & $pass1, & $pass2 )); + /** + * Fires before the password and confirm password fields are checked for congruity. + * + * @since 1.5.1 + * + * @param string $user_login The username. + * @param string &$pass1 The password, passed by reference. + * @param string &$pass2 The confirmed password, passed by reference. + */ + do_action_ref_array( 'check_passwords', array( $user->user_login, &$pass1, &$pass2 ) ); if ( $update ) { if ( empty($pass1) && !empty($pass2) ) @@ -133,206 +133,98 @@ function edit_user( $user_id = 0 ) { } /* Check for "\" in password */ - if( strpos( " ".$pass1, "\\" ) ) + if ( false !== strpos( wp_unslash( $pass1 ), "\\" ) ) $errors->add( 'pass', __( 'ERROR: Passwords may not contain the character "\\".' ), array( 'form-field' => 'pass1' ) ); /* checking the password has been typed twice the same */ if ( $pass1 != $pass2 ) $errors->add( 'pass', __( 'ERROR: Please enter the same password in the two password fields.' ), array( 'form-field' => 'pass1' ) ); - if (!empty ( $pass1 )) + if ( !empty( $pass1 ) ) $user->user_pass = $pass1; - if ( !$update && !validate_username( $user->user_login ) ) - $errors->add( 'user_login', __( 'ERROR: This username is invalid. Please enter a valid username.' )); + if ( !$update && isset( $_POST['user_login'] ) && !validate_username( $_POST['user_login'] ) ) + $errors->add( 'user_login', __( 'ERROR: This username is invalid because it uses illegal characters. Please enter a valid username.' )); - if (!$update && username_exists( $user->user_login )) + if ( !$update && username_exists( $user->user_login ) ) $errors->add( 'user_login', __( 'ERROR: This username is already registered. Please choose another one.' )); /* checking e-mail address */ - if ( empty ( $user->user_email ) ) { - $errors->add( 'user_email', __( 'ERROR: Please enter an e-mail address.' ), array( 'form-field' => 'email' ) ); - } else - if (!is_email( $user->user_email ) ) { - $errors->add( 'user_email', __( "ERROR: The e-mail address isn't correct." ), array( 'form-field' => 'email' ) ); - } + if ( empty( $user->user_email ) ) { + $errors->add( 'empty_email', __( 'ERROR: Please enter an e-mail address.' ), array( 'form-field' => 'email' ) ); + } elseif ( !is_email( $user->user_email ) ) { + $errors->add( 'invalid_email', __( 'ERROR: The email address isn’t correct.' ), array( 'form-field' => 'email' ) ); + } elseif ( ( $owner_id = email_exists($user->user_email) ) && ( !$update || ( $owner_id != $user->ID ) ) ) { + $errors->add( 'email_exists', __('ERROR: This email is already registered, please choose another one.'), array( 'form-field' => 'email' ) ); + } + + /** + * Fires before user profile update errors are returned. + * + * @since 2.8.0 + * + * @param array &$errors An array of user profile update errors, passed by reference. + * @param bool $update Whether this is a user update. + * @param WP_User &$user WP_User object, passed by reference. + */ + do_action_ref_array( 'user_profile_update_errors', array( &$errors, $update, &$user ) ); if ( $errors->get_error_codes() ) return $errors; if ( $update ) { - $user_id = wp_update_user( get_object_vars( $user )); + $user_id = wp_update_user( $user ); } else { - $user_id = wp_insert_user( get_object_vars( $user )); - wp_new_user_notification( $user_id ); + $user_id = wp_insert_user( $user ); + wp_new_user_notification( $user_id, 'both' ); } return $user_id; } /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * - * @return array List of user IDs. - */ -function get_author_user_ids() { - global $wpdb; - $level_key = $wpdb->prefix . 'user_level'; - return $wpdb->get_col( $wpdb->prepare("SELECT user_id FROM $wpdb->usermeta WHERE meta_key = %s AND meta_value != '0'", $level_key) ); -} - -/** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * - * @param int $user_id User ID. - * @return array|bool List of editable authors. False if no editable users. - */ -function get_editable_authors( $user_id ) { - global $wpdb; - - $editable = get_editable_user_ids( $user_id ); - - if( !$editable ) { - return false; - } else { - $editable = join(',', $editable); - $authors = $wpdb->get_results( "SELECT * FROM $wpdb->users WHERE ID IN ($editable) ORDER BY display_name" ); - } - - return apply_filters('get_editable_authors', $authors); -} - -/** - * {@internal Missing Short Description}} + * Fetch a filtered list of user roles that the current user is + * allowed to edit. * - * {@internal Missing Long Description}} + * Simple function who's main purpose is to allow filtering of the + * list of roles in the $wp_roles object so that plugins can remove + * inappropriate ones depending on the situation or user making edits. + * Specifically because without filtering anyone with the edit_users + * capability can edit others to be administrators, even if they are + * only editors or authors. This filter allows admins to delegate + * user management. * - * @since unknown + * @since 2.8.0 * - * @param int $user_id User ID. - * @param bool $exclude_zeros Optional, default is true. Whether to exclude zeros. - * @return unknown - */ -function get_editable_user_ids( $user_id, $exclude_zeros = true, $post_type = 'post' ) { - global $wpdb; - - $user = new WP_User( $user_id ); - - if ( ! $user->has_cap("edit_others_{$post_type}s") ) { - if ( $user->has_cap("edit_{$post_type}s") || $exclude_zeros == false ) - return array($user->id); - else - return false; - } - - $level_key = $wpdb->prefix . 'user_level'; - - $query = $wpdb->prepare("SELECT user_id FROM $wpdb->usermeta WHERE meta_key = %s", $level_key); - if ( $exclude_zeros ) - $query .= " AND meta_value != '0'"; - - return $wpdb->get_col( $query ); -} - -/** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * - * @return unknown - */ -function get_nonauthor_user_ids() { - global $wpdb; - $level_key = $wpdb->prefix . 'user_level'; - - return $wpdb->get_col( $wpdb->prepare("SELECT user_id FROM $wpdb->usermeta WHERE meta_key = %s AND meta_value = '0'", $level_key) ); -} - -/** - * Retrieve editable posts from other users. - * - * @since unknown - * - * @param int $user_id User ID to not retrieve posts from. - * @param string $type Optional, defaults to 'any'. Post type to retrieve, can be 'draft' or 'pending'. - * @return array List of posts from others. + * @return array */ -function get_others_unpublished_posts($user_id, $type='any') { - global $wpdb; - - $editable = get_editable_user_ids( $user_id ); - - if ( in_array($type, array('draft', 'pending')) ) - $type_sql = " post_status = '$type' "; - else - $type_sql = " ( post_status = 'draft' OR post_status = 'pending' ) "; - - $dir = ( 'pending' == $type ) ? 'ASC' : 'DESC'; - - if( !$editable ) { - $other_unpubs = ''; - } else { - $editable = join(',', $editable); - $other_unpubs = $wpdb->get_results( $wpdb->prepare("SELECT ID, post_title, post_author FROM $wpdb->posts WHERE post_type = 'post' AND $type_sql AND post_author IN ($editable) AND post_author != %d ORDER BY post_modified $dir", $user_id) ); - } - - return apply_filters('get_others_drafts', $other_unpubs); -} +function get_editable_roles() { + $all_roles = wp_roles()->roles; -/** - * Retrieve drafts from other users. - * - * @since unknown - * - * @param int $user_id User ID. - * @return array List of drafts from other users. - */ -function get_others_drafts($user_id) { - return get_others_unpublished_posts($user_id, 'draft'); -} + /** + * Filter the list of editable roles. + * + * @since 2.8.0 + * + * @param array $all_roles List of roles. + */ + $editable_roles = apply_filters( 'editable_roles', $all_roles ); -/** - * Retrieve pending review posts from other users. - * - * @since unknown - * - * @param int $user_id User ID. - * @return array List of posts with pending review post type from other users. - */ -function get_others_pending($user_id) { - return get_others_unpublished_posts($user_id, 'pending'); + return $editable_roles; } /** * Retrieve user data and filter it. * - * @since unknown + * @since 2.0.5 * * @param int $user_id User ID. - * @return object WP_User object with user data. + * @return WP_User|bool WP_User object on success, false on failure. */ function get_user_to_edit( $user_id ) { - $user = new WP_User( $user_id ); - $user->user_login = attribute_escape($user->user_login); - $user->user_email = attribute_escape($user->user_email); - $user->user_url = clean_url($user->user_url); - $user->first_name = attribute_escape($user->first_name); - $user->last_name = attribute_escape($user->last_name); - $user->display_name = attribute_escape($user->display_name); - $user->nickname = attribute_escape($user->nickname); - $user->aim = isset( $user->aim ) && !empty( $user->aim ) ? attribute_escape($user->aim) : ''; - $user->yim = isset( $user->yim ) && !empty( $user->yim ) ? attribute_escape($user->yim) : ''; - $user->jabber = isset( $user->jabber ) && !empty( $user->jabber ) ? attribute_escape($user->jabber) : ''; - $user->description = isset( $user->description ) && !empty( $user->description ) ? wp_specialchars($user->description) : ''; + $user = get_userdata( $user_id ); + + if ( $user ) + $user->filter = 'edit'; return $user; } @@ -340,7 +232,9 @@ function get_user_to_edit( $user_id ) { /** * Retrieve the user's drafts. * - * @since unknown + * @since 2.0.0 + * + * @global wpdb $wpdb * * @param int $user_id User ID. * @return array @@ -348,54 +242,132 @@ function get_user_to_edit( $user_id ) { function get_users_drafts( $user_id ) { global $wpdb; $query = $wpdb->prepare("SELECT ID, post_title FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'draft' AND post_author = %d ORDER BY post_modified DESC", $user_id); - $query = apply_filters('get_users_drafts', $query); + + /** + * Filter the user's drafts query string. + * + * @since 2.0.0 + * + * @param string $query The user's drafts query string. + */ + $query = apply_filters( 'get_users_drafts', $query ); return $wpdb->get_results( $query ); } /** * Remove user and optionally reassign posts and links to another user. * - * If the $reassign parameter is not assigned to an User ID, then all posts will + * If the $reassign parameter is not assigned to a User ID, then all posts will * be deleted of that user. The action 'delete_user' that is passed the User ID * being deleted will be run after the posts are either reassigned or deleted. * The user meta will also be deleted that are for that User ID. * - * @since unknown + * @since 2.0.0 + * + * @global wpdb $wpdb * * @param int $id User ID. * @param int $reassign Optional. Reassign posts and links to new User ID. * @return bool True when finished. */ -function wp_delete_user($id, $reassign = 'novalue') { +function wp_delete_user( $id, $reassign = null ) { global $wpdb; $id = (int) $id; + $user = new WP_User( $id ); - if ($reassign == 'novalue') { - $post_ids = $wpdb->get_col( $wpdb->prepare("SELECT ID FROM $wpdb->posts WHERE post_author = %d", $id) ); + if ( !$user->exists() ) + return false; + + // Normalize $reassign to null or a user ID. 'novalue' was an older default. + if ( 'novalue' === $reassign ) { + $reassign = null; + } elseif ( null !== $reassign ) { + $reassign = (int) $reassign; + } - if ($post_ids) { - foreach ($post_ids as $post_id) - wp_delete_post($post_id); + /** + * Fires immediately before a user is deleted from the database. + * + * @since 2.0.0 + * + * @param int $id ID of the user to delete. + * @param int|null $reassign ID of the user to reassign posts and links to. + * Default null, for no reassignment. + */ + do_action( 'delete_user', $id, $reassign ); + + if ( null === $reassign ) { + $post_types_to_delete = array(); + foreach ( get_post_types( array(), 'objects' ) as $post_type ) { + if ( $post_type->delete_with_user ) { + $post_types_to_delete[] = $post_type->name; + } elseif ( null === $post_type->delete_with_user && post_type_supports( $post_type->name, 'author' ) ) { + $post_types_to_delete[] = $post_type->name; + } + } + + /** + * Filter the list of post types to delete with a user. + * + * @since 3.4.0 + * + * @param array $post_types_to_delete Post types to delete. + * @param int $id User ID. + */ + $post_types_to_delete = apply_filters( 'post_types_to_delete_with_user', $post_types_to_delete, $id ); + $post_types_to_delete = implode( "', '", $post_types_to_delete ); + $post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_author = %d AND post_type IN ('$post_types_to_delete')", $id ) ); + if ( $post_ids ) { + foreach ( $post_ids as $post_id ) + wp_delete_post( $post_id ); } // Clean links - $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->links WHERE link_owner = %d", $id) ); + $link_ids = $wpdb->get_col( $wpdb->prepare("SELECT link_id FROM $wpdb->links WHERE link_owner = %d", $id) ); + + if ( $link_ids ) { + foreach ( $link_ids as $link_id ) + wp_delete_link($link_id); + } } else { - $reassign = (int) $reassign; - $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_author = %d WHERE post_author = %d", $reassign, $id) ); - $wpdb->query( $wpdb->prepare("UPDATE $wpdb->links SET link_owner = %d WHERE link_owner = %d", $reassign, $id) ); + $post_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_author = %d", $id ) ); + $wpdb->update( $wpdb->posts, array('post_author' => $reassign), array('post_author' => $id) ); + if ( ! empty( $post_ids ) ) { + foreach ( $post_ids as $post_id ) + clean_post_cache( $post_id ); + } + $link_ids = $wpdb->get_col( $wpdb->prepare("SELECT link_id FROM $wpdb->links WHERE link_owner = %d", $id) ); + $wpdb->update( $wpdb->links, array('link_owner' => $reassign), array('link_owner' => $id) ); + if ( ! empty( $link_ids ) ) { + foreach ( $link_ids as $link_id ) + clean_bookmark_cache( $link_id ); + } } // FINALLY, delete user - do_action('delete_user', $id); + if ( is_multisite() ) { + remove_user_from_blog( $id, get_current_blog_id() ); + } else { + $meta = $wpdb->get_col( $wpdb->prepare( "SELECT umeta_id FROM $wpdb->usermeta WHERE user_id = %d", $id ) ); + foreach ( $meta as $mid ) + delete_metadata_by_mid( 'user', $mid ); + + $wpdb->delete( $wpdb->users, array( 'ID' => $id ) ); + } - $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->users WHERE ID = %d", $id) ); - $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id = %d", $id) ); + clean_user_cache( $user ); - wp_cache_delete($id, 'users'); - wp_cache_delete($user->user_login, 'userlogins'); - wp_cache_delete($user->user_email, 'useremail'); + /** + * Fires immediately after a user is deleted from the database. + * + * @since 2.9.0 + * + * @param int $id ID of the deleted user. + * @param int|null $reassign ID of the user to reassign posts and links to. + * Default null, for no reassignment. + */ + do_action( 'deleted_user', $id, $reassign ); return true; } @@ -403,7 +375,7 @@ function wp_delete_user($id, $reassign = 'novalue') { /** * Remove all capabilities from user. * - * @since unknown + * @since 2.1.0 * * @param int $id User ID. */ @@ -414,324 +386,63 @@ function wp_revoke_user($id) { $user->remove_all_caps(); } -if ( !class_exists('WP_User_Search') ) : /** - * WordPress User Search class. + * @since 2.8.0 * - * @since unknown - * @author Mark Jaquith + * @global int $user_ID + * + * @param false $errors Deprecated. */ -class WP_User_Search { - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $results; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $search_term; - - /** - * Page number. - * - * @since unknown - * @access private - * @var int - */ - var $page; - - /** - * Role name that users have. - * - * @since unknown - * @access private - * @var string - */ - var $role; - - /** - * Raw page number. - * - * @since unknown - * @access private - * @var int|bool - */ - var $raw_page; - - /** - * Amount of users to display per page. - * - * @since unknown - * @access public - * @var int - */ - var $users_per_page = 50; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $first_user; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var int - */ - var $last_user; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $query_limit; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $query_sort; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $query_from_where; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var int - */ - var $total_users_for_query = 0; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var bool - */ - var $too_many_total_users = false; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $search_errors; - - /** - * {@internal Missing Description}} - * - * @since unknown - * @access private - * @var unknown_type - */ - var $paging_text; - - /** - * PHP4 Constructor - Sets up the object properties. - * - * @since unknown - * - * @param string $search_term Search terms string. - * @param int $page Optional. Page ID. - * @param string $role Role name. - * @return WP_User_Search - */ - function WP_User_Search ($search_term = '', $page = '', $role = '') { - $this->search_term = $search_term; - $this->raw_page = ( '' == $page ) ? false : (int) $page; - $this->page = (int) ( '' == $page ) ? 1 : $page; - $this->role = $role; - - $this->prepare_query(); - $this->query(); - $this->prepare_vars_for_template_usage(); - $this->do_paging(); - } - - /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * @access public - */ - function prepare_query() { - global $wpdb; - $this->first_user = ($this->page - 1) * $this->users_per_page; - $this->query_limit = $wpdb->prepare(" LIMIT %d, %d", $this->first_user, $this->users_per_page); - $this->query_sort = ' ORDER BY user_login'; - $search_sql = ''; - if ( $this->search_term ) { - $searches = array(); - $search_sql = 'AND ('; - foreach ( array('user_login', 'user_nicename', 'user_email', 'user_url', 'display_name') as $col ) - $searches[] = $col . " LIKE '%$this->search_term%'"; - $search_sql .= implode(' OR ', $searches); - $search_sql .= ')'; - } - - $this->query_from_where = "FROM $wpdb->users"; - if ( $this->role ) - $this->query_from_where .= $wpdb->prepare(" INNER JOIN $wpdb->usermeta ON $wpdb->users.ID = $wpdb->usermeta.user_id WHERE $wpdb->usermeta.meta_key = '{$wpdb->prefix}capabilities' AND $wpdb->usermeta.meta_value LIKE %s", '%' . $this->role . '%'); - else - $this->query_from_where .= " WHERE 1=1"; - $this->query_from_where .= " $search_sql"; - - } - - /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * @access public - */ - function query() { - global $wpdb; - $this->results = $wpdb->get_col('SELECT ID ' . $this->query_from_where . $this->query_sort . $this->query_limit); - - if ( $this->results ) - $this->total_users_for_query = $wpdb->get_var('SELECT COUNT(ID) ' . $this->query_from_where); // no limit - else - $this->search_errors = new WP_Error('no_matching_users_found', __('No matching users were found!')); - } - - /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * @access public - */ - function prepare_vars_for_template_usage() { - $this->search_term = stripslashes($this->search_term); // done with DB, from now on we want slashes gone - } - - /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * @access public - */ - function do_paging() { - if ( $this->total_users_for_query > $this->users_per_page ) { // have to page the results - $args = array(); - if( ! empty($this->search_term) ) - $args['usersearch'] = urlencode($this->search_term); - if( ! empty($this->role) ) - $args['role'] = urlencode($this->role); - - $this->paging_text = paginate_links( array( - 'total' => ceil($this->total_users_for_query / $this->users_per_page), - 'current' => $this->page, - 'base' => 'users.php?%_%', - 'format' => 'userspage=%#%', - 'add_args' => $args - ) ); - if ( $this->paging_text ) { - $this->paging_text = sprintf( '' . __( 'Displaying %s–%s of %s' ) . '%s', - number_format_i18n( ( $this->page - 1 ) * $this->users_per_page + 1 ), - number_format_i18n( min( $this->page * $this->users_per_page, $this->total_users_for_query ) ), - number_format_i18n( $this->total_users_for_query ), - $this->paging_text - ); - } - } - } - - /** - * {@internal Missing Short Description}} - * - * {@internal Missing Long Description}} - * - * @since unknown - * @access public - * - * @return unknown - */ - function get_results() { - return (array) $this->results; +function default_password_nag_handler($errors = false) { + global $user_ID; + // Short-circuit it. + if ( ! get_user_option('default_password_nag') ) + return; + + // get_user_setting = JS saved UI setting. else no-js-fallback code. + if ( 'hide' == get_user_setting('default_password_nag') || isset($_GET['default_password_nag']) && '0' == $_GET['default_password_nag'] ) { + delete_user_setting('default_password_nag'); + update_user_option($user_ID, 'default_password_nag', false, true); } +} - /** - * Displaying paging text. - * - * @see do_paging() Builds paging text. - * - * @since unknown - * @access public - */ - function page_links() { - echo $this->paging_text; - } +/** + * @since 2.8.0 + * + * @param int $user_ID + * @param object $old_data + */ +function default_password_nag_edit_user($user_ID, $old_data) { + // Short-circuit it. + if ( ! get_user_option('default_password_nag', $user_ID) ) + return; - /** - * Whether paging is enabled. - * - * @see do_paging() Builds paging text. - * - * @since unknown - * @access public - * - * @return bool - */ - function results_are_paged() { - if ( $this->paging_text ) - return true; - return false; - } + $new_data = get_userdata($user_ID); - /** - * Whether there are search terms. - * - * @since unknown - * @access public - * - * @return bool - */ - function is_search() { - if ( $this->search_term ) - return true; - return false; + // Remove the nag if the password has been changed. + if ( $new_data->user_pass != $old_data->user_pass ) { + delete_user_setting('default_password_nag'); + update_user_option($user_ID, 'default_password_nag', false, true); } } -endif; -?> +/** + * @since 2.8.0 + * + * @global string $pagenow + */ +function default_password_nag() { + global $pagenow; + // Short-circuit it. + if ( 'profile.php' == $pagenow || ! get_user_option('default_password_nag') ) + return; + + echo '
'; + echo '

'; + echo '' . __('Notice:') . ' '; + _e('You’re using the auto-generated password for your account. Would you like to change it?'); + echo '

'; + printf( '' . __('Yes, take me to my profile page') . ' | ', get_edit_profile_url() . '#password' ); + printf( '' . __('No thanks, do not remind me again') . '', '?default_password_nag=0' ); + echo '

'; +}