/***************************************************************************
 *
 *   RobotStats
 *
 * Author:   Olivier Duffez, WebRankInfo ( http://www.webrankinfo.com )
 * Version:  1.0
 * Date:     2003-10-11
 * Homepage: http://www.robotstats.com    
 *
 * Traduzione Italiana di Marco Di Silvio - ( http://www.submission.it )
 *
 ***************************************************************************/

// ---------------------------------------------------------------------------
// Descrizione delle funzionalit di RobotStats
// ---------------------------------------------------------------------------


La schermata principale di RobotStats  composta da 5 parti:
- il calendario
- la lista degli spider
- la sezione con il riassunto dei dati
- la sezione con sulle pagine
- la sezione con il grafico

Questo file presenta inoltre informazioni sull'amministrazione di RobotStats.


// ---------------------------------------------------------------------------
// Calendario
// ---------------------------------------------------------------------------

Il giorno corrente  visualizzato in arancione. Tutte le celle con data
anteriore all'odierna sono cliccabili.
E' possibile inoltre cliccare sul numero della settimana o sul nome del mese 
per visualizzare i dati relativi nelle altre sezioni.
All'interno della sezione con il grafico, il calendario viene disabilitato.

// ---------------------------------------------------------------------------
// Lista degli spider (robots)
// ---------------------------------------------------------------------------

Gli spider utilizzati in RobotStats sono divisi in 2 gruppi distinti:
- spider abilitati (sui quali viene effettuato il monitoraggio)
- spider disabilitati
Lo spider selezionato  affiancato da una freccia verde. 
Tutte le statistiche visualizzate nelle altre sezioni sono riferite a questo 
specifico spider. Per selezionare un altro spider, basta cliccare sul nome 
di un altro spider.

// ---------------------------------------------------------------------------
// Riassunto
// ---------------------------------------------------------------------------


Il riassunto indica, per lo spider selezionato nel periodo definito dal calendario,
i seguenti dati:
- visite: numero di volte che lo spider  passato
- pagine: numero di pagine differenti visitate (in genere i due dati coincidono, 
o comunque le differenti pagine viste sono inferiori alle visitew totali)
- visite/giorno: numero di visite per giorno

E' inoltre visualizzato il dato di tutti gli spider identificati nel periodo coniderato,
Il numero di visite per spider  visualizzato alla destra del nome corrispondente.
E' presente il grafico a torta con il numero di visite in percentuale per ciascuno spider (ad indicare gli spider pi attivi). Il grafico pu impiegare un po' di tempo per venir generato ( possibile disabilitarne la visualizzazione modificando la variabile $RS_DISPLAY_PIE_PLOT nel file 'admin/config.php').
Tutti gli indirizzi IP degli spider sono mostrati in 2 colonne, accanto ai relativi robot.


// ---------------------------------------------------------------------------
// Pagine
// ---------------------------------------------------------------------------

Questa sezione mostra in dettaglio tutte le pagine visitate dallo spider selezionato nel periodo definito dal calendario (per default, il calendario mostra la data corrente).
E' possibile ordinare la tabella per URL, per intestazione HTTP, per data, per numero di visite, per indirizzo IP o per DNS semplicemente cliccando sul nome della colonna; cliccando 2 volte,  possibile effettuare l'ordinamento inverso.
Se una pagina  stata visitata pi di una volta nel periodo selezionato, la data mostrata  quella dell'ultima visita.

// ---------------------------------------------------------------------------
// Grafico
// ---------------------------------------------------------------------------

Questa sezione mostra con diagrammi a barre le statistiche delle visite dello spider selezionato. Il calendario  disattivato in questa sezione perch  possibile definire il periodo di analisi direttamente all'interno della sezione. Il grafico pu essere selezionato con dati riferiti ad 1, 2, 3, 6 o 12 mesi. Pi precisamente, il periodo di analisi copre un periodo riferito agli ultimi 30, 60, 90, 180 o 360 giorni.

// ---------------------------------------------------------------------------
// Amministrazione RobotStats
// ---------------------------------------------------------------------------

L'amministrazione di RobotStats  abbastanza semplice. La maggior parte delle opzioni sono comprese nel file  'admin/config.php'.
Sono disponibili 3 sezioni:
1- cancellazione dei dati (reset)
2- controllo della versione
3- amministrazione degli spider

1- E' possibile cancellare tutti i dati presenti nel database oppure mese per mese; attenzione alle cancellazioni: nessuna conferma viene richiesta.
2- Questa opzione permette di controllare se  disponibile una versione aggiornata di RobotStats
3- L'amministrazione della lista degli spider permette di modificare i robots da monitorare. E' possibile aggiungere, modificare o cancellare un robots; attualmente  configurato con una lista degli spider pi diffusi.
Consiglio: meglio disabilitare uno spider (agendo sul campo Attivo/Inattivo) piuttosto che cancellarlo definitivamente.
Questa la descrizione dei campi presenti nella form:

   name          : nome dello spider
   active?       : 'yes' se vuoi monitorare questo robot, altrimenti scegli 'no'.
   user agent    : nome ufficiale dello user agent. E' possibile inserire anche solo una parte di stringa dello spider per monitorarlo
   IP address #1 : indirizzo IP dello spider (o iniziali dell'indirizzo IP)
   IP address #2 : altro indirizzo IP
   Detection mode: rilevamento sulla base dell'indirizzo IP o sullo UserAgent
   Description   : descrizione dello spider (testo libero)
   URL           : URL della pagina di spiegazione del funzionamento del robot

