N-Software Email Validator — Vollständige Anleitung & Handbuch für das WordPress-Plugin

Version: 1.3.13 · Plattform: WordPress-Plugin · API: email-validaton.com

Der N-Software Email Validator ist ein WordPress-Plugin zur Echtzeit-E-Mail-Verifizierung über die 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.

Diese Anleitung behandelt alle Funktionen im Detail – von der Installation bis zur Fehlerbehebung für Fortgeschrittene.

Was ist das?

Das Plugin fängt jede E-Mail-Adresse ab, die auf deiner WordPress-Website übermittelt wird – in Registrierungsformularen, Kontaktformularen, Kommentaren und der WooCommerce-Kasse – und prüft sie anhand der email-validaton.com API before WordPress processes it.

Drei Schutzebenen

Voraussetzungen

Installation – 4 Schritte

1. Lade die ZIP-Datei oder den Ordner hoch n-software-email-validator to /wp-content/plugins/
2. Plugins → Installierte Plugins → Aktivieren
3. Der Menüpunkt N-Software Email Validator erscheint in der Seitenleiste
4. Öffnen Sie Einstellungen → API-Schlüssel eingeben → speichern. Ein grüner Punkt mit der Bezeichnung API verbunden bestätigt die Verbindung

Aufbau des Admin-Bereichs

N-Software Email Validator
├── Dashboard      — Konto, Tarif, Statistiken, Schnell Einzel-email Validierung
├── Einstellungen       — API Schlüssel, Validierung Regeln, Formular Integrationen
├── Bulk Validieren  — Massen Verifizierung von CSV/TXT Dateien
├── Protokolle           — Letzte 100 Validierungen mit Details
└── Email Health-Check   — Scan bestehende Adressen + Bereinigung

Zusätzlich:

• WordPress-Dashboard-Widget — Tarif, Guthaben, Fortschrittsbalken, heutige Statistiken
• Benutzer → Alle Benutzer — E-Mail-Status Spalte (Gültig, Ungültig, Riskant usw.)

Einstellungsreferenz

API-Konfiguration

Der Cache spart Guthaben — dieselbe Adresse wird während der Gültigkeit des Caches nicht erneut an die API gesendet.

Validierungsregeln

Formular-Integrationen

Aktivieren Sie nur die Formulare, die Sie verwenden: Contact Form 7, WPForms, Gravity Forms, WooCommerce-Kasse, Ninja Forms, Fluent Forms, Formidable, Forminator, MC4WP (Mailchimp), WS Forms, Mailster, WordPress-Kommentare.

So funktioniert die Validierung

Validierungsablauf

Nutzer sendet 500er Formular mit eine email Adresse
  ↓
Plugin fängt ab VOR WordPress Prozesse it
  ↓
Speicher Cache (sofort, pro-request)
  ↓
Persistent Cache (WordPress transient, konfigurierbar TTL)
  ↓
API Credits Prüfung (GET /API/v1/Konto)
  ↓
API Validierung call (POST /API/v1/verify)
  ↓
API gibt zurück status mit Konfidenz score und MX Details
  ↓
BLOCK: ungültig, Wegwerf, error
ALLOW: gültig, riskant, unbekannt, over_quota
  ↓
Protokoll auf Datenbank + erhöhen täglich Statistiken

Vom API zurückgegebene Status

Wichtige Erkenntnis: valid, invalid, over_quota, and disposable consume 1 credit each.
Fehler, unbekannt und riskant sind kostenlos. Interner SMTP-Gate ausgelastet
Zustände werden nie zurückgegeben – sie erscheinen als unknown.

Standard-Sperrregeln

• Erlaubt: valid, risky, unknown, over_quota
• Gesperrt: invalid, disposable, error
• Optional gesperrt: kostenlose E-Mail-Anbieter (Gmail, Yahoo…), wenn der Schalter aktiviert ist

Wenn etwas schiefgeht

Das Plugin unterbricht Ihre Formulare niemals:

Dashboard – Schnellstart

N-Software Email Validator → Dashboard

• Konto: Tarif, verbleibende Credits, Fortschrittsbalken
• Heutige Statistik: valid / invalid / risky / disposable für den aktuellen Tag
• Schnellprüfung: E-Mail eingeben, auf Validieren klicken und das Ergebnis sofort sehen

Verwenden Sie Quick Validate, um Ihren API-Schlüssel und eine einzelne Adresse zu testen, bevor Sie live gehen.

Bulk Validate — Massenverifizierung

N-Software Email Validator → Bulk Validate

Datei vorbereiten

• Format: CSV- oder TXT-Datei
• Eine Adresse pro Zeile (CSV: erste Spalte)
• Maximal 5.000 eindeutige Adressen
• Kopfzeilen (email, e-mail) are auto-skipped

Schritte

1. Datei auswählen → CSV- oder TXT-Datei auswählen
2. Massenvalidierung starten
3. Fortschrittsbalken verfolgen (Batch für Batch)
4. Nach Abschluss: CSV exportieren mit Ergebnissen

Export enthält

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

Protokolle – Validierungsverlauf

N-Software Email Validator → Protokolle

• Letzte 100 Validierungen (E-Mail, Status, Konfidenz, MX, Datum)
• Debug-Test — eine Adresse validieren + Ergebnis protokollieren
• Cache leeren — zwischengespeicherte Ergebnisse löschen (nicht die Protokolle)
• Aktualisieren — Tabelle neu laden
• Protokolle, die älter als 7 Tage sind, werden über WP-Cron automatisch bereinigt

E-Mail-Gesundheit — Prüfen & Bereinigen

Das leistungsstärkste Modul. Prüft vorhandene Adressen in Ihrer Website-Datenbank.

