=== Allow Multiple Accounts === Contributors: coffee2code Donate link: http://coffee2code.com/donate Tags: multiple accounts, registration, email, e-mail, signup, account, user, users, restrictions, login, admin, debug, test, coffee2code, multisite, buddypress Requires at least: 3.1 Tested up to: 3.3 Stable tag: 2.6.2 Version: 2.6.2 Allow multiple user accounts to be created from the same email address. == Description == Allow multiple user accounts to be created from the same email address. By default, WordPress only allows a single user account to be associated with a specific email address. This plugin removes that restriction. An admin settings page (accessed via Users -> Multiple Accounts or via the Settings link next to the plugin on the Manage Plugins page) is also provided to allow only certain email addresses the ability to have multiple accounts (such as if you only want admins to have that ability). You may also specify a limit to the number of accounts an email address can have. The settings page for the plugin also provides a table listing all user accounts, grouped by the email address (see screenshot). Compatible with Multisite and BuddyPress as well. Links: [Plugin Homepage](http://coffee2code.com/wp-plugins/allow-multiple-accounts/) | [Plugin Directory Page](http://wordpress.org/extend/plugins/allow-multiple-accounts/) | [Author Homepage](http://coffee2code.com) == Installation == 1. Whether installing or updating, whether this plugin or any other, it is always advisable to back-up your data before starting 1. Unzip `allow-multiple-accounts.zip` inside the `/wp-content/plugins/` directory for your site (or install via the built-in WordPress plugin installer) 1. Activate the plugin through the 'Plugins' admin menu in WordPress 1. Go to the Users -> Multiple Accounts admin settings page (which you can also get to via the Settings link next to the plugin on the Manage Plugins page) and configure settings. On a Multisite install, go to My Sites -> Network Admin -> Users -> Multiple Accounts. == Screenshots == 1. A screenshot of the plugin's admin settings page. 2. A screenshot of a registration attempt failing due to exceeding the limit on the number of allowed multiple accounts. == Template Tags == The plugin provides three optional template tags for use in your theme templates. = Functions = * `<?php c2c_count_multiple_accounts( $email ); ?>` Returns a count of the number of users associated with the given email. * `<?php c2c_get_users_by_email( $email ); ?>` Returns the users associated with the given email. * `<?php c2c_has_multiple_accounts( $email ); ?>` Returns a boolean indicating if the given email is associated with more than one user account. = Arguments = * `$email` (string) An email address. == Frequently Asked Questions == = Why would I want to allow multiple accounts to be associated with one email address? = Maybe your site is one that doesn't mind if users can sign up for multiple accounts from the same email address, maybe for different identities. More likely, you as an admin, plugin developer, and/or theme developer would like to be able to create multiple accounts on a blog to test various permissions or just want to test the blog having numerous users and don't want to have to assign unique email addresses for each account. = Can I limit who can create multiple accounts for an email? = Yes. You can specify a limit on how many accounts can be created per email address. You can also explicitly list the email addresses which are allowed to create multiple accounts (useful for just allowing admins to have multiple accounts). = How does the plugin affect the "Lost your password?" feature? = The clearest method for resetting a forgotten password is to supply the username on the "Lost your password" form when prompted. If an email address is instead supplied on the form, WordPress will send an email to that address with reset information for the first account found associated with that address. If multiple accounts are associated with that email address, then the email will include a listing of all associated usernames. In order to reset the password for a specific account, go back to the forgotten password form and supply the desired username, or if the email that was sent happens to be for the account that needs the password reset, follow the instructions and link in the email. Bear in mind that the password reset email can be safely disregarded if it relates to an account that shouldn't be reset. = What if I allowed email addresses to create up to 5 accounts and some people did so. Then I lowered the limit to 2. What happens now that some email accounts exceed the current limit? = Nothing happens. The plugin does not do anything with existing accounts. Those email addresses will not be able to create new accounts because they exceed the current limits. = Is this Multisite compatible? = Yes. = Is this BuddyPress compatible? = Yes, for at least BuddyPress 1.2+ and 1.3+, and perhaps other versions. = In Multisite, why do I get this error message when trying to register for another account with an already used email address: "That email address has already been used. Please check your inbox for an activation email. It will become available in a couple of days if you do nothing." = If you're seeing that error then it means the email address used for the new registration matches one used by an account in the signups table. Basically, an account has been registered with that email address but have not been activated yet. Only one account can be in this registered-but-not-activated state per email address. Before that email address can be used for another account, you have to activate that pending account, delete the pending account from the signups table, or wait a couple of days until the pending account expires. = Why do I see this notice in my admin: "NOTE: Allow Multiple Accounts is not able to function as intended because another plugin has overridden the WordPress function `get_user_by()`" = You are using another plugin that has overridden WordPress's `get_user_by()` function, which this plugin needs to do itself in order to function as intended. (This is necessary due to the lack of any more direct methods within WordPress for achieving its goals.) You will have to find and disable the other plugin, or disable this plugin. == Filters == The plugin exposes three filters for hooking. Typically, customizations utilizing these hooks would be put into your active theme's functions.php file, or used by another plugin. = c2c_count_multiple_accounts (filter) = The 'c2c_count_multiple_accounts' hook allows you to use an alternative approach to safely invoke `c2c_count_multiple_accounts()` in such a way that if the plugin were deactivated or deleted, then your calls to the function won't cause errors in your site. Arguments: * same as for `c2c_count_multiple_accounts()` Example: Instead of: `<?php echo c2c_count_multiple_accounts( $email ); ?>` Do: `<?php echo apply_filters( 'c2c_count_multiple_accounts', $email ); ?>` = c2c_get_users_by_email (filter) = The 'c2c_get_users_by_email' hook allows you to use an alternative approach to safely invoke `c2c_get_users_by_email()` in such a way that if the plugin were deactivated or deleted, then your calls to the function won't cause errors in your site. Arguments: * same as for `c2c_get_users_by_email()` Example: Instead of: `<?php echo c2c_get_users_by_email( $email ); ?>` Do: `<?php echo apply_filters( 'c2c_get_users_by_email', $email ); ?>` = c2c_has_multiple_accounts (filter) = The 'c2c_has_multiple_accounts' hook allows you to use an alternative approach to safely invoke `c2c_has_multiple_accounts()` in such a way that if the plugin were deactivated or deleted, then your calls to the function won't cause errors in your site. Arguments: * same as for `c2c_has_multiple_accounts()` Example: Instead of: `<?php echo c2c_has_multiple_accounts( $email ); ?>` Do: `<?php echo apply_filters( 'c2c_has_multiple_accounts', $email ); ?>` == Changelog == = 2.6.2 = * Fix for WP 3.2.x to prevent warning notice unnecessarily appearing in admin = 2.6.1 = * Fix for WP 3.2.x (need to override get_user_by_email() again instead of get_user_by() - but just for WP < 3.3) = 2.6 = * Add/fix multisite support * Remove get_user_by_email() override function * Override get_user_by() to circumvent check for email existence * Show admin notice if unable to override get_user_by() * Update plugin framework to 033 * Remove support for 'c2c_allow_multiple_accounts' global * Note compatibility through WP 3.3+ * Change parent constructor invocation * Create 'lang' subdirectory and move .pot file into it * Regenerate .pot * Add more FAQs * Minor phpDoc reformatting * Add 'Domain Path' directive to top of main plugin file * Add link to plugin directory page to readme.txt * Tweak installation instructions in readme.txt * Update screenshots for WP 3.3 * Update copyright date (2012) = 2.5 = * Fix user listing error by adapting older user_row() into class function * Add support for BuddyPress * Add bp_members_validate_user_signup() * Fix has_exceeded_limit() to account for the account_limit applying to certain emails and not everyone * Fix to properly register activation and uninstall hooks * Add filters 'c2c_count_multiple_accounts', 'c2c_get_users_by_email', and 'c2c_has_multiple_accounts' to respond to the function of the same name so that users can use the apply_filters() notation for invoking template tags * Use get_users() rather than direct query * Remove Posts (which provided count of posts) from multi-account user listing table * Update plugin framework to 023 * Save a static version of itself in class variable $instance * Deprecate use of global variable $c2c_allow_multiple_accounts to store instance * In global space functions: use new class instance variable to access instance instead of using global * Rename class from 'AllowMultipleAccounts' to 'c2c_AllowMultipleAccounts' * Add __construct(), activation(), uninstall() * Note compatibility through WP 3.2+ * Drop support for versions of WP older than 3.1 * Add more FAQ questions * Call _deprecated_function() on deprecated functions to generate proper notices/warnings * Add filters section to readme.txt and document filters * Explicitly declare functions public * Minor code formatting changes (spacing) * Update copyright date (2011) * Add plugin homepage and author links in description in readme.txt = 2.0.1 = * Update plugin framework to C2C_Plugin_016 (fixes WP 2.9.2 compatibility issues) = 2.0 = * Fix compatibility with MU/Multi-site * Fix bug preventing admins from editing the profile of an account * Re-implementation by extending C2C_Plugin_011, which among other things adds support for: * Reset of options to default values * Better sanitization of input values * Offload of core/basic functionality to generic plugin framework * Additional hooks for various stages/places of plugin operation * Easier localization support * Full localization support * Move count_multiple_accounts() to c2c_count_multiple_accounts() * Deprecate count_multiple_accounts(), but retain it (for now) for backwards compatibility * Move get_users_by_email() to c2c_get_users_by_email() * Deprecate get_users_by_email(), but retain it (for now) for backwards compatibility * Move has_multiple_accounts() to c2c_has_multiple_accounts() * Deprecate has_multiple_accounts(), but retain it (for now) for backwards compatibility * Rename global instance variable from allow_multiple_accounts to c2c_allow_multiple_accounts * Explicitly ensure $allow_multiple_accounts is global when instantiating plugin object * Note compatibility with WP 3.0+ * Add 'Text Domain' header tag * Add omitted word in string * Minor string variable formatting changes * Update .pot file * Minor code reformatting (spacing) * Add PHPDoc documentation * Add package info to top of plugin file * Remove docs from top of plugin file (all that and more are in readme.txt) * Remove trailing whitespace in header docs * Add Template Tags and Upgrade Notice sections to readme.txt = 1.5 = * Fixed bug causing 'Too many accounts...' error to be incorrectly triggered * For retrieve password request emails, if the account is one associated with multiple accounts, list those account names in the email for informational purposes * Added class functions: count_multiple_emails(), get_users_by_email(), has_multiple_emails() * Exposed new class functions for external use via globally defined functions: count_multiple_emails(), get_users_by_email(), has_multiple_emails() * Changed invocation of plugin's install function to action hooked in constructor rather than in global space * Update object's option buffer after saving changed submitted by user * Finalized full support for localization * Parameterized textdomain name * Used _n() instead of deprecated __ngettext() * Supported swappable arguments in translatable string * Miscellaneous tweaks to update plugin to my current plugin conventions * Noted compatibility with WP2.9.1 * Dropped compatibility with versions of WP older than 2.8 = 1.1 = * Added handling for admin creation of users for WP2.8 * Improved query * Changed permission check * More localization-related work * Removed hardcoded path * Noted WP2.8 compatibility = 1.0 = * Initial release == Upgrade Notice == = 2.6.2 = Bugfix release for WP 3.1.x and 3.2.x to prevent warning notice from appearing unnecessarily in admin = 2.6.1 = Bugfix release for users running WP 3.1.x or 3.2.x. = 2.6 = Recommended update. Highlights: added/fixed Multisite compatibility; fixed compatibility with WP 3.3+ = 2.5 = Recommended update. Fixed outstanding bugs; added BuddyPress compatibility; noted WP 3.2 compatibility; dropped support for versions of WP older than 3.1; updated plugin framework. = 2.0.1 = Recommended minor bugfix release. Updated plugin framework to fix WP 2.9.2 compatibility issue. = 2.0 = Major update! This release fixes WP 3.0 + MU compatibility. Also includes major re-implementation, bug fixes, localization support, deprecation of all existing template tags (they've been renamed), and more.