SolidStats Documentation

Introduction

SolidStats gives you the possibility to track your entire Web Site. The SolidStats HTML code is able to automatically detect the name(s) and the Url(s) of your pages.
You need to upload the pphlogger.js file to your server and place the SolidStats HTML code into all your Web site Pages. Both, you can find in your confirmation email or - if you have lost that - when you enter your useraccount, in the "settings" area.

Implementation

Here's the code you should enter in your pages:

<!-- SolidStats Code START -->
<script language="JavaScript" type="text/javascript" src="/pphlogger.js"></script>
<a href="http://counter.akado.fi/"><img src="http://counter.akado.fi/showhits.php?id=your_username&st=img" alt="Free Web Counter" border="0"></a>
<!-- SolidStats Code END -->

Make sure pphlogger.js is located in the main (root) directory of your website. If also can use an absolute path like src="http://www.your_domain.com/pphlogger.js".

URL handling

Dynamic website

If you're using a dynamically built site that is just made of one single page. e.g. you only got list.php and the actual content of this page gets generated out of the information located in the query-part of the URL. So you actually need to distinguish between URLs with various different query-strings. At this point you have to use the "short query" user setting. You can specify your own query-strings that you wish to get logged. You have to enter the query-strings into the "short query" textbox in the "settings" menu, each separated by a newline.

Example:

Let's say your URL looks like:
http://www.abc.com/abc.php?date=200111&s=d46df4e47043bfab5d08fee9d24e0146&threadid=100&page=news

short query:
------------
date
page
------------

result:
-------
SolidStats will keep your URL like:
http://www.abc.com/abc.php?date=200111&page=news

By specifying "date" and "page" we're able to cut the query-string down to those two values and stripping off all the other stuff. e.g. we don't need to store the session-ID s=d46df4e47043bfab5d08fee9d24e0146 and threadid=100.

If we enter a "*" as short query string, then nothing will be stripped off and SolidStats will keep the whole query-string:

http://www.abc.com/abc.php?date=200111&s=d46df4e47043bfab5d08fee9d24e0146&threadid=100&page=news

short query:
------------
*
------------

result:
-------
http://www.abc.com/abc.php?date=200111&s=d46df4e47043bfab5d08fee9d24e0146&threadid=100&page=news

As default, the "short query"-string is empty. That way SolidStats would strip off the whole query string.

index.* --> /

This list is for those who would like to handle "index.*" as "/".
Enter all index.* into this setting box, separated by newlines, e.g.:

index.* --> /

---------------
index.html
index.php
index.phtml
---------------

FAQ - Frequently Asked Questions

When do I need to press the [ clean-up ] link in the bottom-right corner of the calendar?
The [ clean-up ] is only used if your calendar is somehow messed-up. Usually this should NEVER happen, so you don't actually ever need to use this link.
If you click on it, all you calendar information will be deleted and recalculated (without affecting any logs! don't worry :). If you got a huge amount of logs in your logs-table (by "huge" I mean like 200 logs/day throughout a whole year...) then it may take a long time to recalculate. Due to the maximum execution time that is usually set to 30 seconds the script may break. Just reload it again and again till you see the calendar. While it is running DO NOT RELOAD! Always wait till it is done.
Due to an enormous server load, this [ clean-up ] link has been disabled for users who are just logged in as guests.

What does "mp" mean?
mp stands for "multi-page" and is the amount of pageimpressions by user. It shows how many pages a user was viewing and how many reloads he has done.

How do I track referrers on a framed site?
Edit your pphlogger.js file:
uncomment (remove the '//') the following line on top of the file: pp_frames = TRUE;
WARNING: This may cause a Javascript security error on several browsers in case your frameset is not located on the same domain. For people using a "stealth frame" like Namezero or MyDomain offers, it will be impossible to track referrers!