CNStats 2.0

Installation and Set Up of CNStats

Step 1. Unpacking

The downloaded archive must be unpacked to the directory where you want to run CNStats.

If you have downloaded ZIP archive:

Unzip it with pkunzip supporting long file names ( (pkzip25 или WinZIP). Additional information about ZIP archivers is available at http://www.pkware.com/.

pkzip25 -extract -dir cnstats10.zip

If you have downloaded TGZ archive, unpack it with a set of commands:

gunzip cnstats10.tgz
tar -xf cnstats10.tar

Step 2 - Installation

Now< you have to go to /cnstats/install.php. If the server is configured correctly, you will see the form:

You have to fill in the following data:

• MySql server (for example localhost) - Host, where MySql server runs (for example localhost)
• MySql connection login - MySql server login
• MySql connection password - MySql server password
• Database name - database name
• Administrators password - password to access statistics
• Retype password - re-type password to access statistics
• Save statistics for the period of - sets time period while web-site attendance data is kept. This setting helps to manage size of the database.
• Type of the counter - counter type.

1. PHP include - recommended way. Allows to count all requests to your site.
2. 88x31 - traditional way, does not allow to count visitors, who turn off images in their browsers. The look of the counter may be changed. Requires GD library.
3. GIF image 1x1 - has lacks of the previous one, but does not require GD library.

• Symbols color (for PNG counter) - necessary to select color on counter symbols if you choose PNG image.
• IP - IP address not included in statistics.
• Mask - Mask. Helps to exclude networks from statistics.

After the form is filled in, the installation script will create or update database and display data for config.php creation. Create config.php in cnstats directory and copy that data to the file.

Attention: there should not be any symbols before <? and after ?> (even symbols of carriage return and line break).

You will also be provided with the counter code.

If you selected PHP include method (recommended), you need to insert the code at the beginning of your PHP-pages - before the place, where information output will start. It is necessary for correct Cookies settings and visitors counting.

If you chose graphic counter, you may insert it into any place, where it is convenient for you.

Step 3 - Test Entry

It is necessary to delete file install.php and go to /cnstats address. When you will have your password indicated in config.php submitted, you will be able to view statistics for your site.