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

Installation : instructions

1- Dcompressez le fichier 'robotstats.zip'. Normalement, un rpertoire
   'robotstats' est alors cr. Placez-le dans la racine de votre site.

2- Editez le fichier 'robotstats/admin/config.php' avec un diteur de texte
   quelconque (Notepad fera l'affaire) et remplacez les 4 lments suivants
   par leurs valeurs (contactez votre hbergeur en cas de besoin) : 
   - "HOST"     : le nom de la base de donnes MySQL
   - "LOGIN"    : le login
   - "PASSWORD" : le mot de passe
   - "BASE"     : le nom de la base MySQL
 
   Remplissez votre adresse mail (elle sera utilise pour vous envoyer des
   alertes comme par exemple le dbut du Full Crawl, ou pour vous signaler
   les erreurs d'excution) : variable RS_ADRESSE_EMAIL

   Si vous le souhaitez, modifiez les variables suivantes :
    - RS_URL_REWRITING    : mettre "y" si vous l'utilisez, ou "n" sinon
    - RS_GRAPH_SCALE      : mettre "lin" (chelle linaire) ou "log" (chelle
                            logarithmique) pour les graphiques
    - RS_VALEURS_GRAPH    : mettre "y" si vous voulez afficher les valeurs sur
                            le graphique ou "n" sinon
    - RS_SET_EXEC_TIME    : mettre "y" (pour spcifier la dure max
                            d'excution du script 'graph') ou "n" sinon
    - RS_TEST_FULL_CRAWL  : mettre "y" si vous souhaitez faire un test de
                            dtection du dbut du Full Crawl et tre prvenu
                            automatiquement par mail (l'adresse mail est celle
                            dfinie prcdemment). Sinon mettre "n".
    - RS_SEND_ERROR_MYSQL : mettre "y" pour l'envoi d'email en cas d'erreur.
                            Sinon mettre "n".

   Pour personnaliser votre installation, vous pouvez aussi modifier les
   variables suivantes :
    - RS_LANGUE           : mettre "fr" (franais), "en" (anglais), "de"
                            (allemand) ou "es" (espagnol)
    - RS_TABLE_LOG        : nom de la table utilise pour stocker les
                            informations des visites
    - RS_TABLE_ROBOTS     : nom de la table utilise pour stocker les
                            informations des robots
    - RS_NB_J_DET_FULL_CRAWL : pour la dtection du Full Crawl : on gnre une
                            alerte donnant le dbut du Full Crawl ds qu'un
                            robot du Full Crawl se prsente et qu'aucune
                            visite de robot de Full Crawl n'a t enregistre
                            dans les RS_NB_J_DET_FULL_CRAWL derniers jours.

3- Transfrez l'ensemble du rpertoire 'robotstats' par FTP.

4- Protgez le rpertoire 'admin' en y mettant un fichier '.htaccess' et un
   fichier '.htpassword' (renseignez-vous auprs de votre hbergeur ou allez
   lire l'article complet sur
   http://www.webrankinfo.com/analyses/autres/htaccess-restriction.php).

5- Installation :
   * Si c'est la premire fois que vous installez RobotStats, rendez-vous
      l'adresse 'http://__votre_site__/robotstats/install.php' et suivez les
     instructions. Une fois l'installation termine, supprimez le fichier
     'install.php' de votre serveur.
   * Si vous avez dj install une version antrieure de RobotStats
     (autrefois appel GoogleStats), il est recommand de commencer par
     sauvegarder votre table 'gs_log'.
     Ensuite :
     Si vous avez dj install la version 2.0 ou 2.01 de GoogleStats :
       - faites une sauvegarde de votre fichier admin/config.php
       - copiez sur votre serveur tous les fichiers fournis dans
         robotstats.zip
       - ditez le nouveau fichier admin/config.php pour y remettre votre
         configuration (il y a quelques variables de plus...)
       - rendez-vous  l'adresse :
         http://__votre_site__/robotstats/update.php et suivez les
         instructions. Une fois l'installation termine, supprimez le fichier
         'update.php' de votre serveur.
     Si votre version de GoogleStats est plus ancienne, il faut passer par
     l'installation complte de RobotStats.

6- Il vous reste ensuite  insrer le code suivant sur chaque page de votre
   site (sauf celles que vous ne voulez pas analyser). Si vous utilisez
   Dreamweaver (ou tout autre diteur grant les modles), vous pouvez insrer
   ce code dans votre modle (template). Dans ce cas, passez en affichage du
   code source et insrez le code dans une zone non ditable (c'est--dire
   en dehors d'une zone comprise entre "<!-- #BeginEditable" et
   "<!-- #EndEditable -->"). Vous pouvez par exemple l'insrer juste avant la
   balise "</head>". Pour tre sr de ne pas ralentir l'affichage de vos pages,
   vous pouvez aussi mettre le code aprs la balise </html>.

   <?php
   include($DOCUMENT_ROOT.'/robotstats/robotstats.inc.php');
   ?>

7- Pour vrifier si l'installation est correcte, activez le robot '_test' et
   parcourez quelques pages de votre site. Regardez ensuite si ces visites
   sont enregistres. N'oubliez pas de finir en dsactivant ce robot de test
   (cf. Description de RobotStats dans le fichier 'doc/fr/robotstats.txt').
   Si vous n'enregistrez aucune visite, allez lire le fichier 'doc/fr/faq.txt'
   ou bien consultez la FAQ sur http://www.robotstats.com/faq.php

8- Si vous utilisez RobotStats, vous n'avez rien  payer : c'est gratuit.
   Par contre je vous demande de faire un lien vers RobotStats :
   <a href="http://www.robotstats.com/" target="_blank"
   title="RobotStats analyse les visites de Google et des autres robots">
   Analyse des robots web</a>

   Merci !
