Installation

Deux façons d'installer l'extension Moelleux.

Depuis le répertoire WordPress.org (à venir)

Dans votre administration, allez à Extensions → Ajouter, recherchez « Moelleux », puis cliquez sur Installer et Activer.

Installation manuelle

Téléversez le fichier zip de l'extension dans wp-content/plugins/ (ou via Extensions → Ajouter → Téléverser une extension), puis activez « Moelleux ».

Pré-requis : WordPress 6.2 ou plus récent, PHP 7.4 ou plus récent.

Configurer la clé de site

Copiez votre clé de site (un UUID visible dans le tableau de bord Moelleux) et collez-la dans Réglages → Moelleux. La clé est validée au format UUID v4.

Pour un déploiement automatisé, définissez plutôt la clé via une constante PHP dans wp-config.php (ou la variable d'environnement du même nom) :

// wp-config.php
define( 'MOELLEUX_WP_SITE_KEY', '550e8400-e29b-41d4-a716-446655440000' );

Quand la constante MOELLEUX_WP_SITE_KEY (ou la variable d'environnement) est définie, elle a priorité et le champ dans l'admin passe en lecture seule.

La bannière

Dès qu'une clé valide est enregistrée, l'extension injecte le script embed dans le <head> de vos pages publiques. La bannière s'affiche alors automatiquement — aucune autre configuration nécessaire.

<!-- injecté automatiquement dans <head> -->
<script src="https://cdn.moelleux.ca/c/{site_key}.js" async></script>

Le script est chargé depuis le CDN Moelleux à partir de votre clé de site.

Afficher la politique

Affichez votre politique de confidentialité générée par Moelleux n'importe où sur votre site, de trois façons au choix : le shortcode [moelleux_policy], le bloc Gutenberg « Politique Moelleux », ou le widget Elementor (catégorie « Moelleux »).

[moelleux_policy]

Le shortcode dans une page ou un article.

Attributs partagés

Le shortcode, le bloc et le widget partagent les mêmes attributs :

Attribut	Description
`jurisdiction`	Juridiction de la politique : qc-loi25 (défaut), ca-pipeda, us-ccpa, eu-gdpr, world. Une valeur absente ou invalide retombe sur qc-loi25.
`lang`	Langue : fr ou en. Si absent, auto-détectée (Polylang, puis WPML, puis la langue du site) — la même page en FR ou EN affiche la politique correspondante.
`cache`	Mise en cache du fragment : yes (défaut) ou no.

[moelleux_policy jurisdiction="eu-gdpr" lang="en"]

Exemple : politique RGPD en anglais.

La politique est récupérée à la volée depuis le fragment JSON servi par le CDN Moelleux, selon la juridiction et la langue demandées.

Bouton « Gérer mes témoins »

Le shortcode [moelleux_manage] insère un bouton qui rouvre la modale de préférences (équivalent à window.Moelleux.openPreferences()). Indispensable dans un pied de page pour rester conforme. Un attribut optionnel label personnalise le texte du bouton.

[moelleux_manage label="Gérer mes témoins"]

Exemple avec un libellé personnalisé.

WP Consent API

Si l'extension WP Consent API est active, Moelleux relaie automatiquement les choix de consentement via wp_set_consent. Les autres extensions qui respectent ce standard — Site Kit by Google, WooCommerce, etc. — appliquent alors les choix du visiteur, y compris côté serveur. Si WP Consent API n'est pas installée, ce relais reste dormant et n'a aucun effet.

Compatibilité et outils

L'extension s'intègre proprement à l'écosystème WordPress :

Exclusions de cache et d'optimisation automatiques pour WP Rocket, LiteSpeed Cache, Autoptimize et SG Optimizer, afin que l'embed ne soit jamais concaténé ni différé incorrectement.
Détection des CMP concurrents et des extensions Google, avec un rappel sur Consent Mode v2 quand c'est pertinent.
Commandes WP-CLI : wp moelleux status, wp moelleux set-key, wp moelleux clear-key.
Intégration à Site Health (Outils → Santé du site) pour diagnostiquer la configuration.

Extension WordPress