Plugin Koha ⇄ Matomo
Koha ⇄ Matomo est un plugin qui facilite l'intégration d'un OPAC Koha au système de mesure de la fréquentation d'un site web Matomo. Il insère le code de suivi Matomo dans les pages de l'OPAC et enrichit les statistiques avec des informations propres à Koha : recherches effectuées, notices consultées, pages éditoriales.
Aucune modification de la préférence système OPACUserJS n'est nécessaire :
le plugin injecte lui-même son code dans l'OPAC.
Prérequis
- Koha 24.11 ou supérieur.
- Une instance Matomo accessible depuis le navigateur des usagers de l'OPAC dans laquelle un site a été créé pour l'OPAC. Notez son ID de site (Administration > Sites web > Gérer).
Installation
Activation des plugins — Si ce n'est pas déjà fait, activez les plugins
dans Koha. Demandez à votre prestataire Koha de le faire, ou bien vérifiez que
<enable_plugins>1</enable_plugins> est présent dans koha-conf.xml.
▼ TÉLÉCHARGEMENT ▼ — Récupérez sur le site Tamil l'archive du plugin Koha ⇄ Matomo.
Installation — Dans l'interface pro de Koha, allez dans Outils > Outils de plugins. Cliquez sur Télécharger un plugin. Choisissez l'archive téléchargée à l'étape précédente. Cliquez sur Télécharger.
Configuration
Dans Outils > Outils de plugins, sur la ligne du plugin Koha ⇄ Matomo, choisissez Actions > Configurer.
Accès à Matomo
- URL du tracker — Adresse de votre instance Matomo, sans
/final ni nom de fichier, par exemplehttps://stats.example.org. La forme//stats.example.orgpermet de suivre le protocole de l'OPAC. Le plugin ajoute lui-même/matomo.phpet/matomo.js. - ID du site — Identifiant du site Matomo correspondant à l'OPAC.
OPAC
- Activer le tracker à l'OPAC — Tant que cette case n'est pas cochée, aucun code Matomo n'est envoyé à l'OPAC.
- Titres des pages — Libellés sous lesquels chaque type de page apparaît dans Matomo : Accueil, Recherche avancée, Résultat, Détail notice et Page statique. Les valeurs par défaut conviennent dans la plupart des cas.
L'enregistrement de la configuration prend effet immédiatement à l'OPAC.
Données envoyées à Matomo
Le suivi ne porte que sur les pages suivantes de l'OPAC. Les autres pages (compte usager, panier, etc.) ne sont pas suivies.
| Page OPAC | Ce qui est mesuré dans Matomo |
|---|---|
| Accueil | Une page vue, sous le titre configuré. |
| Recherche avancée | Une page vue, sous le titre configuré. |
| Résultats de recherche | Une recherche interne (Comportement > Recherche interne) avec la requête de l'usager, et une page vue intitulée <titre> : <requête>. |
| Détail d'une notice | Un événement Biblio / View / <biblionumber>, une impression de contenu Notice / <biblionumber> : <titre>, une page vue intitulée <titre> : <titre de la notice> et le suivi des liens sortants. |
Page éditoriale (opac-page.pl) |
Une page vue intitulée <titre> : <titre de la page> et le suivi des liens sortants. |
Pour exploiter pleinement ces données dans Matomo :
- activez la recherche interne dans les paramètres du site, afin que les requêtes de l'OPAC apparaissent dans les rapports de recherche ;
- consultez les notices les plus vues dans Comportement > Événements
(catégorie
Biblio) ou Comportement > Contenus.
Vie privée
Le plugin ne gère pas le consentement des usagers. Selon votre politique RGPD, configurez Matomo en conséquence (anonymisation des adresses IP, suivi sans cookie, etc.) ou conditionnez le suivi au consentement recueilli par Koha.
Dépannage
- Rien n'apparaît dans Matomo — Vérifiez que la case Activer est cochée,
que l'URL du tracker est correcte et que
<URL du tracker>/matomo.jsest accessible depuis un navigateur. Un bloqueur de publicité peut aussi empêcher le suivi. - Le code de suivi est absent de l'OPAC — Vérifiez que le plugin est activé dans Outils de plugins. Le code est mis en cache côté Koha pendant une heure ; le cache est vidé à chaque enregistrement de la configuration.
Versions
- 1.0.2 / oct. 2026 — Déploiement facilité.
- 1.0.1 / déc. 2025 — Version initiale.
Licence
This software is copyright (c) 2025 by Tamil s.a.r.l..
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.