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' ) ) {
15 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
16 '<p>' . __( 'Sorry, you are not allowed to add users to this network.' ) . '</p>',
20 } elseif ( ! current_user_can( 'create_users' ) ) {
22 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
23 '<p>' . __( 'Sorry, you are not allowed to create users.' ) . '</p>',
28 if ( is_multisite() ) {
29 add_filter( 'wpmu_signup_user_notification_email', 'admin_created_user_email' );
32 if ( isset($_REQUEST['action']) && 'adduser' == $_REQUEST['action'] ) {
33 check_admin_referer( 'add-user', '_wpnonce_add-user' );
36 $user_email = wp_unslash( $_REQUEST['email'] );
37 if ( false !== strpos( $user_email, '@' ) ) {
38 $user_details = get_user_by( 'email', $user_email );
40 if ( is_super_admin() ) {
41 $user_details = get_user_by( 'login', $user_email );
43 wp_redirect( add_query_arg( array('update' => 'enter_email'), 'user-new.php' ) );
48 if ( !$user_details ) {
49 wp_redirect( add_query_arg( array('update' => 'does_not_exist'), 'user-new.php' ) );
53 if ( ! current_user_can( 'promote_user', $user_details->ID ) ) {
55 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
56 '<p>' . __( 'Sorry, you are not allowed to add users to this network.' ) . '</p>',
61 // Adding an existing user to this blog
62 $new_user_email = $user_details->user_email;
63 $redirect = 'user-new.php';
64 $username = $user_details->user_login;
65 $user_id = $user_details->ID;
66 if ( ( $username != null && !is_super_admin( $user_id ) ) && ( array_key_exists($blog_id, get_blogs_of_user($user_id)) ) ) {
67 $redirect = add_query_arg( array('update' => 'addexisting'), 'user-new.php' );
69 if ( isset( $_POST[ 'noconfirmation' ] ) && current_user_can( 'manage_network_users' ) ) {
70 add_existing_user_to_blog( array( 'user_id' => $user_id, 'role' => $_REQUEST[ 'role' ] ) );
71 $redirect = add_query_arg( array( 'update' => 'addnoconfirmation' , 'user_id' => $user_id ), 'user-new.php' );
73 $newuser_key = substr( md5( $user_id ), 0, 5 );
74 add_option( 'new_user_' . $newuser_key, array( 'user_id' => $user_id, 'email' => $user_details->user_email, 'role' => $_REQUEST[ 'role' ] ) );
76 $roles = get_editable_roles();
77 $role = $roles[ $_REQUEST['role'] ];
80 * Fires immediately after a user is invited to join a site, but before the notification is sent.
84 * @param int $user_id The invited user's ID.
85 * @param array $role The role of invited user.
86 * @param string $newuser_key The key of the invitation.
88 do_action( 'invite_user', $user_id, $role, $newuser_key );
90 $switched_locale = switch_to_locale( get_user_locale( $user_details ) );
92 /* translators: 1: Site name, 2: site URL, 3: role, 4: activation URL */
95 You\'ve been invited to join \'%1$s\' at
96 %2$s with the role of %3$s.
98 Please click the following link to confirm the invite:
100 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/" ) ) );
102 if ( $switched_locale ) {
103 restore_previous_locale();
106 $redirect = add_query_arg( array('update' => 'add'), 'user-new.php' );
109 wp_redirect( $redirect );
111 } elseif ( isset($_REQUEST['action']) && 'createuser' == $_REQUEST['action'] ) {
112 check_admin_referer( 'create-user', '_wpnonce_create-user' );
114 if ( ! current_user_can( 'create_users' ) ) {
116 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
117 '<p>' . __( 'Sorry, you are not allowed to create users.' ) . '</p>',
122 if ( ! is_multisite() ) {
123 $user_id = edit_user();
125 if ( is_wp_error( $user_id ) ) {
126 $add_user_errors = $user_id;
128 if ( current_user_can( 'list_users' ) )
129 $redirect = 'users.php?update=add&id=' . $user_id;
131 $redirect = add_query_arg( 'update', 'add', 'user-new.php' );
132 wp_redirect( $redirect );
136 // Adding a new user to this site
137 $new_user_email = wp_unslash( $_REQUEST['email'] );
138 $user_details = wpmu_validate_user_signup( $_REQUEST['user_login'], $new_user_email );
139 if ( is_wp_error( $user_details[ 'errors' ] ) && !empty( $user_details[ 'errors' ]->errors ) ) {
140 $add_user_errors = $user_details[ 'errors' ];
143 * Filters the user_login, also known as the username, before it is added to the site.
147 * @param string $user_login The sanitized username.
149 $new_user_login = apply_filters( 'pre_user_login', sanitize_user( wp_unslash( $_REQUEST['user_login'] ), true ) );
150 if ( isset( $_POST[ 'noconfirmation' ] ) && current_user_can( 'manage_network_users' ) ) {
151 add_filter( 'wpmu_signup_user_notification', '__return_false' ); // Disable confirmation email
152 add_filter( 'wpmu_welcome_user_notification', '__return_false' ); // Disable welcome email
154 wpmu_signup_user( $new_user_login, $new_user_email, array( 'add_to_blog' => $wpdb->blogid, 'new_role' => $_REQUEST['role'] ) );
155 if ( isset( $_POST[ 'noconfirmation' ] ) && current_user_can( 'manage_network_users' ) ) {
156 $key = $wpdb->get_var( $wpdb->prepare( "SELECT activation_key FROM {$wpdb->signups} WHERE user_login = %s AND user_email = %s", $new_user_login, $new_user_email ) );
157 $new_user = wpmu_activate_signup( $key );
158 if ( is_wp_error( $new_user ) ) {
159 $redirect = add_query_arg( array( 'update' => 'addnoconfirmation' ), 'user-new.php' );
161 $redirect = add_query_arg( array( 'update' => 'addnoconfirmation', 'user_id' => $new_user['user_id'] ), 'user-new.php' );
164 $redirect = add_query_arg( array('update' => 'newuserconfirmation'), 'user-new.php' );
166 wp_redirect( $redirect );
172 $title = __('Add New User');
173 $parent_file = 'users.php';
176 if ( is_multisite() && current_user_can('promote_users') && current_user_can('create_users') )
179 $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>';
181 if ( is_multisite() ) {
182 $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>' .
183 '<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>';
185 $help .= '<p>' . __('New users are automatically assigned a password, which they can change after logging in. You can view or edit the assigned password by clicking the Show Password button. The username cannot be changed once the user has been added.') . '</p>' .
187 '<p>' . __('By default, new users will receive an email letting them know they’ve been added as a user for your site. This email will also contain a password reset link. Uncheck the box if you don’t want to send the new user a welcome email.') . '</p>';
190 $help .= '<p>' . __('Remember to click the Add New User button at the bottom of this screen when you are finished.') . '</p>';
192 get_current_screen()->add_help_tab( array(
194 'title' => __('Overview'),
198 get_current_screen()->add_help_tab( array(
199 'id' => 'user-roles',
200 'title' => __('User Roles'),
201 'content' => '<p>' . __('Here is a basic overview of the different user roles and the permissions associated with each one:') . '</p>' .
203 '<li>' . __('Subscribers can read comments/comment/receive newsletters, etc. but cannot create regular site content.') . '</li>' .
204 '<li>' . __('Contributors can write and manage their posts but not publish posts or upload media files.') . '</li>' .
205 '<li>' . __('Authors can publish and manage their own posts, and are able to upload files.') . '</li>' .
206 '<li>' . __('Editors can publish posts, manage posts as well as manage other people’s posts, etc.') . '</li>' .
207 '<li>' . __('Administrators have access to all the administration features.') . '</li>' .
211 get_current_screen()->set_help_sidebar(
212 '<p><strong>' . __('For more information:') . '</strong></p>' .
213 '<p>' . __('<a href="https://codex.wordpress.org/Users_Add_New_Screen">Documentation on Adding New Users</a>') . '</p>' .
214 '<p>' . __('<a href="https://wordpress.org/support/">Support Forums</a>') . '</p>'
217 wp_enqueue_script('wp-ajax-response');
218 wp_enqueue_script( 'user-profile' );
221 * Filters whether to enable user auto-complete for non-super admins in Multisite.
225 * @param bool $enable Whether to enable auto-complete for non-super admins. Default false.
227 if ( is_multisite() && current_user_can( 'promote_users' ) && ! wp_is_large_network( 'users' )
228 && ( is_super_admin() || apply_filters( 'autocomplete_users_for_site_admins', false ) )
230 wp_enqueue_script( 'user-suggest' );
233 require_once( ABSPATH . 'wp-admin/admin-header.php' );
235 if ( isset($_GET['update']) ) {
237 if ( is_multisite() ) {
239 if ( ( isset( $_GET['user_id'] ) ) ) {
240 $user_id_new = absint( $_GET['user_id'] );
241 if ( $user_id_new ) {
242 $edit_link = esc_url( add_query_arg( 'wp_http_referer', urlencode( wp_unslash( $_SERVER['REQUEST_URI'] ) ), get_edit_user_link( $user_id_new ) ) );
246 switch ( $_GET['update'] ) {
247 case "newuserconfirmation":
248 $messages[] = __('Invitation email sent to new user. A confirmation link must be clicked before their account is created.');
251 $messages[] = __('Invitation email sent to user. A confirmation link must be clicked for them to be added to your site.');
253 case "addnoconfirmation":
254 if ( empty( $edit_link ) ) {
255 $messages[] = __( 'User has been added to your site.' );
257 /* translators: %s: edit page url */
258 $messages[] = sprintf( __( 'User has been added to your site. <a href="%s">Edit user</a>' ), $edit_link );
262 $messages[] = __('That user is already a member of this site.');
264 case "does_not_exist":
265 $messages[] = __('The requested user does not exist.');
268 $messages[] = __('Please enter a valid email address.');
272 if ( 'add' == $_GET['update'] )
273 $messages[] = __('User added.');
278 <h1 id="add-new-user"><?php
279 if ( current_user_can( 'create_users' ) ) {
280 _e( 'Add New User' );
281 } elseif ( current_user_can( 'promote_users' ) ) {
282 _e( 'Add Existing User' );
286 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
290 foreach ( $errors->get_error_messages() as $err )
291 echo "<li>$err</li>\n";
297 if ( ! empty( $messages ) ) {
298 foreach ( $messages as $msg )
299 echo '<div id="message" class="updated notice is-dismissible"><p>' . $msg . '</p></div>';
302 <?php if ( isset($add_user_errors) && is_wp_error( $add_user_errors ) ) : ?>
305 foreach ( $add_user_errors->get_error_messages() as $message )
306 echo "<p>$message</p>";
310 <div id="ajax-response"></div>
313 if ( is_multisite() ) {
315 echo '<h2 id="add-existing-user">' . __( 'Add Existing User' ) . '</h2>';
316 if ( !is_super_admin() ) {
317 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>';
318 $label = __('Email');
321 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>';
322 $label = __('Email or Username');
326 <form method="post" name="adduser" id="adduser" class="validate" novalidate="novalidate"<?php
328 * Fires inside the adduser form tag.
332 do_action( 'user_new_form_tag' );
334 <input name="action" type="hidden" value="adduser" />
335 <?php wp_nonce_field( 'add-user', '_wpnonce_add-user' ) ?>
337 <table class="form-table">
338 <tr class="form-field form-required">
339 <th scope="row"><label for="adduser-email"><?php echo $label; ?></label></th>
340 <td><input name="email" type="<?php echo $type; ?>" id="adduser-email" class="wp-suggest-user" value="" /></td>
342 <tr class="form-field">
343 <th scope="row"><label for="adduser-role"><?php _e('Role'); ?></label></th>
344 <td><select name="role" id="adduser-role">
345 <?php wp_dropdown_roles( get_option('default_role') ); ?>
349 <?php if ( current_user_can( 'manage_network_users' ) ) { ?>
351 <th scope="row"><?php _e( 'Skip Confirmation Email' ); ?></th>
353 <input type="checkbox" name="noconfirmation" id="adduser-noconfirmation" value="1" />
354 <label for="adduser-noconfirmation"><?php _e( 'Add the user without sending an email that requires their confirmation.' ); ?></label>
361 * Fires at the end of the new user form.
363 * Passes a contextual string to make both types of new user forms
364 * uniquely targetable. Contexts are 'add-existing-user' (Multisite),
365 * and 'add-new-user' (single site and network admin).
369 * @param string $type A contextual string specifying which type of new user form the hook follows.
371 do_action( 'user_new_form', 'add-existing-user' );
373 <?php submit_button( __( 'Add Existing User' ), 'primary', 'adduser', true, array( 'id' => 'addusersub' ) ); ?>
378 if ( current_user_can( 'create_users') ) {
380 echo '<h2 id="create-new-user">' . __( 'Add New User' ) . '</h2>';
382 <p><?php _e('Create a brand new user and add them to this site.'); ?></p>
383 <form method="post" name="createuser" id="createuser" class="validate" novalidate="novalidate"<?php
384 /** This action is documented in wp-admin/user-new.php */
385 do_action( 'user_new_form_tag' );
387 <input name="action" type="hidden" value="createuser" />
388 <?php wp_nonce_field( 'create-user', '_wpnonce_create-user' ); ?>
390 // Load up the passed data, else set to a default.
391 $creating = isset( $_POST['createuser'] );
393 $new_user_login = $creating && isset( $_POST['user_login'] ) ? wp_unslash( $_POST['user_login'] ) : '';
394 $new_user_firstname = $creating && isset( $_POST['first_name'] ) ? wp_unslash( $_POST['first_name'] ) : '';
395 $new_user_lastname = $creating && isset( $_POST['last_name'] ) ? wp_unslash( $_POST['last_name'] ) : '';
396 $new_user_email = $creating && isset( $_POST['email'] ) ? wp_unslash( $_POST['email'] ) : '';
397 $new_user_uri = $creating && isset( $_POST['url'] ) ? wp_unslash( $_POST['url'] ) : '';
398 $new_user_role = $creating && isset( $_POST['role'] ) ? wp_unslash( $_POST['role'] ) : '';
399 $new_user_send_notification = $creating && ! isset( $_POST['send_user_notification'] ) ? false : true;
400 $new_user_ignore_pass = $creating && isset( $_POST['noconfirmation'] ) ? wp_unslash( $_POST['noconfirmation'] ) : '';
403 <table class="form-table">
404 <tr class="form-field form-required">
405 <th scope="row"><label for="user_login"><?php _e('Username'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
406 <td><input name="user_login" type="text" id="user_login" value="<?php echo esc_attr( $new_user_login ); ?>" aria-required="true" autocapitalize="none" autocorrect="off" maxlength="60" /></td>
408 <tr class="form-field form-required">
409 <th scope="row"><label for="email"><?php _e('Email'); ?> <span class="description"><?php _e('(required)'); ?></span></label></th>
410 <td><input name="email" type="email" id="email" value="<?php echo esc_attr( $new_user_email ); ?>" /></td>
412 <?php if ( !is_multisite() ) { ?>
413 <tr class="form-field">
414 <th scope="row"><label for="first_name"><?php _e('First Name') ?> </label></th>
415 <td><input name="first_name" type="text" id="first_name" value="<?php echo esc_attr($new_user_firstname); ?>" /></td>
417 <tr class="form-field">
418 <th scope="row"><label for="last_name"><?php _e('Last Name') ?> </label></th>
419 <td><input name="last_name" type="text" id="last_name" value="<?php echo esc_attr($new_user_lastname); ?>" /></td>
421 <tr class="form-field">
422 <th scope="row"><label for="url"><?php _e('Website') ?></label></th>
423 <td><input name="url" type="url" id="url" class="code" value="<?php echo esc_attr( $new_user_uri ); ?>" /></td>
425 <tr class="form-field form-required user-pass1-wrap">
428 <?php _e( 'Password' ); ?>
429 <span class="description hide-if-js"><?php _e( '(required)' ); ?></span>
433 <input class="hidden" value=" " /><!-- #24364 workaround -->
434 <button type="button" class="button wp-generate-pw hide-if-no-js"><?php _e( 'Show password' ); ?></button>
435 <div class="wp-pwd hide-if-js">
436 <?php $initial_password = wp_generate_password( 24 ); ?>
437 <span class="password-input-wrapper">
438 <input type="password" name="pass1" id="pass1" class="regular-text" autocomplete="off" data-reveal="1" data-pw="<?php echo esc_attr( $initial_password ); ?>" aria-describedby="pass-strength-result" />
440 <button type="button" class="button wp-hide-pw hide-if-no-js" data-toggle="0" aria-label="<?php esc_attr_e( 'Hide password' ); ?>">
441 <span class="dashicons dashicons-hidden"></span>
442 <span class="text"><?php _e( 'Hide' ); ?></span>
444 <button type="button" class="button wp-cancel-pw hide-if-no-js" data-toggle="0" aria-label="<?php esc_attr_e( 'Cancel password change' ); ?>">
445 <span class="text"><?php _e( 'Cancel' ); ?></span>
447 <div style="display:none" id="pass-strength-result" aria-live="polite"></div>
451 <tr class="form-field form-required user-pass2-wrap hide-if-js">
452 <th scope="row"><label for="pass2"><?php _e( 'Repeat Password' ); ?> <span class="description"><?php _e( '(required)' ); ?></span></label></th>
454 <input name="pass2" type="password" id="pass2" autocomplete="off" />
458 <th><?php _e( 'Confirm Password' ); ?></th>
461 <input type="checkbox" name="pw_weak" class="pw-checkbox" />
462 <?php _e( 'Confirm use of weak password' ); ?>
467 <th scope="row"><?php _e( 'Send User Notification' ) ?></th>
469 <input type="checkbox" name="send_user_notification" id="send_user_notification" value="1" <?php checked( $new_user_send_notification ); ?> />
470 <label for="send_user_notification"><?php _e( 'Send the new user an email about their account.' ); ?></label>
473 <?php } // !is_multisite ?>
474 <tr class="form-field">
475 <th scope="row"><label for="role"><?php _e('Role'); ?></label></th>
476 <td><select name="role" id="role">
478 if ( !$new_user_role )
479 $new_user_role = !empty($current_role) ? $current_role : get_option('default_role');
480 wp_dropdown_roles($new_user_role);
485 <?php if ( is_multisite() && current_user_can( 'manage_network_users' ) ) { ?>
487 <th scope="row"><?php _e( 'Skip Confirmation Email' ); ?></th>
489 <input type="checkbox" name="noconfirmation" id="noconfirmation" value="1" <?php checked( $new_user_ignore_pass ); ?> />
490 <label for="noconfirmation"><?php _e( 'Add the user without sending an email that requires their confirmation.' ); ?></label>
497 /** This action is documented in wp-admin/user-new.php */
498 do_action( 'user_new_form', 'add-new-user' );
501 <?php submit_button( __( 'Add New User' ), 'primary', 'createuser', true, array( 'id' => 'createusersub' ) ); ?>
504 <?php } // current_user_can('create_users') ?>
507 include( ABSPATH . 'wp-admin/admin-footer.php' );