Geprüfte Quellen

Scan-Steuerung

Batch-Größe: 5–50 pro Charge. Tempo: 200–10.000 ms zwischen Anfragen — niedriger = schneller, aber höhere API-Last.

Typischer Ablauf

1. Quellen auswählen (z. B. WP-Benutzer + Kommentare)
2. Scan starten
3. Fortschrittsbalken und Statistiken beobachten
4. Problematische Kategorien filtern (Ungültig, Wegwerf-Adresse, Fehler)
5. Zeilen auswählen oder Automatische Auswahl verwenden
6. Ausgewählte löschen oder Ausgewählte anonymisieren
7. Zum Löschen im Bestätigungsfenster DELETE eingeben

Filter und Tabelle

• Filter: Alle, Gültig, Ungültig, Riskant, Wegwerf-Adresse, Unbekannt, Fehler, Postfach voll, Ratenlimit erreicht, Erneut geprüft
• Spalten: E-Mail, Status, Konfidenz, MX-Server
• Seitennummerierung: 25 / 50 / 100 pro Seite

Erneut prüfen

• Diese Kategorie erneut prüfen — prüft alle Einträge im aktiven Filter erneut
• Erneut geprüft Einträge zeigen eine 🔄-Markierung und einen eigenen Filter

Löschen vs. Anonymisieren

⚠️ Die Löschung ist unwiderruflich – das Modalfenster erfordert zur Bestätigung das Wort DELETE.

Persistenz

• Fortschritt gespeichert in MySQL-Tabellen: wp_north_ev_health_emails, wp_north_ev_health_results
• Meta-Status: nev_health_scan_state option
• Fortschritt speichern verwendet UPSERT – löscht niemals vorhandene Ergebnisse
• Beim Verlassen des Tabs speichert das Plugin automatisch über sendBeacon

Wichtig – Hintergrund-Tab

Email Health und Bulk Validation laufen im Browser (JavaScript + AJAX). Inaktive Browser-Tabs verlangsamen Timer – Scans werden langsamer oder stoppen. Halte den Admin-Tab bei großen Scans aktiv. Formular- und Registrierungsschutz funktioniert auch ohne geöffneten Tab normal weiter.

Benutzer → Spalte E-Mail-Status

Auf Benutzer → Alle Benutzer siehst du für jeden Benutzer ein Badge:

• Status aus Benutzer-Meta (nev_email_status)
• Fallback: neuester Eintrag in den Validierungsprotokollen
• Aktualisiert bei Registrierung, Formularvalidierung und Email Health-Scans

Guthaben und Benachrichtigungen

Kurzanleitungen für Szenarien

A — Registrierung schützen

1. Einstellungen → API-Schlüssel eingeben
2. Aktiviere Bei der Registrierung validieren
3. Test: Registrierung mit test@mailinator.com — should be blocked

B — CF7-Formular

1. Einstellungen → aktivieren Contact Form 7
2. Ein Testformular mit ungültiger E-Mail-Adresse absenden
3. Protokolle prüfen

C — Alte Benutzer bereinigen

1. E-Mail-Gesundheit → auswählen WordPress-Benutzer
2. Scan starten → warten
3. Ungültige + Wegwerf-Adressen filtern
4. Ausgewählte löschen (mit DELETE bestätigen)

D — Eine Mailingliste validieren

1. Massenvalidierung → CSV hochladen
2. Ergebnisse exportieren
3. Ungültige/Wegwerf-Adressen in Mailchimp/Brevo/etc. aus deiner Liste entfernen

Datenbankschema (technisch)

Tabellen mit $wpdb prefix:

• Deaktivierung: Daten bleiben erhalten
• Deinstallation: Entfernt alle Tabellen, Optionen, Transienten und Cron-Jobs
• Multisite: Unterstützt — Aktivierung pro Website oder netzwerkweit

FAQ / Fehlerbehebung

F: Plugin-Prüfung meldet Fehler?
A: Verwende das neueste ZIP (1.3.13). Lösche das alte Plugin, bevor du es neu installierst.

F: Die Validierung funktioniert in einem Formular nicht?
A: Prüfen Sie, ob die Integration in den Einstellungen aktiviert ist und Sie über Credits verfügen.

F: Fortschritt der E-Mail-Gesundheitsprüfung verloren?
A: Klicken Sie auf Scan fortsetzen. Die Daten befinden sich in der Datenbank, sofern Sie nicht „Neu starten“ verwendet haben.

F: Fortschritt speichern meldet einen Fehler, aber die Daten sind vorhanden?
A: In Version 1.3.x überprüft Speichern die Anzahl der Zeilen serverseitig – laden Sie die Seite neu.

F: Kann ich 50.000 Adressen prüfen?
A: Technisch ja, aber lassen Sie den Tab geöffnet und stellen Sie das Tempo auf 1000–2000 ms ein.

F: Wo erhalte ich einen API-Schlüssel?
A: email-validaton.com → Dashboard → API-Schlüssel.

Zusammenfassung

Der N-Software Email Validator ist ein umfassendes Toolkit zur E-Mail-Hygiene für WordPress:

• Echtzeitschutz für Formulare, Registrierungen und die WooCommerce-Kasse
• Massenvalidierung von Listen mit CSV/TXT-Upload
• Datenbankbereinigung über den E-Mail-Health-Scanner
• Credit-Verfolgung mit klaren Statusanzeigen

Für den Produktiveinsatz: Konfigurieren Sie zuerst die Einstellungen und die Schnellvalidierung, aktivieren Sie anschließend die Integrationen und nutzen Sie dann Email Health für eine Prüfung bestehender Adressen.

Plugin herunterladen →