3 * Edit user administration panel.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
12 wp_reset_vars( array( 'action', 'user_id', 'wp_http_referer' ) );
14 $user_id = (int) $user_id;
15 $current_user = wp_get_current_user();
16 if ( ! defined( 'IS_PROFILE_PAGE' ) )
17 define( 'IS_PROFILE_PAGE', ( $user_id == $current_user->ID ) );
19 if ( ! $user_id && IS_PROFILE_PAGE )
20 $user_id = $current_user->ID;
21 elseif ( ! $user_id && ! IS_PROFILE_PAGE )
22 wp_die(__( 'Invalid user ID.' ) );
23 elseif ( ! get_userdata( $user_id ) )
24 wp_die( __('Invalid user ID.') );
26 wp_enqueue_script('user-profile');
28 $title = IS_PROFILE_PAGE ? __('Profile') : __('Edit User');
29 if ( current_user_can('edit_users') && !IS_PROFILE_PAGE )
30 $submenu_file = 'users.php';
32 $submenu_file = 'profile.php';
34 if ( current_user_can('edit_users') && !is_user_admin() )
35 $parent_file = 'users.php';
37 $parent_file = 'profile.php';
39 $profile_help = '<p>' . __('Your profile contains information about you (your “account”) as well as some personal options related to using WordPress.') . '</p>' .
40 '<p>' . __('You can change your password, turn on keyboard shortcuts, change the color scheme of your WordPress administration screens, and turn off the WYSIWYG (Visual) editor, among other things. You can hide the Toolbar (formerly called the Admin Bar) from the front end of your site, however it cannot be disabled on the admin screens.') . '</p>' .
41 '<p>' . __('Your username cannot be changed, but you can use other fields to enter your real name or a nickname, and change which name to display on your posts.') . '</p>' .
42 '<p>' . __('Required fields are indicated; the rest are optional. Profile information will only be displayed if your theme is set up to do so.') . '</p>' .
43 '<p>' . __('Remember to click the Update Profile button when you are finished.') . '</p>';
45 get_current_screen()->add_help_tab( array(
47 'title' => __('Overview'),
48 'content' => $profile_help,
51 get_current_screen()->set_help_sidebar(
52 '<p><strong>' . __('For more information:') . '</strong></p>' .
53 '<p>' . __('<a href="http://codex.wordpress.org/Users_Your_Profile_Screen" target="_blank">Documentation on User Profiles</a>') . '</p>' .
54 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
57 $wp_http_referer = remove_query_arg(array('update', 'delete_count'), $wp_http_referer );
59 $user_can_edit = current_user_can( 'edit_posts' ) || current_user_can( 'edit_pages' );
62 * Optional SSL preference that can be turned on by hooking to the 'personal_options' action.
66 * @param object $user User data object
68 function use_ssl_preference($user) {
71 <th scope="row"><?php _e('Use https')?></th>
72 <td><label for="use_ssl"><input name="use_ssl" type="checkbox" id="use_ssl" value="1" <?php checked('1', $user->use_ssl); ?> /> <?php _e('Always use https when visiting the admin'); ?></label></td>
78 * Filter whether to allow administrators on Multisite to edit every user.
80 * Enabling the user editing form via this filter also hinges on the user holding
81 * the 'manage_network_users' cap, and the logged-in user not matching the user
82 * profile open for editing.
84 * The filter was introduced to replace the EDIT_ANY_USER constant.
88 * @param bool $allow Whether to allow editing of any user. Default true.
91 && ! current_user_can( 'manage_network_users' )
92 && $user_id != $current_user->ID
93 && ! apply_filters( 'enable_edit_any_user_configuration', true )
95 wp_die( __( 'You do not have permission to edit this user.' ) );
98 // Execute confirmed email change. See send_confirmation_on_profile_email().
99 if ( is_multisite() && IS_PROFILE_PAGE && isset( $_GET[ 'newuseremail' ] ) && $current_user->ID ) {
100 $new_email = get_option( $current_user->ID . '_new_email' );
101 if ( $new_email[ 'hash' ] == $_GET[ 'newuseremail' ] ) {
102 $user = new stdClass;
103 $user->ID = $current_user->ID;
104 $user->user_email = esc_html( trim( $new_email[ 'newemail' ] ) );
105 if ( $wpdb->get_var( $wpdb->prepare( "SELECT user_login FROM {$wpdb->signups} WHERE user_login = %s", $current_user->user_login ) ) )
106 $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->signups} SET user_email = %s WHERE user_login = %s", $user->user_email, $current_user->user_login ) );
107 wp_update_user( $user );
108 delete_option( $current_user->ID . '_new_email' );
109 wp_redirect( add_query_arg( array('updated' => 'true'), self_admin_url( 'profile.php' ) ) );
112 } elseif ( is_multisite() && IS_PROFILE_PAGE && !empty( $_GET['dismiss'] ) && $current_user->ID . '_new_email' == $_GET['dismiss'] ) {
113 delete_option( $current_user->ID . '_new_email' );
114 wp_redirect( add_query_arg( array('updated' => 'true'), self_admin_url( 'profile.php' ) ) );
121 check_admin_referer('update-user_' . $user_id);
123 if ( !current_user_can('edit_user', $user_id) )
124 wp_die(__('You do not have permission to edit this user.'));
126 if ( IS_PROFILE_PAGE ) {
128 * Fires before the page loads on the 'Your Profile' editing screen.
130 * The action only fires if the current user is editing their own profile.
134 * @param int $user_id The user ID.
136 do_action( 'personal_options_update', $user_id );
139 * Fires before the page loads on the 'Edit User' screen.
143 * @param int $user_id The user ID.
145 do_action( 'edit_user_profile_update', $user_id );
148 if ( !is_multisite() ) {
149 $errors = edit_user($user_id);
151 $user = get_userdata( $user_id );
153 // Update the email address in signups, if present.
154 if ( $user->user_login && isset( $_POST[ 'email' ] ) && is_email( $_POST[ 'email' ] ) && $wpdb->get_var( $wpdb->prepare( "SELECT user_login FROM {$wpdb->signups} WHERE user_login = %s", $user->user_login ) ) )
155 $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->signups} SET user_email = %s WHERE user_login = %s", $_POST[ 'email' ], $user_login ) );
157 // We must delete the user from the current blog if WP added them after editing.
158 $delete_role = false;
159 $blog_prefix = $wpdb->get_blog_prefix();
160 if ( $user_id != $current_user->ID ) {
161 $cap = $wpdb->get_var( "SELECT meta_value FROM {$wpdb->usermeta} WHERE user_id = '{$user_id}' AND meta_key = '{$blog_prefix}capabilities' AND meta_value = 'a:0:{}'" );
162 if ( !is_network_admin() && null == $cap && $_POST[ 'role' ] == '' ) {
163 $_POST[ 'role' ] = 'contributor';
167 if ( !isset( $errors ) || ( isset( $errors ) && is_object( $errors ) && false == $errors->get_error_codes() ) )
168 $errors = edit_user($user_id);
169 if ( $delete_role ) // stops users being added to current blog when they are edited
170 delete_user_meta( $user_id, $blog_prefix . 'capabilities' );
172 if ( is_multisite() && is_network_admin() && !IS_PROFILE_PAGE && current_user_can( 'manage_network_options' ) && !isset($super_admins) && empty( $_POST['super_admin'] ) == is_super_admin( $user_id ) )
173 empty( $_POST['super_admin'] ) ? revoke_super_admin( $user_id ) : grant_super_admin( $user_id );
176 if ( !is_wp_error( $errors ) ) {
177 $redirect = add_query_arg( 'updated', true, get_edit_user_link( $user_id ) );
178 if ( $wp_http_referer )
179 $redirect = add_query_arg('wp_http_referer', urlencode($wp_http_referer), $redirect);
180 wp_redirect($redirect);
185 $profileuser = get_user_to_edit($user_id);
187 if ( !current_user_can('edit_user', $user_id) )
188 wp_die(__('You do not have permission to edit this user.'));
190 include (ABSPATH . 'wp-admin/admin-header.php');
193 <?php if ( !IS_PROFILE_PAGE && is_super_admin( $profileuser->ID ) && current_user_can( 'manage_network_options' ) ) { ?>
194 <div class="updated"><p><strong><?php _e('Important:'); ?></strong> <?php _e('This user has super admin privileges.'); ?></p></div>
196 <?php if ( isset($_GET['updated']) ) : ?>
197 <div id="message" class="updated">
198 <?php if ( IS_PROFILE_PAGE ) : ?>
199 <p><strong><?php _e('Profile updated.') ?></strong></p>
201 <p><strong><?php _e('User updated.') ?></strong></p>
203 <?php if ( $wp_http_referer && !IS_PROFILE_PAGE ) : ?>
204 <p><a href="<?php echo esc_url( $wp_http_referer ); ?>"><?php _e('← Back to Users'); ?></a></p>
208 <?php if ( isset( $errors ) && is_wp_error( $errors ) ) : ?>
209 <div class="error"><p><?php echo implode( "</p>\n<p>", $errors->get_error_messages() ); ?></p></div>
212 <div class="wrap" id="profile-page">
215 echo esc_html( $title );
216 if ( ! IS_PROFILE_PAGE ) {
217 if ( current_user_can( 'create_users' ) ) { ?>
218 <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add New', 'user' ); ?></a>
219 <?php } elseif ( is_multisite() && current_user_can( 'promote_users' ) ) { ?>
220 <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add Existing', 'user' ); ?></a>
226 * Fires inside the your-profile form tag on the user editing screen.
231 <form id="your-profile" action="<?php echo esc_url( self_admin_url( IS_PROFILE_PAGE ? 'profile.php' : 'user-edit.php' ) ); ?>" method="post"<?php do_action( 'user_edit_form_tag' ); ?>>
232 <?php wp_nonce_field('update-user_' . $user_id) ?>
233 <?php if ( $wp_http_referer ) : ?>
234 <input type="hidden" name="wp_http_referer" value="<?php echo esc_url($wp_http_referer); ?>" />
237 <input type="hidden" name="from" value="profile" />
238 <input type="hidden" name="checkuser_id" value="<?php echo get_current_user_id(); ?>" />
241 <h3><?php _e('Personal Options'); ?></h3>
243 <table class="form-table">
244 <?php if ( ! ( IS_PROFILE_PAGE && ! $user_can_edit ) ) : ?>
246 <th scope="row"><?php _e('Visual Editor')?></th>
247 <td><label for="rich_editing"><input name="rich_editing" type="checkbox" id="rich_editing" value="false" <?php if ( ! empty( $profileuser->rich_editing ) ) checked( 'false', $profileuser->rich_editing ); ?> /> <?php _e( 'Disable the visual editor when writing' ); ?></label></td>
250 <?php if ( count($_wp_admin_css_colors) > 1 && has_action('admin_color_scheme_picker') ) : ?>
252 <th scope="row"><?php _e('Admin Color Scheme')?></th>
255 * Fires in the 'Admin Color Scheme' section of the user editing screen.
257 * The section is only enabled if a callback is hooked to the action,
258 * and if there is more than one defined color scheme for the admin.
263 <td><?php do_action( 'admin_color_scheme_picker', $user_id ); ?></td>
266 endif; // $_wp_admin_css_colors
267 if ( !( IS_PROFILE_PAGE && !$user_can_edit ) ) : ?>
269 <th scope="row"><?php _e( 'Keyboard Shortcuts' ); ?></th>
270 <td><label for="comment_shortcuts"><input type="checkbox" name="comment_shortcuts" id="comment_shortcuts" value="true" <?php if ( ! empty( $profileuser->comment_shortcuts ) ) checked( 'true', $profileuser->comment_shortcuts ); ?> /> <?php _e('Enable keyboard shortcuts for comment moderation.'); ?></label> <?php _e('<a href="http://codex.wordpress.org/Keyboard_Shortcuts" target="_blank">More information</a>'); ?></td>
273 <tr class="show-admin-bar">
274 <th scope="row"><?php _e('Toolbar')?></th>
275 <td><fieldset><legend class="screen-reader-text"><span><?php _e('Toolbar') ?></span></legend>
276 <label for="admin_bar_front">
277 <input name="admin_bar_front" type="checkbox" id="admin_bar_front" value="1"<?php checked( _get_admin_bar_pref( 'front', $profileuser->ID ) ); ?> />
278 <?php _e( 'Show Toolbar when viewing site' ); ?></label><br />
284 * Fires at the end of the 'Personal Options' settings table on the user editing screen.
288 * @param WP_User $profileuser The current WP_User object.
290 do_action( 'personal_options', $profileuser );
294 if ( IS_PROFILE_PAGE ) {
296 * Fires after the 'Personal Options' settings table on the 'Your Profile' editing screen.
298 * The action only fires if the current user is editing their own profile.
302 * @param WP_User $profileuser The current WP_User object.
304 do_action( 'profile_personal_options', $profileuser );
308 <h3><?php _e('Name') ?></h3>
310 <table class="form-table">
312 <th><label for="user_login"><?php _e('Username'); ?></label></th>
313 <td><input type="text" name="user_login" id="user_login" value="<?php echo esc_attr($profileuser->user_login); ?>" disabled="disabled" class="regular-text" /> <span class="description"><?php _e('Usernames cannot be changed.'); ?></span></td>
316 <?php if ( !IS_PROFILE_PAGE && !is_network_admin() ) : ?>
317 <tr><th><label for="role"><?php _e('Role') ?></label></th>
318 <td><select name="role" id="role">
320 // Compare user role against currently editable roles
321 $user_roles = array_intersect( array_values( $profileuser->roles ), array_keys( get_editable_roles() ) );
322 $user_role = array_shift( $user_roles );
324 // print the full list of roles with the primary one selected.
325 wp_dropdown_roles($user_role);
327 // print the 'no role' option. Make it selected if the user has no role yet.
329 echo '<option value="">' . __('— No role for this site —') . '</option>';
331 echo '<option value="" selected="selected">' . __('— No role for this site —') . '</option>';
334 <?php endif; //!IS_PROFILE_PAGE
336 if ( is_multisite() && is_network_admin() && ! IS_PROFILE_PAGE && current_user_can( 'manage_network_options' ) && !isset($super_admins) ) { ?>
337 <tr><th><?php _e('Super Admin'); ?></th>
339 <?php if ( $profileuser->user_email != get_site_option( 'admin_email' ) || ! is_super_admin( $profileuser->ID ) ) : ?>
340 <p><label><input type="checkbox" id="super_admin" name="super_admin"<?php checked( is_super_admin( $profileuser->ID ) ); ?> /> <?php _e( 'Grant this user super admin privileges for the Network.' ); ?></label></p>
342 <p><?php _e( 'Super admin privileges cannot be removed because this user has the network admin email.' ); ?></p>
348 <th><label for="first_name"><?php _e('First Name') ?></label></th>
349 <td><input type="text" name="first_name" id="first_name" value="<?php echo esc_attr($profileuser->first_name) ?>" class="regular-text" /></td>
353 <th><label for="last_name"><?php _e('Last Name') ?></label></th>
354 <td><input type="text" name="last_name" id="last_name" value="<?php echo esc_attr($profileuser->last_name) ?>" class="regular-text" /></td>
358 <th><label for="nickname"><?php _e('Nickname'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
359 <td><input type="text" name="nickname" id="nickname" value="<?php echo esc_attr($profileuser->nickname) ?>" class="regular-text" /></td>
363 <th><label for="display_name"><?php _e('Display name publicly as') ?></label></th>
365 <select name="display_name" id="display_name">
367 $public_display = array();
368 $public_display['display_nickname'] = $profileuser->nickname;
369 $public_display['display_username'] = $profileuser->user_login;
371 if ( !empty($profileuser->first_name) )
372 $public_display['display_firstname'] = $profileuser->first_name;
374 if ( !empty($profileuser->last_name) )
375 $public_display['display_lastname'] = $profileuser->last_name;
377 if ( !empty($profileuser->first_name) && !empty($profileuser->last_name) ) {
378 $public_display['display_firstlast'] = $profileuser->first_name . ' ' . $profileuser->last_name;
379 $public_display['display_lastfirst'] = $profileuser->last_name . ' ' . $profileuser->first_name;
382 if ( !in_array( $profileuser->display_name, $public_display ) ) // Only add this if it isn't duplicated elsewhere
383 $public_display = array( 'display_displayname' => $profileuser->display_name ) + $public_display;
385 $public_display = array_map( 'trim', $public_display );
386 $public_display = array_unique( $public_display );
388 foreach ( $public_display as $id => $item ) {
390 <option <?php selected( $profileuser->display_name, $item ); ?>><?php echo $item; ?></option>
399 <h3><?php _e('Contact Info') ?></h3>
401 <table class="form-table">
403 <th><label for="email"><?php _e('E-mail'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
404 <td><input type="text" name="email" id="email" value="<?php echo esc_attr($profileuser->user_email) ?>" class="regular-text ltr" />
406 $new_email = get_option( $current_user->ID . '_new_email' );
407 if ( $new_email && $new_email['newemail'] != $current_user->user_email && $profileuser->ID == $current_user->ID ) : ?>
408 <div class="updated inline">
409 <p><?php printf( __('There is a pending change of your e-mail to <code>%1$s</code>. <a href="%2$s">Cancel</a>'), $new_email['newemail'], esc_url( self_admin_url( 'profile.php?dismiss=' . $current_user->ID . '_new_email' ) ) ); ?></p>
416 <th><label for="url"><?php _e('Website') ?></label></th>
417 <td><input type="text" name="url" id="url" value="<?php echo esc_attr($profileuser->user_url) ?>" class="regular-text code" /></td>
421 foreach ( wp_get_user_contact_methods( $profileuser ) as $name => $desc ) {
426 * Filter a user contactmethod label.
428 * The dynamic portion of the filter hook, $name, refers to
429 * each of the keys in the contactmethods array.
433 * @param string $desc The translatable label for the contactmethod.
436 <th><label for="<?php echo $name; ?>"><?php echo apply_filters( "user_{$name}_label", $desc ); ?></label></th>
437 <td><input type="text" name="<?php echo $name; ?>" id="<?php echo $name; ?>" value="<?php echo esc_attr($profileuser->$name) ?>" class="regular-text" /></td>
444 <h3><?php IS_PROFILE_PAGE ? _e('About Yourself') : _e('About the user'); ?></h3>
446 <table class="form-table">
448 <th><label for="description"><?php _e('Biographical Info'); ?></label></th>
449 <td><textarea name="description" id="description" rows="5" cols="30"><?php echo $profileuser->description; // textarea_escaped ?></textarea><br />
450 <span class="description"><?php _e('Share a little biographical information to fill out your profile. This may be shown publicly.'); ?></span></td>
454 /** This filter is documented in wp-admin/user-new.php */
455 $show_password_fields = apply_filters( 'show_password_fields', true, $profileuser );
456 if ( $show_password_fields ) :
459 <th><label for="pass1"><?php _e( 'New Password' ); ?></label></th>
461 <input class="hidden" value=" " /><!-- #24364 workaround -->
462 <input type="password" name="pass1" id="pass1" class="regular-text" size="16" value="" autocomplete="off" /><br />
463 <span class="description"><?php _e( 'If you would like to change the password type a new one. Otherwise leave this blank.' ); ?></span>
467 <th scope="row"><label for="pass2"><?php _e( 'Repeat New Password' ); ?></label></th>
469 <input name="pass2" type="password" id="pass2" class="regular-text" size="16" value="" autocomplete="off" /><br />
470 <span class="description" for="pass2"><?php _e( 'Type your new password again.' ); ?></span>
472 <div id="pass-strength-result"><?php _e( 'Strength indicator' ); ?></div>
473 <p class="description indicator-hint"><?php _e( 'Hint: The password should be at least seven characters long. To make it stronger, use upper and lower case letters, numbers, and symbols like ! " ? $ % ^ & ).' ); ?></p>
480 if ( IS_PROFILE_PAGE ) {
482 * Fires after the 'About Yourself' settings table on the 'Your Profile' editing screen.
484 * The action only fires if the current user is editing their own profile.
488 * @param WP_User $profileuser The current WP_User object.
490 do_action( 'show_user_profile', $profileuser );
493 * Fires after the 'About the User' settings table on the 'Edit User' screen.
497 * @param WP_User $profileuser The current WP_User object.
499 do_action( 'edit_user_profile', $profileuser );
505 * Filter whether to display additional capabilities for the user.
507 * The 'Additional Capabilities' section will only be enabled if
508 * the number of the user's capabilities exceeds their number of
513 * @param bool $enable Whether to display the capabilities. Default true.
514 * @param WP_User $profileuser The current WP_User object.
516 if ( count( $profileuser->caps ) > count( $profileuser->roles )
517 && apply_filters( 'additional_capabilities_display', true, $profileuser )
519 <h3><?php _e( 'Additional Capabilities' ); ?></h3>
520 <table class="form-table">
522 <th scope="row"><?php _e( 'Capabilities' ); ?></th>
526 foreach ( $profileuser->caps as $cap => $value ) {
527 if ( ! $wp_roles->is_role( $cap ) ) {
530 $output .= $value ? $cap : sprintf( __( 'Denied: %s' ), $cap );
540 <input type="hidden" name="action" value="update" />
541 <input type="hidden" name="user_id" id="user_id" value="<?php echo esc_attr($user_id); ?>" />
543 <?php submit_button( IS_PROFILE_PAGE ? __('Update Profile') : __('Update User') ); ?>
551 <script type="text/javascript">
552 if (window.location.hash == '#password') {
553 document.getElementById('pass1').focus();
557 include( ABSPATH . 'wp-admin/admin-footer.php');