3 * Users administration panel.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( './admin.php' );
12 if ( ! current_user_can( 'list_users' ) )
13 wp_die( __( 'Cheatin’ uh?' ) );
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', array('label' => _x( 'Users', 'users per page (screen options)' )) );
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 posts. 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 posts. 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="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>'
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) . '" />';
72 $redirect = 'users.php';
78 switch ( $wp_list_table->current_action() ) {
80 /* Bulk Dropdown menu Role changes */
82 check_admin_referer('bulk-users');
84 if ( ! current_user_can( 'promote_users' ) )
85 wp_die( __( 'You can’t edit that user.' ) );
87 if ( empty($_REQUEST['users']) ) {
88 wp_redirect($redirect);
92 $editable_roles = get_editable_roles();
93 if ( empty( $editable_roles[$_REQUEST['new_role']] ) )
94 wp_die(__('You can’t give users that role.'));
96 $userids = $_REQUEST['users'];
98 foreach ( $userids as $id ) {
101 if ( ! current_user_can('promote_user', $id) )
102 wp_die(__('You can’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';
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’ uh?'));
113 $user = new WP_User($id);
114 $user->set_role($_REQUEST['new_role']);
117 wp_redirect(add_query_arg('update', $update, $redirect));
123 if ( is_multisite() )
124 wp_die( __('User deletion is not allowed from this screen.') );
126 check_admin_referer('delete-users');
128 if ( empty($_REQUEST['users']) ) {
129 wp_redirect($redirect);
133 if ( ! current_user_can( 'delete_users' ) )
134 wp_die(__('You can’t delete users.'));
136 $userids = $_REQUEST['users'];
140 foreach ( (array) $userids as $id) {
143 if ( ! current_user_can( 'delete_user', $id ) )
144 wp_die(__( 'You can’t delete that user.' ) );
146 if ( $id == $current_user->ID ) {
147 $update = 'err_admin_del';
150 switch ( $_REQUEST['delete_option'] ) {
152 if ( current_user_can('delete_user', $id) )
156 if ( current_user_can('delete_user', $id) )
157 wp_delete_user($id, $_REQUEST['reassign_user']);
163 $redirect = add_query_arg( array('delete_count' => $delete_count, 'update' => $update), $redirect);
164 wp_redirect($redirect);
170 if ( is_multisite() )
171 wp_die( __('User deletion is not allowed from this screen.') );
173 check_admin_referer('bulk-users');
175 if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
176 wp_redirect($redirect);
180 if ( ! current_user_can( 'delete_users' ) )
181 $errors = new WP_Error( 'edit_users', __( 'You can’t delete users.' ) );
183 if ( empty($_REQUEST['users']) )
184 $userids = array(intval($_REQUEST['user']));
186 $userids = (array) $_REQUEST['users'];
188 include ('admin-header.php');
190 <form action="" method="post" name="updateusers" id="updateusers">
191 <?php wp_nonce_field('delete-users') ?>
192 <?php echo $referer; ?>
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>
201 foreach ( $userids as $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";
207 echo "<li><input type=\"hidden\" name=\"users[]\" value=\"" . esc_attr($id) . "\" />" . sprintf(__('ID #%1s: %2s'), $id, $user->user_login) . "</li>\n";
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>
222 <input type="hidden" name="action" value="dodelete" />
223 <?php submit_button( __('Confirm Deletion'), 'secondary' ); ?>
225 <p><?php _e('There are no valid users selected for deletion.'); ?></p>
234 check_admin_referer('remove-users');
236 if ( ! is_multisite() )
237 wp_die( __( 'You can’t remove users.' ) );
239 if ( empty($_REQUEST['users']) ) {
240 wp_redirect($redirect);
244 if ( ! current_user_can( 'remove_users' ) )
245 wp_die( __( 'You can’t remove users.' ) );
247 $userids = $_REQUEST['users'];
250 foreach ( $userids as $id ) {
252 if ( $id == $current_user->ID && !is_super_admin() ) {
253 $update = 'err_admin_remove';
256 if ( !current_user_can('remove_user', $id) ) {
257 $update = 'err_admin_remove';
260 remove_user_from_blog($id, $blog_id);
263 $redirect = add_query_arg( array('update' => $update), $redirect);
264 wp_redirect($redirect);
271 check_admin_referer('bulk-users');
273 if ( ! is_multisite() )
274 wp_die( __( 'You can’t remove users.' ) );
276 if ( empty($_REQUEST['users']) && empty($_REQUEST['user']) ) {
277 wp_redirect($redirect);
281 if ( !current_user_can('remove_users') )
282 $error = new WP_Error('edit_users', __('You can’t remove users.'));
284 if ( empty($_REQUEST['users']) )
285 $userids = array(intval($_REQUEST['user']));
287 $userids = $_REQUEST['users'];
289 include ('admin-header.php');
291 <form action="" method="post" name="updateusers" id="updateusers">
292 <?php wp_nonce_field('remove-users') ?>
293 <?php echo $referer; ?>
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>
302 foreach ( $userids as $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";
310 echo "<li><input type=\"hidden\" name=\"users[]\" value=\"{$id}\" />" . sprintf(__('ID #%1s: %2s'), $id, $user->user_login) . "</li>\n";
315 <?php if ( $go_remove ) : ?>
316 <input type="hidden" name="action" value="doremove" />
317 <?php submit_button( __('Confirm Removal'), 'secondary' ); ?>
319 <p><?php _e('There are no valid users selected for removal.'); ?></p>
329 if ( !empty($_GET['_wp_http_referer']) ) {
330 wp_redirect(remove_query_arg(array('_wp_http_referer', '_wpnonce'), stripslashes($_SERVER['REQUEST_URI'])));
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 ) );
340 include('./admin-header.php');
343 if ( isset($_GET['update']) ) :
344 switch($_GET['update']) {
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>';
351 $messages[] = '<div id="message" class="updated"><p>' . __('New user created.') . '</p></div>';
354 $messages[] = '<div id="message" class="updated"><p>' . __('Changed roles.') . '</p></div>';
356 case 'err_admin_role':
357 $messages[] = '<div id="message" class="error"><p>' . __('The current user’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>';
360 case 'err_admin_del':
361 $messages[] = '<div id="message" class="error"><p>' . __('You can’t delete the current user.') . '</p></div>';
362 $messages[] = '<div id="message" class="updated"><p>' . __('Other users have been deleted.') . '</p></div>';
365 $messages[] = '<div id="message" class="updated fade"><p>' . __('User removed from this site.') . '</p></div>';
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>';
374 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
378 foreach ( $errors->get_error_messages() as $err )
379 echo "<li>$err</li>\n";
385 if ( ! empty($messages) ) {
386 foreach ( $messages as $msg )
391 <?php screen_icon(); ?>
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>
402 printf( '<span class="subtitle">' . __('Search results for “%s”') . '</span>', esc_html( $usersearch ) ); ?>
405 <?php $wp_list_table->views(); ?>
407 <form action="" method="get">
409 <?php $wp_list_table->search_box( __( 'Search Users' ), 'user' ); ?>
411 <?php $wp_list_table->display(); ?>
419 } // end of the $doaction switch
421 include('./admin-footer.php');