wp-admin/users.php

   1 <?php
   2 /**
   3  * User administration panel
   4  *
   5  * @package WordPress
   6  * @subpackage Administration
   7  * @since 1.0.0
   8  */
   9
  10 /** WordPress Administration Bootstrap */
  11 require_once( dirname( __FILE__ ) . '/admin.php' );
  12
  13 if ( ! current_user_can( 'list_users' ) ) {
  14         wp_die(
  15                 '<h1>' . __( 'Cheatin&#8217; uh?' ) . '</h1>' .
  16                 '<p>' . __( 'You are not allowed to browse users.' ) . '</p>',
  17                 403
  18         );
  19 }
  20
  21 $wp_list_table = _get_list_table('WP_Users_List_Table');
  22 $pagenum = $wp_list_table->get_pagenum();
  23 $title = __('Users');
  24 $parent_file = 'users.php';
  25
  26 add_screen_option( 'per_page' );
  27
  28 // contextual help - choose Help on the top right of admin panel to preview this.
  29 get_current_screen()->add_help_tab( array(
  30         'id'      => 'overview',
  31         'title'   => __('Overview'),
  32         '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>' .
  33                                  '<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>'
  34 ) ) ;
  35
  36 get_current_screen()->add_help_tab( array(
  37         'id'      => 'screen-display',
  38         'title'   => __('Screen Display'),
  39         'content' => '<p>' . __('You can customize the display of this screen in a number of ways:') . '</p>' .
  40                                         '<ul>' .
  41                                         '<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>' .
  42                                         '<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>' .
  43                                         '<li>' . __('You can view all posts made by a user by clicking on the number under the Posts column.') . '</li>' .
  44                                         '</ul>'
  45 ) );
  46
  47 $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>' .
  48         '<ul>' .
  49         '<li>' . __('Edit takes you to the editable profile screen for that user. You can also reach that screen by clicking on the username.') . '</li>';
  50
  51 if ( is_multisite() )
  52         $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>';
  53 else
  54         $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>';
  55
  56 $help .= '</ul>';
  57
  58 get_current_screen()->add_help_tab( array(
  59         'id'      => 'actions',
  60         'title'   => __('Actions'),
  61         'content' => $help,
  62 ) );
  63 unset( $help );
  64
  65 get_current_screen()->set_help_sidebar(
  66     '<p><strong>' . __('For more information:') . '</strong></p>' .
  67     '<p>' . __('<a href="https://codex.wordpress.org/Users_Screen" target="_blank">Documentation on Managing Users</a>') . '</p>' .
  68     '<p>' . __('<a href="https://codex.wordpress.org/Roles_and_Capabilities" target="_blank">Descriptions of Roles and Capabilities</a>') . '</p>' .
  69     '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
  70 );
  71
  72 get_current_screen()->set_screen_reader_content( array(
  73         'heading_views'      => __( 'Filter users list' ),
  74         'heading_pagination' => __( 'Users list navigation' ),
  75         'heading_list'       => __( 'Users list' ),
  76 ) );
  77
  78 if ( empty($_REQUEST) ) {
  79         $referer = '<input type="hidden" name="wp_http_referer" value="'. esc_attr( wp_unslash( $_SERVER['REQUEST_URI'] ) ) . '" />';
  80 } elseif ( isset($_REQUEST['wp_http_referer']) ) {
  81         $redirect = remove_query_arg(array('wp_http_referer', 'updated', 'delete_count'), wp_unslash( $_REQUEST['wp_http_referer'] ) );
  82         $referer = '<input type="hidden" name="wp_http_referer" value="' . esc_attr($redirect) . '" />';
  83 } else {
  84         $redirect = 'users.php';
  85         $referer = '';
  86 }
  87
  88 $update = '';
  89
  90 switch ( $wp_list_table->current_action() ) {
  91
  92 /* Bulk Dropdown menu Role changes */
  93 case 'promote':
  94         check_admin_referer('bulk-users');
  95
  96         if ( ! current_user_can( 'promote_users' ) )
  97                 wp_die( __( 'You can&#8217;t edit that user.' ) );
  98
  99         if ( empty($_REQUEST['users']) ) {
 100                 wp_redirect($redirect);
 101                 exit();
 102         }
 103
 104         $editable_roles = get_editable_roles();
 105         $role = false;
 106         if ( ! empty( $_REQUEST['new_role2'] ) ) {
 107                 $role = $_REQUEST['new_role2'];
 108         } elseif ( ! empty( $_REQUEST['new_role'] ) ) {
 109                 $role = $_REQUEST['new_role'];
 110         }
 111
 112         if ( ! $role || empty( $editable_roles[ $role ] ) ) {
 113                 wp_die( __( 'You can&#8217;t give users that role.' ) );
 114         }
 115
 116         $userids = $_REQUEST['users'];
 117         $update = 'promote';
 118         foreach ( $userids as $id ) {
 119                 $id = (int) $id;
 120
 121                 if ( ! current_user_can('promote_user', $id) )
 122                         wp_die(__('You can&#8217;t edit that user.'));
 123                 // The new role of the current user must also have the promote_users cap or be a multisite super admin
 124                 if ( $id == $current_user->ID && ! $wp_roles->role_objects[ $role ]->has_cap('promote_users')
 125                         && ! ( is_multisite() && is_super_admin() ) ) {
 126                                 $update = 'err_admin_role';
 127                                 continue;
 128                 }
 129
 130                 // If the user doesn't already belong to the blog, bail.
 131                 if ( is_multisite() && !is_user_member_of_blog( $id ) ) {
 132                         wp_die(
 133                                 '<h1>' . __( 'Cheatin&#8217; uh?' ) . '</h1>' .
 134                                 '<p>' . __( 'One of the selected users is not a member of this site.' ) . '</p>',
 135                                 403
 136                         );
 137                 }
 138
 139                 $user = get_userdata( $id );
 140                 $user->set_role( $role );
 141         }
 142
 143         wp_redirect(add_query_arg('update', $update, $redirect));
 144         exit();
 145
 146 case 'dodelete':
 147         if ( is_multisite() )
 148                 wp_die( __('User deletion is not allowed from this screen.') );
 149
 150         check_admin_referer('delete-users');
 151
 152         if ( empty($_REQUEST['users']) ) {
 153                 wp_redirect($redirect);
 154                 exit();
 155         }
 156
 157         $userids = array_map( 'intval', (array) $_REQUEST['users'] );
 158
 159         if ( empty( $_REQUEST['delete_option'] ) ) {
 160                 $url = self_admin_url( 'users.php?action=delete&users[]=' . implode( '&users[]=', $userids ) . '&error=true' );
 161                 $url = str_replace( '&amp;', '&', wp_nonce_url( $url, 'bulk-users' ) );
 162                 wp_redirect( $url );
 163                 exit;
 164         }
 165
 166         if ( ! current_user_can( 'delete_users' ) )
 167                 wp_die(__('You can&#8217;t delete users.'));
 168
 169         $update = 'del';
 170         $delete_count = 0;
 171
 172         foreach ( $userids as $id ) {
 173                 if ( ! current_user_can( 'delete_user', $id ) )
 174                         wp_die(__( 'You can&#8217;t delete that user.' ) );
 175
 176                 if ( $id == $current_user->ID ) {
 177                         $update = 'err_admin_del';
 178                         continue;
 179                 }
 180                 switch ( $_REQUEST['delete_option'] ) {
 181                 case 'delete':
 182                         wp_delete_user( $id );
 183                         break;
 184                 case 'reassign':
 185                         wp_delete_user( $id, $_REQUEST['reassign_user'] );
 186                         break;
 187                 }
 188                 ++$delete_count;
 189         }
 190
 191         $redirect = add_query_arg( array('delete_count' => $delete_count, 'update' => $update), $redirect);
 192         wp_redirect($redirect);
 193         exit();
 194
 195 case 'delete':
 196         if ( is_multisite() )
 197                 wp_die( __('User deletion is not allowed from this screen.') );
 198
 199         check_admin_referer('bulk-users');
 200
 201         if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
 202                 wp_redirect($redirect);
 203                 exit();
 204         }
 205
 206         if ( ! current_user_can( 'delete_users' ) )
 207                 $errors = new WP_Error( 'edit_users', __( 'You can&#8217;t delete users.' ) );
 208
 209         if ( empty($_REQUEST['users']) )
 210                 $userids = array( intval( $_REQUEST['user'] ) );
 211         else
 212                 $userids = array_map( 'intval', (array) $_REQUEST['users'] );
 213
 214         $users_posts = new WP_Query( array(
 215                 'post_type' => 'any',
 216                 'author' => implode( ',', $userids ),
 217                 'posts_per_page' => 1
 218         ) );
 219
 220         if ( $users_posts->have_posts() ) {
 221                 add_action( 'admin_head', 'delete_users_add_js' );
 222         }
 223
 224         include( ABSPATH . 'wp-admin/admin-header.php' );
 225 ?>
 226 <form method="post" name="updateusers" id="updateusers">
 227 <?php wp_nonce_field('delete-users') ?>
 228 <?php echo $referer; ?>
 229
 230 <div class="wrap">
 231 <h1><?php _e( 'Delete Users' ); ?></h1>
 232 <?php if ( isset( $_REQUEST['error'] ) ) : ?>
 233         <div class="error">
 234                 <p><strong><?php _e( 'ERROR:' ); ?></strong> <?php _e( 'Please select an option.' ); ?></p>
 235         </div>
 236 <?php endif; ?>
 237
 238 <?php if ( 1 == count( $userids ) ) : ?>
 239         <p><?php _e( 'You have specified this user for deletion:' ); ?></p>
 240 <?php else : ?>
 241         <p><?php _e( 'You have specified these users for deletion:' ); ?></p>
 242 <?php endif; ?>
 243
 244 <ul>
 245 <?php
 246         $go_delete = 0;
 247         foreach ( $userids as $id ) {
 248                 $user = get_userdata( $id );
 249                 if ( $id == $current_user->ID ) {
 250                         echo "<li>" . sprintf(__('ID #%1$s: %2$s <strong>The current user will not be deleted.</strong>'), $id, $user->user_login) . "</li>\n";
 251                 } else {
 252                         echo "<li><input type=\"hidden\" name=\"users[]\" value=\"" . esc_attr($id) . "\" />" . sprintf(__('ID #%1$s: %2$s'), $id, $user->user_login) . "</li>\n";
 253                         $go_delete++;
 254                 }
 255         }
 256         ?>
 257         </ul>
 258 <?php if ( $go_delete ) :
 259
 260         if ( ! $users_posts->have_posts() ) : ?>
 261                 <input type="hidden" name="delete_option" value="delete" />
 262         <?php else: ?>
 263                 <?php if ( 1 == $go_delete ) : ?>
 264                         <fieldset><p><legend><?php _e( 'What should be done with content owned by this user?' ); ?></legend></p>
 265                 <?php else : ?>
 266                         <fieldset><p><legend><?php _e( 'What should be done with content owned by these users?' ); ?></legend></p>
 267                 <?php endif; ?>
 268                 <ul style="list-style:none;">
 269                         <li><label><input type="radio" id="delete_option0" name="delete_option" value="delete" />
 270                         <?php _e('Delete all content.'); ?></label></li>
 271                         <li><input type="radio" id="delete_option1" name="delete_option" value="reassign" />
 272                         <?php echo '<label for="delete_option1">' . __( 'Attribute all content to:' ) . '</label> ';
 273                         wp_dropdown_users( array( 'name' => 'reassign_user', 'exclude' => array_diff( $userids, array($current_user->ID) ) ) ); ?></li>
 274                 </ul></fieldset>
 275         <?php endif;
 276         /**
 277          * Fires at the end of the delete users form prior to the confirm button.
 278          *
 279          * @since 4.0.0
 280          *
 281          * @param WP_User $current_user WP_User object for the user being deleted.
 282          */
 283         do_action( 'delete_user_form', $current_user );
 284         ?>
 285         <input type="hidden" name="action" value="dodelete" />
 286         <?php submit_button( __('Confirm Deletion'), 'primary' ); ?>
 287 <?php else : ?>
 288         <p><?php _e('There are no valid users selected for deletion.'); ?></p>
 289 <?php endif; ?>
 290 </div>
 291 </form>
 292 <?php
 293
 294 break;
 295
 296 case 'doremove':
 297         check_admin_referer('remove-users');
 298
 299         if ( ! is_multisite() )
 300                 wp_die( __( 'You can&#8217;t remove users.' ) );
 301
 302         if ( empty($_REQUEST['users']) ) {
 303                 wp_redirect($redirect);
 304                 exit;
 305         }
 306
 307         if ( ! current_user_can( 'remove_users' ) )
 308                 wp_die( __( 'You can&#8217;t remove users.' ) );
 309
 310         $userids = $_REQUEST['users'];
 311
 312         $update = 'remove';
 313         foreach ( $userids as $id ) {
 314                 $id = (int) $id;
 315                 if ( $id == $current_user->ID && !is_super_admin() ) {
 316                         $update = 'err_admin_remove';
 317                         continue;
 318                 }
 319                 if ( !current_user_can('remove_user', $id) ) {
 320                         $update = 'err_admin_remove';
 321                         continue;
 322                 }
 323                 remove_user_from_blog($id, $blog_id);
 324         }
 325
 326         $redirect = add_query_arg( array('update' => $update), $redirect);
 327         wp_redirect($redirect);
 328         exit;
 329
 330 case 'remove':
 331
 332         check_admin_referer('bulk-users');
 333
 334         if ( ! is_multisite() )
 335                 wp_die( __( 'You can&#8217;t remove users.' ) );
 336
 337         if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
 338                 wp_redirect($redirect);
 339                 exit();
 340         }
 341
 342         if ( !current_user_can('remove_users') )
 343                 $error = new WP_Error('edit_users', __('You can&#8217;t remove users.'));
 344
 345         if ( empty($_REQUEST['users']) )
 346                 $userids = array(intval($_REQUEST['user']));
 347         else
 348                 $userids = $_REQUEST['users'];
 349
 350         include( ABSPATH . 'wp-admin/admin-header.php' );
 351 ?>
 352 <form method="post" name="updateusers" id="updateusers">
 353 <?php wp_nonce_field('remove-users') ?>
 354 <?php echo $referer; ?>
 355
 356 <div class="wrap">
 357 <h1><?php _e( 'Remove Users from Site' ); ?></h1>
 358
 359 <?php if ( 1 == count( $userids ) ) : ?>
 360         <p><?php _e( 'You have specified this user for removal:' ); ?></p>
 361 <?php else : ?>
 362         <p><?php _e( 'You have specified these users for removal:' ); ?></p>
 363 <?php endif; ?>
 364
 365 <ul>
 366 <?php
 367         $go_remove = false;
 368         foreach ( $userids as $id ) {
 369                 $id = (int) $id;
 370                 $user = get_userdata( $id );
 371                 if ( $id == $current_user->ID && !is_super_admin() ) {
 372                         echo "<li>" . sprintf(__('ID #%1$s: %2$s <strong>The current user will not be removed.</strong>'), $id, $user->user_login) . "</li>\n";
 373                 } elseif ( !current_user_can('remove_user', $id) ) {
 374                         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";
 375                 } else {
 376                         echo "<li><input type=\"hidden\" name=\"users[]\" value=\"{$id}\" />" . sprintf(__('ID #%1$s: %2$s'), $id, $user->user_login) . "</li>\n";
 377                         $go_remove = true;
 378                 }
 379         }
 380         ?>
 381 </ul>
 382 <?php if ( $go_remove ) : ?>
 383                 <input type="hidden" name="action" value="doremove" />
 384                 <?php submit_button( __('Confirm Removal'), 'primary' ); ?>
 385 <?php else : ?>
 386         <p><?php _e('There are no valid users selected for removal.'); ?></p>
 387 <?php endif; ?>
 388 </div>
 389 </form>
 390 <?php
 391
 392 break;
 393
 394 default:
 395
 396         if ( !empty($_GET['_wp_http_referer']) ) {
 397                 wp_redirect( remove_query_arg( array( '_wp_http_referer', '_wpnonce'), wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
 398                 exit;
 399         }
 400
 401         $wp_list_table->prepare_items();
 402         $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
 403         if ( $pagenum > $total_pages && $total_pages > 0 ) {
 404                 wp_redirect( add_query_arg( 'paged', $total_pages ) );
 405                 exit;
 406         }
 407
 408         include( ABSPATH . 'wp-admin/admin-header.php' );
 409
 410         $messages = array();
 411         if ( isset($_GET['update']) ) :
 412                 switch($_GET['update']) {
 413                 case 'del':
 414                 case 'del_many':
 415                         $delete_count = isset($_GET['delete_count']) ? (int) $_GET['delete_count'] : 0;
 416                         if ( 1 == $delete_count ) {
 417                                 $message = __( 'User deleted.' );
 418                         } else {
 419                                 $message = _n( '%s user deleted.', '%s users deleted.', $delete_count );
 420                         }
 421                         $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . sprintf( $message, number_format_i18n( $delete_count ) ) . '</p></div>';
 422                         break;
 423                 case 'add':
 424                         if ( isset( $_GET['id'] ) && ( $user_id = $_GET['id'] ) && current_user_can( 'edit_user', $user_id ) ) {
 425                                 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . sprintf( __( 'New user created. <a href="%s">Edit user</a>' ),
 426                                         esc_url( add_query_arg( 'wp_http_referer', urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ),
 427                                                 self_admin_url( 'user-edit.php?user_id=' . $user_id ) ) ) ) . '</p></div>';
 428                         } else {
 429                                 $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __( 'New user created.' ) . '</p></div>';
 430                         }
 431                         break;
 432                 case 'promote':
 433                         $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Changed roles.') . '</p></div>';
 434                         break;
 435                 case 'err_admin_role':
 436                         $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __('The current user&#8217;s role must have user editing capabilities.') . '</p></div>';
 437                         $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Other user roles have been changed.') . '</p></div>';
 438                         break;
 439                 case 'err_admin_del':
 440                         $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __('You can&#8217;t delete the current user.') . '</p></div>';
 441                         $messages[] = '<div id="message" class="updated notice is-dismissible"><p>' . __('Other users have been deleted.') . '</p></div>';
 442                         break;
 443                 case 'remove':
 444                         $messages[] = '<div id="message" class="updated notice is-dismissible fade"><p>' . __('User removed from this site.') . '</p></div>';
 445                         break;
 446                 case 'err_admin_remove':
 447                         $messages[] = '<div id="message" class="error notice is-dismissible"><p>' . __("You can't remove the current user.") . '</p></div>';
 448                         $messages[] = '<div id="message" class="updated notice is-dismissible fade"><p>' . __('Other users have been removed.') . '</p></div>';
 449                         break;
 450                 }
 451         endif; ?>
 452
 453 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
 454         <div class="error">
 455                 <ul>
 456                 <?php
 457                         foreach ( $errors->get_error_messages() as $err )
 458                                 echo "<li>$err</li>\n";
 459                 ?>
 460                 </ul>
 461         </div>
 462 <?php endif;
 463
 464 if ( ! empty($messages) ) {
 465         foreach ( $messages as $msg )
 466                 echo $msg;
 467 } ?>
 468
 469 <div class="wrap">
 470 <h1>
 471 <?php
 472 echo esc_html( $title );
 473 if ( current_user_can( 'create_users' ) ) { ?>
 474         <a href="user-new.php" class="page-title-action"><?php echo esc_html_x( 'Add New', 'user' ); ?></a>
 475 <?php } elseif ( is_multisite() && current_user_can( 'promote_users' ) ) { ?>
 476         <a href="user-new.php" class="page-title-action"><?php echo esc_html_x( 'Add Existing', 'user' ); ?></a>
 477 <?php }
 478
 479 if ( $usersearch )
 480         printf( '<span class="subtitle">' . __('Search results for &#8220;%s&#8221;') . '</span>', esc_html( $usersearch ) ); ?>
 481 </h1>
 482
 483 <?php $wp_list_table->views(); ?>
 484
 485 <form method="get">
 486
 487 <?php $wp_list_table->search_box( __( 'Search Users' ), 'user' ); ?>
 488
 489 <?php $wp_list_table->display(); ?>
 490 </form>
 491
 492 <br class="clear" />
 493 </div>
 494 <?php
 495 break;
 496
 497 } // end of the $doaction switch
 498
 499 include( ABSPATH . 'wp-admin/admin-footer.php' );