N-Software Email Validator — Plugin para WordPress

O que é o N-Software Email Validator?

O N-Software Email Validator é um plugin para WordPress que verifica endereços de e-mail em tempo real através da email-validaton.com API. Ele impede registos falsos, endereços descartáveis (temporários) e caixas de correio inexistentes antes de entrarem na sua base de dados — no registo, em formulários, comentários e no checkout do WooCommerce.

Três camadas de proteção:

Fluxo de Validação — Como Funciona

Estados do E-mail — O Que É Bloqueado, O Que Consome Créditos

Chave: valid, invalid, over_quota, and disposable consume 1 credit each. Disposable, error, unknown, and risky checks are free. Internal SMTP-gate busy states are never returned — they appear as unknown.

Degradação elegante — os formulários nunca falham

Integrações com formulários — mais de 9 plugins

Integra-se nativamente com estes criadores de formulários e funcionalidades da plataforma:

Todas as integrações apresentam erros em linha — texto a vermelho junto ao campo de e-mail, seguindo o estilo de erro nativo de cada plugin. O formulário nunca é submetido se o e-mail estiver bloqueado.

Estrutura do Painel de Administração

Widget do Painel do WordPress: Plano, créditos, barra de progresso e estatísticas de hoje, num relance.

Utilizadores → Todos os Utilizadores: Estado do e-mail coluna com distintivo — Válido, Inválido, Arriscado, etc.

Referência das Definições

Saúde do E-mail — Verificar e Limpar Endereços Existentes

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

Fontes analisadas:

Controlos da análise: Iniciar análise, Continuar, Recomeçar do zero, Pausar, Parar, Guardar progresso.
Tamanho do lote: 5–50 e-mails por lote. Ritmo: 200–10 000 ms entre pedidos.

Filtrar por estado: Todos, Válidos, Inválidos, Arriscados, Descartáveis, Desconhecidos, Erro, Caixa cheia, Limite de pedidos atingido, Verificados novamente.
Ações: Eliminar selecionados (permanente, requer confirmação com DELETE) ou Anonimizar selecionados (substitui por anon-{id}@deleted.invalid).

Verificar novamente: Volte a verificar uma categoria ou as linhas selecionadas sem perder o progresso anterior.

⚠️ A Saúde do E-mail e a Validação em Massa são executadas no navegador (JavaScript + AJAX). Mantenha o separador de administração ativo durante análises grandes — os separadores em segundo plano abrandam os temporizadores do navegador.

Validação em massa — Processar até 5000 endereços

Carregue um ficheiro CSV ou TXT — um endereço por linha (CSV: primeira coluna). As linhas de cabeçalho são ignoradas automaticamente. O plugin processa-os em lotes com uma barra de progresso em tempo real.

Quando o trabalho for concluído, exporte os resultados em CSV com: Email, Status, Confidence, MX Server, Is Free, Is Disposable, Is Role, Reason, Domain.

Registos — Histórico de Validações

Veja as últimas 100 validações com todos os detalhes: email, pontuação de confiança, servidor MX, data.

Teste de Depuração: Validação de um único endereço com registo na base de dados.
Limpar Cache: Elimina os resultados em cache (não os registos).
Limpeza automática: Os registos com mais de 7 dias são removidos através do WP Cron.

Detalhes Técnicos

Tabelas da base de dados (prefixo $wpdb):

Desativação: Os dados são mantidos. Desinstalação: Remove todas as tabelas, opções, transientes e tarefas cron.
Multisite: Suportado — ativação por site ou em toda a rede.

Segurança

• Injeção SQL: Todas as consultas usam $wpdb->prepare()
• XSS: esc_html__(), esc_attr(), esc_url() throughout
• CSRF: Todos os handlers AJAX verificam os nonces
• Verificação de capacidades: manage_options on all admin endpoints
• Acesso direto: if (!defined('WPINC')) die; in all files
• Chave de API: sanitize_text_field() with validation before saving
• Carregamento de ficheiros: Verificação de extensão + sanitize_email() + is_email()

FAQ / Resolução de problemas

P: A validação não funciona num formulário?
R: Verifique se a integração está ativada nas Definições e se tem créditos disponíveis.

P: Perdeu o progresso do Email Health?
R: Clique em Continuar análise. Os dados são guardados na base de dados. Apenas Reiniciar do zero limpa-o.

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

P: Posso verificar 50.000 endereços?
R: Tecnicamente sim, mas mantenha a aba aberta e defina um ritmo de 1000–2000 ms para ficar dentro dos limites de taxa.

P: Onde obtenho a chave da API?
R: email-validaton.com → Painel → Chave de API

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. Acesse N-Software Email Validator → Configurações e insira sua chave de API
4. Salve — um ponto verde confirma a conexão com a API. Iniciar validação.