XOOPS Pulse — Aide

XOOPS Pulse enregistre des statistiques de fréquentation (hits) et propose des graphiques pour analyser l’activité du site : hits par jour, activité sur 48h, OS, navigateurs, mobile, dark mode, top pages.

Où trouver les graphes ?
Administration du module → Graphiques.

Sommaire

1) Installation

  1. Installe le module depuis l’administration XOOPS.
  2. Vérifie que la table xoopspulse_hits est bien créée.
  3. Configure pulse_config.php (voir section 2).
  4. Assure-toi que le tracking Pulse est bien appelé sur le site (voir section 3).
Mise à jour du module :
Si tu remplaces le dossier du module par un nouveau ZIP, ton pulse_config.php peut être écrasé. Garde toujours une copie de ton fichier de configuration (ou utilise une variante “local” si ton code le permet).

2) Configuration : pulse_config.php

Le fichier pulse_config.php permet de filtrer les hits enregistrés (bots, IP, comptes, invités…). Il retourne un tableau : return [ ... ];

2.1 — Emplacement

Astuce anti-écrasement :
Lors des mises à jour, garde une copie de ton pulse_config.php sur ton PC. (Ou si tu as prévu une logique “local” dans ton code : pulse_config.local.php, utilise-la.)

2.2 — Options disponibles

2.3 — Exemple de configuration

<?php
declare(strict_types=1);

return [
  'ignore_bots' => true,
  'bot_regex' => '~bot|crawl|spider|slurp|bingpreview|duckduckbot|baiduspider|yandex|mj12bot|semrush|ahrefs|facebookexternalhit|preview|uptimerobot|pingdom|datadog|newrelic|monitor~i',
  'ignore_ips' => [
    '127.0.0.1',
    '::1',
    '54.37.80.0/24',
  ],
  'allow_ips' => [
    // '82.67.47.0/24',
  ],
  'ignore_uids' => [
    // 3,
  ],
  'allow_guests' => true,
];
Ordre de logique recommandé :
1) IP dans allow_ips ⇒ hit accepté.
2) IP dans ignore_ips ⇒ hit ignoré.
3) UID dans ignore_uids ⇒ hit ignoré.
4) allow_guests=false et uid=0 ⇒ hit ignoré.
5) ignore_bots=true et UA match bot_regex ⇒ hit ignoré.

3) Comment Pulse enregistre un hit (tracking)

Pulse n’invente pas les hits : il faut qu’un appel de tracking soit exécuté quand une page est vue. Selon ton intégration, cela peut être :

Recommandation :
idéalement le tracking doit être appelé “site-wide” (sur toutes les pages), pour avoir des statistiques complètes.
Données typiquement enregistrées à chaque hit :
timestamp (ts), page (page), uid, user-agent, OS, navigateur, mobile, darkmode, etc. (selon les champs présents dans ta table et ton code).

4) Pages / fonctions dans l’administration

XOOPS Pulse propose plusieurs pages côté admin (selon ton module) :

Chart.js :
Si les graphs n’apparaissent pas, vérifie le chargement du script Chart.js (pas de 404) et la console JS.

5) Ce que mesure “Pulse”

6) Dark mode : c’est quoi ?

Le dark mode (mode sombre) est un réglage d’affichage où l’interface utilise des couleurs foncées (fond sombre, texte clair). Pulse peut compter combien de visiteurs utilisent ce mode.

7) Table xoopspulse_hits (champs)

Les champs exacts dépendent de ta version, mais on retrouve généralement :

Top pages vides ?
Vérifie que page est bien rempli au moment du tracking.

8) Conseils

9) Dépannage

Graphiques vides ?
Vérifie : (1) la table xoopspulse_hits contient des lignes, (2) le tracking est bien exécuté côté site, (3) Chart.js est bien chargé (pas de 404), (4) aucune erreur JS dans la console.
Trop de hits “internes” ?
Ajoute ton IP (ou ton réseau) dans ignore_ips, ou exclue ton UID dans ignore_uids.
Pulse ne compte pas les visiteurs ?
Vérifie que allow_guests est à true si tu veux compter les invités (uid=0).

10) Note RGPD / confidentialité

Important :
Selon ce que tu stockes (IP, user-agent, page), cela peut être considéré comme une donnée personnelle. Pense à l’indiquer dans ta politique de confidentialité et à conserver uniquement ce qui est nécessaire.

11) Version / Auteur

Module : XOOPS Pulse
Auteur : à compléter
Licence : à compléter