3 * Edit Site Users Administration Screen
6 * @subpackage Multisite
10 /** Load WordPress Administration Bootstrap */
11 require_once( dirname( __FILE__ ) . '/admin.php' );
13 if ( ! is_multisite() )
14 wp_die( __( 'Multisite support is not enabled.' ) );
16 if ( ! current_user_can('manage_sites') )
17 wp_die(__('You do not have sufficient permissions to edit this site.'));
19 $wp_list_table = _get_list_table('WP_Users_List_Table');
20 $wp_list_table->prepare_items();
22 get_current_screen()->add_help_tab( array(
24 'title' => __('Overview'),
26 '<p>' . __('The menu is for editing information specific to individual sites, particularly if the admin area of a site is unavailable.') . '</p>' .
27 '<p>' . __('<strong>Info</strong> — The site URL is rarely edited as this can cause the site to not work properly. The Registered date and Last Updated date are displayed. Network admins can mark a site as archived, spam, deleted and mature, to remove from public listings or disable.') . '</p>' .
28 '<p>' . __('<strong>Users</strong> — This displays the users associated with this site. You can also change their role, reset their password, or remove them from the site. Removing the user from the site does not remove the user from the network.') . '</p>' .
29 '<p>' . sprintf( __('<strong>Themes</strong> — This area shows themes that are not already enabled across the network. Enabling a theme in this menu makes it accessible to this site. It does not activate the theme, but allows it to show in the site’s Appearance menu. To enable a theme for the entire network, see the <a href="%s">Network Themes</a> screen.' ), network_admin_url( 'themes.php' ) ) . '</p>' .
30 '<p>' . __('<strong>Settings</strong> — This page shows a list of all settings associated with this site. Some are created by WordPress and others are created by plugins you activate. Note that some fields are grayed out and say Serialized Data. You cannot modify these values due to the way the setting is stored in the database.') . '</p>'
33 get_current_screen()->set_help_sidebar(
34 '<p><strong>' . __('For more information:') . '</strong></p>' .
35 '<p>' . __('<a href="https://codex.wordpress.org/Network_Admin_Sites_Screen" target="_blank">Documentation on Site Management</a>') . '</p>' .
36 '<p>' . __('<a href="https://wordpress.org/support/forum/multisite/" target="_blank">Support Forums</a>') . '</p>'
39 get_current_screen()->set_screen_reader_content( array(
40 'heading_views' => __( 'Filter site users list' ),
41 'heading_pagination' => __( 'Site users list navigation' ),
42 'heading_list' => __( 'Site users list' ),
45 $_SERVER['REQUEST_URI'] = remove_query_arg( 'update', $_SERVER['REQUEST_URI'] );
46 $referer = remove_query_arg( 'update', wp_get_referer() );
48 if ( ! empty( $_REQUEST['paged'] ) ) {
49 $referer = add_query_arg( 'paged', (int) $_REQUEST['paged'], $referer );
52 $id = isset( $_REQUEST['id'] ) ? intval( $_REQUEST['id'] ) : 0;
55 wp_die( __('Invalid site ID.') );
57 $details = get_blog_details( $id );
59 wp_die( __( 'The requested site does not exist.' ) );
62 if ( ! can_edit_network( $details->site_id ) )
63 wp_die( __( 'You do not have permission to access this page.' ), 403 );
65 $is_main_site = is_main_site( $id );
67 switch_to_blog( $id );
69 $action = $wp_list_table->current_action();
75 check_admin_referer( 'add-user', '_wpnonce_add-new-user' );
76 $user = $_POST['user'];
77 if ( ! is_array( $_POST['user'] ) || empty( $user['username'] ) || empty( $user['email'] ) ) {
80 $password = wp_generate_password( 12, false);
81 $user_id = wpmu_create_user( esc_html( strtolower( $user['username'] ) ), $password, esc_html( $user['email'] ) );
83 if ( false === $user_id ) {
84 $update = 'err_new_dup';
86 add_user_to_blog( $id, $user_id, $_POST['new_role'] );
89 * Fires after a user has been created via the network site-users.php page.
93 * @param int $user_id ID of the newly created user.
95 do_action( 'network_site_users_created_user', $user_id );
101 check_admin_referer( 'add-user', '_wpnonce_add-user' );
102 if ( !empty( $_POST['newuser'] ) ) {
104 $newuser = $_POST['newuser'];
105 $user = get_user_by( 'login', $newuser );
106 if ( $user && $user->exists() ) {
107 if ( ! is_user_member_of_blog( $user->ID, $id ) )
108 add_user_to_blog( $id, $user->ID, $_POST['new_role'] );
110 $update = 'err_add_member';
112 $update = 'err_add_notfound';
115 $update = 'err_add_notfound';
120 if ( ! current_user_can( 'remove_users' ) )
121 die(__('You can’t remove users.'));
122 check_admin_referer( 'bulk-users' );
125 if ( isset( $_REQUEST['users'] ) ) {
126 $userids = $_REQUEST['users'];
128 foreach ( $userids as $user_id ) {
129 $user_id = (int) $user_id;
130 remove_user_from_blog( $user_id, $id );
132 } elseif ( isset( $_GET['user'] ) ) {
133 remove_user_from_blog( $_GET['user'] );
135 $update = 'err_remove';
140 check_admin_referer( 'bulk-users' );
141 $editable_roles = get_editable_roles();
142 if ( empty( $editable_roles[$_REQUEST['new_role']] ) )
143 wp_die(__('You can’t give users that role.'));
145 if ( isset( $_REQUEST['users'] ) ) {
146 $userids = $_REQUEST['users'];
148 foreach ( $userids as $user_id ) {
149 $user_id = (int) $user_id;
151 // If the user doesn't already belong to the blog, bail.
152 if ( ! is_user_member_of_blog( $user_id ) ) {
154 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
155 '<p>' . __( 'One of the selected users is not a member of this site.' ) . '</p>',
160 $user = get_userdata( $user_id );
161 $user->set_role( $_REQUEST['new_role'] );
164 $update = 'err_promote';
169 wp_safe_redirect( add_query_arg( 'update', $update, $referer ) );
173 restore_current_blog();
175 if ( isset( $_GET['action'] ) && 'update-site' == $_GET['action'] ) {
176 wp_safe_redirect( $referer );
180 add_screen_option( 'per_page' );
182 $title = sprintf( __( 'Edit Site: %s' ), esc_html( $details->blogname ) );
184 $parent_file = 'sites.php';
185 $submenu_file = 'sites.php';
188 * Filter whether to show the Add Existing User form on the Multisite Users screen.
192 * @param bool $bool Whether to show the Add Existing User form. Default true.
194 if ( ! wp_is_large_network( 'users' ) && apply_filters( 'show_network_site_users_add_existing_form', true ) )
195 wp_enqueue_script( 'user-suggest' );
197 require( ABSPATH . 'wp-admin/admin-header.php' ); ?>
199 <script type="text/javascript">
200 var current_site_id = <?php echo $id; ?>;
205 <h1 id="edit-site"><?php echo $title; ?></h1>
206 <p class="edit-site-actions"><a href="<?php echo esc_url( get_home_url( $id, '/' ) ); ?>"><?php _e( 'Visit' ); ?></a> | <a href="<?php echo esc_url( get_admin_url( $id ) ); ?>"><?php _e( 'Dashboard' ); ?></a></p>
207 <h2 class="nav-tab-wrapper nav-tab-small wp-clearfix">
210 'site-info' => array( 'label' => __( 'Info' ), 'url' => 'site-info.php' ),
211 'site-users' => array( 'label' => __( 'Users' ), 'url' => 'site-users.php' ),
212 'site-themes' => array( 'label' => __( 'Themes' ), 'url' => 'site-themes.php' ),
213 'site-settings' => array( 'label' => __( 'Settings' ), 'url' => 'site-settings.php' ),
215 foreach ( $tabs as $tab_id => $tab ) {
216 $class = ( $tab['url'] == $pagenow ) ? ' nav-tab-active' : '';
217 echo '<a href="' . $tab['url'] . '?id=' . $id .'" class="nav-tab' . $class . '">' . esc_html( $tab['label'] ) . '</a>';
222 if ( isset($_GET['update']) ) :
223 switch($_GET['update']) {
225 echo '<div id="message" class="updated notice is-dismissible"><p>' . __( 'User added.' ) . '</p></div>';
227 case 'err_add_member':
228 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'User is already a member of this site.' ) . '</p></div>';
230 case 'err_add_notfound':
231 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'Enter the username of an existing user.' ) . '</p></div>';
234 echo '<div id="message" class="updated notice is-dismissible"><p>' . __( 'Changed roles.' ) . '</p></div>';
237 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'Select a user to change role.' ) . '</p></div>';
240 echo '<div id="message" class="updated notice is-dismissible"><p>' . __( 'User removed from this site.' ) . '</p></div>';
243 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'Select a user to remove.' ) . '</p></div>';
246 echo '<div id="message" class="updated notice is-dismissible"><p>' . __( 'User created.' ) . '</p></div>';
249 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'Enter the username and email.' ) . '</p></div>';
252 echo '<div id="message" class="error notice is-dismissible"><p>' . __( 'Duplicated username or email address.' ) . '</p></div>';
257 <form class="search-form" method="get">
258 <?php $wp_list_table->search_box( __( 'Search Users' ), 'user' ); ?>
259 <input type="hidden" name="id" value="<?php echo esc_attr( $id ) ?>" />
262 <?php $wp_list_table->views(); ?>
264 <form method="post" action="site-users.php?action=update-site">
265 <input type="hidden" name="id" value="<?php echo esc_attr( $id ) ?>" />
267 <?php $wp_list_table->display(); ?>
273 * Fires after the list table on the Users screen in the Multisite Network Admin.
277 do_action( 'network_site_users_after_list_table' );
279 /** This filter is documented in wp-admin/network/site-users.php */
280 if ( current_user_can( 'promote_users' ) && apply_filters( 'show_network_site_users_add_existing_form', true ) ) : ?>
281 <h2 id="add-existing-user"><?php _e( 'Add Existing User' ); ?></h2>
282 <form action="site-users.php?action=adduser" id="adduser" method="post">
283 <input type="hidden" name="id" value="<?php echo esc_attr( $id ) ?>" />
284 <table class="form-table">
286 <th scope="row"><label for="newuser"><?php _e( 'Username' ); ?></label></th>
287 <td><input type="text" class="regular-text wp-suggest-user" name="newuser" id="newuser" /></td>
290 <th scope="row"><label for="new_role_adduser"><?php _e( 'Role' ); ?></label></th>
291 <td><select name="new_role" id="new_role_adduser">
292 <?php wp_dropdown_roles( get_option( 'default_role' ) ); ?>
296 <?php wp_nonce_field( 'add-user', '_wpnonce_add-user' ) ?>
297 <?php submit_button( __( 'Add User' ), 'primary', 'add-user', true, array( 'id' => 'submit-add-existing-user' ) ); ?>
303 * Filter whether to show the Add New User form on the Multisite Users screen.
307 * @param bool $bool Whether to show the Add New User form. Default true.
309 if ( current_user_can( 'create_users' ) && apply_filters( 'show_network_site_users_add_new_form', true ) ) : ?>
310 <h2 id="add-new-user"><?php _e( 'Add New User' ); ?></h2>
311 <form action="<?php echo network_admin_url('site-users.php?action=newuser'); ?>" id="newuser" method="post">
312 <input type="hidden" name="id" value="<?php echo esc_attr( $id ) ?>" />
313 <table class="form-table">
315 <th scope="row"><label for="user_username"><?php _e( 'Username' ) ?></label></th>
316 <td><input type="text" class="regular-text" name="user[username]" id="user_username" /></td>
319 <th scope="row"><label for="user_email"><?php _e( 'Email' ) ?></label></th>
320 <td><input type="text" class="regular-text" name="user[email]" id="user_email" /></td>
323 <th scope="row"><label for="new_role_newuser"><?php _e( 'Role' ); ?></label></th>
324 <td><select name="new_role" id="new_role_newuser">
325 <?php wp_dropdown_roles( get_option( 'default_role' ) ); ?>
328 <tr class="form-field">
329 <td colspan="2"><?php _e( 'A password reset link will be sent to the user via email.' ) ?></td>
332 <?php wp_nonce_field( 'add-user', '_wpnonce_add-new-user' ) ?>
333 <?php submit_button( __( 'Add New User' ), 'primary', 'add-user', true, array( 'id' => 'submit-add-user' ) ); ?>
338 require( ABSPATH . 'wp-admin/admin-footer.php' );