This is beta software. A moderate level of knowledge of how your web server works is assumed until better documentation is available.
This sofware requires AWStats to be installed.
Please make sure AWStats is already installed and working on your server. JAWStats will not function without it. Installing JAWStats should only take a couple of minutes.
Download and unpack the latest version of JAWStats into a folder on your web server. This folder should be needs to be web-visible, i.e. you can access it from a web browser by typing in the appropriate URL.
Duplicate the config.dist.php file, calling the new copy config.php.
Edit your new config.php using your favourite text editor as follows:
- $sDefaultLanguage: (NEW to v0.7) the default language (see list of languages below)
- $sConfigDefaultView: ignore (this will be discussed in future documentation)
- If you want to remove the "change site" link, change $bConfigChangeSites to false.
- If you don't want your users to be able to update 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 has 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", "sitename" => "My 1st Domain", "theme" => "default", "fadespeed" => 250, "password" => "my-1st-password", "includes" => "", "language" => "en-gb" );
Those variables explained:
- 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.
- "sitename": (NEW to v0.7) [optional] an alternative name given to the domain as opposed to displaying the actual URL
- "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": 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"
- "language": (NEW to v0.7) [optional] the default language for this site (see list of languages below)
Handling non-standard AWStats filenames
By default, AWStats produces data files in the format awstatsMMYYYY.example.com.txt where MM and DDDD represent the month and year numbers respectively and example.com would be replaced with the name of your domain config.
As of a patched release of version 0.7, JAWStats can now also handle these files. To do so, add in an extra variable to each config array that needs it called statsname. For example, this may look like:
$aConfig["site1"] = array( "statspath" => "/path/to/data/", "statsname" => "myformat[YYYY][MM].txt", "updatepath" => "/path/to/awstats.pl/", "siteurl" => "http://www.my-1st-domain.com", "sitename" => "My 1st Domain", "theme" => "default", "fadespeed" => 250, "password" => "my-1st-password", "includes" => "", "language" => "en-gb" );
The segments of the string in square brackets denote the year and month numbers, simply rearrange the string to suits your particular configuration. Date options are:
- [YYYY]: Year in 4 digits, e.g. 2009
- [YY]: Year in 2 digits, e.g. 09
- [MM]: Month in 2 digits, e.g. 01..12
- [M]: Month without leading zero, e.g. 1..12
Note: Don't forget to include the square brackets.
Installing Language packs
Download the latest language pack from the Add-Ons section. Unzip this file into your jawstats/language directory. These translations are available to use immediately (though you may need to clear your browser cache if they don't appear immediately).
At the time of writing available languages are:
- English (use code: en-gb)
- French (use code: fr)
- German (use code: de-de)
- Japanese (use code: jp)
- Polish (use code: pl)
- Swedish (use code: sv)
Feel free to request new languages to be translated.
Version 0.7 Beta Released
Sprechen Sie Deutsch? Multi-lingual JAWStats v0.7 is finally here.
Please donate a dollar (or more!) towards the hosting costs for this site. This money doesn't go anywhere near my pocket, it is purely used against my hosting bill.