=== Multi-Email Login ===
Contributors: mdburnette
Tags: authentication, email, login, multiple-emails, user-management
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Allow users to login with multiple email addresses on a single WordPress account.

== Description ==

Multi-Email Login is a WordPress plugin that enables users to associate multiple email addresses with a single account and authenticate using any of them. This solves a common problem where users have multiple email addresses (personal, work, legacy accounts) but want to maintain a single WordPress profile.

**Why Use Multi-Email Login?**

* **Flexibility**: Users can login with whichever email address they have handy
* **Account Consolidation**: No need to create separate accounts for different email addresses
* **Smooth Transitions**: When changing primary email addresses, users can keep both active for seamless access
* **Business Use**: Perfect for team members who use multiple email addresses across different departments or clients
* **Zero Friction**: Works transparently with WordPress authentication—no special configuration needed

**Features:**
* Multiple email addresses per user (unlimited)
* Login with any associated email address
* Seamless WordPress authentication integration
* Unique email enforcement
* User-friendly interface
* No configuration needed
* No WordPress core modifications
* Developer-friendly API for finding users by any email address

**Security:**
* Email format validation
* Input sanitization
* AJAX nonce protection
* User capability checks
* Password verification
* Duplicate prevention

== Installation ==

1. Upload the `multi-email-login` folder to `/wp-content/plugins/`
2. Activate the plugin from the WordPress Plugins menu
3. Go to Users → Your Profile and add secondary emails
4. Login with any associated email address

== Frequently Asked Questions ==

= Can I login with any of my associated emails? =
Yes! Once you add an email address to your account, you can use it to login just like your primary email.

= Is there a limit to how many emails I can add? =
No, you can add as many email addresses as you need to your account.

= Are my emails secure? =
Yes, all emails are validated and stored securely. AJAX requests are protected with nonces and user capabilities are verified.

= Will this work with multisite? =
Yes, the plugin is fully compatible with WordPress multisite installations.

= Can developers use this in their code? =
Yes! Developers can use the `melog_get_user_by()` function as a drop-in replacement for WordPress's `get_user_by()`. It automatically checks both primary and secondary email addresses when looking up users by email.

== Developer Usage ==

The plugin provides a simple API for developers to work with multiple email addresses:

**Find a user by any email address (primary or secondary):**
`$user = melog_get_user_by( 'email', 'user@example.com' );`

This function works just like WordPress's `get_user_by()` but automatically checks both primary and secondary email addresses.

**Instead of:**
`$user = get_user_by( 'email', 'user@example.com' );`

**Use:**
`$user = melog_get_user_by( 'email', 'user@example.com' );`

For other field types (login, ID, slug), it behaves identically to the standard WordPress function.

== Changelog ==

= 1.0.2 =
* Added `melog_get_user_by()` function for developers

= 1.0.1 =
* Fixed WordPress security standards compliance
* Improved code documentation
* Enhanced error handling

= 1.0.0 =
* Initial release