Tes formulaires. Ton serveur.

Installation

1. Télécharge le ZIP de l’extension prêt à installer depuis les releases GitHub. Utilise l’archive de distribution, pas l’archive du code source : les dépendances Composer sont nécessaires.
2. Dans WordPress, ouvre Extensions → Ajouter → Téléverser une extension. Envoie le ZIP, installe-le et active-le.
3. Ajoute un champ Gaitcha à un formulaire compatible, ou active un formulaire natif dans Réglages → Gaitcha.
4. Teste le formulaire public en étant déconnecté. Les administrateurs contournent la validation par défaut.

L’extension génère son secret de signature à l’activation. Elle nécessite WordPress 6.0+ et PHP 7.4+. Ce minimum décrit la compatibilité ; utilise une version PHP encore maintenue par ton hébergement.

Huit intégrations de formulaires

Les connecteurs se chargent lorsque leur extension de formulaire est active. Ils font partie de Gaitcha for WordPress ; le core PHP ne contient pas ces connecteurs.

Contact Form 7

Insère [gaitcha] avant le bouton d’envoi. La validation passe par le filtre antispam de CF7. Voir le guide Contact Form 7.

Gravity Forms

Ajoute Gaitcha depuis Champs avancés. Le connecteur valide côté serveur et se réinitialise après un rendu AJAX. Voir le guide Gravity Forms.

WPForms

Ajoute Gaitcha depuis les champs standards. L’adaptateur transmet les données cachées du widget à la validation WPForms. Teste aussi une soumission en erreur suivie d’un nouvel essai.

Fluent Forms

Ajoute l’élément Gaitcha dans le constructeur. Le connecteur déclare son type de champ pour que le parseur conserve les données de vérification, y compris dans les soumissions imbriquées.

Formidable Forms

Choisis Gaitcha dans la palette de champs. L’intégration utilise une classe de champ et le hook de validation de Formidable. Teste le parcours normal et les erreurs après publication.

Ninja Forms

Ajoute le champ Gaitcha. Le connecteur prend en charge la charge utile AJAX de Ninja Forms et retire l’erreur du champ captcha quand le visiteur coche à nouveau la case.

WS Form Pro

Glisse Gaitcha depuis Spam Protection. Le connecteur gère aussi les formulaires rendus dynamiquement, notamment en AJAX ou dans une popup. Cette intégration cible WS Form Pro.

Elementor Pro

Ajoute un champ de type Gaitcha dans un widget Forms d’Elementor Pro. Les données de vérification sont retirées de l’enregistrement avant les emails et les autres actions. Voir le guide Elementor Pro.

Formulaires natifs WordPress

Dans Réglages → Gaitcha, active séparément la protection de la connexion, de l’inscription, du mot de passe oublié et des commentaires. Ces quatre protections sont désactivées par défaut.

Ces réglages concernent les formulaires natifs WordPress. Le paiement WooCommerce et les formulaires d’espace membre personnalisés ne font pas partie de ces intégrations.

Apparence et réglages par défaut

Choisis un thème clair, sombre ou automatique, puis un style classique ou minimal. Les deux réglages se combinent et s’appliquent à tous les connecteurs.

La preuve de travail et l’anti-rejeu sont activés par défaut dans l’extension. L’anti-rejeu conserve temporairement un état dans les options WordPress. La bibliothèque PHP les laisse désactivés tant qu’ils ne sont pas configurés.

Hooks pour développeurs

Le filtre gaitcha_config permet d’ajuster le core. Enregistre-le dans une extension de site ou un mu-plugin : Gaitcha le lit sur plugins_loaded, avant le chargement du functions.php du thème. Cet exemple laisse trois minutes pour envoyer le formulaire après l’émission du jeton :

/**
 * Ajuste la durée de validité des jetons pour ce site.
 *
 * @param array $config Configuration Gaitcha.
 * @return array
 */
function mysite_gaitcha_config( array $config ): array {
    $config['ttl'] = 180;
    return $config;
}
add_filter( 'gaitcha_config', 'mysite_gaitcha_config' );

Pour soumettre aussi les administrateurs à la vérification :

add_filter( 'gaitcha_bypass_admin', '__return_false' );

La référence des hooks dans le README détaille les options et leurs valeurs par défaut, avec des exemples pour régler le seuil de score et ajuster ou désactiver la preuve de travail.

Mises à jour et dépannage

Les mises à jour arrivent depuis GitHub Releases, dans l’écran de mises à jour WordPress. Cette vérification administrative contacte GitHub ; la validation du captcha reste sur ton site.

Si le widget ne charge pas, vérifie son JavaScript et l’accès à /wp-json/gaitcha/v1/init. Exclus cet endpoint du cache de pages. Si le formulaire coché est rejeté, vérifie l’intégration AJAX, l’expiration des jetons et la console avant de changer le seuil.

Consulte le fonctionnement et les limites. Signale les problèmes dans les issues de l’extension, avec les versions et les étapes de reproduction, sans données de visiteurs.

Pour avancer à partir du symptôme, consulte le guide de dépannage.