=== ClearBounce Email Verification ===
Contributors: clearbounce
Tags: email verification, email validation, disposable email, spam prevention, email bounce
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real-time email verification for WordPress. Block invalid, disposable, and risky email addresses on registration, comments, checkout, and forms.

== Description ==

ClearBounce Email Verification validates email addresses in real-time using the [ClearBounce](https://clearbounce.net) email verification API. Stop fake signups, reduce bounces, and protect your sender reputation.

**Key Features:**

* Real-time email verification via SMTP-level checks
* Block undeliverable, disposable, role-based, and risky emails
* Typo detection with "Did you mean...?" suggestions
* Smart caching to minimize API calls
* Fail-open design ensures forms always work, even during API outages
* Detailed verification logs and statistics
* Customizable error messages
* Works with WordPress registration, comments, and all major form plugins

**Supported Integrations:**

* WordPress Registration
* WordPress Comments
* WooCommerce (checkout and registration)
* Contact Form 7
* Gravity Forms
* WPForms
* Elementor Pro Forms
* Ninja Forms
* Fluent Forms
* Fallback mode (hooks into is_email for universal coverage)

**How It Works:**

1. A visitor submits a form with an email address
2. ClearBounce verifies the email in real-time (SMTP check, MX records, disposable detection, etc.)
3. If the email fails your configured rules, the form shows a friendly error message
4. Valid emails pass through normally with zero friction

**What ClearBounce Checks:**

* Email syntax validation
* MX record verification
* SMTP mailbox verification
* Disposable email detection
* Role-based email detection (info@, admin@, etc.)
* Free email provider detection
* Catch-all domain detection
* Typo detection with smart suggestions

== Installation ==

1. Upload the `clearbounce-email-verification` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > ClearBounce
4. Enter your API key (get one at [clearbounce.net](https://clearbounce.net))
5. Click "Test Connection" to verify your key works
6. Configure your block rules and integrations
7. Save changes - you're protected!

== Frequently Asked Questions ==

= Where do I get an API key? =

Sign up at [clearbounce.net](https://clearbounce.net) to get your API key. New accounts include free verification credits to get started.

= How many credits does each verification use? =

Each email verification uses 1 credit. Results are cached (24 hours by default) so repeat submissions of the same email don't use additional credits.

= What happens if I run out of credits? =

The plugin will fail open by default, meaning emails will be allowed through without verification. You can change this behavior in settings, but we recommend keeping fail-open enabled to avoid blocking legitimate users.

= What happens if the API is down? =

With the default "fail open" setting, all emails are allowed through when the API is unreachable. Your forms will never break due to an API outage.

= Will this slow down my forms? =

The API typically responds in 1-3 seconds. Results are cached so returning visitors experience no delay. The verification happens server-side during form submission, so there's no impact on page load speed.

= Does it work with my form plugin? =

ClearBounce supports WordPress Registration, WordPress Comments, WooCommerce, Contact Form 7, Gravity Forms, WPForms, Elementor Pro Forms, Ninja Forms, and Fluent Forms. There's also a fallback mode that hooks into WordPress core for universal coverage.

= Can I customize the error messages? =

Yes! All error messages are fully customizable from the Settings page. You can set different messages for undeliverable, disposable, risky, role-based, catch-all, and free provider emails.

= Is the plugin GDPR compliant? =

ClearBounce only sends the email address to our API for verification. No other personal data is transmitted. Verification logs stored locally can be cleared at any time from the settings page. See our [privacy policy](https://clearbounce.net/privacy) for full details.

= What is the fallback/is_email mode? =

The fallback mode hooks into WordPress core's `is_email` function to catch email validations from any source. It's disabled by default because it affects all email processing in WordPress, including admin operations. Only enable it if you need to cover forms or plugins not listed in the supported integrations.

== Screenshots ==

1. Settings page with API configuration and block rules
2. Integration toggles with auto-detection of installed plugins
3. Verification logs with filtering and search
4. Statistics dashboard showing block rates and trends
5. Typo suggestion shown on an email field

== Changelog ==

= 1.0.0 =
* Initial release
* Real-time email verification via ClearBounce API
* Support for WordPress Registration, Comments, and WooCommerce
* Contact Form 7, Gravity Forms, WPForms integrations
* Elementor Pro Forms, Ninja Forms, Fluent Forms integrations
* Fallback is_email hook for universal coverage
* Typo detection and suggestion
* Verification logs and statistics
* Customizable error messages and block rules
* Smart transient caching
* Fail-open design for reliability

== Upgrade Notice ==

= 1.0.0 =
Initial release of ClearBounce Email Verification for WordPress.
