Documentation d'installation et d'utilisation de SpongeStats 3

  1. Présentation
  2. Installation
  3. Utilisation
  4. Configuration avancée
  5. Utilisation des thèmes
  6. Questions fréquentes
  7. Crédits

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 :

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 :

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 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"); ?>

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 :

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 servir des thèmes existants comme modèle. Créez simplement un nouveau répertoire contenant un fichier style.css ou copier un dossier thème existant, et créer votre propre thème juste en modifiant le fichier style.css. Si vous souhaitez nous faire partager vos thèmes, nous les intègrerons volontiers dans les prochaines versions.

6. Questions fréquentes

Voici une liste des questions le plus fréquentes sur SpongeStats, si vous ne trouvez pas votre réponse ici, veuillez nous adresser une demande de support à spongestats@gmail.com

1. J'ai installé SpongeStats sur mon site mais je ne vois toujours pas d'informations dans les statistiques ?
Avez-vous bien terminé l'installation en ajoutant l'include du fichier stats.php dans les pages que vous souhaitez auditer ?

2. Je n'ai pas de base de données MySQL, SpongeStats peut-il fonctionner ?
Non, SpongeStats est un logiciel fonctionnant avec une base de données MySQL, il ne peut donc pas fonctionner sans.

3. SpongeStats peut-il s'installer sur un serveur mutualisé ?
Oui, vous n'avez pas besoin d'avoir accès à la configuration de votre serveur pour installer SpongeStats, il vous suffit de copier les fichiers dans votre répertoire FTP et de lancer l'installation.

4. Existe-t-il des plugins pour Dotclear, Wordpress ou d'autres plateformes de blog ?
Actuellement, seul un plugin pour dotclear 1 est disponible, en revanche, d'autres plugins et widgets seront disponibles prochainement.

5. La traduction n'est pas disponible dans ma langue, comment puis-je l'avoir ?
SpongeStats est actuellement disponible en Français, Anglais et Allemand. Si vous parlez couramment une autre langue et que vous souhaitez participer, vous pouvez faire votre propre traduction. Les fichiers de langue sont dans le répertoire locale. Le fichier "messages.po" est le fichier d'édition et le "messages.mo" est le fichier compilé. Vous pouvez utiliser le logiciel PoEDIT pour éditer le fichier "messages.po" et commencer la traduction. Une fois votre contribution terminée, vous pouvez nous envoyer le fichier messages.po et nous le mettrons en téléchargement pour que les autres utilisateurs puissent en profiter.

6. SpongeStats fonctionne-t-il chez tous les hébergeurs ?
Normalement oui. SpongeStats ne nécessite pas de modules PHP/MySQL spécifiques pour fonctionner donc il est censé fonctionner sur toutes les plateformes mutualisées du marché. En revanche, certains hébergeurs bloquent l'utilisation d'outils de statistiques personnalisés donc lisez bien les conditions d'utilisations de votre espace web.

7. Dans l'administration, on me demande mon mot de passe mais ne l'ai pas ou je l'ai perdu, que puis-je faire ?
Le mot de passe pour accéder à l'administration est demandé dés l'installation (dans le dernier champ de configuration). Beaucoup d'utilisateurs confondent ce mot de passe avec leur mot de passe de base de données, peut-être avez-vous confondu aussi. Essayez avec votre mot de passe de base de donnée ou sinon sans mot de passe. Au pire, ce mot de passe est modifiable dans la table MySQL sps_config, (champ param : sps_admin_pass chiffré en MD5).

8. Mon site est hébergé chez free et j'ai des erreurs Warning PHP concernant les sessions (Warning: session_start()), est-ce que je peux régler le problème ?
Oui, Free gère les sessions PHP différemment des autres hébergeurs mutualisés. Il vous faudra créer un répertoire "sessions/" à la racine de votre répertoire d'hébergement (et non à la racine du répertoire SpongeStats)

7. Crédits

SpongeStats est un logiciel libre sous licence GPL v2.
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 et des stickers sur le site du projet

Vous pouvez participer à son développement en envoyant vos suggestions, rapports de bugs et informations diverses par email aux auteurs à l'adresse spongestats@gmail.com.

Développement et intégration

Graphisme

BETA Testeurs

Ainsi que tous ceux dont nous n'avons pas le nom et qui ont contribué à l'évolution de cette version. Merci à tous !

Traduction