Manuel d'intégration

  1. Suivi Matomo
    1. Version 2.9 et supérieure
    2. Version 2.7 et 2.8
    3. Version 2.6 et inférieure
  2. Paramétrage avancé : statistiques sur les mots clés recherchés
  3. Affichage des statistiques Matomo

Suivi Matomo

Version 2.9 et supérieure

1. Importer la XSL suivante:

<xsl:import href="gdpr:matomo"/>

2. Dans la section "<head>" de vos chartes, faire appel au template "matomo"

<html>
   <head>
       [...]
       <xsl:call-template name="matomo"/>
   </head> 
   <body>
       [...]
   </body>
</html>

Version 2.7 et 2.8

1. Importer la XSL suivante:

<xsl:import href="gdpr:piwik"/>

2. Dans la section "<head>" de vos chartes, faire appel au template "piwik"

<html>
   <head>
       [...]
     <xsl:call-template name="piwik"/>
   </head> 
   <body>
       [...]
   </body>
</html>

Version 2.6 et inférieure

1. Importer la XSL suivante:

<xsl:import href="plugin:web-analytics://stylesheets/piwik.xsl"/>

2. Dans la section "<head>" de vos chartes, faire appel au template "piwik"

<html>
   <head>
       [...]
     <xsl:call-template name="piwik"/>
   </head> 
   <body>
       [...]
   </body>
</html>

Paramétrage avancé : statistiques sur les mots clés recherchés

Les statistiques sur les mots clés n'est pas compatible avec l'utilisation du gestionnaire de cookies tarteaucitron

Matomo permet d'obtenir des statistiques sur les mots clés les plus recherchés.

Par défault Ametys envoi au serveur Matomo les mots clés recherchés au travers du champ de recherche nommé "texfield".

Si vous avez besoin de traquer un ou plusieurs autres champs de recherche, faite appel au template "matomo" (ou "piwik" suivant la version de votre plugin web-analytics" en précisant le ou les noms des champs de recherche à traquer comme dans l'exemple ci-dessous:

<xsl:call-template name="matomo"> 
   <xsl:with-param name="keywordFields"> 
     <fields> 
        <field name="textfield"/> 
        <field name="fulltext"/> 
        <field name="keywords"/> 
     </fields> 
   </xsl:with-param> 
</xsl:call-template> 

Affichage des statistiques Matomo

A partir de la version 2.9.0

A partir de la version 2.9.0, il est possible de récupérer et d'afficher les statistiques Matomo du nombre de vues.

Pour cela vous devrez importer le JS suivant dans la section <head> de votre charte graphique:

<script src="{ametys:pluginResourceURL('web-analytics', 'js/AmetysMatomoHelper.js')}" type="text/javascript"/>

Ce fichier fournit un helper JS AmetysMatomoHelper.getPageData permettant de récupérer les statistiques sur le nombre de vue de la page courante.
Les arguments sont les suivants:

  • selector : selecteur jquery permettant d'identifier l'élément HTML qui affichera les statistiques
  • contextPath: le chemin du contexte courant
  • pageUrl: url absolue de la page pour laquelle on souhaite obtenir les statistiques. Laissez vide ou null pour la page courante
  • callback: fonction JS qui sera appelée après la récupération des statistiques (optionnelle)

Le helper récupére les statistiques auprès du serveur Matomo et modifie les éléments HTML cibles identifiés par un attribut "data-matomo" de la manière suivante:

  • data-matomo="nb-visits": nombre de vues totales
  • data-matomo="nb-visits-last-days": nombre de vues sur les X derniers jours, X étant défini dans les paramètres du site
  • data-matomo="last-days": plage des X derniers jours

Exemple d'intégration:

<div class="stats" style="display: none">
   <span data-matomo="nb-visits" ></span> vues dont <span data-matomo="nb-visits-last-days"></span> les <span data-matomo="last-days"></span> derniers jours
</div>
<script type="text/javascript">
   $j(document).ready(function() {
     AmetysMatomoHelper.getPageData(".stats", "<xsl:value-of select="$site-uri-prefix" />", null, function() {
        $j(".stats").show();
    });
   });
</script>
Retour en haut

Web analytics