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>' . __( 'You can log out of other devices, such as your phone or a public computer, by clicking the Log Out of All Other Sessions button.' ) . '</p>' .
43 '<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>' .
44 '<p>' . __('Remember to click the Update Profile button when you are finished.') . '</p>';
46 get_current_screen()->add_help_tab( array(
48 'title' => __('Overview'),
49 'content' => $profile_help,
52 get_current_screen()->set_help_sidebar(
53 '<p><strong>' . __('For more information:') . '</strong></p>' .
54 '<p>' . __('<a href="https://codex.wordpress.org/Users_Your_Profile_Screen" target="_blank">Documentation on User Profiles</a>') . '</p>' .
55 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
58 $wp_http_referer = remove_query_arg(array('update', 'delete_count'), $wp_http_referer );
60 $user_can_edit = current_user_can( 'edit_posts' ) || current_user_can( 'edit_pages' );
63 * Optional SSL preference that can be turned on by hooking to the 'personal_options' action.
67 * @param object $user User data object
69 function use_ssl_preference($user) {
71 <tr class="user-use-ssl-wrap">
72 <th scope="row"><?php _e('Use https')?></th>
73 <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>
79 * Filter whether to allow administrators on Multisite to edit every user.
81 * Enabling the user editing form via this filter also hinges on the user holding
82 * the 'manage_network_users' cap, and the logged-in user not matching the user
83 * profile open for editing.
85 * The filter was introduced to replace the EDIT_ANY_USER constant.
89 * @param bool $allow Whether to allow editing of any user. Default true.
92 && ! current_user_can( 'manage_network_users' )
93 && $user_id != $current_user->ID
94 && ! apply_filters( 'enable_edit_any_user_configuration', true )
96 wp_die( __( 'You do not have permission to edit this user.' ) );
99 // Execute confirmed email change. See send_confirmation_on_profile_email().
100 if ( is_multisite() && IS_PROFILE_PAGE && isset( $_GET[ 'newuseremail' ] ) && $current_user->ID ) {
101 $new_email = get_option( $current_user->ID . '_new_email' );
102 if ( $new_email[ 'hash' ] == $_GET[ 'newuseremail' ] ) {
103 $user = new stdClass;
104 $user->ID = $current_user->ID;
105 $user->user_email = esc_html( trim( $new_email[ 'newemail' ] ) );
106 if ( $wpdb->get_var( $wpdb->prepare( "SELECT user_login FROM {$wpdb->signups} WHERE user_login = %s", $current_user->user_login ) ) )
107 $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->signups} SET user_email = %s WHERE user_login = %s", $user->user_email, $current_user->user_login ) );
108 wp_update_user( $user );
109 delete_option( $current_user->ID . '_new_email' );
110 wp_redirect( add_query_arg( array('updated' => 'true'), self_admin_url( 'profile.php' ) ) );
113 } elseif ( is_multisite() && IS_PROFILE_PAGE && !empty( $_GET['dismiss'] ) && $current_user->ID . '_new_email' == $_GET['dismiss'] ) {
114 delete_option( $current_user->ID . '_new_email' );
115 wp_redirect( add_query_arg( array('updated' => 'true'), self_admin_url( 'profile.php' ) ) );
122 check_admin_referer('update-user_' . $user_id);
124 if ( !current_user_can('edit_user', $user_id) )
125 wp_die(__('You do not have permission to edit this user.'));
127 if ( IS_PROFILE_PAGE ) {
129 * Fires before the page loads on the 'Your Profile' editing screen.
131 * The action only fires if the current user is editing their own profile.
135 * @param int $user_id The user ID.
137 do_action( 'personal_options_update', $user_id );
140 * Fires before the page loads on the 'Edit User' screen.
144 * @param int $user_id The user ID.
146 do_action( 'edit_user_profile_update', $user_id );
149 // Update the email address in signups, if present.
150 if ( is_multisite() ) {
151 $user = get_userdata( $user_id );
153 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 ) ) ) {
154 $wpdb->query( $wpdb->prepare( "UPDATE {$wpdb->signups} SET user_email = %s WHERE user_login = %s", $_POST[ 'email' ], $user_login ) );
159 $errors = edit_user( $user_id );
161 // Grant or revoke super admin status if requested.
162 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 ) ) {
163 empty( $_POST['super_admin'] ) ? revoke_super_admin( $user_id ) : grant_super_admin( $user_id );
166 if ( !is_wp_error( $errors ) ) {
167 $redirect = add_query_arg( 'updated', true, get_edit_user_link( $user_id ) );
168 if ( $wp_http_referer )
169 $redirect = add_query_arg('wp_http_referer', urlencode($wp_http_referer), $redirect);
170 wp_redirect($redirect);
175 $profileuser = get_user_to_edit($user_id);
177 if ( !current_user_can('edit_user', $user_id) )
178 wp_die(__('You do not have permission to edit this user.'));
180 $sessions = WP_Session_Tokens::get_instance( $profileuser->ID );
182 include(ABSPATH . 'wp-admin/admin-header.php');
185 <?php if ( !IS_PROFILE_PAGE && is_super_admin( $profileuser->ID ) && current_user_can( 'manage_network_options' ) ) { ?>
186 <div class="updated"><p><strong><?php _e('Important:'); ?></strong> <?php _e('This user has super admin privileges.'); ?></p></div>
188 <?php if ( isset($_GET['updated']) ) : ?>
189 <div id="message" class="updated notice is-dismissible">
190 <?php if ( IS_PROFILE_PAGE ) : ?>
191 <p><strong><?php _e('Profile updated.') ?></strong></p>
193 <p><strong><?php _e('User updated.') ?></strong></p>
195 <?php if ( $wp_http_referer && !IS_PROFILE_PAGE ) : ?>
196 <p><a href="<?php echo esc_url( $wp_http_referer ); ?>"><?php _e('← Back to Users'); ?></a></p>
200 <?php if ( isset( $errors ) && is_wp_error( $errors ) ) : ?>
201 <div class="error"><p><?php echo implode( "</p>\n<p>", $errors->get_error_messages() ); ?></p></div>
204 <div class="wrap" id="profile-page">
207 echo esc_html( $title );
208 if ( ! IS_PROFILE_PAGE ) {
209 if ( current_user_can( 'create_users' ) ) { ?>
210 <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add New', 'user' ); ?></a>
211 <?php } elseif ( is_multisite() && current_user_can( 'promote_users' ) ) { ?>
212 <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add Existing', 'user' ); ?></a>
216 <form id="your-profile" action="<?php echo esc_url( self_admin_url( IS_PROFILE_PAGE ? 'profile.php' : 'user-edit.php' ) ); ?>" method="post" novalidate="novalidate"<?php
218 * Fires inside the your-profile form tag on the user editing screen.
222 do_action( 'user_edit_form_tag' );
224 <?php wp_nonce_field('update-user_' . $user_id) ?>
225 <?php if ( $wp_http_referer ) : ?>
226 <input type="hidden" name="wp_http_referer" value="<?php echo esc_url($wp_http_referer); ?>" />
229 <input type="hidden" name="from" value="profile" />
230 <input type="hidden" name="checkuser_id" value="<?php echo get_current_user_id(); ?>" />
233 <h3><?php _e('Personal Options'); ?></h3>
235 <table class="form-table">
236 <?php if ( ! ( IS_PROFILE_PAGE && ! $user_can_edit ) ) : ?>
237 <tr class="user-rich-editing-wrap">
238 <th scope="row"><?php _e( 'Visual Editor' ); ?></th>
239 <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>
242 <?php if ( count($_wp_admin_css_colors) > 1 && has_action('admin_color_scheme_picker') ) : ?>
243 <tr class="user-admin-color-wrap">
244 <th scope="row"><?php _e('Admin Color Scheme')?></th>
247 * Fires in the 'Admin Color Scheme' section of the user editing screen.
249 * The section is only enabled if a callback is hooked to the action,
250 * and if there is more than one defined color scheme for the admin.
253 * @since 3.8.1 Added `$user_id` parameter.
255 * @param int $user_id The user ID.
257 do_action( 'admin_color_scheme_picker', $user_id );
261 endif; // $_wp_admin_css_colors
262 if ( !( IS_PROFILE_PAGE && !$user_can_edit ) ) : ?>
263 <tr class="user-comment-shortcuts-wrap">
264 <th scope="row"><?php _e( 'Keyboard Shortcuts' ); ?></th>
265 <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="https://codex.wordpress.org/Keyboard_Shortcuts" target="_blank">More information</a>'); ?></td>
268 <tr class="show-admin-bar user-admin-bar-front-wrap">
269 <th scope="row"><?php _e( 'Toolbar' ); ?></th>
270 <td><fieldset><legend class="screen-reader-text"><span><?php _e('Toolbar') ?></span></legend>
271 <label for="admin_bar_front">
272 <input name="admin_bar_front" type="checkbox" id="admin_bar_front" value="1"<?php checked( _get_admin_bar_pref( 'front', $profileuser->ID ) ); ?> />
273 <?php _e( 'Show Toolbar when viewing site' ); ?></label><br />
279 * Fires at the end of the 'Personal Options' settings table on the user editing screen.
283 * @param WP_User $profileuser The current WP_User object.
285 do_action( 'personal_options', $profileuser );
290 if ( IS_PROFILE_PAGE ) {
292 * Fires after the 'Personal Options' settings table on the 'Your Profile' editing screen.
294 * The action only fires if the current user is editing their own profile.
298 * @param WP_User $profileuser The current WP_User object.
300 do_action( 'profile_personal_options', $profileuser );
304 <h3><?php _e('Name') ?></h3>
306 <table class="form-table">
307 <tr class="user-user-login-wrap">
308 <th><label for="user_login"><?php _e('Username'); ?></label></th>
309 <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>
312 <?php if ( !IS_PROFILE_PAGE && !is_network_admin() ) : ?>
313 <tr class="user-role-wrap"><th><label for="role"><?php _e('Role') ?></label></th>
314 <td><select name="role" id="role">
316 // Compare user role against currently editable roles
317 $user_roles = array_intersect( array_values( $profileuser->roles ), array_keys( get_editable_roles() ) );
318 $user_role = reset( $user_roles );
320 // print the full list of roles with the primary one selected.
321 wp_dropdown_roles($user_role);
323 // print the 'no role' option. Make it selected if the user has no role yet.
325 echo '<option value="">' . __('— No role for this site —') . '</option>';
327 echo '<option value="" selected="selected">' . __('— No role for this site —') . '</option>';
330 <?php endif; //!IS_PROFILE_PAGE
332 if ( is_multisite() && is_network_admin() && ! IS_PROFILE_PAGE && current_user_can( 'manage_network_options' ) && !isset($super_admins) ) { ?>
333 <tr class="user-super-admin-wrap"><th><?php _e('Super Admin'); ?></th>
335 <?php if ( $profileuser->user_email != get_site_option( 'admin_email' ) || ! is_super_admin( $profileuser->ID ) ) : ?>
336 <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>
338 <p><?php _e( 'Super admin privileges cannot be removed because this user has the network admin email.' ); ?></p>
343 <tr class="user-first-name-wrap">
344 <th><label for="first_name"><?php _e('First Name') ?></label></th>
345 <td><input type="text" name="first_name" id="first_name" value="<?php echo esc_attr($profileuser->first_name) ?>" class="regular-text" /></td>
348 <tr class="user-last-name-wrap">
349 <th><label for="last_name"><?php _e('Last Name') ?></label></th>
350 <td><input type="text" name="last_name" id="last_name" value="<?php echo esc_attr($profileuser->last_name) ?>" class="regular-text" /></td>
353 <tr class="user-nickname-wrap">
354 <th><label for="nickname"><?php _e('Nickname'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
355 <td><input type="text" name="nickname" id="nickname" value="<?php echo esc_attr($profileuser->nickname) ?>" class="regular-text" /></td>
358 <tr class="user-display-name-wrap">
359 <th><label for="display_name"><?php _e('Display name publicly as') ?></label></th>
361 <select name="display_name" id="display_name">
363 $public_display = array();
364 $public_display['display_nickname'] = $profileuser->nickname;
365 $public_display['display_username'] = $profileuser->user_login;
367 if ( !empty($profileuser->first_name) )
368 $public_display['display_firstname'] = $profileuser->first_name;
370 if ( !empty($profileuser->last_name) )
371 $public_display['display_lastname'] = $profileuser->last_name;
373 if ( !empty($profileuser->first_name) && !empty($profileuser->last_name) ) {
374 $public_display['display_firstlast'] = $profileuser->first_name . ' ' . $profileuser->last_name;
375 $public_display['display_lastfirst'] = $profileuser->last_name . ' ' . $profileuser->first_name;
378 if ( !in_array( $profileuser->display_name, $public_display ) ) // Only add this if it isn't duplicated elsewhere
379 $public_display = array( 'display_displayname' => $profileuser->display_name ) + $public_display;
381 $public_display = array_map( 'trim', $public_display );
382 $public_display = array_unique( $public_display );
384 foreach ( $public_display as $id => $item ) {
386 <option <?php selected( $profileuser->display_name, $item ); ?>><?php echo $item; ?></option>
395 <h3><?php _e('Contact Info') ?></h3>
397 <table class="form-table">
398 <tr class="user-email-wrap">
399 <th><label for="email"><?php _e('E-mail'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
400 <td><input type="email" name="email" id="email" value="<?php echo esc_attr( $profileuser->user_email ) ?>" class="regular-text ltr" />
402 $new_email = get_option( $current_user->ID . '_new_email' );
403 if ( $new_email && $new_email['newemail'] != $current_user->user_email && $profileuser->ID == $current_user->ID ) : ?>
404 <div class="updated inline">
405 <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>
411 <tr class="user-url-wrap">
412 <th><label for="url"><?php _e('Website') ?></label></th>
413 <td><input type="url" name="url" id="url" value="<?php echo esc_attr( $profileuser->user_url ) ?>" class="regular-text code" /></td>
417 foreach ( wp_get_user_contact_methods( $profileuser ) as $name => $desc ) {
419 <tr class="user-<?php echo $name; ?>-wrap">
420 <th><label for="<?php echo $name; ?>">
423 * Filter a user contactmethod label.
425 * The dynamic portion of the filter hook, `$name`, refers to
426 * each of the keys in the contactmethods array.
430 * @param string $desc The translatable label for the contactmethod.
432 echo apply_filters( "user_{$name}_label", $desc );
435 <td><input type="text" name="<?php echo $name; ?>" id="<?php echo $name; ?>" value="<?php echo esc_attr($profileuser->$name) ?>" class="regular-text" /></td>
442 <h3><?php IS_PROFILE_PAGE ? _e('About Yourself') : _e('About the user'); ?></h3>
444 <table class="form-table">
445 <tr class="user-description-wrap">
446 <th><label for="description"><?php _e('Biographical Info'); ?></label></th>
447 <td><textarea name="description" id="description" rows="5" cols="30"><?php echo $profileuser->description; // textarea_escaped ?></textarea>
448 <p class="description"><?php _e('Share a little biographical information to fill out your profile. This may be shown publicly.'); ?></p></td>
452 /** This filter is documented in wp-admin/user-new.php */
453 $show_password_fields = apply_filters( 'show_password_fields', true, $profileuser );
454 if ( $show_password_fields ) :
456 <tr id="password" class="user-pass1-wrap">
457 <th><label for="pass1"><?php _e( 'New Password' ); ?></label></th>
459 <input class="hidden" value=" " /><!-- #24364 workaround -->
460 <input type="password" name="pass1" id="pass1" class="regular-text" size="16" value="" autocomplete="off" />
461 <p class="description"><?php _e( 'If you would like to change the password type a new one. Otherwise leave this blank.' ); ?></p>
464 <tr class="user-pass2-wrap">
465 <th scope="row"><label for="pass2"><?php _e( 'Repeat New Password' ); ?></label></th>
467 <input name="pass2" type="password" id="pass2" class="regular-text" size="16" value="" autocomplete="off" />
468 <p class="description"><?php _e( 'Type your new password again.' ); ?></p>
470 <div id="pass-strength-result"><?php _e( 'Strength indicator' ); ?></div>
471 <p class="description indicator-hint"><?php echo wp_get_password_hint(); ?></p>
477 if ( IS_PROFILE_PAGE && count( $sessions->get_all() ) === 1 ) : ?>
478 <tr class="user-sessions-wrap hide-if-no-js">
480 <td aria-live="assertive">
481 <div class="destroy-sessions"><button type="button" disabled class="button button-secondary"><?php _e( 'Log Out of All Other Sessions' ); ?></button></div>
482 <p class="description">
483 <?php _e( 'You are only logged in at this location.' ); ?>
487 <?php elseif ( IS_PROFILE_PAGE && count( $sessions->get_all() ) > 1 ) : ?>
488 <tr class="user-sessions-wrap hide-if-no-js">
490 <td aria-live="assertive">
491 <div class="destroy-sessions"><button type="button" class="button button-secondary" id="destroy-sessions"><?php _e( 'Log Out of All Other Sessions' ); ?></button></div>
492 <p class="description">
493 <?php _e( 'Left your account logged in at a public computer? Lost your phone? This will log you out everywhere except your current browser.' ); ?>
497 <?php elseif ( ! IS_PROFILE_PAGE && $sessions->get_all() ) : ?>
498 <tr class="user-sessions-wrap hide-if-no-js">
501 <p><button type="button" class="button button-secondary" id="destroy-sessions"><?php _e( 'Log Out of All Sessions' ); ?></button></p>
502 <p class="description">
504 /* translators: 1: User's display name. */
505 printf( __( 'Log %s out of all sessions' ), $profileuser->display_name );
515 if ( IS_PROFILE_PAGE ) {
517 * Fires after the 'About Yourself' settings table on the 'Your Profile' editing screen.
519 * The action only fires if the current user is editing their own profile.
523 * @param WP_User $profileuser The current WP_User object.
525 do_action( 'show_user_profile', $profileuser );
528 * Fires after the 'About the User' settings table on the 'Edit User' screen.
532 * @param WP_User $profileuser The current WP_User object.
534 do_action( 'edit_user_profile', $profileuser );
540 * Filter whether to display additional capabilities for the user.
542 * The 'Additional Capabilities' section will only be enabled if
543 * the number of the user's capabilities exceeds their number of
548 * @param bool $enable Whether to display the capabilities. Default true.
549 * @param WP_User $profileuser The current WP_User object.
551 if ( count( $profileuser->caps ) > count( $profileuser->roles )
552 && apply_filters( 'additional_capabilities_display', true, $profileuser )
554 <h3><?php _e( 'Additional Capabilities' ); ?></h3>
555 <table class="form-table">
556 <tr class="user-capabilities-wrap">
557 <th scope="row"><?php _e( 'Capabilities' ); ?></th>
561 foreach ( $profileuser->caps as $cap => $value ) {
562 if ( ! $wp_roles->is_role( $cap ) ) {
565 $output .= $value ? $cap : sprintf( __( 'Denied: %s' ), $cap );
575 <input type="hidden" name="action" value="update" />
576 <input type="hidden" name="user_id" id="user_id" value="<?php echo esc_attr($user_id); ?>" />
578 <?php submit_button( IS_PROFILE_PAGE ? __('Update Profile') : __('Update User') ); ?>
586 <script type="text/javascript">
587 if (window.location.hash == '#password') {
588 document.getElementById('pass1').focus();
592 include( ABSPATH . 'wp-admin/admin-footer.php');