3 * New User Administration Screen.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
12 if ( is_multisite() ) {
13 if ( ! current_user_can( 'create_users' ) && ! current_user_can( 'promote_users' ) )
14 wp_die( __( 'Cheatin’ uh?' ) );
15 } elseif ( ! current_user_can( 'create_users' ) ) {
16 wp_die( __( 'Cheatin’ uh?' ) );
19 if ( is_multisite() ) {
20 function admin_created_user_email( $text ) {
21 $roles = get_editable_roles();
22 $role = $roles[ $_REQUEST['role'] ];
23 /* translators: 1: Site name, 2: site URL, 3: role */
24 return sprintf( __( 'Hi,
25 You\'ve been invited to join \'%1$s\' at
26 %2$s with the role of %3$s.
27 If you do not want to join this site please ignore
28 this email. This invitation will expire in a few days.
30 Please click the following link to activate your user account:
31 %%s' ), get_bloginfo( 'name' ), home_url(), wp_specialchars_decode( translate_user_role( $role['name'] ) ) );
33 add_filter( 'wpmu_signup_user_notification_email', 'admin_created_user_email' );
35 function admin_created_user_subject( $text ) {
36 return sprintf( __( '[%s] Your site invite' ), get_bloginfo( 'name' ) );
40 if ( isset($_REQUEST['action']) && 'adduser' == $_REQUEST['action'] ) {
41 check_admin_referer( 'add-user', '_wpnonce_add-user' );
44 if ( false !== strpos($_REQUEST[ 'email' ], '@') ) {
45 $user_details = get_user_by('email', $_REQUEST[ 'email' ]);
47 if ( is_super_admin() ) {
48 $user_details = get_user_by('login', $_REQUEST[ 'email' ]);
50 wp_redirect( add_query_arg( array('update' => 'enter_email'), 'user-new.php' ) );
55 if ( !$user_details ) {
56 wp_redirect( add_query_arg( array('update' => 'does_not_exist'), 'user-new.php' ) );
60 if ( ! current_user_can('promote_user', $user_details->ID) )
61 wp_die(__('Cheatin’ uh?'));
63 // Adding an existing user to this blog
64 $new_user_email = $user_details->user_email;
65 $redirect = 'user-new.php';
66 $username = $user_details->user_login;
67 $user_id = $user_details->ID;
68 if ( ( $username != null && !is_super_admin( $user_id ) ) && ( array_key_exists($blog_id, get_blogs_of_user($user_id)) ) ) {
69 $redirect = add_query_arg( array('update' => 'addexisting'), 'user-new.php' );
71 if ( isset( $_POST[ 'noconfirmation' ] ) && is_super_admin() ) {
72 add_existing_user_to_blog( array( 'user_id' => $user_id, 'role' => $_REQUEST[ 'role' ] ) );
73 $redirect = add_query_arg( array('update' => 'addnoconfirmation'), 'user-new.php' );
75 $newuser_key = substr( md5( $user_id ), 0, 5 );
76 add_option( 'new_user_' . $newuser_key, array( 'user_id' => $user_id, 'email' => $user_details->user_email, 'role' => $_REQUEST[ 'role' ] ) );
78 $roles = get_editable_roles();
79 $role = $roles[ $_REQUEST['role'] ];
80 /* translators: 1: Site name, 2: site URL, 3: role, 4: activation URL */
83 You\'ve been invited to join \'%1$s\' at
84 %2$s with the role of %3$s.
86 Please click the following link to confirm the invite:
88 wp_mail( $new_user_email, sprintf( __( '[%s] Joining confirmation' ), wp_specialchars_decode( get_option( 'blogname' ) ) ), sprintf( $message, get_option( 'blogname' ), home_url(), wp_specialchars_decode( translate_user_role( $role['name'] ) ), home_url( "/newbloguser/$newuser_key/" ) ) );
89 $redirect = add_query_arg( array('update' => 'add'), 'user-new.php' );
92 wp_redirect( $redirect );
94 } elseif ( isset($_REQUEST['action']) && 'createuser' == $_REQUEST['action'] ) {
95 check_admin_referer( 'create-user', '_wpnonce_create-user' );
97 if ( ! current_user_can('create_users') )
98 wp_die(__('Cheatin’ uh?'));
100 if ( ! is_multisite() ) {
101 $user_id = edit_user();
103 if ( is_wp_error( $user_id ) ) {
104 $add_user_errors = $user_id;
106 if ( current_user_can( 'list_users' ) )
107 $redirect = 'users.php?update=add&id=' . $user_id;
109 $redirect = add_query_arg( 'update', 'add', 'user-new.php' );
110 wp_redirect( $redirect );
114 // Adding a new user to this site
115 $user_details = wpmu_validate_user_signup( $_REQUEST[ 'user_login' ], $_REQUEST[ 'email' ] );
116 if ( is_wp_error( $user_details[ 'errors' ] ) && !empty( $user_details[ 'errors' ]->errors ) ) {
117 $add_user_errors = $user_details[ 'errors' ];
120 * Filter the user_login, also known as the username, before it is added to the site.
124 * @param string $user_login The sanitized username.
126 $new_user_login = apply_filters( 'pre_user_login', sanitize_user( wp_unslash( $_REQUEST['user_login'] ), true ) );
127 if ( isset( $_POST[ 'noconfirmation' ] ) && is_super_admin() ) {
128 add_filter( 'wpmu_signup_user_notification', '__return_false' ); // Disable confirmation email
130 wpmu_signup_user( $new_user_login, $_REQUEST[ 'email' ], array( 'add_to_blog' => $wpdb->blogid, 'new_role' => $_REQUEST[ 'role' ] ) );
131 if ( isset( $_POST[ 'noconfirmation' ] ) && is_super_admin() ) {
132 $key = $wpdb->get_var( $wpdb->prepare( "SELECT activation_key FROM {$wpdb->signups} WHERE user_login = %s AND user_email = %s", $new_user_login, $_REQUEST[ 'email' ] ) );
133 wpmu_activate_signup( $key );
134 $redirect = add_query_arg( array('update' => 'addnoconfirmation'), 'user-new.php' );
136 $redirect = add_query_arg( array('update' => 'newuserconfirmation'), 'user-new.php' );
138 wp_redirect( $redirect );
144 $title = __('Add New User');
145 $parent_file = 'users.php';
148 if ( is_multisite() && current_user_can('promote_users') && current_user_can('create_users') )
151 $help = '<p>' . __('To add a new user to your site, fill in the form on this screen and click the Add New User button at the bottom.') . '</p>';
153 if ( is_multisite() ) {
154 $help .= '<p>' . __('Because this is a multisite installation, you may add accounts that already exist on the Network by specifying a username or email, and defining a role. For more options, such as specifying a password, you have to be a Network Administrator and use the hover link under an existing user’s name to Edit the user profile under Network Admin > All Users.') . '</p>' .
155 '<p>' . __('New users will receive an email letting them know they’ve been added as a user for your site. This email will also contain their password. Check the box if you don’t want the user to receive a welcome email.') . '</p>';
157 $help .= '<p>' . __('You must assign a password to the new user, which they can change after logging in. The username, however, cannot be changed.') . '</p>' .
158 '<p>' . __('New users will receive an email letting them know they’ve been added as a user for your site. By default, this email will also contain their password. Uncheck the box if you don’t want the password to be included in the welcome email.') . '</p>';
161 $help .= '<p>' . __('Remember to click the Add New User button at the bottom of this screen when you are finished.') . '</p>';
163 get_current_screen()->add_help_tab( array(
165 'title' => __('Overview'),
169 get_current_screen()->add_help_tab( array(
170 'id' => 'user-roles',
171 'title' => __('User Roles'),
172 'content' => '<p>' . __('Here is a basic overview of the different user roles and the permissions associated with each one:') . '</p>' .
174 '<li>' . __('Subscribers can read comments/comment/receive newsletters, etc. but cannot create regular site content.') . '</li>' .
175 '<li>' . __('Contributors can write and manage their posts but not publish posts or upload media files.') . '</li>' .
176 '<li>' . __('Authors can publish and manage their own posts, and are able to upload files.') . '</li>' .
177 '<li>' . __('Editors can publish posts, manage posts as well as manage other people’s posts, etc.') . '</li>' .
178 '<li>' . __('Administrators have access to all the administration features.') . '</li>' .
182 get_current_screen()->set_help_sidebar(
183 '<p><strong>' . __('For more information:') . '</strong></p>' .
184 '<p>' . __('<a href="http://codex.wordpress.org/Users_Add_New_Screen" target="_blank">Documentation on Adding New Users</a>') . '</p>' .
185 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
188 wp_enqueue_script('wp-ajax-response');
189 wp_enqueue_script('user-profile');
192 * Filter whether to enable user auto-complete for non-super admins in Multisite.
196 * @param bool $enable Whether to enable auto-complete for non-super admins. Default false.
198 if ( is_multisite() && current_user_can( 'promote_users' ) && ! wp_is_large_network( 'users' )
199 && ( is_super_admin() || apply_filters( 'autocomplete_users_for_site_admins', false ) )
201 wp_enqueue_script( 'user-suggest' );
204 require_once( ABSPATH . 'wp-admin/admin-header.php' );
206 if ( isset($_GET['update']) ) {
208 if ( is_multisite() ) {
209 switch ( $_GET['update'] ) {
210 case "newuserconfirmation":
211 $messages[] = __('Invitation email sent to new user. A confirmation link must be clicked before their account is created.');
214 $messages[] = __('Invitation email sent to user. A confirmation link must be clicked for them to be added to your site.');
216 case "addnoconfirmation":
217 $messages[] = __('User has been added to your site.');
220 $messages[] = __('That user is already a member of this site.');
222 case "does_not_exist":
223 $messages[] = __('The requested user does not exist.');
226 $messages[] = __('Please enter a valid email address.');
230 if ( 'add' == $_GET['update'] )
231 $messages[] = __('User added.');
236 <h2 id="add-new-user"> <?php
237 if ( current_user_can( 'create_users' ) ) {
238 echo _x( 'Add New User', 'user' );
239 } elseif ( current_user_can( 'promote_users' ) ) {
240 echo _x( 'Add Existing User', 'user' );
244 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
248 foreach ( $errors->get_error_messages() as $err )
249 echo "<li>$err</li>\n";
255 if ( ! empty( $messages ) ) {
256 foreach ( $messages as $msg )
257 echo '<div id="message" class="updated"><p>' . $msg . '</p></div>';
260 <?php if ( isset($add_user_errors) && is_wp_error( $add_user_errors ) ) : ?>
263 foreach ( $add_user_errors->get_error_messages() as $message )
264 echo "<p>$message</p>";
268 <div id="ajax-response"></div>
271 if ( is_multisite() ) {
273 echo '<h3 id="add-existing-user">' . __('Add Existing User') . '</h3>';
274 if ( !is_super_admin() ) {
275 echo '<p>' . __( 'Enter the email address of an existing user on this network to invite them to this site. That person will be sent an email asking them to confirm the invite.' ) . '</p>';
276 $label = __('E-mail');
279 echo '<p>' . __( 'Enter the email address or username of an existing user on this network to invite them to this site. That person will be sent an email asking them to confirm the invite.' ) . '</p>';
280 $label = __('E-mail or Username');
286 * Fires inside the adduser form tag.
291 <form action="" method="post" name="adduser" id="adduser" class="validate" novalidate="novalidate"<?php do_action( 'user_new_form_tag' );?>>
292 <input name="action" type="hidden" value="adduser" />
293 <?php wp_nonce_field( 'add-user', '_wpnonce_add-user' ) ?>
295 <table class="form-table">
296 <tr class="form-field form-required">
297 <th scope="row"><label for="adduser-email"><?php echo $label; ?></label></th>
298 <td><input name="email" type="<?php echo $type; ?>" id="adduser-email" class="wp-suggest-user" value="" /></td>
300 <tr class="form-field">
301 <th scope="row"><label for="adduser-role"><?php _e('Role'); ?></label></th>
302 <td><select name="role" id="adduser-role">
303 <?php wp_dropdown_roles( get_option('default_role') ); ?>
307 <?php if ( is_super_admin() ) { ?>
309 <th scope="row"><label for="adduser-noconfirmation"><?php _e('Skip Confirmation Email') ?></label></th>
310 <td><label for="adduser-noconfirmation"><input type="checkbox" name="noconfirmation" id="adduser-noconfirmation" value="1" /> <?php _e( 'Add the user without sending an email that requires their confirmation.' ); ?></label></td>
316 * Fires at the end of the new user form.
318 * Passes a contextual string to make both types of new user forms
319 * uniquely targetable. Contexts are 'add-existing-user' (Multisite),
320 * and 'add-new-user' (single site and network admin).
324 * @param string $type A contextual string specifying which type of new user form the hook follows.
326 do_action( 'user_new_form', 'add-existing-user' );
328 <?php submit_button( __( 'Add Existing User '), 'primary', 'adduser', true, array( 'id' => 'addusersub' ) ); ?>
333 if ( current_user_can( 'create_users') ) {
335 echo '<h3 id="create-new-user">' . __( 'Add New User' ) . '</h3>';
337 <p><?php _e('Create a brand new user and add them to this site.'); ?></p>
338 <?php /** This action is documented in wp-admin/user-new.php */ ?>
339 <form action="" method="post" name="createuser" id="createuser" class="validate" novalidate="novalidate"<?php do_action( 'user_new_form_tag' );?>>
340 <input name="action" type="hidden" value="createuser" />
341 <?php wp_nonce_field( 'create-user', '_wpnonce_create-user' ); ?>
343 // Load up the passed data, else set to a default.
344 $creating = isset( $_POST['createuser'] );
346 $new_user_login = $creating && isset( $_POST['user_login'] ) ? wp_unslash( $_POST['user_login'] ) : '';
347 $new_user_firstname = $creating && isset( $_POST['first_name'] ) ? wp_unslash( $_POST['first_name'] ) : '';
348 $new_user_lastname = $creating && isset( $_POST['last_name'] ) ? wp_unslash( $_POST['last_name'] ) : '';
349 $new_user_email = $creating && isset( $_POST['email'] ) ? wp_unslash( $_POST['email'] ) : '';
350 $new_user_uri = $creating && isset( $_POST['url'] ) ? wp_unslash( $_POST['url'] ) : '';
351 $new_user_role = $creating && isset( $_POST['role'] ) ? wp_unslash( $_POST['role'] ) : '';
352 $new_user_send_password = $creating && isset( $_POST['send_password'] ) ? wp_unslash( $_POST['send_password'] ) : '';
353 $new_user_ignore_pass = $creating && isset( $_POST['noconfirmation'] ) ? wp_unslash( $_POST['noconfirmation'] ) : '';
356 <table class="form-table">
357 <tr class="form-field form-required">
358 <th scope="row"><label for="user_login"><?php _e('Username'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
359 <td><input name="user_login" type="text" id="user_login" value="<?php echo esc_attr($new_user_login); ?>" aria-required="true" /></td>
361 <tr class="form-field form-required">
362 <th scope="row"><label for="email"><?php _e('E-mail'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
363 <td><input name="email" type="email" id="email" value="<?php echo esc_attr( $new_user_email ); ?>" /></td>
365 <?php if ( !is_multisite() ) { ?>
366 <tr class="form-field">
367 <th scope="row"><label for="first_name"><?php _e('First Name') ?> </label></th>
368 <td><input name="first_name" type="text" id="first_name" value="<?php echo esc_attr($new_user_firstname); ?>" /></td>
370 <tr class="form-field">
371 <th scope="row"><label for="last_name"><?php _e('Last Name') ?> </label></th>
372 <td><input name="last_name" type="text" id="last_name" value="<?php echo esc_attr($new_user_lastname); ?>" /></td>
374 <tr class="form-field">
375 <th scope="row"><label for="url"><?php _e('Website') ?></label></th>
376 <td><input name="url" type="url" id="url" class="code" value="<?php echo esc_attr( $new_user_uri ); ?>" /></td>
380 * Filter the display of the password fields.
384 * @param bool $show Whether to show the password fields. Default true.
386 if ( apply_filters( 'show_password_fields', true ) ) : ?>
387 <tr class="form-field form-required">
388 <th scope="row"><label for="pass1"><?php _e('Password'); ?> <span class="description"><?php /* translators: password input field */_e('(required)'); ?></span></label></th>
390 <input class="hidden" value=" " /><!-- #24364 workaround -->
391 <input name="pass1" type="password" id="pass1" autocomplete="off" />
394 <tr class="form-field form-required">
395 <th scope="row"><label for="pass2"><?php _e('Repeat Password'); ?> <span class="description"><?php /* translators: password input field */_e('(required)'); ?></span></label></th>
397 <input name="pass2" type="password" id="pass2" autocomplete="off" />
399 <div id="pass-strength-result"><?php _e('Strength indicator'); ?></div>
400 <p class="description indicator-hint"><?php _e('Hint: The password should be at least seven characters long. To make it stronger, use upper and lower case letters, numbers, and symbols like ! " ? $ % ^ & ).'); ?></p>
404 <th scope="row"><label for="send_password"><?php _e('Send Password?') ?></label></th>
405 <td><label for="send_password"><input type="checkbox" name="send_password" id="send_password" value="1" <?php checked( $new_user_send_password ); ?> /> <?php _e('Send this password to the new user by email.'); ?></label></td>
408 <?php } // !is_multisite ?>
409 <tr class="form-field">
410 <th scope="row"><label for="role"><?php _e('Role'); ?></label></th>
411 <td><select name="role" id="role">
413 if ( !$new_user_role )
414 $new_user_role = !empty($current_role) ? $current_role : get_option('default_role');
415 wp_dropdown_roles($new_user_role);
420 <?php if ( is_multisite() && is_super_admin() ) { ?>
422 <th scope="row"><label for="noconfirmation"><?php _e('Skip Confirmation Email') ?></label></th>
423 <td><label for="noconfirmation"><input type="checkbox" name="noconfirmation" id="noconfirmation" value="1" <?php checked( $new_user_ignore_pass ); ?> /> <?php _e( 'Add the user without sending an email that requires their confirmation.' ); ?></label></td>
429 /** This action is documented in wp-admin/user-new.php */
430 do_action( 'user_new_form', 'add-new-user' );
433 <?php submit_button( __( 'Add New User '), 'primary', 'createuser', true, array( 'id' => 'createusersub' ) ); ?>
436 <?php } // current_user_can('create_users') ?>
439 include( ABSPATH . 'wp-admin/admin-footer.php' );