N-Software Email Validator — Guia Completo do Plugin WordPress e Manual

Versão: 1.3.13 · Plataforma: Plugin WordPress · API: email-validaton.com

O N-Software Email Validator é um plugin para WordPress que faz a verificação de e-mails em tempo real por meio da 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.

Este guia aborda todos os recursos em detalhes — desde a instalação até a solução avançada de problemas.

O que é?

O plugin intercepta todo endereço de e-mail enviado no seu site WordPress — em formulários de cadastro, formulários de contato, comentários e no checkout do WooCommerce — e o valida com a email-validaton.com API before WordPress processes it.

Três Camadas de Proteção

Requisitos

Instalação — 4 etapas

1. Envie o ZIP ou a pasta n-software-email-validator to /wp-content/plugins/
2. Plugins → Plugins instalados → Ativar
3. O item de menu N-Software Email Validator aparece na barra lateral
4. Acesse Definições → introduza a sua chave de API → guarde. Um ponto verde com a legenda API ligada confirma a ligação

Estrutura do Painel de Administração

N-Software Email Validator
├── Painel      — Conta, plano, estatísticas, rápido individual-email validação
├── Definições       — API chave, validação regras, form integrações
├── Em massa Validar  — Em massa verificação de CSV/TXT files
├── Registos           — Último 100 validações with detail
└── Email Saúde   — Verificar existentes endereços + limpeza

Adicional:

• Widget do Painel do WordPress — plano, créditos, barra de progresso, estatísticas de hoje
• Utilizadores → Todos os Utilizadores — Estado do e-mail coluna (Válido, Inválido, Arriscado, etc.)

Referência das Definições

Configuração da API

A cache poupa créditos — o mesmo endereço não é reenviado à API enquanto a cache for válida.

Regras de Validação

Integrações de Formulários

Ative apenas os formulários que utiliza: Contact Form 7, WPForms, Gravity Forms, WooCommerce Checkout, Ninja Forms, Fluent Forms, Formidable, Forminator, MC4WP (Mailchimp), WS Forms, Mailster, Comentários do WordPress.

Como Funciona a Validação

Fluxo de Validação

Usuário submete um form with um email endereço
  ↓
Plugin intercepta ANTES WordPress de processá-lo ele
  ↓
Memória cache (instantâneo, por-request)
  ↓
Persistente cache (WordPress transitório, configurável TTL)
  ↓
API créditos de sintaxe (GET /api/v1/conta)
  ↓
API validação chamar (POST /api/v1/verify)
  ↓
API devolve status with confiança score e MX detalhes
  ↓
BLOQUEAR: invalid, Wegwerf-E-Mail, error
PERMITIR: valid, arriscado, unbekannt, over_quota
  ↓
Registar à banco de dados + incrementar diário estatísticas

Estados Devolvidos pela API

Insight principal: valid, invalid, over_quota, and disposable consume 1 credit each.
Erro, desconhecido e arriscado são gratuitos. Gate SMTP interno ocupado
os estados nunca são devolvidos — aparecem como unknown.

Regras de Bloqueio Predefinidas

• Permitidos: valid, risky, unknown, over_quota
• Bloqueados: invalid, disposable, error
• Bloqueados opcionalmente: fornecedores de e-mail gratuitos (Gmail, Yahoo…) se o interruptor estiver ativado

Quando Algo Corre Mal

O plugin nunca interrompe os seus formulários:

Painel — Início Rápido

N-Software Email Validator → Painel

• Conta: Plano, créditos restantes, barra de progresso
• Estatísticas de Hoje:válido / inválido / arriscado / descartável para o dia atual
• Validação Rápida: Digite um e-mail, clique em Validar e veja o resultado imediatamente

Use a Validação Rápida para testar sua chave de API e um único endereço antes de entrar em produção.

Validação em Massa — Verificação em Lote

N-Software Email Validator → Validação em Massa

Preparando o Arquivo

• Formato: CSV ou TXT
• Um endereço por linha (CSV: primeira coluna)
• Máximo de 5.000 endereços únicos
• Linhas de cabeçalho (email, e-mail) are auto-skipped

Etapas

1. Escolher Arquivo → selecione CSV ou TXT
2. Iniciar Validação em Massa
3. Acompanhe a barra de progresso (lote por lote)
4. Ao concluir: Exportar CSV com resultados

A Exportação Contém

Email, Status, Confidence, MX Server, Is Free, Is Disposable, Is Role, Reason, Domain

Registos — Histórico de Validações

N-Software Email Validator → Registros

• Últimos 100 validações (e-mail, status, confiança, MX, data)
• Teste de Depuração — valide um endereço e registre o resultado
• Limpar Cache— limpar resultados em cache (não os logs)
• Atualizar — recarregar a tabela
• Logs com mais de 7 dias são limpos automaticamente através do WP Cron

Saúde do E-mail — Verificação e Limpeza

