Prérequis
- WordPress 6.0 ou version ultérieure
- PHP 7.4 ou version ultérieure
- Un compte Didit Console
Étape 1 : Obtenez vos identifiants Didit
- Créez un compte ou connectez-vous sur business.didit.me
- Accédez à API et Webhooks et copiez votre Clé API
- Accédez à Workflows, créez ou sélectionnez un workflow, puis copiez l’ID du workflow
Vous pouvez utiliser une URL UniLink pour prévisualiser le parcours de vérification sans clés API.
Utilisez le mode Session API avec une clé API et un ID de workflow pour les contrôles de contenu et les exigences de vérification WooCommerce.
Une finalisation UniLink seule ne débloque pas le contenu protégé et n’approuve pas une commande.
Étape 2 : Installez l’extension
- Téléchargez
didit-verify-0.3.4.zipdepuis la version 0.3.4 - Dans l’administration de WordPress, accédez à Extensions → Ajouter → Téléverser une extension
- Choisissez le fichier ZIP téléchargé, puis cliquez sur Installer maintenant
- Cliquez sur Activer
Didit Verify est également référencée sur WordPress.org.
Vérifiez la version avant l’installation : utilisez la 0.3.4 ou une version ultérieure pour bénéficier du comportement de vérification confirmé par le serveur décrit ici.
À partir de la 0.3.4, l’accès au contenu protégé est révoqué lorsqu’une vérification approuvée est ensuite refusée, expire ou repasse en examen.
Si le répertoire propose une version plus ancienne, installez le ZIP de version ci-dessus.
Étape 3 : Configurez l’extension
Accédez à Paramètres → Didit Verify.Choisissez votre mode
Pour UniLink : définissez le mode sur « UniLink », collez votre URL, puis enregistrez.
Pour Session API : définissez le mode sur « Session API », saisissez l’ID de votre workflow et votre clé API, puis enregistrez.
La clé API est stockée de manière sécurisée sur votre serveur et n’est jamais exposée aux visiteurs.
Configurez les options de session (mode API uniquement)
Ces paramètres facultatifs vous donnent un contrôle plus fin :- Données du vendeur : lie chaque vérification à un utilisateur précis dans votre tableau de bord Didit, afin de savoir qui s’est vérifié. Par défaut, il s’agit de l’ID utilisateur WordPress (par exemple
wp-42). Vous pouvez aussi choisir l’e-mail de l’utilisateur, un préfixe personnalisé ou désactiver cette option. - URL de rappel : une page de votre site vers laquelle les utilisateurs sont redirigés après la vérification. Didit ajoute
verificationSessionIdetstatuscomme paramètres de requête. - Méthode de rappel : l’appareil qui gère la redirection :
initiator(l’appareil qui a démarré la session),completer(l’appareil qui la termine) ouboth(les deux). - Langue : choisissez parmi 54 langues ou laissez la détection automatique à partir du navigateur.
Configurez les options d’affichage
- Mode d’affichage : Modal (fenêtre superposée) ou Intégré (directement dans la page)
- Bouton de fermeture : affiche ou masque la croix sur la fenêtre modale
- Confirmation de sortie : affiche une boîte de dialogue « Êtes-vous sûr ? » lors de la fermeture
- Fermeture automatique : ferme automatiquement la fenêtre modale lorsque la vérification se termine
- Journalisation de débogage : consigne les événements du SDK dans la console du navigateur (pour le dépannage)
Personnalisez le bouton
Sous Apparence du bouton, vous pouvez modifier :- le texte du bouton et le texte affiché en cas de réussite
- la couleur d’arrière-plan et la couleur du texte
- le rayon de bordure, l’espacement intérieur et la taille de police
Étape 4 : Ajoutez la vérification à votre site
Pour les boutiques WooCommerce
- Dans Paramètres → Didit Verify → WooCommerce, cochez Exiger la vérification d’identité au paiement
- Choisissez l’emplacement de la section de vérification :
- En haut de la page de paiement
- Après les détails de facturation
- Après les notes de commande
- Avant « Passer la commande » (recommandé)
- Vous pouvez éventuellement choisir un Périmètre des produits : tous les produits (par défaut), uniquement les produits sélectionnés, ou tous les produits sauf les produits sélectionnés. Marquez les produits avec la case Vérification Didit sous Données produit → Avancé dans l’éditeur de produit. Un panier contenant au moins un produit nécessitant une vérification exige cette vérification. Le périmètre s’applique à la fois au paiement et au mode d’après-achat.
- Vous pouvez modifier le Titre de section, le Message de paiement et le Message après achat sous Paramètres → Didit Verify → WooCommerce ; les champs vides utilisent le texte par défaut.
- Vous pouvez activer Envoyer les données de facturation pour transmettre automatiquement le nom, l’e-mail, le téléphone et l’adresse du client à Didit, afin de préremplir les champs et de procéder à une validation croisée.
Les codes pays sont automatiquement convertis du format alpha-2 de WooCommerce vers le format alpha-3 requis par Didit.
Pour n’importe quelle page WordPress
Ajoutez ce shortcode à n’importe quelle page ou article :Étape 5 : Restreindre le contenu aux utilisateurs vérifiés (facultatif)
Afficher ou masquer du contenu selon l’état de vérification : Les restrictions de contenu exigent un utilisateur connecté et une approbation confirmée via le mode API Session. Les callbacks du navigateur et les paramètres de requête de redirection n’accordent pas d’accès.Vérifier l’état de la vérification
Dépannage
Sécurité
Le plugin agit comme un proxy sécurisé côté serveur. Votre clé API n’atteint jamais le navigateur. Chaque requête de session est protégée par :- Nonce CSRF : les requêtes doivent provenir de votre site WordPress
- Exigence de connexion : seuls les utilisateurs enregistrés peuvent créer des sessions (configurable)
- Limitation de débit : 10 sessions/heure par utilisateur, 3/heure par IP pour les invités
- Assainissement des entrées : tous les champs sont filtrés par liste blanche et assainis côté serveur
Pour les développeurs
Hooks PHP
Le plugin déclenche des actions WordPress auxquelles d’autres plugins ou thèmes peuvent se connecter :Événement JavaScript
Un événement DOM est émis lorsque la vérification se termine :Vérifier la vérification en PHP
didit:complete du navigateur.