--------- StatFast 1.1 by Emiliano Principi -----------------------------------------

StatFast is a collection of very simple php scripts which 
allows you to carry out a fast and easy statistic 
of the external accesses to your web site.

The greater advantage is the simple installation,
but you need PHP running on your http server... :-)
Contact your web server administrator for information...

Please contact me if you detect bugs and mistakes...

This version has been tested successfully on Apache2.0.40/PHP4.2.2/RedHat9A

This program is free software. Please read the attached GNU license.

				Camerino, 1st June 2004
				Emiliano Principi 



-------------------------------------------------------------------------------------

New features:

version 1.1: 
1) web robots are excluded automatically from statistics
2) removed external_COUNT.dat (obsolete)
3) corrected several small mistakes



-------------------------------------------------------------------------------------

Installation instructions:


A- untar or unzip the package inside the main directory of your web site:
	>$ tar -xpvzf StatFast_1_1.tgz
	or
	>$ unzip StatFast_1_1.zip (this works also under Windows)

B- edit SCRIPTphp.script writing the correct FULL path 
   to the file COUNTERphp.script.

C- copy and paste SCRIPTphp.script at the bottom of the pages you want 
   to include within the results of the statistics
   (better if below the final tag </html>).

D- check the permissions of the log file external_LOG.dat: 
   permissions have to be -rw-rw-rw-. If necessary change them:
	>$ chmod 666 external_LOG.dat 

E- if you want to move the log files into another directory 
   go to the step F-, otherwise (faster choice) go to the step G-.  

F- edit READER.php, READERday.php, READERmonth.php:  
   1) look for the string "insert the correct path" (line 55) within these files;
   2) write the correct path to the file external_LOG.dat. 

G- edit COUNTERphp.script: 
   1) (line 34) write the correct FULL path to the file external_LOG.dat;
   2) (line 60) write the ip numbers you want to exclude from the statistics.

H- O P T I O N A L: 
   if you want to show the TOTAL number of connections to your web site, you
   can copy and paste NCONNECTIONSphp.script into (for example) your
   home page. Do not forget to write the correct FULL path to the file
   external_COUNT.dat (line 8 within NCONNECTIONSphp.script).

I- enjoy StatFast 1.1!
   (tell your browser something like: http://www.mywebsite.boh/StatFast_1_1/READER.php)




-------------------------------------------------------------------------------------

USEFUL HINT: 

If after a long period of time, the list of IP numbers shown by 
READER.php, READERday.php and READERmonth.php is too long,
look for the string 

//if ( $valore < 20){break;}; 

inside them and change it with 

if ( $valore < 20){break;};

In your statistics you will see only the best 20 IP numbers.