├── lang
    ├── add_users.mo
    └── add_users.po
├── uninstall.php
├── .gitmodules
├── sql.txt
├── changelog.txt
├── README.md
└── add-existing-users.php


/lang/add_users.mo:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/wpmudev/add-existing-users/master/lang/add_users.mo


--------------------------------------------------------------------------------
/uninstall.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | if( !defined( 'WP_UNINSTALL_PLUGIN' ) )
4 | 	exit ();
5 | 
6 | delete_site_option( ' add_users_version' );
7 | 


--------------------------------------------------------------------------------
/.gitmodules:
--------------------------------------------------------------------------------
1 | [submodule "dash-notice"]
2 | 	path = dash-notice
3 | 	url = git@bitbucket.org:incsub/wpmudev-dashboard-notification.git
4 | 	branch = master
5 | 


--------------------------------------------------------------------------------
/sql.txt:
--------------------------------------------------------------------------------
 1 | CREATE TABLE IF NOT EXISTS `wp_add_users_queue` (
 2 |   `add_users_ID` bigint(20) unsigned NOT NULL auto_increment,
 3 |   `add_users_site_ID` bigint(20),
 4 |   `add_users_blog_ID` bigint(20),
 5 |   `add_users_batch_ID` varchar(255),
 6 |   `add_users_user_email` varchar(255),
 7 |   `add_users_user_role` varchar(255),
 8 |   PRIMARY KEY  (`add_users_ID`)
 9 | ) ENGINE=MyISAM;
10 | 


--------------------------------------------------------------------------------
/changelog.txt:
--------------------------------------------------------------------------------
 1 | Plugin Name: Add Existing Users
 2 | Author: WPMUDEV
 3 | 
 4 | Change Log:
 5 | ----------------------------------------------------------------------
 6 | ----------------------------------------------------------------------
 7 | 
 8 | 1.2.1 - 2014-03-04
 9 | ----------------------------------------------------------------------
10 | - Fixed capability issue for Administrators
11 | 
12 | 1.2 - 2014-01-10
13 | ----------------------------------------------------------------------
14 | - Completely recoded.
15 | - Table dropped. Users are added instantly.
16 | - Better WP UI integration.
17 | - Other fixes.
18 | 
19 | 1.1.1 - 02/24/2011
20 | ----------------------------------------------------------------------
21 | - Enhancement: compatibility with WordPress 3.1
22 | - Enhancement: internationalization
23 | 


--------------------------------------------------------------------------------
/lang/add_users.po:
--------------------------------------------------------------------------------
 1 | msgid ""
 2 | msgstr ""
 3 | "Project-Id-Version: Add Existing Users\n"
 4 | "Report-Msgid-Bugs-To: \n"
 5 | "POT-Creation-Date: 2014-01-07 15:53+0100\n"
 6 | "PO-Revision-Date: 2014-01-07 15:53+0100\n"
 7 | "Last-Translator: Ignacio <igmoweb@gmail.com>\n"
 8 | "Language-Team: \n"
 9 | "MIME-Version: 1.0\n"
