wp-admin/users.php

   1 <?php
   2 /**
   3  * Users administration panel.
   4  *
   5  * @package WordPress
   6  * @subpackage Administration
   7  */
   8
   9 /** WordPress Administration Bootstrap */
  10 require_once( './admin.php' );
  11
  12 if ( ! current_user_can( 'list_users' ) )
  13         wp_die( __( 'Cheatin&#8217; uh?' ) );
  14
  15 $wp_list_table = _get_list_table('WP_Users_List_Table');
  16 $pagenum = $wp_list_table->get_pagenum();
  17 $title = __('Users');
  18 $parent_file = 'users.php';
  19
  20 add_screen_option( 'per_page', array('label' => _x( 'Users', 'users per page (screen options)' )) );
  21
  22 // contextual help - choose Help on the top right of admin panel to preview this.
  23 get_current_screen()->add_help_tab( array(
  24         'id'      => 'overview',
  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>'
  28 ) ) ;
  29
  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>' .
  34                                         '<ul>' .
  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>' .
  38                                         '</ul>'
  39 ) );
  40
  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>' .
  42         '<ul>' .
  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>';
  44
  45 if ( is_multisite() )
  46         $help .= '<li>' . __( 'Remove allows you to remove a user from your site. It does not delete their posts. You can also remove multiple users at once by using Bulk Actions.' ) . '</li>';
  47 else
  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 posts. You can also delete multiple users at once by using Bulk Actions.' ) . '</li>';
  49
  50 $help .= '</ul>';
  51
  52 get_current_screen()->add_help_tab( array(
  53         'id'      => 'actions',
  54         'title'   => __('Actions'),
  55         'content' => $help,
  56 ) );
  57 unset( $help );
  58
  59 get_current_screen()->set_help_sidebar(
  60     '<p><strong>' . __('For more information:') . '</strong></p>' .
  61     '<p>' . __('<a href="http://codex.wordpress.org/Users_Screen" target="_blank">Documentation on Managing Users</a>') . '</p>' .
  62     '<p>' . __('<a href="http://codex.wordpress.org/Roles_and_Capabilities" target="_blank">Descriptions of Roles and Capabilities</a>') . '</p>' .
  63     '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
  64 );
  65
  66 if ( empty($_REQUEST) ) {
  67         $referer = '<input type="hidden" name="wp_http_referer" value="'. esc_attr(stripslashes($_SERVER['REQUEST_URI'])) . '" />';
  68 } elseif ( isset($_REQUEST['wp_http_referer']) ) {
  69         $redirect = remove_query_arg(array('wp_http_referer', 'updated', 'delete_count'), stripslashes($_REQUEST['wp_http_referer']));
  70         $referer = '<input type="hidden" name="wp_http_referer" value="' . esc_attr($redirect) . '" />';
  71 } else {
  72         $redirect = 'users.php';
  73         $referer = '';
  74 }
  75
  76 $update = '';
  77
  78 switch ( $wp_list_table->current_action() ) {
  79
  80 /* Bulk Dropdown menu Role changes */
  81 case 'promote':
  82         check_admin_referer('bulk-users');
  83
  84         if ( ! current_user_can( 'promote_users' ) )
  85                 wp_die( __( 'You can&#8217;t edit that user.' ) );
  86
  87         if ( empty($_REQUEST['users']) ) {
  88                 wp_redirect($redirect);
  89                 exit();
  90         }
  91
  92         $editable_roles = get_editable_roles();
  93         if ( empty( $editable_roles[$_REQUEST['new_role']] ) )
  94                 wp_die(__('You can&#8217;t give users that role.'));
  95
  96         $userids = $_REQUEST['users'];
  97         $update = 'promote';
  98         foreach ( $userids as $id ) {
  99                 $id = (int) $id;
 100
 101                 if ( ! current_user_can('promote_user', $id) )
 102                         wp_die(__('You can&#8217;t edit that user.'));
 103                 // The new role of the current user must also have the promote_users cap or be a super admin
 104                 if ( $id == $current_user->ID && ! is_super_admin() && ! $wp_roles->role_objects[ $_REQUEST['new_role'] ]->has_cap('promote_users') ) {
 105                         $update = 'err_admin_role';
 106                         continue;
 107                 }
 108
 109                 // If the user doesn't already belong to the blog, bail.
 110                 if ( is_multisite() && !is_user_member_of_blog( $id ) )
 111                         wp_die(__('Cheatin&#8217; uh?'));
 112
 113                 $user = new WP_User($id);
 114                 $user->set_role($_REQUEST['new_role']);
 115         }
 116
 117         wp_redirect(add_query_arg('update', $update, $redirect));
 118         exit();
 119
 120 break;
 121
 122 case 'dodelete':
 123         if ( is_multisite() )
 124                 wp_die( __('User deletion is not allowed from this screen.') );
 125
 126         check_admin_referer('delete-users');
 127
 128         if ( empty($_REQUEST['users']) ) {
 129                 wp_redirect($redirect);
 130                 exit();
 131         }
 132
 133         if ( ! current_user_can( 'delete_users' ) )
 134                 wp_die(__('You can&#8217;t delete users.'));
 135
 136         $userids = $_REQUEST['users'];
 137         $update = 'del';
 138         $delete_count = 0;
 139
 140         foreach ( (array) $userids as $id) {
 141                 $id = (int) $id;
 142
 143                 if ( ! current_user_can( 'delete_user', $id ) )
 144                         wp_die(__( 'You can&#8217;t delete that user.' ) );
 145
 146                 if ( $id == $current_user->ID ) {
 147                         $update = 'err_admin_del';
 148                         continue;
 149                 }
 150                 switch ( $_REQUEST['delete_option'] ) {
 151                 case 'delete':
 152                         if ( current_user_can('delete_user', $id) )
 153                                 wp_delete_user($id);
 154                         break;
 155                 case 'reassign':
 156                         if ( current_user_can('delete_user', $id) )
 157                                 wp_delete_user($id, $_REQUEST['reassign_user']);
 158                         break;
 159                 }
 160                 ++$delete_count;
 161         }
 162
 163         $redirect = add_query_arg( array('delete_count' => $delete_count, 'update' => $update), $redirect);
 164         wp_redirect($redirect);
 165         exit();
 166
 167 break;
 168
 169 case 'delete':
 170         if ( is_multisite() )
 171                 wp_die( __('User deletion is not allowed from this screen.') );
 172
 173         check_admin_referer('bulk-users');
 174
 175         if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
 176                 wp_redirect($redirect);
 177                 exit();
 178         }
 179
 180         if ( ! current_user_can( 'delete_users' ) )
 181                 $errors = new WP_Error( 'edit_users', __( 'You can&#8217;t delete users.' ) );
 182
 183         if ( empty($_REQUEST['users']) )
 184                 $userids = array(intval($_REQUEST['user']));
 185         else
 186                 $userids = (array) $_REQUEST['users'];
 187
 188         include ('admin-header.php');
 189 ?>
 190 <form action="" method="post" name="updateusers" id="updateusers">
 191 <?php wp_nonce_field('delete-users') ?>
 192 <?php echo $referer; ?>
 193
 194 <div class="wrap">
 195 <?php screen_icon(); ?>
 196 <h2><?php _e('Delete Users'); ?></h2>
 197 <p><?php echo _n( 'You have specified this user for deletion:', 'You have specified these users for deletion:', count( $userids ) ); ?></p>
 198 <ul>
 199 <?php
 200         $go_delete = 0;
 201         foreach ( $userids as $id ) {
 202                 $id = (int) $id;
 203                 $user = new WP_User($id);
 204                 if ( $id == $current_user->ID ) {
 205                         echo "<li>" . sprintf(__('ID #%1s: %2s <strong>The current user will not be deleted.</strong>'), $id, $user->user_login) . "</li>\n";
 206                 } else {
 207                         echo "<li><input type=\"hidden\" name=\"users[]\" value=\"" . esc_attr($id) . "\" />" . sprintf(__('ID #%1s: %2s'), $id, $user->user_login) . "</li>\n";
 208                         $go_delete++;
 209                 }
 210         }
 211         ?>
 212         </ul>
 213 <?php if ( $go_delete ) : ?>
 214         <fieldset><p><legend><?php echo _n( 'What should be done with posts and links owned by this user?', 'What should be done with posts and links owned by these users?', $go_delete ); ?></legend></p>
 215         <ul style="list-style:none;">
 216                 <li><label><input type="radio" id="delete_option0" name="delete_option" value="delete" checked="checked" />
 217                 <?php _e('Delete all posts and links.'); ?></label></li>
 218                 <li><input type="radio" id="delete_option1" name="delete_option" value="reassign" />
 219                 <?php echo '<label for="delete_option1">'.__('Attribute all posts and links to:').'</label>';
 220                 wp_dropdown_users( array( 'name' => 'reassign_user', 'exclude' => array_diff( $userids, array($current_user->ID) ) ) ); ?></li>
 221         </ul></fieldset>
 222         <input type="hidden" name="action" value="dodelete" />
 223         <?php submit_button( __('Confirm Deletion'), 'secondary' ); ?>
 224 <?php else : ?>
 225         <p><?php _e('There are no valid users selected for deletion.'); ?></p>
 226 <?php endif; ?>
 227 </div>
 228 </form>
 229 <?php
 230
 231 break;
 232
 233 case 'doremove':
 234         check_admin_referer('remove-users');
 235
 236         if ( ! is_multisite() )
 237                 wp_die( __( 'You can&#8217;t remove users.' ) );
 238
 239         if ( empty($_REQUEST['users']) ) {
 240                 wp_redirect($redirect);
 241                 exit;
 242         }
 243
 244         if ( ! current_user_can( 'remove_users' ) )
 245                 wp_die( __( 'You can&#8217;t remove users.' ) );
 246
 247         $userids = $_REQUEST['users'];
 248
 249         $update = 'remove';
 250         foreach ( $userids as $id ) {
 251                 $id = (int) $id;
 252                 if ( $id == $current_user->ID && !is_super_admin() ) {
 253                         $update = 'err_admin_remove';
 254                         continue;
 255                 }
 256                 if ( !current_user_can('remove_user', $id) ) {
 257                         $update = 'err_admin_remove';
 258                         continue;
 259                 }
 260                 remove_user_from_blog($id, $blog_id);
 261         }
 262
 263         $redirect = add_query_arg( array('update' => $update), $redirect);
 264         wp_redirect($redirect);
 265         exit;
 266
 267 break;
 268
 269 case 'remove':
 270
 271         check_admin_referer('bulk-users');
 272
 273         if ( ! is_multisite() )
 274                 wp_die( __( 'You can&#8217;t remove users.' ) );
 275
 276         if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
 277                 wp_redirect($redirect);
 278                 exit();
 279         }
 280
 281         if ( !current_user_can('remove_users') )
 282                 $error = new WP_Error('edit_users', __('You can&#8217;t remove users.'));
 283
 284         if ( empty($_REQUEST['users']) )
 285                 $userids = array(intval($_REQUEST['user']));
 286         else
 287                 $userids = $_REQUEST['users'];
 288
 289         include ('admin-header.php');
 290 ?>
 291 <form action="" method="post" name="updateusers" id="updateusers">
 292 <?php wp_nonce_field('remove-users') ?>
 293 <?php echo $referer; ?>
 294
 295 <div class="wrap">
 296 <?php screen_icon(); ?>
 297 <h2><?php _e('Remove Users from Site'); ?></h2>
 298 <p><?php _e('You have specified these users for removal:'); ?></p>
 299 <ul>
 300 <?php
 301         $go_remove = false;
 302         foreach ( $userids as $id ) {
 303                 $id = (int) $id;
 304                 $user = new WP_User($id);
 305                 if ( $id == $current_user->ID && !is_super_admin() ) {
 306                         echo "<li>" . sprintf(__('ID #%1s: %2s <strong>The current user will not be removed.</strong>'), $id, $user->user_login) . "</li>\n";
 307                 } elseif ( !current_user_can('remove_user', $id) ) {
 308                         echo "<li>" . sprintf(__('ID #%1s: %2s <strong>You don\'t have permission to remove this user.</strong>'), $id, $user->user_login) . "</li>\n";
 309                 } else {
 310                         echo "<li><input type=\"hidden\" name=\"users[]\" value=\"{$id}\" />" . sprintf(__('ID #%1s: %2s'), $id, $user->user_login) . "</li>\n";
 311                         $go_remove = true;
 312                 }
 313         }
 314         ?>
 315 <?php if ( $go_remove ) : ?>
 316                 <input type="hidden" name="action" value="doremove" />
 317                 <?php submit_button( __('Confirm Removal'), 'secondary' ); ?>
 318 <?php else : ?>
 319         <p><?php _e('There are no valid users selected for removal.'); ?></p>
 320 <?php endif; ?>
 321 </div>
 322 </form>
 323 <?php
 324
 325 break;
 326
 327 default:
 328
 329         if ( !empty($_GET['_wp_http_referer']) ) {
 330                 wp_redirect(remove_query_arg(array('_wp_http_referer', '_wpnonce'), stripslashes($_SERVER['REQUEST_URI'])));
 331                 exit;
 332         }
 333
 334         $wp_list_table->prepare_items();
 335         $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
 336         if ( $pagenum > $total_pages && $total_pages > 0 ) {
 337                 wp_redirect( add_query_arg( 'paged', $total_pages ) );
 338                 exit;
 339         }
 340         include('./admin-header.php');
 341
 342         $messages = array();
 343         if ( isset($_GET['update']) ) :
 344                 switch($_GET['update']) {
 345                 case 'del':
 346                 case 'del_many':
 347                         $delete_count = isset($_GET['delete_count']) ? (int) $_GET['delete_count'] : 0;
 348                         $messages[] = '<div id="message" class="updated"><p>' . sprintf(_n('%s user deleted', '%s users deleted', $delete_count), $delete_count) . '</p></div>';
 349                         break;
 350                 case 'add':
 351                         $messages[] = '<div id="message" class="updated"><p>' . __('New user created.') . '</p></div>';
 352                         break;
 353                 case 'promote':
 354                         $messages[] = '<div id="message" class="updated"><p>' . __('Changed roles.') . '</p></div>';
 355                         break;
 356                 case 'err_admin_role':
 357                         $messages[] = '<div id="message" class="error"><p>' . __('The current user&#8217;s role must have user editing capabilities.') . '</p></div>';
 358                         $messages[] = '<div id="message" class="updated"><p>' . __('Other user roles have been changed.') . '</p></div>';
 359                         break;
 360                 case 'err_admin_del':
 361                         $messages[] = '<div id="message" class="error"><p>' . __('You can&#8217;t delete the current user.') . '</p></div>';
 362                         $messages[] = '<div id="message" class="updated"><p>' . __('Other users have been deleted.') . '</p></div>';
 363                         break;
 364                 case 'remove':
 365                         $messages[] = '<div id="message" class="updated fade"><p>' . __('User removed from this site.') . '</p></div>';
 366                         break;
 367                 case 'err_admin_remove':
 368                         $messages[] = '<div id="message" class="error"><p>' . __("You can't remove the current user.") . '</p></div>';
 369                         $messages[] = '<div id="message" class="updated fade"><p>' . __('Other users have been removed.') . '</p></div>';
 370                         break;
 371                 }
 372         endif; ?>
 373
 374 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
 375         <div class="error">
 376                 <ul>
 377                 <?php
 378                         foreach ( $errors->get_error_messages() as $err )
 379                                 echo "<li>$err</li>\n";
 380                 ?>
 381                 </ul>
 382         </div>
 383 <?php endif;
 384
 385 if ( ! empty($messages) ) {
 386         foreach ( $messages as $msg )
 387                 echo $msg;
 388 } ?>
 389
 390 <div class="wrap">
 391 <?php screen_icon(); ?>
 392 <h2>
 393 <?php
 394 echo esc_html( $title );
 395 if ( current_user_can( 'create_users' ) ) { ?>
 396         <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add New', 'user' ); ?></a>
 397 <?php } elseif ( is_multisite() && current_user_can( 'promote_users' ) ) { ?>
 398         <a href="user-new.php" class="add-new-h2"><?php echo esc_html_x( 'Add Existing', 'user' ); ?></a>
 399 <?php }
 400
 401 if ( $usersearch )
 402         printf( '<span class="subtitle">' . __('Search results for &#8220;%s&#8221;') . '</span>', esc_html( $usersearch ) ); ?>
 403 </h2>
 404
 405 <?php $wp_list_table->views(); ?>
 406
 407 <form action="" method="get">
 408
 409 <?php $wp_list_table->search_box( __( 'Search Users' ), 'user' ); ?>
 410
 411 <?php $wp_list_table->display(); ?>
 412 </form>
 413
 414 <br class="clear" />
 415 </div>
 416 <?php
 417 break;
 418
 419 } // end of the $doaction switch
 420
 421 include('./admin-footer.php');