/***************************************************************************
 *
 *   RobotStats
 *
 * Author:   Olivier Duffez, WebRankInfo ( http://www.webrankinfo.com )
 * Version:  1.0
 * Date:     2003-10-11
 * Homepage: http://www.robotstats.com    
 *
 ***************************************************************************/

// ---------------------------------------------------------------------------
// Prsentation rapide
// ---------------------------------------------------------------------------

RobotStats est une application gratuite permettant d'analyser les visites des
robots sur votre site. Pour chaque page de votre site contenant un petit
bout de code PHP, RobotStats dtecte si le visiteur est un des 180 robots
pris en compte par l'application. Si c'est le cas, la visite est enregistre
dans une base de donnes MySQL.
Ensuite, il est possible de visualiser des statistiques compltes :
- liste des robots venus dans une priode donne
- pour chaque robot venu :
  * nombre de pages vues
  * liste des pages vues, avec la date et l'heure
  * graphique des visites sur plusieurs mois
RobotStats vous informe prcisment de l'activit des robots sur votre site.
Cela permet notamment de savoir si votre site a des chances de bien tre
index dans les moteurs de recherche.
En change de sa gratuit, il est demand d'ajouter un lien vers le site
RobotStats, sous forme de texte ou de vignette :
voir http://www.robotstats.com/lien.php


// ---------------------------------------------------------------------------
// Guide d'utilisation
// ---------------------------------------------------------------------------

L'cran principal de RobotStats est constitu de 5 parties :
- le calendrier
- la liste des robots
- la rubrique Bilan
- la rubrique Pages
- la rubrique Graphique

Ce fichier dcrit galement l'interface d'administration.


// ---------------------------------------------------------------------------
// Le calendrier
// ---------------------------------------------------------------------------

Le jour courant est indiqu en orange. Toutes les cases correspondant  des
dates antrieures  la date du jour sont cliquables.
Vous pouvez galement cliquer sur un numro de semaine ou sur le nom du mois
pour modifier la priode prise en compte pour les rubriques Bilan et Pages.
Le calendrier n'est pas actif dans la rubrique Graphique.


// ---------------------------------------------------------------------------
// La liste des robots
// ---------------------------------------------------------------------------

Les robots configurs dans RobotStats sont lists en 2 groupes distincts :
- les robots actuellement activs (et donc pris en compte lors de la dtection)
- les robots actuellement dsactivs
Le robot slectionn est indiqu par une flche verte. C'est pour celui-ci que
sont donnes toutes les autres statistiques. Pour changer de robot slectionn
il suffit de cliquer sur le nom d'un autre robot.
Un clic sur [info] affiche toutes les informations concernant le robot.

// ---------------------------------------------------------------------------
// Le Bilan
// ---------------------------------------------------------------------------

Le bilan indique, pour le robot slectionn et pour la priode dfinie dans le
calendrier, les donnes suivantes :
- visites        : nb de fois o le robot est venu et a t dtect
- pages          : nb de pages diffrentes (pages est toujours infrieur ou gal
                    visites)
- visites / jour : nombre moyen de visites par jour (sur la priode dfinie)
Ensuite est donne la liste de tous les robots dtects sur la priode dfinie
(pour viter d'avoir  les slectionner un par un). A ct de chaque robot est
indiqu son nb de visites pour la priode dfinie.
Ensuite est affich un graphique de type "camembert" donnant la rpartition
en % des robots (pour voir les robots les plus actifs). L'affichage du
graphique prenant un peu de temps, il est possible de le dsactiver dans le
fichier admin/config.php (variable $RS_DISPLAY_PIE_PLOT).
Enfin, la liste de toutes les adresses IP du robot slectionn est affiche
sur 2 colonnes, avec entre crochets l'occurrence de chaque adresse IP.


// ---------------------------------------------------------------------------
// Les Pages
// ---------------------------------------------------------------------------

Cette rubrique affiche le dtail de toutes les pages visites par le robot
slectionn pendant la priode dfinie dans le calendrier (par dfaut le jour
courant).
Il est possible de trier ce tableau en fonction de l'URL, du code de retour
HTTP, de l'heure, du nombre de visites, de l'adresse IP ou du DNS. Il suffit
de cliquer sur un intitul de colonne. Un nouveau clic sur un intitul inverse
le sens du tri.
Lorsqu'une page a t visite plusieurs fois, la date indique est celle de la
dernire visite (le jour est indiqu en plus de l'heure).


// ---------------------------------------------------------------------------
// Le Graphique
// ---------------------------------------------------------------------------

Cette rubrique permet de visualiser sous la forme d'un diagramme en barres les
statistiques de frquentation du robot slectionn.
Le calendrier n'est plus actif car la slection de la priode analyse se fait
 l'intrieur de cette rubrique. On peut choisir d'afficher le graphique pour
1, 2, 3, 6 ou 12 mois. Plus prcisment, la priode analyse couvre les 30, 60,
90, 180 ou 360 derniers jours.


// ---------------------------------------------------------------------------
// Administration de RobotStats
// ---------------------------------------------------------------------------

L'administration de RobotStats est trs simple. La plupart des options se
configurent lors de l'installation dans le fichier 'admin/config.php' (voir le
fichier 'doc/fr/install.txt').
3 rubriques sont disponibles :
1- reset (suppression d'enregistrements)
2- vrification de la version
3- gestion des robots

1- Vous pouvez purger l'ensemble des enregistrements de la table des visites
   ou bien le faire mois par mois. Attention : aucune confirmation n'est
   demande.

2- Cette option permet de vrifier s'il existe une version de RobotStats plus
   rcente que celle que vous avez installe.

3- La gestion des robots permet de dfinir prcisment les robots pour
   lesquels vous souhaitez dtecter et analyser les visites. Lors de
   l'installation, RobotStats configure un ensemble de robots parmi les plus
   rpandus. Vous pouvez en ajouter, en modifier ou en supprimer.
   Attention : plutt que d'en supprimer, vous pouvez en dsactiver afin de ne
   plus les prendre en compte, quitte  les ractiver plus tard.
   Voici la description des champs du formulaire :
   nom           : nom que vous souhaitez donner au robot (texte libre)
   activ ?      : oui pour qu'il soit pris en compte (dans la dtection),
                   non sinon
   nom d'agent   : nom officiel de l'agent ('user agent'). Vous pouvez mettre
                   seulement une partie du nom si c'est suffisamment
                   distinctif.
   Adresse IP #1 : adresse IP du robot (ou dbut d'adresse)
   Adresse IP #2 : autre adresse IP
   Mode de dtection : par adresse IP ou par nom d'agent
   Description   : texte libre, en franais puis en anglais
   URL           : URL de la page dcrivant le robot.

   Si vous ajoutez un nouveau robot, indiquez-le sur le forum de WebRankInfo
   afin d'en faire profiter les autres utilisateurs ! Voyez sur le site
   www.webrankinfo.com/forums/viewforum_7.htm