10 | "Content-Type: text/plain; charset=UTF-8\n"
11 | "Content-Transfer-Encoding: 8bit\n"
12 | "X-Poedit-KeywordsList: _;gettext;gettext_noop;__;_e\n"
13 | "X-Poedit-Basepath: .\n"
14 | "X-Poedit-SearchPath-0: ..\n"
15 | 
16 | #: ../add-existing-users.php:135
17 | #: ../add-existing-users.php:201
18 | msgid "Add Existing Users"
19 | msgstr ""
20 | 
21 | #: ../add-existing-users.php:176
22 | msgid "Users have been added."
23 | msgstr ""
24 | 
25 | #: ../add-existing-users.php:202
26 | msgid "This tool allows you to create existing users on this site to your blog."
27 | msgstr ""
28 | 
29 | #: ../add-existing-users.php:206
30 | #, php-format
31 | msgid "To add new users that have not already been created, please use the <a href=\"%s\">Add New Users functionality here</a>."
32 | msgstr ""
33 | 
34 | #: ../add-existing-users.php:210
35 | #, php-format
36 | msgid "To add users simply enter each user's email and select a role for them on this blog - you can find out more about different levels of access for different roles <a href=\"%s\">here</a>."
37 | msgstr ""
38 | 
39 | #: ../add-existing-users.php:220
40 | msgid "User Email"
41 | msgstr ""
42 | 
43 | #: ../add-existing-users.php:223
44 | msgid "Required"
45 | msgstr ""
46 | 
47 | #: ../add-existing-users.php:231
48 | msgid "User Role"
49 | msgstr ""
50 | 
51 | #: ../add-existing-users.php:241
52 | msgid "Submit"
53 | msgstr ""
54 | 
55 | #: ../add-existing-users.php:243
56 | msgid "This may take some time so please be patient."
57 | msgstr ""
58 | 
59 | #: ../add-existing-users.php:289
60 | #, php-format
61 | msgid "The user with email address <strong>%s</strong> could not be found"
62 | msgstr ""
63 | 
64 | #: ../add-existing-users.php:305
65 | #, php-format
66 | msgid "Email <strong>%s</strong> is not a valid one"
67 | msgstr ""
68 | 
69 | #: ../add-existing-users.php:315
70 | msgid "No data to process"
71 | msgstr ""
72 | 
73 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Add Existing Users
 2 | 
 3 | 
 4 | **INACTIVE NOTICE: This plugin is unsupported by WPMUDEV, we've published it here for those technical types who might want to fork and maintain it for their needs.**
 5 | 
 6 | ## Translations
 7 | 
 8 | Translation files can be found at https://github.com/wpmudev/translations
 9 | 
