=== RadarAddress – Fake and Mistyped Email Check for Newsletter ===
Contributors: radarwave
Tags: newsletter, email validation, fake email, disposable email, subscribers
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 corrected at signup, fake and disposable emails refused, your subscribers 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 subscription made with The Newsletter Plugin, with nothing to configure beyond the API token. An unmistakable typo is corrected before the confirmation email leaves, and the confirmation page says so. When the address only looks mistyped, the visitor reads «Did you mean mario@gmail.com?»; a visitor who sends the same address again keeps it as written. A mailbox that cannot receive mail (dead domain, disposable address) is refused with a message.

The subscribers already in your lists can be verified in bulk from Newsletter → 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: the subscriber page, the page of the plugin with the latest outcomes and a CSV export, and, if you choose one, a list that collects the addresses to check, so that you can exclude it when you send a newsletter.

**What you get**

* Every form of The Newsletter Plugin verified: syntax, domain that receives mail, disposable mailbox, role address (info@, office@…), typos.
* Unmistakable typos corrected before the confirmation email leaves, and a «Did you mean …?» question when in doubt.
* 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 active 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.
* A list of your choice for the addresses to check.
* 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. Newsletter → 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.

This plugin is not affiliated with or endorsed by the authors of The Newsletter Plugin.

**Third-party service**

This plugin sends the email address typed in the subscription 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. The Newsletter Plugin 9.5 or later is required.
3. Newsletter → 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, 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 form of The Newsletter Plugin is verified as soon as you paste the token. There are no fields to choose.

= Where do I see the outcome? =

On the subscriber page, in Newsletter → RadarAddress with the latest outcomes and the CSV export, and in the list you choose for the addresses to check, which you can exclude when you send a newsletter.

= 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. At signup the address is corrected before the confirmation email leaves, and the confirmation page says so. In the bulk verification it happens only if the option is on, and the original stays with the outcome. A subscriber linked to a WordPress user is not changed in bulk, and an address that already belongs to another subscriber is never used: the correction stays as a suggestion.

= What about subscribers who arrive from an add-on or an import? =

The check at signup runs on the subscription 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 Newsletter → RadarAddress.

* **What is sent and when:** when a visitor submits a subscription 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 Newsletter → RadarAddress: token, switches for subscriptions and subscribers.

== Changelog ==

= 1.0.0 =
* First release: email verification at signup (unmistakable typos corrected, «Did you mean …?» when in doubt, 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 on the subscriber page, in a list of your choice and in a CSV export.
