Documentation
đ Documentation Captcha Fusion
Guide complet d’installation et de configuration
đ Table des matiĂšres
1ïžâŁ PrĂ©requis
Avant d’installer Captcha Fusion, assurez-vous que votre environnement rĂ©pond aux exigences suivantes :
- WordPress : Version 6.0 ou supérieure
- PHP : Version 7.4 ou supérieure (8.0+ recommandé)
- Licence active : Abonnement mensuel ou annuel Captcha Fusion
- Clés Google reCAPTCHA : Compte Google et clés API (voir section suivante)
2ïžâŁ Obtenir vos clĂ©s Google reCAPTCHA
Avant d’utiliser Captcha Fusion, vous devez obtenir des clĂ©s API gratuites de Google reCAPTCHA. Ce processus prend environ 2 minutes.
Créez un nouveau site
Cliquez sur le bouton « + » pour créer un nouveau site.
Remplissez le formulaire
Libellé : Donnez un nom à votre site (ex: « Mon Site WordPress »)
Type reCAPTCHA : Sélectionnez « reCAPTCHA v3 »
Domaines : Ajoutez votre nom de domaine (ex: monsite.com)
Récupérez vos clés API
Google vous fournira deux clés :
– ClĂ© du site (Site Key) : clĂ© publique
– ClĂ© secrĂšte (Secret Key) : clĂ© privĂ©e
Copiez ces deux clés, vous en aurez besoin pour la configuration du plugin.
Répétez pour reCAPTCHA v2
Créez une seconde configuration en sélectionnant « reCAPTCHA v2 » > « Je ne suis pas un robot ». Récupérez également ces clés.
3ïžâŁ Installation du plugin
MĂ©thode 1 : Installation depuis votre compte
Téléchargez le plugin
Lors de votre commande, vous avez reçu par e-mail un lien pour télécharger la derniÚre version du plugin Captcha Fusion. Utilisez ce lien pour télécharger le plugin.
Accédez à WordPress
Dans votre administration WordPress, allez dans Extensions > Ajouter une extension
Téléversez le fichier ZIP
Cliquez sur « Téléverser une extension » en haut de la page, puis « Choisir un fichier » et sélectionnez le fichier ZIP téléchargé.
Installez et activez
Cliquez sur « Installer maintenant » puis « Activer l’extension »
4ïžâŁ Configuration de base
Accédez aux réglages
Dans le menu WordPress, allez dans RĂ©glages > Captcha Fusion
Activez votre licence
Dans l’onglet « Licence », entrez votre clĂ© de licence reçue par email aprĂšs votre achat. Enregistrez la licence et ensuite cliquez sur « Activer ».
Configurez reCAPTCHA V3
Dans l’onglet « ClĂ©s API » :
– Collez votre ClĂ© du site V3
– Collez votre ClĂ© secrĂšte V3
Configurez reCAPTCHA V2 (Fallback)
Dans l’onglet « reCAPTCHA V2 » :
– Collez votre ClĂ© du site V2
– Collez votre ClĂ© secrĂšte V2
Enregistrez
Cliquez sur « Enregistrer les modifications » en bas de la page.
5ïžâŁ Protection des formulaires WordPress
Captcha Fusion peut protéger automatiquement les formulaires natifs de WordPress : connexion, inscription, et récupération de mot de passe.
Activer la protection
Accédez aux réglages des formulaires
Dans RĂ©glages > Captcha Fusion > Formulaires
Activez les formulaires souhaités
Cochez les cases pour activer la protection et indiquez un score pour la V3 :
– âïž Formulaire de connexion
– âïž Formulaire d’inscription
– âïž Mot de passe oubliĂ©
– âïž Faites de mĂȘme pour les autres formulaires tiers
Enregistrez
Cliquez sur « Enregistrer »
6ïžâŁ IntĂ©gration Contact Form 7
Captcha Fusion s’intĂšgre nativement Ă Contact Form 7 avec une configuration par formulaire.
Ăditez votre formulaire CF7
Allez dans Contact > Formulaires de contact et cliquez sur le formulaire à protéger.
Activez Captcha Fusion
Dans l’onglet form, trouvez le champ « Captcha Fusion » et ajoutez le
Configurez le seuil de score
Définissez le seuil de score V3 pour ce formulaire spécifique (0.5 par défaut) en éditant le champ. Vous pouvez utiliser un score différent pour chaque formulaire.
Enregistrez
Cliquez sur « Enregistrer »
7ïžâŁ IntĂ©gration Ninja Forms
Ăditez votre formulaire
Allez dans Ninja Forms > Tableaux de bord et éditez le formulaire à protéger.
Ajoutez le champ
Cliquez sur l’icĂŽne pour ajouter un champ puis cherchez le champ « Captcha Fusion » et ajoutez le
Activez Captcha Fusion
Dans la section « RĂ©glage » du champ, configurez le seuil de score et l’action souhaitĂ©.
Publiez
Cliquez sur « Publier » ou « Mettre à jour »
8ïžâŁ DĂ©pannage
Le captcha ne s’affiche pas
- Vérifiez que vos clés API sont correctement configurées
- Videz le cache de votre site (si vous utilisez un plugin de cache)
- Vérifiez que votre domaine est bien enregistré dans la console Google reCAPTCHA
- DĂ©sactivez temporairement les autres plugins pour identifier un conflit potentiel
Le fallback V2 ne fonctionne pas
- Vérifiez que vous avez bien configuré les clés V2 en plus des clés V3
- Assurez-vous que les deux domaines (V2 et V3) sont identiques dans Google
Les formulaires sont bloqués pour les vrais utilisateurs
- RĂ©duisez le seuil de score V3 (essayez 0.4 ou 0.3)
- Vérifiez que le fallback V2 est bien activé
Message d’erreur « Licence invalide »
- VĂ©rifiez que votre abonnement est actif
- Assurez-vous d’utiliser la bonne clĂ© de licence
- VĂ©rifiez que le domaine correspond Ă celui de votre licence
- Contactez le support : hello@captchafusion.com