Switch branches/tags
Find file
Fetching contributors…
Cannot retrieve contributors at this time
138 lines (87 sloc) 5.25 KB
=== Multisite User Management ===
Contributors: thenbrent
Tags: multisite, buddypress, users, roles, multiuser
Requires at least: 3.0
Tested up to: 3.4.1
Stable tag: 1.1
License: GPLv2
Automatically add users to each site in your WordPress network.
== Description ==
Running a WordPress network? You no longer need to manually add new users to each of your sites.
With this plugin, users are assigned a default role for each of your sites. You set the default role for each site and this plugin applies it.
You can assign different roles for each site or keep a site private by assigning no role.
== Installation ==
1. Upload the entire `/multisite-user-management/` folder to the `/wp-content/plugins/` directory.
1. Activate the plugin.
1. Navigate to the **Multisite User Management** section of the *Network Admin > Settings > Network Settings* page. At `` this page would be found at ``.
1. Set default roles for each of your sites.
== Frequently Asked Questions ==
= Does the plugin require a multisite installation? =
Yes, WordPress takes care of the default role on non-multisite installations.
= Where do I find the settings section =
The **Multisite User Management** section is near the bottom of the the *Network Admin > Settings > Network Settings* page.
For `` this page would be found at ``.
= Why aren't all my sites listed on the options page? =
Any sites archived or deleted will not appear. All others sites will appear.
If you do not see your sites, be sure you are looking at the *Network Settings* Page found at `/wp-admin/network/settings.php` not a single site settings, found at `/wp-admin/settings.php`.
= Does this plugin assign the default role to existing users? =
Yes, existing users will receive the default role. If you change the default role, all of your users with the old default role will receive the new default role.
= Will these roles be allocated to new users registering with a new site? =
Yes, users registering with a site will receive all the existing default roles.
The new site will not have a default role until it is manually set. Once set, all existing users will receive that role for the new site.
= Why aren't my users allocated the role and showing up on all sites? =
Sometimes magic happens.
To re-apply a role to all users on all sites, you must:
1. Change the default role for every site listed in the settings page (even if the role is set to the role you want for that site, change it just for now). Every role must be different.
1. Save the settings.
1. If any of the roles are set to something other than the role you want, change the role to the one you want.
1. Save the settings.
All users in your database should now be assigned a role for all sites.
= Where can I report bugs? =
Add a new topic on the [WordPress Support Forum](
== Screenshots ==
1. **Network Admin Settings** - Super admins can choose the default role for each site.
== Changelog ==
= 1.1 =
* The msum_add_roles() function is now called on vanilla "user_register" hook so that it should work with all plugins that use the standard WP User registration API, not just WP Network/Multisite plugins
* Updating use of deprecated `get_userdatabylogin()` to new `get_user_by( 'login' )`
= 1.0 =
* Hooking the `msum_add_roles()` function to the `wpmu_new_user` action.
= 0.8 =
* No longer using deprecated get_blog_list function anywhere
= 0.7 =
* Can now assign roles for mature sites and sites with search engines blocked.
* No longer using deprecated get_blog_list function
= 0.6 =
* Role now added for dashboard site as 3.1 assigns no role for any site
* bbPress registration now supported.
* New tags, including BuddyPress.
= 0.5 =
* Roles now assigned on login. Plugin can now live in the wp-content/plugins directory.
= 0.4 =
* Fixed bug: original site did not restore when old role was the same as new role.
= 0.3 =
* Fixed bug found when updating WPMU options page with no MSUM set.
= 0.2 =
* Default roles now assigned to existing users
* New users registering with a blog are now assigned default roles for existing sites
* Fixed bugs affecting dashboad default role and activation when some sites had no default role
= 0.1 =
* Initial release.
== Upgrade Notice ==
= 1.1 =
Optional Upgrade: Improved compatibility with plugins designed for standard WordPress sites (not just Network/Multisite WordPress installs)
= 1.0 =
Optional Upgrade: only upgrade if you are adding a large number of new users manually.
= 0.8 =
Optional Upgrade: only upgrade if you want to assign a role for a blog marked mature or with search engines blocked.
= 0.7 =
Optional Upgrade: you only need to upgrade if you want to assign a role for a blog marked mature or with search engines blocked.
= 0.6 =
Important upgrade for WordPress 3.1. You can now assign a role for the dashboard site.
= 0.5 =
Important upgrade. You can now install MSUM in the default wp-content/plugins folder. This makes it easier to install and keep track of updates.
= 0.4 =
Upgrade to fix bug found when saving options page without changing roles.
= 0.3 =
Important upgrade to fix bug found when saving options page with no multisite user management option.