10 | ## About
11 | 
12 | Add existing users lets you quickly bulk add existing users to any site on your network.
13 | 
14 | Adding existing users to a site is now as simple as entering the email address attached to their existing username and selecting the level of access you want to grant them. Use nice simple forms, so it can be easily used by anyone. 
15 | 
16 | ![Add Existing users panel](http://premium.wpmudev.org/wp-content/uploads/2011/02/addexist64.jpg)
17 | 
18 |  Simple forms easy for everyone
19 | 
20 | Perfect for importing multiple existing users into new and existing sites.
21 | 
22 | ## Usage
23 | 
24 | Start by reading [Installing plugins](../wpmu-manual/installing-regular-plugins-on-wpmu/) section in our comprehensive [WordPress and WordPress Multisite Manual](https://premium.wpmudev.org/manuals/wpmu-manual-2/) if you are new to WordPress.
25 | 
26 | ### To install:
27 | 
28 | 1.  Download the plugin file 
29 | 
30 | 2.  Unzip the file into a folder on your hard drive 
31 | 
32 | 3.  Upload **/add-existing-users/** folder to **/wp-content/plugins/** folder on your site 
33 | 
34 | 4.  Login to your admin panel for WordPress Multisite 
35 | 
36 | 5.  Visit **Network Admin -> Plugins** and **Network Activate** the plugin. **That's it! No configuration necessary!**
37 | 
38 | ### To use:
39 | 
40 | A new menu item called **Add Existing Users** should appear under the **Users** navigation menu in the site admin dashboard. It is designed for quickly adding existing users to a site in batches of up to 15 users. Use [Add New Users plugin](https://premium.wpmudev.org/project/add-new-users) if you want to create and add new users in batches of up to 15 users _Please note:_
41 | 
42 | *   The users are immediately added to the site and automatically listed as users on the**Users** page.
43 | *   They can only access features in the site’s administration panel based on the role they've been assigned
44 | *   Spam filters, especially strict ones for institutional email addresses, often block the emails that the login details.  If unsure use free webmail accounts such as gmail, hotmail that don’t block these invitation emails.
45 | 
46 | **To add the existing users, administrators simply enter:**
47 | 
48 | 1.  The email address attached to their existing username
49 | 2.  Assign their role - you can find out more about different [levels of access here](https://premium.wpmudev.org/wpmu-manual/introduction-to-super-admin-user/).
50 | 3.  Once added they'll be sent an email with their login details -- their password will be blank since they just need to use their existing password
51 | 
52 | ![Adding existing users to a site](https://premium.wpmudev.org/wp-content/uploads/2011/02/addexist63.jpg)
53 | 
54 | 
55 | 


--------------------------------------------------------------------------------
/add-existing-users.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | /*
  3 | Plugin Name: Add Existing Users
  4 | Plugin URI:
  5 | Description: Allows you to bulk add existing users to a site, including the facility to set their role.
  6 | Author: WPMU DEV
  7 | Version: 1.2.1
  8 | Text Domain: add_users
  9 | Author URI: http://premium.wpmudev.org
 10 | WDP ID: 175
 11 | */
 12 | 
 13 | /**
 14 |  * Main plugin class
 15 |  *
 16 |  **/
 17 | class Incsub_Add_Users {
 18 | 
 19 | 	/**
 20 | 	 * Language domain
 21 | 	 */
 22 | 	var $lang_domain = 'add_users';
 23 | 
 24 | 	/**
 25 | 	 * Current version number
 26 | 	 *
 27 | 	 **/
 28 | 	var $current_version = '1.2.1';
 29 | 
 30 | 	/**
 31 | 	 * Version slug for options table
 32 | 	 */
 33 | 	var $version_option_slug = 'add_users_version';
 34 | 
 35 | 	/**
 36 | 	 * For Pro Sites Only only
 37 | 	 *
 38 | 	 **/
 39 | 	var $pro_site_only; // Either true OR false (set in __construct() )
 40 | 
 41 | 	/**
 42 | 	 * Number of field sets to display
 43 | 	 *
 44 | 	 **/
 45 | 	var $fields = '';
 46 | 
 47 | 	/**
 48 | 	 * Menu slug
 49 | 	 */
 50 | 	var $menu_slug = 'add-existing-users';
 51 | 
 52 | 	/**
 53 | 	 * Save the errors that occurs in the form
 54 | 	 */
 55 | 	var $form_errors = array();
 56 | 	
 57 | 
 58 | 	/**
 59 | 	 * Constructor
 60 | 	 *
 61 | 	 **/
 62 | 	function __construct() {
 63 | 		global $wpdb;
 64 | 
 65 | 		if ( ! defined( 'ADD_EXISTING_USERS_PRO_SITES_ONLY' ) )
 66 | 			$this->pro_site_only = false;
 67 | 		else
 68 | 			$this->pro_site_only = ADD_EXISTING_USERS_PRO_SITES_ONLY;
 69 | 
 70 | 		// get number of field sets
 71 | 		$this->fields = isset( $_GET['fields'] ) ? $_GET['fields'] : '';
 72 | 
 73 | 		// default to 15 field sets
 74 | 		if ( $this->fields == '' )
 75 | 			$this->fields = 10;
 76 | 
 77 | 		// no more than 50 fields sets
 78 | 		if ( $this->fields > 50 )
 79 | 			$this->fields = 50;
 80 | 
 81 | 		global $wpmudev_notices;
 82 | 		$wpmudev_notices[] = array( 'id'=> 175,'name'=> 'Add Existing Users', 'screens' => array( 'users_page_add-existing-users' ) );
 83 | 		include_once( plugin_dir_path( __FILE__ ) . 'externals/wpmudev-dash-notification.php' );
 84 | 
 85 | 		// add admin menu page
 86 | 		add_action( 'admin_menu', array( &$this, 'plug_pages' ) );
 87 | 
 88 | 		// Load text domain
 89 | 		add_action( 'plugins_loaded', array( &$this, 'load_text_domain' ) );
 90 | 
 91 | 		// Need upgrade?
 92 | 		add_action( 'init', array( &$this, 'maybe_upgrade' ) );
 93 | 
 94 | 		register_activation_hook( __FILE__, array( &$this, 'activate' ) );
 95 | 
 96 | 	}
 97 | 
 98 | 	/**
 99 | 	 * Load the plugin text domain and MO files
100 | 	 * 
101 | 	 * These can be uploaded to the main WP Languages folder
102 | 	 * or the plugin one
103 | 	 */
104 | 	public function load_text_domain() {
105 | 		$locale = apply_filters( 'plugin_locale', get_locale(), $this->lang_domain );
106 | 
107 | 		load_textdomain( $this->lang_domain, WP_LANG_DIR . '/' . $this->lang_domain . '/' . $this->lang_domain . '-' . $locale . '.mo' );
108 | 		load_plugin_textdomain( $this->lang_domain, false, dirname( plugin_basename( __FILE__ ) ) . '/lang/' );
109 | 	}
110 | 
111 | 	public function activate() {
112 | 		update_site_option( $this->version_option_slug, $this->current_version );
113 | 	}
114 | 
115 | 	/**
116 | 	 * Manage the plugin upgrades
117 | 	 */
118 | 	public function maybe_upgrade() {
119 | 		$current_version = get_site_option( $this->version_option_slug, '1.0' );
120 | 
121 | 		if ( version_compare( $current_version, '1.1.1', '<=' ) ) {
122 | 			global $wpdb;
123 | 			$table = $wpdb->base_prefix . 'add_users_queue';
124 | 			$wpdb->query( "DROP TABLE $table" );
125 | 			update_site_option( $this->version_option_slug, $this->current_version );
126 | 		}
127 | 	}
128 | 
129 | 
130 | 	/**
131 | 	 * Add admin menu
132 | 	 *
133 | 	 **/
134 | 	function plug_pages() {
135 | 		$this->page_id = add_submenu_page( 'users.php', __( 'Add Existing Users', $this->lang_domain ), __( 'Add Existing Users', $this->lang_domain ), 'manage_options', $this->menu_slug, array( &$this, 'page_output' ) );
136 | 		add_action( 'load-' . $this->page_id, array( &$this, 'sanitize_form' ) );
137 | 	}
138 | 
139 | 	/**
140 | 	 * Check if current blog is a Pro Site blog
141 | 	 *
142 | 	 **/
143 | 	function is_pro_site() {
144 | 		if ( function_exists( 'is_pro_site' ) )
145 | 			return is_pro_site();
146 | 
147 | 		return false;
148 | 	}
149 | 
150 | 	/**
151 | 	 * Display plugin admin page
152 | 	 *
153 | 	 **/
154 | 	function page_output() {
155 | 		global $wpdb, $wp_roles;
156 | 
157 | 		// display error message if Pro Site only
158 | 		if ( ! $this->is_pro_site() &&  $this->pro_site_only ) {
159 | 			global $psts;
160 | 			if ( is_object( $psts ) )
161 | 				$psts->feature_notice();
162 | 			return;
163 | 		}
164 | 
165 | 		$fields = ! empty( $_GET['fields'] ) ? $_GET['fields'] : '';
166 | 		$form_url = add_query_arg( 
167 | 			array( 
168 | 				'fields' => $fields,
169 | 				'action' => 'process'
170 | 			)
171 | 		);
172 | 
173 | 		// display message when successful
174 | 		if ( isset( $_GET['updated'] ) ) {
175 | 			?>
176 | 				<div class="updated fade"><p><?php _e( 'Users have been added.', $this->lang_domain ); ?></p></div>
177 | 			<?php
178 | 		}
179 | 
180 | 		if ( ! empty( $this->form_errors ) ) {
181 | 			if ( isset( $this->form_errors['no_data'] ) ) {
182 | 				?>
183 | 					<div class="error"><p><?php echo $this->form_errors['no_data']->get_error_message(); ?></p></div>
184 | 				<?php
185 | 			}
186 | 			else {
187 | 				?>
188 | 					<div class="error">
189 | 						<ul>
190 | 							<?php foreach ( $this->form_errors as $key => $error ): ?>
191 | 								<li><?php echo $error->get_error_message(); ?></li>
192 | 							<?php endforeach; ?>
193 | 						</ul>
194 | 					</div>
195 | 				<?php
196 | 			}
197 | 		}
198 | 			
199 | 		?>
200 | 		<div class="wrap">
201 | 			<h2><?php _e( 'Add Existing Users', $this->lang_domain  ); ?></h2>
202 | 			<p><?php _e( 'This tool allows you to add existing users on this site to your blog.', $this->lang_domain  ); ?></p>
203 | 
204 | 			<?php if ( class_exists( 'Add_New_Users' ) ): ?>
205 | 				<?php $add_new_users_url = add_query_arg( 'page', 'add-new-users', admin_url( 'users.php' ) ); ?>
206 | 				<p><?php printf( __( 'To add new users that have not already been created, please use the <a href="%s">Add New Users functionality here</a>.', $this->lang_domain ), $add_new_users_url ); ?></p>
207 | 			<?php endif; ?>
208 | 			
209 | 			<?php $help_url = 'http://help.edublogs.org/2009/08/24/what-are-the-different-roles-of-users/'; ?>
210 | 			<p><?php printf( __( 'To add users simply enter each user\'s email and select a role for them on this blog - you can find out more about different levels of access for different roles <a href="%s">here</a>.', $this->lang_domain ), $help_url ); ?></p>
211 | 
212 | 			<form name='form1' method='POST' action='<?php echo $form_url; ?>'>
213 | 				<?php wp_nonce_field( 'add-users-process_new_users' ); ?>
214 | 
215 | 				<?php for ( $counter = 1; $counter <= $this->fields; $counter += 1 ): ?>
216 | 					<?php $user_email = ! empty( $_POST['user_email_' . $counter] ) ? $_POST['user_email_' . $counter] : ''; ?>
217 | 					<h3><?php echo $counter . ':' ?></h3>
218 | 					<table class="form-table">
219 | 						<tr valign="top">
220 | 							<th scope="row"><?php _e( 'User Email', $this->lang_domain ) ?></th>
221 | 							<td>
222 | 								<input type="text" name="user_email_<?php echo $counter; ?>" id="user_email_<?php echo $counter; ?>" class="medium-text" value="<?php echo esc_attr( $user_email ); ?>" />
223 | 								<span class="description"> <?php _e( 'Required', $this->lang_domain ) ?></span>
224 | 								<?php if ( isset( $this->form_errors[ 'user_email_' . $counter ] ) ): ?>
225 | 									<br/><span style="color:red"><?php echo $this->form_errors[ 'user_email_' . $counter ]->get_error_message(); ?></span>
226 | 								<?php endif; ?>
227 | 							</td>
228 | 						</tr>
229 | 
230 | 						<tr valign="top">
231 | 							<th scope="row"><?php _e( 'User Role', $this->lang_domain ) ?></th>
232 | 							<td>
233 | 								<select name="user_role_<?php echo $counter; ?>">
234 | 									<?php wp_dropdown_roles(); ?>
235 |  								</select>
236 |  							</td>
237 | 						</tr>
238 | 					</table>
239 | 				<?php endfor; ?>
240 | 					
241 | 				<?php submit_button( __( 'Submit', $this->lang_domain ), 'primary', 'process-users-submit' ); ?>
242 | 			
243 | 				<p style="text-align:right;"><?php _e( 'This may take some time so please be patient.', $this->lang_domain ) ?></p>
244 | 			</form>
245 | 		</div>
246 | 			<?php
247 | 	}
248 | 
249 | 	function sanitize_form() {
250 | 		$action = isset( $_GET[ 'action' ] ) ? $_GET[ 'action' ] : '';
251 | 
252 | 		if ( empty( $action ) )
253 | 			return;
254 | 
255 | 		if ( $action == 'process' && isset( $_POST['process-users-submit'] ) ) {
256 | 			
257 | 			check_admin_referer( 'add-users-process_new_users' );
258 | 
259 | 			if ( isset( $_POST['Cancel'] ) ) {
260 | 				$cancel_url = add_query_arg( 'page', $this->menu_slug, admin_url( 'users.php' ) );
261 | 				wp_redirect( $cancel_url );
262 | 				exit;
263 | 			}
264 | 
265 | 			$batch_ID = md5( $wpdb->blogid . time() . '0420i203zm' );
266 | 			$errors = '';
267 | 			$error_fields = '';
268 | 			$error_messages = '';
269 | 			$global_errors = 0;
270 | 			$add_users_items = array();
271 | 
272 | 			for ( $counter = 1; $counter <= $this->fields; $counter += 1 ) {
273 | 				$user_email = trim( stripslashes( $_POST['user_email_' . $counter] ) );
274 | 
275 | 				if ( empty( $user_email ) )
276 | 					continue;
277 | 
278 | 				$user_role = stripslashes( $_POST['user_role_' . $counter] );
279 | 				$error = false;
280 | 				$error_field = '';
281 | 				$error_msg = '';
282 | 
283 | 				if ( is_email( $user_email ) ) {
284 | 					$user = get_user_by( 'email', $user_email );
285 | 					if ( ! $user ) {
286 | 						$error = true;
287 | 						$this->form_errors[ 'user_email_' . $counter ] = new WP_Error( 
288 | 							'user_email_' . $counter, 
289 | 							sprintf( __( 'The user with email address <strong>%s</strong> could not be found', $this->lang_domain ), $user_email )
290 | 						);
291 | 					}
292 | 
293 | 					if ( ! $error ) {
294 | 						$add_users_items[ $counter ] = array(
295 | 							'user_email' => $user_email,
296 | 							'user_role' => $user_role
297 | 						);
298 | 					}
299 | 
300 | 				}
301 | 				else {
302 | 					$error = true;
303 | 					$this->form_errors[ 'user_email_' . $counter ] = new WP_Error( 
304 | 						'user_email_' . $counter, 
305 | 						sprintf( __( 'Email <strong>%s</strong> is not a valid one', $this->lang_domain ), $user_email )
306 | 					);
307 | 				}
308 | 			}
309 | 
310 | 			if ( count( $this->form_errors ) == 0 ) {
311 | 
312 | 				if ( empty( $add_users_items ) ) {
313 | 					$this->form_errors['no_data'] = new WP_Error( 
314 | 						'no_data', 
315 | 						__( 'No data to process', $this->lang_domain )
316 | 					);
317 | 					return false;
318 | 				}
319 | 
320 | 				foreach( $add_users_items as $add_users_item ) {
321 | 					$user = get_user_by( 'email', $add_users_item['user_email'] );
322 | 					add_user_to_blog( get_current_blog_id(), $user->ID, $add_users_item['user_role'] );
323 | 				}
324 | 
325 | 				$redirect_to = add_query_arg( 
326 | 					array( 
327 | 						'page' => $this->menu_slug,
328 | 						'updated' => 'true',
329 | 					),
330 | 					admin_url( 'users.php' ) 
331 | 				);
332 | 				wp_redirect( $redirect_to );
333 | 				exit;
334 | 			}
335 | 		}
336 | 	}
337 | 
338 | }
339 | 
340 | global $incsub_add_users;
341 | $incsub_add_users = new Incsub_Add_Users;
342 | 


--------------------------------------------------------------------------------