3 * Users administration panel.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
12 if ( ! current_user_can( 'list_users' ) )
13 wp_die( __( 'Cheatin’ uh?' ), 403 );
15 $wp_list_table = _get_list_table('WP_Users_List_Table');
16 $pagenum = $wp_list_table->get_pagenum();
18 $parent_file = 'users.php';
20 add_screen_option( 'per_page' );
22 // contextual help - choose Help on the top right of admin panel to preview this.
23 get_current_screen()->add_help_tab( array(
25 'title' => __('Overview'),
26 'content' => '<p>' . __('This screen lists all the existing users for your site. Each user has one of five defined roles as set by the site admin: Site Administrator, Editor, Author, Contributor, or Subscriber. Users with roles other than Administrator will see fewer options in the dashboard navigation when they are logged in, based on their role.') . '</p>' .
27 '<p>' . __('To add a new user for your site, click the Add New button at the top of the screen or Add New in the Users menu section.') . '</p>'
30 get_current_screen()->add_help_tab( array(
31 'id' => 'screen-display',
32 'title' => __('Screen Display'),
33 'content' => '<p>' . __('You can customize the display of this screen in a number of ways:') . '</p>' .
35 '<li>' . __('You can hide/display columns based on your needs and decide how many users to list per screen using the Screen Options tab.') . '</li>' .
36 '<li>' . __('You can filter the list of users by User Role using the text links in the upper left to show All, Administrator, Editor, Author, Contributor, or Subscriber. The default view is to show all users. Unused User Roles are not listed.') . '</li>' .
37 '<li>' . __('You can view all posts made by a user by clicking on the number under the Posts column.') . '</li>' .
41 $help = '<p>' . __('Hovering over a row in the users list will display action links that allow you to manage users. You can perform the following actions:') . '</p>' .
43 '<li>' . __('Edit takes you to the editable profile screen for that user. You can also reach that screen by clicking on the username.') . '</li>';
46 $help .= '<li>' . __( 'Remove allows you to remove a user from your site. It does not delete their content. You can also remove multiple users at once by using Bulk Actions.' ) . '</li>';
48 $help .= '<li>' . __( 'Delete brings you to the Delete Users screen for confirmation, where you can permanently remove a user from your site and delete their content. You can also delete multiple users at once by using Bulk Actions.' ) . '</li>';
52 get_current_screen()->add_help_tab( array(
54 'title' => __('Actions'),
59 get_current_screen()->set_help_sidebar(
60 '<p><strong>' . __('For more information:') . '</strong></p>' .
61 '<p>' . __('<a href="https://codex.wordpress.org/Users_Screen" target="_blank">Documentation on Managing Users</a>') . '</p>' .
62 '<p>' . __('<a href="https://codex.wordpress.org/Roles_and_Capabilities" target="_blank">Descriptions of Roles and Capabilities</a>') . '</p>' .
63 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
66 if ( empty($_REQUEST) ) {
67 $referer = '<input type="hidden" name="wp_http_referer" value="'. esc_attr( wp_unslash( $_SERVER['REQUEST_URI'] ) ) . '" />';
68 } elseif ( isset($_REQUEST['wp_http_referer']) ) {
69 $redirect = remove_query_arg(array('wp_http_referer', 'updated', 'delete_count'), wp_unslash( $_REQUEST['wp_http_referer'] ) );
70 $referer = '<input type="hidden" name="wp_http_referer" value="' . esc_attr($redirect) . '" />';
72 $redirect = 'users.php';
82 function delete_users_add_js() { ?>
84 jQuery(document).ready( function($) {
85 var submit = $('#submit').prop('disabled', true);
86 $('input[name=delete_option]').one('change', function() {
87 submit.prop('disabled', false);
89 $('#reassign_user').focus( function() {
90 $('#delete_option1').prop('checked', true).trigger('change');
97 switch ( $wp_list_table->current_action() ) {
99 /* Bulk Dropdown menu Role changes */
101 check_admin_referer('bulk-users');
103 if ( ! current_user_can( 'promote_users' ) )
104 wp_die( __( 'You can’t edit that user.' ) );
106 if ( empty($_REQUEST['users']) ) {
107 wp_redirect($redirect);
111 $editable_roles = get_editable_roles();
112 if ( empty( $editable_roles[$_REQUEST['new_role']] ) )
113 wp_die(__('You can’t give users that role.'));
115 $userids = $_REQUEST['users'];
117 foreach ( $userids as $id ) {
120 if ( ! current_user_can('promote_user', $id) )
121 wp_die(__('You can’t edit that user.'));
122 // The new role of the current user must also have the promote_users cap or be a multisite super admin
123 if ( $id == $current_user->ID && ! $wp_roles->role_objects[ $_REQUEST['new_role'] ]->has_cap('promote_users')
124 && ! ( is_multisite() && is_super_admin() ) ) {
125 $update = 'err_admin_role';
129 // If the user doesn't already belong to the blog, bail.
130 if ( is_multisite() && !is_user_member_of_blog( $id ) )
131 wp_die( __( 'Cheatin’ uh?' ), 403 );
133 $user = get_userdata( $id );
134 $user->set_role($_REQUEST['new_role']);
137 wp_redirect(add_query_arg('update', $update, $redirect));
141 if ( is_multisite() )
142 wp_die( __('User deletion is not allowed from this screen.') );
144 check_admin_referer('delete-users');
146 if ( empty($_REQUEST['users']) ) {
147 wp_redirect($redirect);
151 $userids = array_map( 'intval', (array) $_REQUEST['users'] );
153 if ( empty( $_REQUEST['delete_option'] ) ) {
154 $url = self_admin_url( 'users.php?action=delete&users[]=' . implode( '&users[]=', $userids ) . '&error=true' );
155 $url = str_replace( '&', '&', wp_nonce_url( $url, 'bulk-users' ) );
160 if ( ! current_user_can( 'delete_users' ) )
161 wp_die(__('You can’t delete users.'));
166 foreach ( $userids as $id ) {
167 if ( ! current_user_can( 'delete_user', $id ) )
168 wp_die(__( 'You can’t delete that user.' ) );
170 if ( $id == $current_user->ID ) {
171 $update = 'err_admin_del';
174 switch ( $_REQUEST['delete_option'] ) {
176 wp_delete_user( $id );
179 wp_delete_user( $id, $_REQUEST['reassign_user'] );
185 $redirect = add_query_arg( array('delete_count' => $delete_count, 'update' => $update), $redirect);
186 wp_redirect($redirect);
190 if ( is_multisite() )
191 wp_die( __('User deletion is not allowed from this screen.') );
193 check_admin_referer('bulk-users');
195 if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
196 wp_redirect($redirect);
200 if ( ! current_user_can( 'delete_users' ) )
201 $errors = new WP_Error( 'edit_users', __( 'You can’t delete users.' ) );
203 if ( empty($_REQUEST['users']) )
204 $userids = array( intval( $_REQUEST['user'] ) );
206 $userids = array_map( 'intval', (array) $_REQUEST['users'] );
208 add_action( 'admin_head', 'delete_users_add_js' );
210 include( ABSPATH . 'wp-admin/admin-header.php' );
212 <form method="post" name="updateusers" id="updateusers">
213 <?php wp_nonce_field('delete-users') ?>
214 <?php echo $referer; ?>
217 <h1><?php _e( 'Delete Users' ); ?></h1>
218 <?php if ( isset( $_REQUEST['error'] ) ) : ?>
220 <p><strong><?php _e( 'ERROR:' ); ?></strong> <?php _e( 'Please select an option.' ); ?></p>
224 <?php if ( 1 == count( $userids ) ) : ?>
225 <p><?php _e( 'You have specified this user for deletion:' ); ?></p>
227 <p><?php _e( 'You have specified these users for deletion:' ); ?></p>
233 foreach ( $userids as $id ) {
234 $user = get_userdata( $id );
235 if ( $id == $current_user->ID ) {
236 echo "<li>" . sprintf(__('ID #%1$s: %2$s <strong>The current user will not be deleted.</strong>'), $id, $user->user_login) . "</li>\n";
238 echo "<li><input type=\"hidden\" name=\"users[]\" value=\"" . esc_attr($id) . "\" />" . sprintf(__('ID #%1$s: %2$s'), $id, $user->user_login) . "</li>\n";
244 <?php if ( $go_delete ) : ?>
245 <?php if ( 1 == $go_delete ) : ?>
246 <fieldset><p><legend><?php _e( 'What should be done with content owned by this user?' ); ?></legend></p>
248 <fieldset><p><legend><?php _e( 'What should be done with content owned by these users?' ); ?></legend></p>
250 <ul style="list-style:none;">
251 <li><label><input type="radio" id="delete_option0" name="delete_option" value="delete" />
252 <?php _e('Delete all content.'); ?></label></li>
253 <li><input type="radio" id="delete_option1" name="delete_option" value="reassign" />
254 <?php echo '<label for="delete_option1">' . __( 'Attribute all content to:' ) . '</label> ';
255 wp_dropdown_users( array( 'name' => 'reassign_user', 'exclude' => array_diff( $userids, array($current_user->ID) ) ) ); ?></li>
259 * Fires at the end of the delete users form prior to the confirm button.
263 * @param WP_User $current_user WP_User object for the user being deleted.
265 do_action( 'delete_user_form', $current_user );
267 <input type="hidden" name="action" value="dodelete" />
268 <?php submit_button( __('Confirm Deletion'), 'secondary' ); ?>
270 <p><?php _e('There are no valid users selected for deletion.'); ?></p>
279 check_admin_referer('remove-users');
281 if ( ! is_multisite() )
282 wp_die( __( 'You can’t remove users.' ) );
284 if ( empty($_REQUEST['users']) ) {
285 wp_redirect($redirect);
289 if ( ! current_user_can( 'remove_users' ) )
290 wp_die( __( 'You can’t remove users.' ) );
292 $userids = $_REQUEST['users'];
295 foreach ( $userids as $id ) {
297 if ( $id == $current_user->ID && !is_super_admin() ) {
298 $update = 'err_admin_remove';
301 if ( !current_user_can('remove_user', $id) ) {
302 $update = 'err_admin_remove';
305 remove_user_from_blog($id, $blog_id);
308 $redirect = add_query_arg( array('update' => $update), $redirect);
309 wp_redirect($redirect);
314 check_admin_referer('bulk-users');
316 if ( ! is_multisite() )
317 wp_die( __( 'You can’t remove users.' ) );
319 if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
320 wp_redirect($redirect);
324 if ( !current_user_can('remove_users') )
325 $error = new WP_Error('edit_users', __('You can’t remove users.'));
327 if ( empty($_REQUEST['users']) )
328 $userids = array(intval($_REQUEST['user']));
330 $userids = $_REQUEST['users'];
332 include( ABSPATH . 'wp-admin/admin-header.php' );
334 <form method="post" name="updateusers" id="updateusers">
335 <?php wp_nonce_field('remove-users') ?>
336 <?php echo $referer; ?>
339 <h1><?php _e( 'Remove Users from Site' ); ?></h1>
341 <?php if ( 1 == count( $userids ) ) : ?>
342 <p><?php _e( 'You have specified this user for removal:' ); ?></p>
344 <p><?php _e( 'You have specified these users for removal:' ); ?></p>
350 foreach ( $userids as $id ) {
352 $user = get_userdata( $id );
353 if ( $id == $current_user->ID && !is_super_admin() ) {
354 echo "<li>" . sprintf(__('ID #%1$s: %2$s <strong>The current user will not be removed.</strong>'), $id, $user->user_login) . "</li>\n";
355 } elseif ( !current_user_can('remove_user', $id) ) {
356 echo "<li>" . sprintf(__('ID #%1$s: %2$s <strong>You don\'t have permission to remove this user.</strong>'), $id, $user->user_login) . "</li>\n";
358 echo "<li><input type=\"hidden\" name=\"users[]\" value=\"{$id}\" />" . sprintf(__('ID #%1$s: %2$s'), $id, $user->user_login) . "</li>\n";
364 <?php if ( $go_remove ) : ?>
365 <input type="hidden" name="action" value="doremove" />
366 <?php submit_button( __('Confirm Removal'), 'secondary' ); ?>
368 <p><?php _e('There are no valid users selected for removal.'); ?></p>
378 if ( !empty($_GET['_wp_http_referer']) ) {
379 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce'), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
383 $wp_list_table->prepare_items();
384 $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
385 if ( $pagenum > $total_pages && $total_pages > 0 ) {
386 wp_redirect( add_query_arg( 'paged', $total_pages ) );
390 include( ABSPATH . 'wp-admin/admin-header.php' );
393 if ( isset($_GET['update']) ) :
394 switch($_GET['update']) {
397 $delete_count = isset($_GET['delete_count']) ? (int) $_GET['delete_count'] : 0;
398 if ( 1 == $delete_count ) {
399 $message = __( 'User deleted.' );
401 $message = _n( '%s user deleted.', '%s users deleted.', $delete_count );
403 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . sprintf( $message, number_format_i18n( $delete_count ) ) . '</p></div>';
406 if ( isset( $_GET['id'] ) && ( $user_id = $_GET['id'] ) && current_user_can( 'edit_user', $user_id ) ) {
407 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . sprintf( __( 'New user created. <a href="%s">Edit user</a>' ),
408 esc_url( add_query_arg( 'wp_http_referer', urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ),
409 self_admin_url( 'user-edit.php?user_id=' . $user_id ) ) ) ) . '</p></div>';
411 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __( 'New user created.' ) . '</p></div>';
415 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Changed roles.') . '</p></div>';
417 case 'err_admin_role':
418 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __('The current user’s role must have user editing capabilities.') . '</p></div>';
419 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Other user roles have been changed.') . '</p></div>';
421 case 'err_admin_del':
422 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __('You can’t delete the current user.') . '</p></div>';
423 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Other users have been deleted.') . '</p></div>';
426 $messages[] = '<div id="message" class="updated notice is-dismissible fade"><p>' . __('User removed from this site.') . '</p></div>';
428 case 'err_admin_remove':
429 $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __("You can't remove the current user.") . '</p></div>';
430 $messages[] = '<div id="message" class="updated notice is-dismissible fade"><p>' . __('Other users have been removed.') . '</p></div>';
435 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
439 foreach ( $errors->get_error_messages() as $err )
440 echo "<li>$err</li>\n";
446 if ( ! empty($messages) ) {
447 foreach ( $messages as $msg )
454 echo esc_html( $title );
455 if ( current_user_can( 'create_users' ) ) { ?>
456 <a href="user-new.php" class="page-title-action"><?php echo esc_html_x( 'Add New', 'user' ); ?></a>
457 <?php } elseif ( is_multisite() && current_user_can( 'promote_users' ) ) { ?>
458 <a href="user-new.php" class="page-title-action"><?php echo esc_html_x( 'Add Existing', 'user' ); ?></a>
462 printf( '<span class="subtitle">' . __('Search results for “%s”') . '</span>', esc_html( $usersearch ) ); ?>
465 <?php $wp_list_table->views(); ?>
469 <?php $wp_list_table->search_box( __( 'Search Users' ), 'user' ); ?>
471 <?php $wp_list_table->display(); ?>
479 } // end of the $doaction switch
481 include( ABSPATH . 'wp-admin/admin-footer.php' );