Aller au contenu
Antisy

Protéger WPForms contre les robots, sans énigme

Pour protéger WPForms (version Lite) avec Antisy : une balise dans la page, puis le filtre wpforms_process_initial_errors côté serveur. Le script d’Antisy ajoute le champ antisy-token à l’envoi AJAX, et le filtre le lit dans $_POST pour demander un verdict. Essayé le 9 novembre 2026 avec WPForms Lite 2.0.4, dans WordPress 7.1.4.

État au .

Comment WPForms envoie le formulaire

WPForms envoie le formulaire par AJAX à admin-ajax.php, depuis l’événement submit : le script d’Antisy y ajoute le champ antisy-token, comme pour un formulaire ordinaire.

Le crochet à poser

Le filtre wpforms_process_initial_errors reçoit les erreurs avant l’enregistrement de l’entrée. Une erreur posée sous la clé header arrête l’envoi et s’affiche au-dessus du formulaire. antisy_verdict est la fonction de la documentation, décrite dans le guide WordPress.

antisy-formulaires.php
// WPForms : le filtre wpforms_process_initial_errors reçoit les erreurs avant l'enregistrement ; une erreur « header » arrête l'envoi.
add_filter('wpforms_process_initial_errors', function ($errors, $form_data) {
    if (!empty($errors[$form_data['id']])) {
        return $errors; // le formulaire est déjà refusé : pas d'appel à Antisy
    }
    if (antisy_verdict($_POST['antisy-token'] ?? '') !== 'allow') {
        $errors[$form_data['id']]['header'] = 'Envoi refusé.';
    }
    return $errors;
}, 10, 2);

Ce que voit le visiteur refusé

WPForms répond 200 avec success à false : aucune entrée n’est enregistrée, et le texte de l’erreur est celui que vous écrivez, ici un refus générique.

Ce qui a été essayé

Le 9 novembre 2026, sur un poste local, dans un WordPress installé pour l’occasion (WordPress 7.1.4, PHP 8.3.36, WPForms Lite 2.0.4, formulaire en envoi AJAX, le réglage par défaut) : un envoi par un vrai navigateur passe, un envoi par curl sans jeton est refusé quand la collecte du navigateur est allumée pour le site, et un Antisy injoignable laisse passer l’envoi. L’API était le laboratoire local d’Antisy, jamais la production. Aucun courriel n’est parti : l’installation n’a pas de serveur de courrier. Non essayé : WPForms avec l’envoi AJAX coupé, un cache de pages ou un plugin d’optimisation, un visiteur connecté, Firefox et Safari, une page en HTTPS, les autres versions de WordPress et de l’extension.

Pour le reste

La balise dans le <head>, la fonction antisy_verdict, le secret et ce qui se passe quand Antisy ne répond pas sont dans le guide WordPress.

Voir : Guide WordPress : la balise, la fonction, le secret · Documentation : quand l’API ne répond pas