O módulo mais poderoso. Verifica os endereços existentes na base de dados do seu site.

Fontes Analisadas

Controlos de Análise

Tamanho do lote: 5–50 por lote. Ritmo: 200–10.000 ms entre as requisições — quanto menor, mais rápido, mas maior a carga na API.

Fluxo de Trabalho Típico

1. Escolha as fontes (ex.: Usuários do WP + Comentários)
2. Iniciar Análise
3. Acompanhe a barra de progresso e as estatísticas
4. Filtre categorias ruins (Inválido, Descartável, Erro)
5. Selecione as linhas ou use a Seleção Automática
6. Excluir Selecionados ou Anonimizar Selecionados
7. Para exclusão: digite DELETE no modal de confirmação

Filtros e Tabela

• Filtros: Todos, Válidos, Inválidos, Arriscados, Descartáveis, Desconhecidos, Erro, Caixa Cheia, Limite de Taxa Atingido, Rechecados
• Colunas: E-mail, Status, Confiança, Servidor MX
• Paginação: 25 / 50 / 100 por página

Verificar Novamente

• Verificar Novamente esta Categoria — rechecka todas as entradas do filtro ativo
• Verificado novamente as entradas exibem um marcador 🔄 e um filtro dedicado

Excluir vs. Anonimizar

⚠️ A eliminação é irreversível — o modal exige a palavra DELETE para confirmação.

Persistência

• Progresso guardado nas tabelas MySQL: wp_north_ev_health_emails, wp_north_ev_health_results
• Estado de metadados: nev_health_scan_state option
• Guardar Progresso usa UPSERT — nunca elimina resultados existentes
• Ao sair do separador, o plugin guarda automaticamente através de sendBeacon

Importante — Separador em Segundo Plano

A Verificação de Saúde de E-mails e a Validação em Massa são executadas no navegador (JavaScript + AJAX). Os separadores inativos abrem temporizadores lentos — as análises ficam mais lentas ou param. Mantenha o separador de administração ativo durante análises extensas. A proteção de formulários e registos funciona normalmente sem um separador aberto.

Utilizadores → Coluna de Estado do E-mail

Em Utilizadores → Todos os Utilizadores verá um distintivo para cada utilizador:

• Estado a partir dos metadados do utilizador (nev_email_status)
• Alternativa: entrada mais recente nos registos de validação
• Atualizado no registo, na validação de formulários e nas análises de Saúde de E-mails

Créditos e Notificações

Guias Rápidos de Cenários

A — Proteger o Registo

1. Definições → introduzir a Chave de API
2. Ative o Validar no Registo
3. Teste: registar com test@mailinator.com — should be blocked

B — Formulário CF7

1. Definições → ativar Contact Form 7
2. Envie um formulário de teste com um e-mail inválido
3. Verificar os Registos

C — Limpar Utilizadores Antigos

1. Saúde do E-mail → selecionar Utilizadores do WordPress
2. Iniciar Análise → aguardar
3. Filtrar Inválidos + Descartáveis
4. Excluir Selecionados (confirme com DELETE)

D — Validar uma Lista de E-mails

1. Validação em Massa → carregar CSV
2. Exportar resultados
3. Remova os inválidos/descartáveis da sua lista no Mailchimp/Brevo/etc.

Esquema da Base de Dados (Técnico)

Tabelas com $wpdb prefix:

• Desativação: Dados preservados
• Desinstalação: Remove todas as tabelas, opções, transientes e tarefas cron
• Multisite: Suportado — ativação por site ou em toda a rede

FAQ / Resolução de problemas

P: O Plugin Check relata erros?
R: Use o ZIP mais recente (1.3.13). Elimine o plugin antigo antes de reinstalar.

P: A validação não funciona num formulário?
R: Verifique se a integração está ativada em Settings e se tem créditos.

P: Perdeu o progresso do Email Health?
R: Clique em Continue Scan. Os dados estão na base de dados, a menos que tenha usado Restart Fresh.

P: O Save Progress indica um erro, mas os dados estão lá?
R: Na versão 1.3.x, o Save verifica o número de linhas no servidor — atualize a página.

P: Posso verificar 50.000 endereços?
R: Tecnicamente sim, mas mantenha o separador aberto e defina o ritmo para 1000–2000 ms.

P: Onde obtenho uma chave de API?
R: email-validaton.com → Dashboard → API Key.

Resumo

O N-Software Email Validator é um kit completo de higiene de e-mails para WordPress:

• Proteção em tempo real em formulários, registos e no checkout do WooCommerce
• Validação de listas em massa com carregamento de CSV/TXT
• Limpeza da base de dados através do scanner Email Health
• Acompanhamento de créditos com indicadores de estado claros

Para utilização em produção: configure primeiro Settings e Quick Validate, depois ative as integrações e, por fim, use Email Health para auditar os endereços existentes.

Transferir o plugin →