Documentation d'installation et d'utilisation de SpongeStats 3

1. Présentation

SpongeStats est un outil d'analyse de fréquentation en temps réel pour votre site Internet ou votre blog. Il permet d'avoir une vue d'ensemble du nombre, du profil et de la provenance de vos visiteurs, les statistiques annuelles, mensuelles et quotidiennes sont affichées de manière graphique ou classées par rubrique. SpongeStats se veut résolument orienté Web 2.0 avec notament le support des fils RSS et une interface d'utilisation XHTML/CSS tirant partie des fonctionnalités Ajax/JQuery. En somme, SpongeStats est un nouvel outil d'analyse de fréquentation adapté aux nouveaux types de sites !

SpongeStats permet de visualiser entre autre :

  • les statistiques quotidiennes, mensuelles et annuelles présentées sous forme de diagramme
  • le détail des statistiques pour un jour donné (nombre de visiteurs, plages horaires, mots clés, pages d'entrée, sites et pages référents, etc...)
  • le classement mensuel des pages les plus vues
  • le classement des IP et des noms d'hôtes des visiteurs
  • la classement des pages et des domaines ayant des liens vers le site
  • la liste des plateformes clientes : systèmes d'exploitation, navigateurs web et agrégateurs
  • la liste des mots clés utilisés pour arriver sur le site
  • la liste et le détails des derniers visiteurs ayant parcouru le site
  • l'historique des visiteurs (première et dernières visites, site referent pour chacune de ses visites, etc...)
  • les statistiques des fils RSS ainsi que les agrégateurs utilisés pour les consulter

SpongeStats se veut résolument moderne et orienté Web 2.0. Développé en PHP/MySQL, il intègre des fonctionnalités de rechargement de page à la volée en Ajax (JQUery) et de mise en page XHTML/CSS. Il ne nécessite pas d'avoir un accès complet au serveur hébergeant le site Internet pour fonctionner (utilisation d'un include dans les fichiers à auditer)

2. Installation

SpongeStats s'installe assez facilement même pour des utilisateurs non expérimentés dans le domaine de la création de site Internet.

SpongeStats se compose de trois parties :

  1. La partie de visualisation des statistiques
  2. La partie administration
  3. Le script à intégrer dans toutes les pages PHP dont vous souhaitez avoir les statistiques (stats.php)

Installation

Pour installer SpongeStats sur votre site Internet vous devez suivre les instructions suivantes :

  • Téléchargez la dernière version disponible sur le site du projet SpongeStats
  • Désarchivez le fichier sur votre disque dur
  • Copiez l'intégralité du dossier /spongestats à la racine du site Internet à l'aide d'un client FTP
  • Allez ensuite à l'adresse de votre site Internet http://www.votre-site.com/spongestats/, vous serez automatiquement redirigé vers la page d'installation.
  • Entrez les paramètres de votre base de données (fournis par votre hébergeur). Si ces paramètres sont bons, vous aurez alors un bouton vous permettant d'installer SpongeStats sur votre base de données
  • Pour vérifier que l'installation s'est correctement déroulée, faites pointer votre navigateur sur l'adresse principale de SpongeStats http://www.votre-site.com/spongestats/, vous devriez avoir l'interface de visualisation qui apparait.

Intégration du module SpongeStats dans les pages à auditer

SpongeStats se sert du fichier stats.php pour entrer les informations de statistiques dans la base de données. Il vous faudra donc faire une liaison entre vos pages PHP et ce script en ajoutant le code suivant dans vos pages PHP.

<?php include_once("spongestats/stats.php"); ?>

Cette instruction va permettre d'insérer le fichier stats.php du dossier /spongestats.

Attention : La fonction include() PHP interprète les chemins de de la même manière que si vous faisiez un lien HTML donc il faut bien penser au chemin vers le fichier. Par exemple si le fichier que vous souhaitez ajouter aux statistiques est dans le répertoire /blog/ à la racine de votre site et que vous avez copié le répertoire spongestats à la racine aussi, il vous faudra utiliser l'instruction suivante à la place :

<?php include("../spongestats/stats.php"); ?>

Note :Il peut arriver que vos pages à surveiller ne soient pas en PHP (sites statiques), même si votre hébergement le supporte. Dans ce cas-là, il vous suffit d'insérer le code suivant (en adaptant à vos répertoires et chemins respectifs, comme plus haut) :

<script type="text/javascript" src="spongestats/stats.php"></script>

3. Utilisation

Pour utiliser SpongeStats, rendez-vous simplement sur votre site Internet à l'adresse http://www.votre-site.com/spongestats.

Les liens du haut vous permettront de naviguer et d'afficher les différentes statistiques de fréquentation et les archives vous permettront de voir l'historique des statistiques au fil des mois.

Le moteur de recherche interne vous permettra d'avoir plus de détails sur l'historique d'un visiteur en recherchant des informations par son nom d'hôte ou par son adresse IP. (Par exemple : Une recherche sur l'IP 82.238.78.124 vous donnera l'historique de mon parcours sur votre site (adresse référente la première fois, nombre de pages vues par jour de connexion, etc.).

L'utilisation de thème est possible depuis la version 2.2. Le menu déroulant vous permet de choisir le thème à utiliser.

4. Configuration et utilisation avancée

Exclure des adresses IP, des hôtes ou des user agents

Dans la partie administration, vous pouvez rajouter des entrées dans les champs pour modifier la configuration par défaut. Vous pouvez par exemple

  • Exclure des adresses ou des plages d'adresses IP
  • Exclure des noms d'hôtes
  • Exclude des navigateurs ou des robots par leurs noms d'hôtes
  • Modifier le thème ou la langue par défaut
  • Ajouter des navigateurs, agrégateurs ou système d'exploitation (attention, les icones des logiciels que vous ajouterez ne s'afficheront pas, si vous souhaitez participer à l'évolution de SpongeStats, vous pouvez nous envoyer votre liste de navigateurs/agrégateurs/plateformes, nous l'intègrerons dans la prochaine version)

5. Utilisation des thèmes

Vous pouvez modifier le thème par défaut depuis l'interface d'administration de SpongeStats.

Si vous souhaitez créer votre propre thème, vous pouvez vous service des thèmes existants comme modèle, créez simplement un nouveau répertoire contenant un fichier style.css et une copie du dossier icones déjà présents dans les autres thèmes. Si vous souhaitez nous faire partager vos thèmes, nous les intègrerons volontiers dans les prochaines versions.

6. Crédits

SpongeStats est un logiciel libre sous licence GPL.
Vous pouvez l'utiliser, le modifier et le diffuser gratuitement sur votre site web personnel ou professionnel.
La mention de l'utilisation de ce script n'est pas obligatoire mais vous pouvez faire un lien vers le projet SpongeStats pour le faire connaitre, vous trouverez des bannières sur le site du projet
Vous pouvez participer à son développement en envoyant vos suggestions, rapports de bugs et informations diverses par email à l'auteur : bastienb@gmail.com

Développement et intégration

Graphisme

BETA Testeurs

Traduction

  • Bastien Bobe (bastienb@gmail.com) (français, anglais)
  • Samy Rabih (contact@lahaut.info) (français, anglais)
  • Benoit Breton et Greg (allemand)