Vous êtes ici : Accueil > Documentation > Plugin Compteur Graphique
Publié : 2 juillet 2007

Plugin Compteur Graphique

Présentation, mise en place

Ce plugin propose d’afficher des compteurs de visite pour vos articles. Il ne fonctionne qu’à la condition qu’une extension graphique (type GD ou GD2) soit activée sur le serveur hébergeant votre site. Dans le cas contraire, des messages d’erreur remplaceront les compteurs dans l’interface publique.

Il est possible de choisir :
- le nombre de chiffres à afficher de 1 à 10, ou bien laisser le plugin le calculer automatiquement (3 chiffres pour 329, 5 chiffres pour 90032 par exemple).
- Un décompte personnel ou bien un décompte basé sur les statistiques gérées par SPIP. Dans le cas d’un décompte personnel, le compteur s’incrémente à chaque visite de l’article.
- Un habillage parmi 30 habillages possibles.

Ce plugin est fourni avec la distribution d’EVA-web à partir de la version Beta 2. Afin de mettre en place ce plugin, il est nécessaire de :

  1. activer ce plugin dans la page de gestion des plugins (onglet Configuration, sous-onglet Gestion des plugins) ;
  2. vérifier qu’un répertoire CompteurGraphique est bien présent dans le répertoire IMG avec les droits en écriture. Si ce n’est pas le cas, le plugin ne fonctionnera pas. Il vous faudra alors créer ce répertoire (attention à bien respecter les 2 majuscules) et lui donner les droits en écriture.

Principe de fonctionnement

Il est possible de définir des compteurs de visite à 3 endroits de l’espace privé de SPIP :
- en éditant un article (bouton Modifier dans la page de l’article concerné) afin de définir un compteur pour cet article ou bien d’interdire l’affichage d’un compteur pour l’article ;
- en éditant une rubrique (bouton Modifier dans la page de la rubrique concernée) afin de définir un compteur pour tous les articles de cette rubrique ou bien d’interdire l’affichage d’un compteur pour les articles de la rubrique ;
- en allant sur la page spécifique (onglet Statistiques => Bouton Compteurs Graphiques) afin de définir un modèle de compteur pour tous les articles du site.

Comme les compteurs peuvent être définis à plusieurs endroits différents (site, rubrique ou article), ils s’appliquent suivant certaines règles de priorité :
- les choix de compteurs effectués dans les pages d’édition des articles sont prioritaires sur ceux définis dans les pages d’édition des rubriques ;
- les choix de compteurs effectués dans les pages d’édition des rubriques sont prioritaires sur ceux définis dans la page spécifique de définition d’un modèle de compteur graphique pour tout le site.
Ainsi, par exemple, il est possible de définir un modèle de compteur de visite pour tous les articles du site et de choisir un autre modèle pour les articles d’une rubrique particulière. De même, il est possible d’interdire l’affichage de compteurs de visites pour tous les articles d’une rubrique sauf un article en particulier.

Adaptations techniques possibles

Les images permettant de générer les compteurs de visite sont stockées dans le répertoire plugins/compteur_graphique/img_pack . Ce répertoire contient 30 sous-répertoires correspondants aux 30 habillages proposés.

Il vous est possible d’ajouter un habillage personnel en suivant les règles suivantes :
- créez 10 images de même dimension, au format GIF, en les nommant 0.gif, 1.gif, ..., 9.gif ; ces images représentent respectivement les 10 chiffres 0, 1, ..., 9.
- placez ces 10 images dans un répertoire nommé 31 (l’habillage 31) que vous placerez dans le répertoire plugins/compteur_graphique/img_pack .
Vous pouvez ainsi ajouter autant d’habillages que vous le souhaitez en créant les répertoires correspondant : 32, 33, etc.

Si vous souhaitez supprimer un des habillages proposés, il vous faut supprimer entièrement le répertoire qui contient les images associées tout en renommant si nécessaire les autres répertoires afin qu’il n’y ait pas de trous dans l’ordre des numéros des habillages. Par exemple, si vous supprimez l’habillage 9, il vous faudra renommer le répertoire de l’habillage 30 en 9 pour que les répertoires contenants les 29 habillages soient bien numérotés de 1 à 29.

Evolutions prévues de ce plugin

Dans l’avenir, des adaptations seront prévues afin de pouvoir afficher le nombre total de visite du site dans la page de sommaire.