Refuses sign-ups with an email address that cannot receive emails or is disposable, and flags WooCommerce orders whose billing email has the same problem. The checks are made by MailProbe, an email verification API hosted in the EU (France).
The user documentation is readme.txt, in the format of the WordPress.org plugin directory.
| Where | When | What happens |
|---|---|---|
WordPress registration form (wp-login.php) |
before the account is created | refused when the address cannot receive emails, is disposable, or (optional) is a shared address such as info@ |
Sign-up page of a multisite network (wp-signup.php) |
same, with the settings of the main site | same; the users that administrators add are not checked |
| WooCommerce "My account" registration | same | same |
| WooCommerce checkout, classic and blocks | after the order, in the background (Action Scheduler) | never blocked; a flagged order gets a private note and a red mark in the orders list |
Rules that do not change with settings:
- Addresses that cannot be confirmed (catch-all domains, providers that block probes such as Outlook, slow servers) are never refused.
- Any error of MailProbe (network, no credits, key refused, timeout) lets the visitor through. The errors that stop every check (no credits, key refused) raise an admin notice until a check succeeds again.
- At registration the visitor waits 3 seconds at most (
mailprobe_registration_wait). The API is asked for 5 seconds, its minimum; a call cut while the address is still being probed is not charged. - A verdict is kept ten minutes for the same address, in a transient named after a hash of the address, which it does not hold: the two steps of a network sign-up that creates a site, or a refused address sent again, use one credit.
- Every call carries the User-Agent
mailprobe-wordpress/<version> WordPress/<version> WooCommerce/<version>, without the site address. MailProbe recordsmailprobe-wordpresson the API key that the plugin uses first: that is how the accounts brought by the plugin are counted.
mailprobe_registration_message(filter): the message shown when a registration is refused. Arguments: message, reason (invalid,disposable,role), MailProbe result.mailprobe_registration_wait(filter): seconds a visitor waits at most, default 3.mailprobe_order_checked(action): an order was checked. Arguments:WC_Order, verdict (valid,risky,unknown,role,invalid,disposable), MailProbe result.
MAILPROBE_API_KEY: the API key, instead of the settings page.MAILPROBE_API_BASE: the API root,https://mailprobe.dev/api/v1by default. Only for tests.
composer install
composer analysePHPStan at level 5, against the stubs of WordPress and WooCommerce, from PHP 7.4. Composer brings these tools only: the plugin needs none, and vendor/ stays out of the zip.
bash bin/build-zip.shbuilds dist/mailprobe-<version>.zip from the last commit, without the development files (.gitattributes, export-ignore). That zip is what goes to the WordPress.org plugin directory.
GPLv2 or later. Copyright 2026 Iris Digital.