N-Software Email Validator — Guida completa al plugin WordPress e manuale

N-Software Email Validator — Guida completa al plugin WordPress e manuale

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

  1. Carica il file ZIP o la cartella n-software-email-validator to /wp-content/plugins/
  2. Plugin → Plugin installati → Attiva
  3. La voce di menu N-Software Email Validator compare nella barra laterale
  4. 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, and disposable consume 1 credit each.
Errore, sconosciuto e rischioso sono gratuiti. Stato interno SMTP-gate occupato
non vengono mai restituiti — appaiono come unknown.

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

  1. Scegli file → seleziona CSV o TXT
  2. Avvia convalida in blocco
  3. Osserva la barra di avanzamento (blocco per blocco)
  4. 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

  1. Scegli le fonti (es. Utenti WP + Commenti)
  2. Avvia scansione
  3. Monitora la barra di avanzamento e le statistiche
  4. Filtra le categorie problematiche (Non valida, Usa e getta, Errore)
  5. Seleziona le righe oppure usa la selezione automatica
  6. Elimina selezionati o Anonimizza selezionati
  7. 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_state option
  • 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

  1. Impostazioni → inserisci la chiave API
  2. Attiva Convalida in fase di registrazione
  3. Test: registrati con test@mailinator.com — should be blocked

B — Modulo CF7

  1. Impostazioni → attiva Contact Form 7
  2. Invia un modulo di prova con un'email non valida
  3. Controlla i log

C — Pulisci gli utenti vecchi

  1. Email Health → seleziona Utenti di WordPress
  2. Avvia scansione → attendi
  3. Filtra non validi + usa-e-getta
  4. Elimina selezionati (conferma con DELETE)

D — Valida una lista di indirizzi

  1. Validazione in blocco → carica CSV
  2. Esporta i risultati
  3. 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.

Scarica il plugin →

Pronto a pulire la tua lista email?

200 verifiche gratuite. Nessuna carta di credito. Validazione SMTP completa in meno di 1 secondo.

🚀 Crea un account gratuito
MP

N-Software

Milan Pasić è il fondatore di N-Software e lead developer di Email Validator. Da oltre dieci anni sviluppa infrastrutture email, strumenti di deliverability e sistemi di validazione SMTP utilizzati da migliaia di marketer e sviluppatori in tutto il mondo.