DocumentationWordPress et WooCommerce

WordPress et WooCommerce

Un seul plugin pour la vérification du site, l’audience sans cookie, tout le trafic côté serveur et l’e-commerce WooCommerce, envoyé après la page pour ne jamais la ralentir.

Sur cette page
  1. Installer le plugin
  2. Ce que fait le plugin
  3. Suivi WooCommerce
  4. Réglages
  5. Déplacer la clé dans wp-config.php
  6. Performance
  7. Désinstaller

Installer le plugin#

  1. Téléchargez l’archive

    Dans Installation › Installer le traceur, cliquez sur Télécharger le plugin (.zip). L’archive est propre à votre site.

  2. Téléversez-la dans WordPress

    Extensions › Ajouter › Téléverser une extension, choisissez l’archive, puis Activer.

  3. 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.2.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.

Une clé par archive

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. Si l’offre de l’espace ne comprend pas la collecte côté serveur, l’archive est sans clé : le plugin pose alors la balise de vérification et le traceur.

Ce que fait le plugin#

FonctionDétail
VérificationBalise meta kreomnis-site-verification dans le <head> de toutes les pages.
AudienceLe traceur sans cookie dans le <head>. Les administrateurs connectés ne sont pas comptés (réglable).
TraficTout le trafic vu par WordPress, côté serveur : pages, robots, scripts, scanners et attaques (wp-login.php, xmlrpc.php, pages absentes), avec le code et la durée de chaque réponse, selon le réglage « Trafic envoyé ». Ni WP-Cron, ni WP-CLI, ni le battement de cœur de l’administration, ni les pages d’administration consultées par un compte connecté.
WooCommerceVue 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énementQuand
view_itemAffichage d’une fiche produit.
add_to_cartAjout au panier (classique, AJAX ou panier en blocs).
remove_from_cartRetrait d’une ligne du panier.
begin_checkoutAffichage de la page de commande avec un panier non vide (une fois par page).
purchasePaiement 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.

Aucune donnée personnelle de commande

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) :

  • Trafic envoyé à Kreomnis : tout le trafic (par défaut, recommandé), les robots et clients HTTP seulement (sites à très fort trafic), ou rien (le traceur mesure toujours l’audience). Le détail : Collecte côté serveur › Plugin WordPress.
  • 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-IP ou X-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 :

wp-config.phpphp
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. La requête et les événements sont mis en file, puis, une fois la page envoyée au visiteur (PHP-FPM et LiteSpeed), partent avec un délai de 2 secondes au plus. Sur les autres serveurs (Apache mod_php), qui ne savent pas terminer la réponse avant, seuls les robots et les événements partent, sans attendre la réponse de Kreomnis (une seconde au plus). Si Kreomnis ne répond pas, l’envoi du trafic s’arrête une minute ; votre site fonctionne normalement.

Chaque page demande un envoi : au-delà d’environ 10 pages par seconde, la limite de l’API est atteinte. Choisissez alors « robots seulement », ou envoyez les journaux d’accès du serveur (Collecte côté serveur › Journaux d’accès).

Cache de pages

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. Les journaux d’accès du serveur, eux, voient aussi les pages en cache.

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.