=== RadarAddress – Fake and Mistyped Email Check for MailPoet ===
Contributors: radarwave
Tags: mailpoet, email validation, fake email, disposable email, newsletter
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fewer bounces, more people reached: typos like gmial.com caught at signup, fake and disposable emails refused, your MailPoet lists verified in bulk.

== Description ==

Someone wants your newsletter, mistypes the address, and never hears from you again. Your lists fill up with addresses that bounce, and every bounce counts against your sender reputation.

RadarAddress checks the email address of every MailPoet subscription, with nothing to configure beyond the API token. A mailbox that cannot receive mail (dead domain, disposable address) is refused with a message in the form. When the address looks mistyped, the visitor reads «Did you mean mario@gmail.com?» and fixes it before MailPoet sends the confirmation email; a visitor who sends the same address again keeps it as written.

The subscribers already in your lists can be verified in bulk from MailPoet → RadarAddress: you choose which ones, from which list, in which order and how many. Unmistakable typos are corrected in the subscriber, with the original address kept next to the outcome.

Where the outcomes go: MailPoet tags (`radaraddress-email-undeliverable`, `radaraddress-email-disposable`, `radaraddress-email-typo`, `radaraddress-email-corrected`, `radaraddress-email-role`, `radaraddress-email-kept`), so you can filter the subscribers and build a segment, and the page of the plugin, with the latest outcomes and a CSV export.

**What you get**

* Every MailPoet form verified: syntax, domain that receives mail, disposable mailbox, role address (info@, office@…), typos.
* A «Did you mean …?» question in the form, so the confirmation email goes to the right address.
* Mailboxes that cannot receive mail refused at signup, and role addresses if you choose so, with messages you can change.
* Subscribers already in your lists verified in bulk: not verified yet or all, one list or all of them, newest, oldest or most recently engaged first, as many as you want. The count is above the button, and unsubscribed and bounced subscribers are left out.
* Unmistakable typos corrected in the subscriber. Optional: unsubscribe those who cannot receive mail.
* Typo correction level (1-3) for the email domain.
* Fail-open by design: if RadarAddress does not answer, the visitor subscribes as usual.
* Data stays in the EU.

**How it works**

1. Create a free account on radaraddress.com (every month 500 light checks are free).
2. Create an API token in your personal area.
3. MailPoet → RadarAddress: paste the token and press «Verify and save». Every subscription is verified from now on, and the subscribers already in your lists are below, with the count before the button.

One light check is used per email verified. For many lists the free checks of the month are enough to start; beyond that, packs and monthly subscriptions on radaraddress.com.

**Third-party service**

This plugin sends the email address typed in the MailPoet forms, and the addresses of the subscribers you choose to verify, to the RadarAddress API (https://www.radaraddress.com) to get verification results. Terms: https://www.radaraddress.com/en/terms — Privacy: https://www.radaraddress.com/en/privacy-policy

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the zip from Plugins → Add New → Upload.
2. Activate it. MailPoet 5.45 or later is required.
3. MailPoet → RadarAddress: paste your API token and press «Verify and save».

== Frequently Asked Questions ==

= Does it block the subscription? =

A mailbox that cannot receive mail is refused with a message in the form, and you can switch that off. A role address only if you choose so. A possible typo gets a question: if the visitor sends the same address again, it is kept as written.

= Do I have to configure anything? =

No: every MailPoet form is verified as soon as you paste the token. There are no fields to choose.

= Where do I see the outcome? =

In the MailPoet tags (radaraddress-email-…), which you can use to filter the subscribers and build a segment, and in MailPoet → RadarAddress, with the latest outcomes and the CSV export.

= Can I verify the subscribers I already have? =

Yes: you choose which ones, from which list, in which order and how many. Unsubscribed and bounced subscribers are left out, so you do not use checks on people who no longer receive your emails.

= Does it change the email of the subscribers? =

Only for an unmistakable typo in the domain, only in the bulk verification and only if the option is on: the original stays with the outcome. MailPoet then shows API as the source of that subscriber. A subscriber linked to a WordPress user, or whose corrected address already belongs to another subscriber, is not changed: the correction stays as a suggestion. At signup, never: MailPoet sends the confirmation email straight away, so the visitor corrects the address by answering the question.

= What about subscribers who arrive from checkout, comments or an import? =

The check at signup runs on the MailPoet forms. The others are in the bulk verification, among the subscribers not verified yet.

= How much does it cost? =

The plugin is free. One light check per email verified. Every month the first 500 are free. Beyond that, packs and monthly subscriptions on radaraddress.com.

= What if RadarAddress is down? =

The visitor subscribes as usual, with no message, and stays among the subscribers to verify.

== External services ==

This plugin connects to the RadarAddress API, a service run by RadarWave (the author of this plugin), to verify email addresses. It does nothing until you paste your own API token in MailPoet → RadarAddress.

* **What is sent and when:** when a visitor submits a MailPoet form, the email address typed is sent to be verified; when you start the bulk verification, the email addresses of the subscribers you chose are sent. Nothing else about the subscribers is sent. The site address and the form or page the request comes from are sent in the request headers, so that the usage log of your account can show them.
* **Where:** https://www.radaraddress.com/api/v1/ (calls are made by your site's server: the token never reaches the browser).
* **Terms of use:** https://www.radaraddress.com/en/terms
* **Privacy policy:** https://www.radaraddress.com/en/privacy-policy

== Screenshots ==

1. The subscribers already in your lists: which ones, from which list, in which order, how many, and the latest outcomes.
2. The form: when the address looks mistyped, the visitor reads the question and fixes it.
3. The settings in MailPoet → RadarAddress: token, switches for subscriptions and subscribers.

== Changelog ==

= 1.0.0 =
* First release: email verification at signup («Did you mean …?», addresses that cannot receive mail refused), subscribers already in your lists verified in bulk (which ones, from which list, in which order, how many), outcomes in MailPoet tags and in a CSV export.
