Documentation WPConsent

Documentation, matériel de référence et tutoriels pour WPConsent

Intégration WP Consent API

Vous souhaitez que d'autres plugins WordPress reconnaissent automatiquement les choix de consentement de vos visiteurs ? WPConsent s'intègre au plugin WP Consent API afin que les décisions de consentement prises via votre bannière soient partagées avec tous les plugins compatibles sur votre site. Ce guide explique ce qu'est la WP Consent API, pourquoi l'intégration est importante et comment WPConsent mappe ses catégories au format API standard.

Table des matières

La WP Consent API est un plugin WordPress gratuit qui crée un langage commun pour la gestion du consentement. Au lieu que chaque plugin crée ses propres vérifications de consentement, la WP Consent API fournit une norme unique que les plugins peuvent utiliser pour demander « ce visiteur autorise-t-il les cookies de statistiques ? » ou « ce visiteur autorise-t-il les cookies de marketing ? ».

Tout plugin prenant en charge la WP Consent API peut lire les états de consentement de tout plugin de gestion de consentement compatible. Cela signifie que vous n'êtes pas enfermé dans un écosystème spécifique — vos choix de consentement sont transmis à tous les plugins qui parlent le même langage.

Pourquoi cette intégration est importante

Sans la WP Consent API, chaque plugin gère le consentement indépendamment. Cela peut entraîner des situations où :

  • Un visiteur accepte les cookies via votre bannière WPConsent, mais un plugin de formulaire ne le sait pas et bloque inutilement des fonctionnalités.
  • Un visiteur rejette les cookies de marketing, mais un plugin d'analyse se charge quand même car il ne vérifie pas l'état de consentement de WPConsent.
  • Vous devez configurer manuellement les vérifications de consentement dans plusieurs plugins au lieu de tout gérer depuis un seul endroit.

Avec l'intégration active, WPConsent devient la source unique de vérité pour le consentement sur votre site. Chaque plugin compatible avec la WP Consent API respecte automatiquement les choix que les visiteurs font via votre bannière.

Comment fonctionne l'intégration

Lorsque WPConsent et le plugin WP Consent API sont tous deux actifs, l'intégration se fait automatiquement. Il n'y a rien à configurer.

Voici ce que WPConsent fait en coulisses :

  1. S'enregistre comme gestionnaire de consentement actif afin que la WP Consent API sache quel plugin gère le consentement.
  2. Définit le type de consentement (opt-in ou opt-out) en fonction de vos paramètres WPConsent, afin que les autres plugins sachent s'ils doivent bloquer ou autoriser par défaut.
  3. Synchronise les choix de consentement chaque fois qu'un visiteur enregistre ses préférences via la bannière. WPConsent traduit ses propres catégories dans le format standard de l'API WP Consent.
  4. Évite le double blocage en ignorant son propre blocage de script pour les scripts que l'API WP Consent gère déjà.

Si le plugin API WP Consent n'est pas installé, WPConsent fonctionne exactement de la même manière — l'intégration ne s'active tout simplement pas.

Mappage des catégories

WPConsent utilise ses propres noms de catégories (Essentiel, Statistiques, Marketing), tandis que l'API WP Consent utilise un ensemble différent de catégories standard. WPConsent effectue automatiquement la correspondance entre les deux chaque fois qu'un visiteur enregistre ses préférences.

Catégorie WPConsentCatégorie API WP ConsentÉtat du consentement
EssentielfonctionnelToujours autorisé
EssentielpréférencesToujours autorisé
StatistiquesstatistiquesBasé sur le choix du visiteur
Statistiquesstatistiques-anonymesBasé sur le choix du visiteur
MarketingmarketingBasé sur le choix du visiteur

Quelques points à noter :

  • Essentiel correspond à la fois à fonctionnel et à préférences car WPConsent n'a pas de catégorie Préférences distincte. Les deux sont toujours définis sur « autorisé » car les cookies essentiels sont nécessaires au bon fonctionnement de votre site.
  • Statistiques correspond à la fois à statistiques et à statistiques-anonymes. L'API WP Consent distingue les analyses régulières et anonymes, mais WPConsent les traite de la même manière — les deux suivent le choix du visiteur pour les Statistiques.
  • Marketing correspond directement à marketing sans traductions supplémentaires.

Ce mappage signifie que tout plugin vérifiant wp_has_consent( 'statistics' ) ou wp_has_consent( 'marketing' ) respecte automatiquement les choix que les visiteurs font via votre bannière WPConsent.

WPConsent indique à l'API WP Consent si votre site utilise le consentement par opt-in ou opt-out :

  • Opt-in (Autorisation par défaut désactivée) : Les scripts et les cookies sont bloqués jusqu'à ce que le visiteur accepte explicitement. C'est la norme pour la conformité RGPD.
  • Opt-out (Autorisation par défaut activée) : Les scripts et les cookies sont autorisés par défaut jusqu'à ce que le visiteur les rejette activement.

Ce paramètre est lu à partir de votre configuration WPConsent sous WPConsent >> Paramètres (le bouton Autorisation par défaut). D'autres plugins qui vérifient le type de consentement peuvent alors ajuster leur comportement en conséquence.

Coordination du blocage des scripts

Lorsque WPConsent et l'API WP Consent gèrent le même script, un double blocage peut se produire. Pour éviter cela, WPConsent ignore automatiquement son propre blocage pour les scripts que l'API WP Consent gère déjà.

Par exemple, le script de suivi d'attribution de WooCommerce est géré via l'API WP Consent. WPConsent le détecte et laisse l'API WP Consent gérer le blocage au lieu d'appliquer ses propres règles par-dessus.

Configuration de l'intégration

  1. Installez et activez le plugin API WP Consent depuis le dépôt de plugins WordPress.
  2. C'est tout. WPConsent détecte automatiquement l'API WP Consent et active l'intégration.

Il n’y a pas de paramètres supplémentaires à configurer. Le mappage des catégories, la synchronisation des types de consentement et la coordination du blocage des scripts se font tous automatiquement.

FAQ

Oui. L’API WP Consent est un plugin gratuit distinct disponible sur le référentiel de plugins WordPress. Installez-le et activez-le aux côtés de WPConsent pour activer l’intégration.

Vérifiez d’abord que le plugin API WP Consent est installé et actif. Confirmez ensuite que l’autre plugin prend bien en charge l’API WP Consent (consultez sa documentation). Enfin, essayez de tester dans une fenêtre de navigation privée pour exclure l’état du consentement mis en cache.

Non. WPConsent fonctionne entièrement par lui-même. L’intégration de l’API WP Consent est un ajout facultatif qui améliore l’interopérabilité avec d’autres plugins prenant en charge la norme.

L’intégration nécessite-t-elle une configuration ?

Non. Une fois les deux plugins actifs, WPConsent gère tout automatiquement : enregistrement, mappage des catégories, synchronisation des types de consentement et coordination du blocage des scripts.

Conclusion

L’intégration de l’API WP Consent permet à WPConsent de partager les décisions de consentement avec tous les plugins compatibles sur votre site via une interface standardisée. Installez le plugin API WP Consent, et WPConsent s’occupe du reste automatiquement. Pour en savoir plus sur des sujets connexes, consultez la gestion des catégories de cookies et le blocage automatique des scripts.

Cet article vous a-t-il été utile ?

Articles associés