WordPress et WooCommerce
Un seul plugin pour la vérification du site, l’audience sans cookie, les robots et l’e-commerce WooCommerce, envoyé après la page pour ne jamais la ralentir.
Sur cette page
Installer le plugin#
- Téléchargez l’archive
Dans Installation › Installer le traceur, cliquez sur Télécharger le plugin (.zip). L’archive est propre à votre site.
- Téléversez-la dans WordPress
Extensions › Ajouter › Téléverser une extension, choisissez l’archive, puis Activer.
- Vérifiez le site
Le plugin pose la balise de vérification : revenez dans la console et cliquez sur Vérifier par balise.
Version actuelle : 2.1.0. Compatible WordPress 5.8 et plus, PHP 7.4 et plus, WooCommerce 6.0 et plus, avec les commandes en tables dédiées (HPOS) et la commande en blocs.
Chaque téléchargement crée une clé d’API dédiée (nommée « Plugin WordPress ») et révoque la précédente. Après un nouveau téléchargement, remplacez le plugin installé, ou mettez à jour la clé dans wp-config.php si vous l’y avez déplacée.
Ce que fait le plugin#
| Fonction | Détail |
|---|---|
| Vérification | Balise meta kreomnis-site-verification dans le <head> de toutes les pages. |
| Audience | Le traceur sans cookie dans le <head>. Les administrateurs connectés ne sont pas comptés (réglable). |
| Robots | Les passages de robots sur les pages publiques, comptés côté serveur : ni administration, ni AJAX, ni REST, ni cron, ni page de connexion, ni fichiers statiques absents. |
| WooCommerce | Vue produit, ajout et retrait du panier, début de commande et achat, avec chiffre d’affaires et produits. Voir ci-dessous. |
Suivi WooCommerce#
Dès que WooCommerce est actif, ces événements sont envoyés côté serveur, sans code à ajouter :
| Événement | Quand |
|---|---|
view_item | Affichage d’une fiche produit. |
add_to_cart | Ajout au panier (classique, AJAX ou panier en blocs). |
remove_from_cart | Retrait d’une ligne du panier. |
begin_checkout | Affichage de la page de commande avec un panier non vide (une fois par page). |
purchase | Paiement confirmé, commande « en cours » ou « terminée », ou page de remerciement. Une seule fois par commande, même si plusieurs de ces étapes surviennent. |
Chaque produit est transmis avec sa référence (SKU, sinon son identifiant), son nom, sa première catégorie, sa déclinaison, son prix et sa quantité. L’achat porte le numéro de commande, le montant total et la devise, et le nom du moyen de paiement.
Ni nom, ni e-mail, ni adresse, ni téléphone du client ne sont envoyés.
Un paiement confirmé plus tard (webhook Stripe, PayPal…) est rattaché à la visite du client : le plugin mémorise son navigateur sur la commande au moment où elle est passée, puis efface ces informations une fois l’achat envoyé. Les rapports sont décrits dans E-commerce.
Réglages#
Dans Réglages › Kreomnis Indexation (facultatif) :
- Compter aussi les visites des administrateurs connectés : désactivé par défaut.
- Compter chaque envoi de formulaire comme un événement : équivaut à
data-forms="true"sur le traceur. - Mon site est derrière un proxy ou Cloudflare : l’IP du visiteur est alors lue dans
CF-Connecting-IP,X-Real-IPouX-Forwarded-For. Ne cochez cette case que si c’est le cas : sinon ces en-têtes peuvent être falsifiés.
La page de réglages indique aussi si les événements partent après la réponse au visiteur, et l’origine de la clé (fichier du plugin ou wp-config.php).
Déplacer la clé dans wp-config.php#
Le fichier du plugin contient une clé d’API propre à votre site. Elle reste sur le serveur : elle n’est jamais envoyée aux visiteurs, jamais journalisée, et la page de réglages n’en affiche que le début. Pour la sortir du plugin, copiez la ligne define('KREOMNIS_API_KEY', …) de kreomnis-indexation.php dans wp-config.php :
define('KREOMNIS_API_KEY', 'ki_live_…');La valeur de wp-config.php est prioritaire sur celle du plugin.
Performance#
Le plugin ne fait aucun appel à Kreomnis pendant la génération de la page. Les événements sont mis en file, puis, une fois la page envoyée au visiteur, partent en un seul lot (PHP-FPM et LiteSpeed). Sur les autres serveurs (Apache mod_php), l’envoi est non bloquant, avec un délai d’une seconde au plus. Si Kreomnis est indisponible, votre site fonctionne normalement.
Avec un cache de pages (WP Rocket, LiteSpeed Cache, Cloudflare…), le traceur fonctionne normalement. Mais les pages servies depuis le cache ne passent pas par WordPress : les robots qui les lisent et les vues produit ne sont alors pas comptés côté serveur. Le panier, la commande et l’achat, jamais mis en cache, restent suivis.
Désinstaller#
Supprimer le plugin efface ses réglages et les données qu’il a ajoutées aux commandes (sur chaque site d’un multisite). Pensez à révoquer la clé « Plugin WordPress » dans Installation › Clés d’API.
Une question sans réponse ici ? Consultez les questions fréquentes.