WPForms vor Bots schützen, ohne Rätsel
So schützen Sie WPForms (Lite-Version) mit Antisy: ein Script-Tag in der Seite, dann der Filter wpforms_process_initial_errors auf dem Server. Das Script von Antisy fügt der AJAX-Übermittlung das Feld antisy-token hinzu, und der Filter liest es in $_POST, um ein Ergebnis anzufordern. Am 9. November 2026 mit WPForms Lite 2.0.4 in WordPress 7.1.4 ausprobiert.
Stand: .
Wie WPForms das Formular sendet
WPForms sendet das Formular per AJAX an admin-ajax.php, ausgelöst vom Ereignis submit: Das Script von Antisy fügt dort das Feld antisy-token hinzu, wie bei einem gewöhnlichen Formular.
Der Hook, den Sie setzen
Der Filter wpforms_process_initial_errors erhält die Fehler, bevor der Eintrag gespeichert wird. Ein Fehler unter dem Schlüssel header stoppt die Übermittlung und wird über dem Formular angezeigt. antisy_verdict ist die Funktion der Dokumentation, beschrieben in der WordPress-Anleitung.
// WPForms: Der Filter wpforms_process_initial_errors erhält die Fehler vor dem Speichern; ein Fehler «header» stoppt die Übermittlung.
add_filter('wpforms_process_initial_errors', function ($errors, $form_data) {
if (!empty($errors[$form_data['id']])) {
return $errors; // Das Formular ist schon abgelehnt: kein Aufruf an Antisy
}
if (antisy_verdict($_POST['antisy-token'] ?? '') !== 'allow') {
$errors[$form_data['id']]['header'] = 'Übermittlung abgelehnt.';
}
return $errors;
}, 10, 2);Was ein abgewiesener Besucher sieht
WPForms antwortet 200 mit success auf false: Kein Eintrag wird gespeichert, und der Text des Fehlers ist der, den Sie schreiben, hier eine allgemeine Abweisung.
Was ausprobiert wurde
Am 9. November 2026 auf einem lokalen Rechner, in einem eigens installierten WordPress (WordPress 7.1.4, PHP 8.3.36, WPForms Lite 2.0.4, Formular mit AJAX-Versand, der Standardeinstellung): Eine Übermittlung durch einen echten Browser geht durch, eine Übermittlung mit curl ohne Token wird abgewiesen, wenn die Browser-Erfassung für die Website eingeschaltet ist, und ein nicht erreichbares Antisy lässt die Übermittlung durch. Die API war das lokale Labor von Antisy, nie die Produktion. Es wurde keine E-Mail verschickt: Die Installation hat keinen Mailserver. Nicht ausprobiert: WPForms mit abgeschaltetem AJAX-Versand, ein Seiten-Cache oder ein Optimierungs-Plugin, ein angemeldeter Besucher, Firefox und Safari, eine HTTPS-Seite, andere Versionen von WordPress und des Plugins.
Der Rest
Das Script-Tag im <head>, die Funktion antisy_verdict, das Secret und was geschieht, wenn Antisy nicht antwortet, stehen in der WordPress-Anleitung.
Siehe: WordPress-Anleitung: das Script-Tag, die Funktion, das Secret · Dokumentation: wenn die API nicht antwortet