Versione: 1.3.13 · Piattaforma: Plugin WordPress · API: email-validaton.com
N-Software Email Validator è un plugin per WordPress che consente la verifica in tempo reale degli indirizzi email tramite 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.
Questa guida illustra in dettaglio ogni funzionalità, dall'installazione alla risoluzione avanzata dei problemi.
Di cosa si tratta?
Il plugin intercetta ogni indirizzo email inviato sul tuo sito WordPress — nei moduli di registrazione, nei moduli di contatto, nei commenti e nel checkout di WooCommerce — e lo convalida tramite email-validaton.com API before WordPress processes it.
Tre livelli di protezione
| Livello | Finalità |
|---|---|
| Protezione in tempo reale | Blocca gli indirizzi non validi al momento dell'invio di moduli o della registrazione |
| Convalida in blocco | Controlla liste CSV/TXT fino a 5.000 indirizzi alla volta |
| Stato delle email | Analizza gli indirizzi esistenti nel database e consente di eliminarli o anonimizzarli |
Requisiti
| Requisito | Minimo |
|---|---|
| WordPress | 6.2 o superiore |
| PHP | 8.0 o superiore |
| Chiave API | email-validaton.com/dashboard |
| Internet | Connessione al servizio API |
| Accesso amministratore | manage_options capability for setup |
Installazione — 4 passaggi
- Carica il file ZIP o la cartella
n-software-email-validatorto/wp-content/plugins/ - Plugin → Plugin installati → Attiva
- La voce di menu N-Software Email Validator compare nella barra laterale
- Vai a Impostazioni → inserisci la tua chiave API → salva. Un punto verde con l'etichetta API connessa conferma il collegamento
Struttura del pannello admin
N-Software Email Validator
├── Dashboard — Account, piano, statistiche, rapida singola-email validazione
├── Impostazioni — API chiave, validazione regole, modulo integrazioni
├── In blocco Valida — Verifica verifica di CSV/TXT files
├── Log — Ultime 100 convalide with dettaglio
└── Email Salute — Scansiona esistenti indirizzi + pulizia
Aggiuntivo:
- Widget per la dashboard di WordPress — piano, crediti, barra di avanzamento, statistiche di oggi
- Utenti → Tutti gli utenti — Stato email colonna (Valid, Invalid, Risky, ecc.)
Riferimento impostazioni
Configurazione API
| Opzione | Descrizione | Consigliato |
|---|---|---|
| Chiave API | Chiave da email-validaton.com | Obbligatorio |
| Timeout di convalida | Attesa massima per la risposta dell'API (1–30 s) | 10 s |
| Salva risultati in cache | TTL della cache in minuti (0 = disattivato) | 60 min |
La cache fa risparmiare crediti: lo stesso indirizzo non viene inviato di nuovo all'API finché la cache è valida.
Regole di validazione
| Opzione | Effetto |
|---|---|
| Convalida in fase di registrazione | Controlla l'email durante la registrazione degli utenti di WP |
| Blocca i provider di posta gratuiti | Blocca Gmail, Yahoo, Outlook ecc. indipendentemente dallo stato |
Integrazioni con i moduli
Attiva solo i moduli che utilizzi: Contact Form 7, WPForms, Gravity Forms, WooCommerce Checkout, Ninja Forms, Fluent Forms, Formidable, Forminator, MC4WP (Mailchimp), WS Forms, Mailster, WordPress Comments.
Come funziona la validazione
Flusso di validazione
L'utente invia un modulo with un email fisico
↓
Plugin intercetta PRIMA WordPress elabora la
↓
Memoria cache (istantanea, per-request)
↓
Persistente cache (WordPress transitorio, configurabile TTL)
↓
API crediti verifica (GET /api/v1/account)
↓
API validazione chiamata (POST /api/v1/verify)
↓
API restituisce status with confidenza score e MX dettagli
↓
BLOCK: non valido, disposable, error
ALLOW: valid, rischioso, sconosciuto, over_quota
↓
Log a database + incrementa giornaliero statistiche
Stati Restituiti dall'API
| Stato | Significato | Bloccato? | Crediti Consumati? |
|---|---|---|---|
valid |
Casella confermata come esistente | No | Sì |
invalid |
La casella postale non esiste | Sì | Sì |
disposable |
Provider temporaneo/usa e getta | Sì | Sì |
error |
Errore di verifica | Sì | No |
risky |
Bassa affidabilità (catch-all, Yahoo, greylisting) | No | No |
unknown |
Nessuna risposta definitiva | No | No |
over_quota |
La casella esiste ma è piena | No | Sì |
Dato chiave:
valid,invalid,over_quota, anddisposableconsume 1 credit each.
Errore, sconosciuto e rischioso sono gratuiti. Stato interno SMTP-gate occupato
non vengono mai restituiti — appaiono comeunknown.
Regole di Blocco Predefinite
- Consentiti:valid, risky, unknown, over_quota
- Bloccati: non validi, usa e getta, errore
- Bloccati facoltativamente: provider di posta gratuiti (Gmail, Yahoo…) se l'opzione è attiva
Quando qualcosa va storto
Il plugin non interrompe mai i tuoi moduli:
| Situazione | Comportamento |
|---|---|
| Crediti a 0 | Avviso amministrativo in rosso, validazione in ppausa — i moduli continuano a funzionare |
| Crediti < 5% | Avviso giallo di attenzione |
| API non raggiungibile | Le email passano senza controllo (fallback sicuro) |
| Limite di frequenza | Attesa automatica + nuovo tentativo — la scansione di salute non si interrompe |
| Errore di rete | Riprova con backoff esponenziale |
Dashboard — Guida rapida
N-Software Email Validator → Dashboard
- Account: piano, crediti rimanenti, barra di avanzamento
- Statistiche di oggi: valide / non valide / a rischio / usa e getta per il giorno corrente
- Validazione rapida: inserisci un'email, clicca su Valida e visualizza subito il risultato
Usa la Validazione rapida per testare la tua chiave API e un singolo indirizzo prima di andare online.
Validazione in blocco — Verifica di massa
N-Software Email Validator → Validazione in blocco
Preparazione del file
- Formato: CSV o TXT
- Un indirizzo per riga (CSV: prima colonna)
- Massimo 5.000 indirizzi unici
- Righe di intestazione (
email,e-mail) are auto-skipped
Passaggi
- Scegli file → seleziona CSV o TXT
- Avvia convalida in blocco
- Osserva la barra di avanzamento (blocco per blocco)
- Al termine: Esporta CSV con risultati
Esporta contiene
Email, Status, Confidence, MX Server, Is Free, Is Disposable, Is Role, Reason, Domain
Log — Cronologia validazioni
N-Software Email Validator → Log
- Ultimi 100 validazioni (email, stato, affidabilità, MX, data)
- Debug Test — convalida un indirizzo + registra il risultato
- Svuota cache — elimina i risultati memorizzati (non i log)
- Aggiorna — ricarica la tabella
- I log più vecchi di 7 giorni vengono eliminati automaticamente tramite WP Cron
Email Health — Scansione e pulizia
Il modulo più potente. Controlla gli indirizzi esistenti nel database del tuo sito.
Fonti analizzate
| Fonte | Cosa analizza |
|---|---|
| Utenti di WordPress | user_email for all users |
| Clienti di WooCommerce | Ricerca clienti WC |
| Ordini di WooCommerce | Email di fatturazione dagli ordini |
| Autori dei commenti | Email degli autori dei commenti |
| Invii CF7 | Meta email CF7 (se presente) |
Controlli scansione
| Pulsante | Funzione |
|---|---|
| Avvia scansione | Nuova scansione (cancella la precedente) |
| Continua scansione | Riprendi scansione in pausa |
| Ricomincia da zero | Ricomincia da zero |
| Metti in pausa | Pausa (mantiene i progressi) |
| Stop | Interrompi — i dati vengono conservati |
| Salva progressi | Salvataggio manuale sul server |
Dimensione lotto: 5–50 per batch. Ritmo: 200–10.000 ms tra una richiesta e l'altra — valori più bassi = più veloce ma maggior carico sulle API.
Flusso di lavoro tipico
- Scegli le fonti (es. Utenti WP + Commenti)
- Avvia scansione
- Monitora la barra di avanzamento e le statistiche
- Filtra le categorie problematiche (Non valida, Usa e getta, Errore)
- Seleziona le righe oppure usa la selezione automatica
- Elimina selezionati o Anonimizza selezionati
- Per l'eliminazione: digita DELETE nella finestra di conferma
Filtri e tabella
- Filtri: Tutti, Validi, Non validi, Rischiosi, Usa e getta, Sconosciuti, Errore, Casella piena, Limite di frequenza, Riverificati
- Colonne: Email, Stato, Affidabilità, Server MX
- Paginazione: 25 / 50 / 100 per pagina
Riverifica
- Riverifica questa categoria — ricontrolla tutte le voci del filtro attivo
- Riverificato le voci mostrano un marcatore 🔄 e un filtro dedicato
Elimina vs Anonimizza
| Azione | Effetto |
|---|---|
| Elimina | Rimuove definitivamente i dati di utente/commento/WC |
| Anonimizza | Sostituisce l'email con anon-{id}@deleted.invalid |
⚠️ L'eliminazione è irreversibile — la finestra richiede la parola DELETE per la conferma.
Persistenza
- Avanzamento salvato nelle tabelle MySQL:
wp_north_ev_health_emails,wp_north_ev_health_results - Stato meta:
nev_health_scan_stateoption - Salva progressi usa UPSERT — non elimina mai i risultati esistenti
- Quando si lascia la scheda, il plugin salva automaticamente tramite
sendBeacon
Importante — Scheda in background
La verifica dello stato delle email e la validazione in blocco vengono eseguite nel browser (JavaScript + AJAX). Le schede inattive rallentano i timer: le scansioni rallentano o si fermano. Mantieni attiva la scheda di amministrazione durante le scansioni di grandi dimensioni. La protezione dei moduli e delle registrazioni funziona normalmente anche senza una scheda aperta.
Utenti → Colonna stato email
Su Utenti → Tutti gli utenti vedi un badge per ogni utente:
- Stato dai meta utente (
nev_email_status) - Alternativa: ultima voce nei log di validazione
- Aggiornato alla registrazione, alla validazione dei moduli e alle scansioni di stato email
Crediti e notifiche
| Scenario | Comportamento |
|---|---|
| Crediti a 0 | Avviso rosso nel backend, validazione in pausa, i moduli continuano a funzionare |
| Crediti < 5% | Avviso giallo di attenzione |
| Limite di frequenza | Attesa automatica + nuovo tentativo (la scansione prosegue) |
| Errore di rete | Nuovo tentativo con backoff (la scansione prosegue) |
| Acquista crediti | email-validaton.com/dashboard |
Guide rapide agli scenari
A — Proteggi la registrazione
- Impostazioni → inserisci la chiave API
- Attiva Convalida in fase di registrazione
- Test: registrati con
test@mailinator.com— should be blocked
B — Modulo CF7
- Impostazioni → attiva Contact Form 7
- Invia un modulo di prova con un'email non valida
- Controlla i log
C — Pulisci gli utenti vecchi
- Email Health → seleziona Utenti di WordPress
- Avvia scansione → attendi
- Filtra non validi + usa-e-getta
- Elimina selezionati (conferma con DELETE)
D — Valida una lista di indirizzi
- Validazione in blocco → carica CSV
- Esporta i risultati
- Rimuovi gli indirizzi non validi/usa-e-getta dalla tua lista in Mailchimp/Brevo/ecc.
Schema del database (tecnico)
Tabelle con $wpdb prefix:
| Tabella | Finalità |
|---|---|
north_ev_validation_logs |
Ogni validazione con tutti i dettagli |
north_ev_bulk_jobs |
Stato e risultati dei processi in blocco |
north_ev_health_emails |
Elenco di indirizzi email di Email Health |
north_ev_health_results |
Risultati di verifica di Email Health |
- Disattivazione: Dati conservati
- Disinstallazione: Rimuove tutte le tabelle, le opzioni, i transient e i cron job
- Multisito: Supportato — attivazione per singolo sito o per l'intera rete
FAQ / Risoluzione dei problemi
D: Plugin Check segnala errori?
R: Usa l'ultimo file ZIP (1.3.13). Elimina il vecchio plugin prima di reinstallarlo.
D: La validazione non funziona su un modulo?
R: Verifica che l'integrazione sia abilitata nelle Impostazioni e che tu abbia crediti disponibili.
D: Hai perso i progressi di Email Health?
R: Fai clic su Continua scansione. I dati sono nel database, a meno che tu non abbia usato Ricomincia da zero.
D: Salva progressi segnala un errore ma i dati ci sono?
R: Nella 1.3.x, Salva verifica lato server il numero di righe — aggiorna la pagina.
D: Posso analizzare 50.000 indirizzi?
A: Tecnicamente sì, ma tieni la scheda aperta e imposta il ritmo a 1000–2000 ms.
D: Dove posso ottenere una chiave API?
R: email-validaton.com → Dashboard → Chiave API.
Riepilogo
N-Software Email Validator è un toolkit completo per la pulizia delle email su WordPress:
- Protezione in tempo reale su moduli, registrazione e checkout di WooCommerce
- Validazione di elenchi in blocco con caricamento di file CSV/TXT
- Pulizia del database tramite lo scanner Email Health
- Monitoraggio dei crediti con indicatori di stato chiari
Per l'uso in produzione: configura prima Impostazioni e Validazione rapida, poi attiva le integrazioni e infine usa Email Health per un audit degli indirizzi esistenti.