Plugin WordPress

Le plugin officiel Quiet Metrics connecte votre site WordPress sans toucher au code : script first-party, tracking serveur imblocable, ou les deux.

Installation

Pendant la bêta privée, le plugin est fourni en .zip sur demande auprès du support (Coordonnée protégée, activez JavaScript pour l’afficher), le répertoire WordPress.org n'étant pas encore alimenté : Extensions → Ajouter → Téléverser une extension, activez, puis ouvrez Réglages → Quiet Metrics. (La publication sur le répertoire WordPress.org viendra avec l'ouverture publique ; les mises à jour se font en réinstallant le .zip par-dessus, les réglages sont conservés.)

Choisir le mode

Script (first-party). Le fichier qm.js est une copie locale servie par votre propre site, et les hits transiteraient par la REST API de votre site (/wp-json/quiet-metrics/v1/collect) avant d'être relayés au service. Aucun domaine tiers côté navigateur : les listes de blocage par domaine sont inopérantes. Ce mode n'est pas encore disponible : son relais passe par votre serveur et exigerait une signature du site qui n'est pas encore implémentée, quelle que soit la clé secrète renseignée. Aucune visite n'est donc mesurée par ce mode pour l'instant, et un message vous le signale dans l'administration WordPress. Ce sera corrigé à la publication du plugin ; utilisez le mode serveur en attendant (voir ci-dessous).

Serveur (imblocable). Les pages vues sont envoyées par PHP en fin de requête, sans JavaScript : invisible pour les bloqueurs de publicité. Renseignez la clé secrète : sans elle, tous vos visiteurs seraient comptés avec l'IP de votre serveur (un seul visiteur !).

Les deux. Le script suit les navigations fines (SPA, thèmes très dynamiques) et le serveur rattrape les visiteurs qui bloquent le JS. Pas de double comptage : le service déduplique les pages vues identiques (même page, même visiteur) reçues à moins de 2 secondes d'écart.

Cas particuliers

Cache pleine page (WP Rocket, WP Super Cache, Varnish, Cloudflare APO…). En mode serveur, le PHP ne s'exécute pas sur les pages servies depuis le cache : ces visites ne sont pas comptées. Avec un cache pleine page, utilisez le mode script (ou les deux) : le JS s'exécute chez le visiteur, cache ou pas.

Plugins de sécurité qui restreignent la REST API. Le mode script relaie les hits via POST /wp-json/quiet-metrics/v1/collect : cette route publique doit rester accessible (whitelist du namespace quiet-metrics/v1 dans votre plugin de sécurité). Symptôme d'un blocage : des erreurs 401/403 sur cette route dans l'onglet Réseau du navigateur.

Multisite. Les réglages sont propres à chaque site du réseau. Créez un site (et une clé) Quiet Metrics par site WordPress pour des statistiques séparées.

Comptes connectés. Les rôles cochés dans les réglages ne sont jamais comptés : ni côté script (le fichier n'est pas injecté), ni côté serveur.

Exclusion à la demande du visiteur. Une personne qui charge n'importe quelle page de votre site avec ?qm_ignore=1 cesse d'être comptée, et ?qm_ignore=0 la remet dans la mesure. Le plugin s'en charge sans réglage à toucher, pour les trois modes de collecte : voir le marqueur d'exclusion. Cela ne remplace pas les rôles et les chemins exclus : ceux-là appartiennent à l'administrateur, le marqueur appartient au visiteur.

Événements personnalisés

Côté navigateur (mode script actif) :

<script>qm('inscription', { plan: 'pro' });</script>

Côté PHP (thème, hook, n'importe où après le chargement des plugins) :

quiet_metrics_event( 'achat', array( 'montant' => 49 ) );

Exemple WooCommerce, pour compter les commandes confirmées :

add_action( 'woocommerce_thankyou', function ( $order_id ) {
    $order = wc_get_order( $order_id );
    if ( $order ) {
        quiet_metrics_event( 'achat', array(
            'montant' => (float) $order->get_total(),
            'articles' => $order->get_item_count(),
        ) );
    }
} );

L'envoi PHP est non bloquant et silencieux en cas d'échec : l'analytics ne casse jamais votre boutique. Pour compter une conversion, créez l'objectif achat (type événement) dans l'espace membre.