JAWStats Site Statistics User Guide

This is beta software. A moderate level of knowledge of how your web server works is assumed until better documentation is available.

Step #1

Download and unpack the latest version of JAWStats into a web-visible folder on your web server.

Step #2

Duplicate the config.dist.php file, calling the new copy config.php.

Step #3

Edit your new config.php using your favourite text editor as follows:

• $sConfigDefaultView: ignore (this will be discussed in future documentation)
• If you don't want your users looking at the stats of other sites, change $bConfigChangeSites to false.
• If you don't want your users updating stats themselves, set $bConfigUpdateSites to false (they will still need a password to do this).
• $sUpdateSiteFilename: ignore (this will be discussed in future documentation)

The AWStats system already running on your server will have one or more configuration(s) in place in order for it to work properly. JAWStats needs to know the name given to these configurations. The AWStats installation guide using an example configuration called awstats.mysite.conf. For the purpose if this guide, we will use the same.

For each site you want to display stats for, edit (or create) a site configuraion array. This is a block of code in your config.php file that looks like this (you need to edit the bits shown in red):

$aConfig["site1"] = array(
  "statspath"   => "/path/to/data/",
  "updatepath"  => "/path/to/awstats.pl/",
  "siteurl"     => "http://www.my-1st-domain.com",
  "theme"       => "default",
  "fadespeed"   => 250,
  "password"    => "my-1st-password",
  "includes"    => ""
);

• Change the name of the array to the name of the AWStats configuration you use, eg. $aConfig["mysite"].
• "statspath": this is a fixed or relative path to the folder on your webserver where AWStats stores the data files it generates. The files look something like awstats112007.mysite.txt. Include the trailing slash.
• "updatepath": this is a fixed or relative path to the folder on your webserver where awstats.pl is installed. Include the trailing slash.
• "siteurl": the URL of the website in question, e.g. http://www.mysite.com.
• "theme": ignore (this will be discussed in future documentation)
• "fadespeed": ignore (this will be discussed in future documentation)
• "password": the password required to dynamically update your website statistics.
• "includes": (NEW to v0.3) a comma seperated list of your own files you wish to include as JAWStats loads. For example, let's say you use a cookie to control a password-protected area of your website (e.g. in a CMS) and have a piece of code at the top of each page to check the visitor is logged in before displaying the page. Well, you can include that code here. Paths, as usual, can be absolute or relative. e.g. "../check_cookie.php"

Support

Software downloaded from this web site is provided 'as is' and is released under the MIT Licence. If you have problems or suggestions, please let me know, but I do not guarantee a response nor support for this product.