Version : 1.3.13 · Plateforme : Plugin WordPress · API : email-validaton.com
N-Software Email Validator est un plugin WordPress de vérification d'e-mails en temps réel grâce à l'email-validaton.com API. It blocks fake registrations, disposable addresses, and non-existent mailboxes before they reach your database. The plugin works across three layers: real-time form protection, bulk CSV validation, and an Email Health scanner for cleaning existing data.
Ce guide détaille toutes les fonctionnalités, de l'installation au dépannage avancé.
Qu'est-ce que c'est ?
Le plugin intercepte chaque adresse e-mail soumise sur votre site WordPress (formulaires d'inscription, formulaires de contact, commentaires et paiement WooCommerce) et la valide auprès de l'email-validaton.com API before WordPress processes it.
Trois niveaux de protection
| Niveau | Objectif |
|---|---|
| Protection en temps réel | Bloque les mauvaises adresses lors de l'envoi d'un formulaire ou d'une inscription |
| Validation en masse | Vérifie jusqu'à 5 000 adresses à la fois à partir de listes CSV/TXT |
| Santé des e-mails | Analyse les adresses existantes dans la base de données et permet de les supprimer ou de les anonymiser |
Prérequis
| Exigence | Minimum |
|---|---|
| WordPress | 6.2 ou supérieur |
| PHP | 8.0 ou supérieur |
| Clé API | email-validaton.com/dashboard |
| Internet | Connexion au service API |
| Accès administrateur | manage_options capability for setup |
Installation — 4 étapes
- Téléversez le fichier ZIP ou le dossier
n-software-email-validatorto/wp-content/plugins/ - Extensions → Extensions installées → Activer
- L'élément de menu N-Software Email Validator apparaît dans la barre latérale
- Rendez-vous dans Réglages → saisissez votre clé API → enregistrez. Un point vert intitulé API connectée confirme la liaison
Structure du panneau d'administration
N-Software Email Validator
├── Tableau de bord — Compte, forfait, statistiques, validation unique-email validation
├── Réglages — API clé, validation de validation, formulaire intégrations
├── Import en masse Valider — En masse vérification de CSV/TXT files
├── Journaux — Dernières 100 validations with détail
└── Email Santé — Analyse existants adresses + nettoyage
Supplémentaire :
- Widget du tableau de bord WordPress — forfait, crédits, barre de progression, statistiques du jour
- Utilisateurs → Tous les utilisateurs — Statut de l'e-mail colonne (Valide, Invalide, Risqué, etc.)
Référence des réglages
Configuration de l'API
| Option | Description | Recommandation |
|---|---|---|
| Clé API | Clé fournie par email-validaton.com | Obligatoire |
| Délai d'expiration de la validation | Délai max. de réponse de l'API (1–30 s) | 10 s |
| Mettre les résultats en cache | Durée de vie du cache en minutes (0 = désactivé) | 60 min |
Le cache permet d'économiser des crédits : la même adresse n'est pas renvoyée à l'API tant que le cache est valide.
Règles de validation
| Option | Effet |
|---|---|
| Valider lors de l'inscription | Vérifie l'e-mail lors de l'inscription d'un utilisateur WP |
| Bloquer les fournisseurs d'e-mails gratuits | Bloque Gmail, Yahoo, Outlook, etc. quel que soit leur statut |
Intégrations de formulaires
Activez uniquement les formulaires que vous utilisez : Contact Form 7, WPForms, Gravity Forms, WooCommerce Checkout, Ninja Forms, Fluent Forms, Formidable, Forminator, MC4WP (Mailchimp), WS Forms, Mailster, WordPress Comments.
Fonctionnement de la validation
Flux de validation
Utilisateur soumet un formulaire with un email adresse
↓
Extension intercepte AVANT WordPress le traite il
↓
Cache mémoire (instantané, par-request)
↓
Transitoire mémoire (WordPress persistant, configurable TTL)
↓
API crédits de la syntaxe (GET /api/v1/le compte)
↓
API validation appel (POST /api/v1/verify)
↓
API renvoie status with confiance score et MX détails
↓
BLOQUER: invalides, jetable, error
AUTORISER: valide, risqué, inconnu, over_quota
↓
Journaliser à la + incrémenter quotidien statistiques
Statuts renvoyés par l'API
| Statut | Signification | Bloqué ? | Crédits consommés ? |
|---|---|---|---|
valid |
Boîte e-mail confirmée comme existante | Aucune | Oui |
invalid |
La boîte aux lettres n'existe pas | Oui | Oui |
disposable |
Fournisseur temporaire ou jetable | Oui | Oui |
error |
Erreur de vérification | Oui | Aucune |
risky |
Faible confiance (catch-all, Yahoo, greylisting) | Aucune | Aucune |
unknown |
Pas de réponse définitive | Aucune | Aucune |
over_quota |
La boîte e-mail existe mais est pleine | Aucune | Oui |
Point clé :
valid,invalid,over_quota, anddisposableconsume 1 credit each.
Les statuts error, unknown et risky sont gratuits. Les états internes SMTP-gate busy
ne sont jamais renvoyés : ils apparaissent commeunknown.
Règles de blocage par défaut
- Autorisés : valid, risky, unknown, over_quota
- Bloqués : invalid, disposable, error
- Bloqués en option : fournisseurs d'e-mail gratuits (Gmail, Yahoo…) si l'option est activée
En cas de problème
Le plugin ne casse jamais vos formulaires :
| Situation | Comportement |
|---|---|
| Crédits à 0 | Notification rouge pour l'administrateur, validation suspendue — les formulaires fonctionnent toujours |
| Crédits < 5 % | Notification d'avertissement jaune |
| API injoignable | Les e-mails sont acceptés sans vérification (solution de repli) |
| Limite de débit | Attente automatique + nouvelle tentative — l'analyse de santé ne s'arrête pas |
| Erreur réseau | Nouvelle tentative avec backoff exponentiel |
Tableau de bord — Démarrage rapide
N-Software Email Validator → Tableau de bord
- Compte : Forfait, crédits restants, barre de progression
- Statistiques du jour : valides / invalides / risqués / jetables pour la journée en cours
- Validation rapide : Saisissez une adresse e-mail, cliquez sur Valider et obtenez le résultat immédiatement
Utilisez la validation rapide pour tester votre clé API et une adresse unique avant la mise en production.
Validation en masse — Vérification à grande échelle
N-Software Email Validator → Validation en masse
Préparation du fichier
- Format : CSV ou TXT
- Une adresse par ligne (CSV : première colonne)
- Maximum 5 000 adresses uniques
- Lignes d'en-tête (
email,e-mail) are auto-skipped
Étapes
- Choisir un fichier → sélectionnez un CSV ou un TXT
- Lancer la validation en masse
- Suivez la barre de progression (lot par lot)
- Une fois terminé : Exporter en CSV avec les résultats
Contenu de l'export
Email, Status, Confidence, MX Server, Is Free, Is Disposable, Is Role, Reason, Domain
Journaux — Historique des validations
Journaux N-Software Email Validator
- Derniers 100 dernières validations (e-mail, statut, confiance, MX, date)
- Test de débogage — valider une adresse et enregistrer le résultat
- Vider le cache — purger les résultats en cache (pas les journaux)
- Actualiser — recharger le tableau
- Les journaux de plus de 7 jours sont nettoyés automatiquement via WP Cron
Santé des e-mails — Analyse et nettoyage
Le module le plus puissant. Vérifie les adresses existantes dans la base de données de votre site.
Sources analysées
| Source | Ce qui est analysé |
|---|---|
| Utilisateurs WordPress | user_email for all users |
| Clients WooCommerce | Recherche de clients WC |
| Commandes WooCommerce | E-mail de facturation des commandes |
| Auteurs de commentaires | E-mails des auteurs de commentaires |
| Soumissions CF7 | Métadonnées e-mail CF7 (si présentes) |
Contrôles de l'analyse
| Bouton | Fonction |
|---|---|
| Lancer l'analyse | Nouvelle analyse (efface la précédente) |
| Continuer l'analyse | Reprendre l'analyse en pause |
| Recommencer à zéro | Repartir de zéro |
| Mettez en pause | Pause (conserve la progression) |
| Arrêter | Arrêt — les données sont conservées |
| Enregistrer la progression | Sauvegarde manuelle sur le serveur |
Taille du lot : 5 à 50 par lot. Cadence : 200 à 10 000 ms entre les requêtes — plus bas = plus rapide, mais charge API plus élevée.
Flux de travail type
- Choisissez les sources (par ex. utilisateurs WP + commentaires)
- Lancer l'analyse
- Suivez la barre de progression et les statistiques
- Filtrez les mauvaises catégories (Invalide, Jetable, Erreur)
- Sélectionnez des lignes ou utilisez la sélection automatique
- Supprimer la sélection ou Anonymiser la sélection
- Pour la suppression : saisissez DELETE dans la fenêtre de confirmation
Filtres et tableau
- Filtres : Tous, Valide, Invalide, Risqué, Jetable, Inconnu, Erreur, Boîte pleine, Limite de débit, Revérifié
- Colonnes : E-mail, Statut, Confiance, Serveur MX
- Pagination : 25 / 50 / 100 par page
Revérifier
- Revérifier cette catégorie — revérifie toutes les entrées du filtre actif
- Revérifiées entrées affichent un marqueur 🔄 et un filtre dédié
Supprimer ou anonymiser
| Action | Effet |
|---|---|
| Supprimer | Supprime définitivement les données utilisateur/commentaire/WC |
| Anonymiser | Remplace l'e-mail par anon-{id}@deleted.invalid |
⚠️ La suppression est irréversible — la fenêtre modale exige le mot DELETE pour confirmation.
Persistance
- Progression enregistrée dans les tables MySQL :
wp_north_ev_health_emails,wp_north_ev_health_results - État meta :
nev_health_scan_stateoption - Enregistrer la progression utilise UPSERT — ne supprime jamais les résultats existants
- Lors de la sortie de l'onglet, l'extension enregistre automatiquement via
sendBeacon
Important — Onglet en arrière-plan
La vérification de santé des e-mails et la validation en masse s'exécutent dans le navigateur (JavaScript + AJAX). Les onglets inactifs ralentissent les minuteurs — les analyses ralentissent ou s'arrêtent. Gardez l'onglet d'administration actif pendant les analyses volumineuses. La protection des formulaires et de l'inscription fonctionne normalement sans onglet ouvert.
Utilisateurs → Colonne Statut e-mail
Le Utilisateurs → Tous les utilisateursyou see a badge for each user:
- Status from user meta (
nev_email_status) - Fallback: latest entry in validation logs
- Updated on registration, form validation, and Email Health scans
Credits and Notifications
| Scénario | Comportement |
|---|---|
| Crédits à 0 | Avis admin rouge, validation suspendue, les formulaires fonctionnent toujours |
| Crédits < 5 % | Notification d'avertissement jaune |
| Limite de débit | Attente automatique + nouvelle tentative (l'analyse de santé continue) |
| Erreur réseau | Nouvelle tentative avec temporisation progressive (l'analyse de santé continue) |
| Acheter des crédits | email-validaton.com/dashboard |
Guides rapides des scénarios
A — Protéger l'inscription
- Réglages → saisissez la clé API
- Activez le Valider lors de l'inscription
- Test : inscrivez-vous avec
test@mailinator.com— should be blocked
B — Formulaire CF7
- Réglages → activez Contact Form 7
- Envoyez un formulaire de test avec une adresse e-mail invalide
- Consulter les journaux
C — Nettoyer les anciens utilisateurs
- Email Health → sélectionnez Utilisateurs WordPress
- Lancer l'analyse → attendre
- Filtrer les invalides + jetables
- Supprimer la sélection (confirmez avec DELETE)
D — Valider une liste de diffusion
- Validation en masse → importez le CSV
- Exporter les résultats
- Supprimez les adresses invalides/jetables de votre liste dans Mailchimp/Brevo/etc.
Schéma de la base de données (technique)
Tables avec $wpdb prefix:
| Table | Objectif |
|---|---|
north_ev_validation_logs |
Chaque validation avec tous les détails |
north_ev_bulk_jobs |
État et résultats des tâches en masse |
north_ev_health_emails |
Liste d'e-mails Email Health |
north_ev_health_results |
Résultats de vérification Email Health |
- Désactivation : Données conservées
- Désinstallation : Supprime toutes les tables, options, transitoires et tâches cron
- Multisite : Prise en charge — activation par site ou à l'échelle du réseau
FAQ / Dépannage
Q : Plugin Check signale des erreurs ?
R : Utilisez le dernier ZIP (1.3.13). Supprimez l'ancienne extension avant de la réinstaller.
Q : La validation ne fonctionne pas sur un formulaire ?
R : Vérifiez que l'intégration est activée dans les Réglages et que vous disposez de crédits.
Q : Vous avez perdu la progression de Email Health ?
R : Cliquez sur Continuer l'analyse. Les données sont dans la base de données, sauf si vous avez utilisé Recommencer à zéro.
Q : Enregistrer la progression affiche une erreur, mais les données sont là ?
R : Dans la version 1.3.x, l'enregistrement vérifie côté serveur le nombre de lignes — actualisez la page.
Q : Puis-je analyser 50 000 adresses ?
R : Techniquement oui, mais gardez l'onglet ouvert et réglez le rythme sur 1000 à 2000 ms.
Q : Où obtenir une clé API ?
R : email-validaton.com → Tableau de bord → Clé API.
Résumé
N-Software Email Validator est une boîte à outils complète d'hygiène des e-mails pour WordPress :
- Protection en temps réelsur les formulaires, l'inscription et le paiement WooCommerce
- Validation de listes en masse avec import CSV/TXT
- Nettoyage de la base de données via le scanner Email Health
- Suivi des crédits avec des indicateurs d'état clairs
Pour une utilisation en production : configurez d'abord les Paramètres et la Validation rapide, activez ensuite les intégrations, puis utilisez Email Health pour auditer les adresses existantes.