Zum Inhalt springen
Antisy

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.

antisy-formulaires.php
// 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