Zum Inhalt springen
Antisy

Contact Form 7 vor Bots schützen, ohne Rätsel

So schützen Sie Contact Form 7 mit Antisy: ein Script-Tag in der Seite, dann der Filter wpcf7_spam auf dem Server. Das Script von Antisy fügt der Übermittlung das Feld antisy-token hinzu, und der Filter liest es in $_POST, um ein Ergebnis anzufordern. Am 9. November 2026 mit Contact Form 7 6.2.4.1 in WordPress 7.1.4 ausprobiert.

Stand: .

Wie Contact Form 7 das Formular sendet

Contact Form 7 sendet das Formular mit fetch an seinen REST-Endpunkt, ausgelöst vom Ereignis submit. Das Script von Antisy hält diese Übermittlung zurück, fügt das versteckte Feld antisy-token hinzu und sendet sie erneut, wie bei einem gewöhnlichen Formular. Das Feld muss im Formular nicht deklariert werden: Ihr Server liest es in $_POST.

Der Hook, den Sie setzen

Der Filter wpcf7_spam wird angewendet, sobald die Felder validiert sind. Gibt er true zurück, gilt die Übermittlung als Spam: Die E-Mail wird nicht gesendet. antisy_verdict ist die Funktion der Dokumentation, beschrieben in der WordPress-Anleitung.

antisy-formulaires.php
// Contact Form 7: Der Filter wpcf7_spam gibt true zurück, wenn die Übermittlung Spam ist, und die E-Mail wird nicht gesendet.
add_filter('wpcf7_spam', function ($spam) {
    if ($spam) {
        return $spam; // von Contact Form 7 schon als Spam eingestuft: kein Aufruf an Antisy
    }
    return antisy_verdict($_POST['antisy-token'] ?? '') !== 'allow';
});

Was ein abgewiesener Besucher sieht

Contact Form 7 antwortet 200 mit dem Status spam und der Meldung «spam» Ihres Formulars, die Sie im Reiter Meldungen festlegen: Lassen Sie eine allgemeine Meldung stehen, die den Grund nicht nennt.

Was ausprobiert wurde

Am 9. November 2026 auf einem lokalen Rechner, in einem eigens installierten WordPress (WordPress 7.1.4, PHP 8.3.36, Contact Form 7 6.2.4.1): 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, und Contact Form 7 antwortet mail_failed, hier als angenommen gezählt. Nicht ausprobiert: 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