Index:

1. System requirements

2. Installation
2.1 Upload
2.2 Installation

3. first steps
3.1 Explanation to the script
3.1.1 Counter settings
3.2 Counter include

4. Troubleshooting

 

1. System requirements
================================

-min. PHP 4.1.0 (4.4.1 & 5.0.4 tested)
-min. MySQL 4.0.x (4.0.x & MySQL 5.0.15 tested)

 

2. Installation
================================

2.1: Upload
---------------------------------------------------------

First you must unchanged upload all files and folders who are in the rare archives to an arbitrary place on your Webspace as of folder "xt_stats". If this was done, the file "counter.config.inc.php" must want to provide 0777 with the write authorities CHMOD in the list "...your path.../xt_stats/management/config/" (one can make this with modern FTP clients such as FlashFXP ).

You can learn rest to CHMOD here http://en.wikipedia.org/wiki/Chmod

2.2: Installation
---------------------------------------------------------

If you open its Web browser, dial the URL to the install.php (such as: www.wunschdomain.de/xt_stats/install.php) and type in there for your MySQL DB under MySQL access data, the access data. You enter its desired user name and password under user setting now. This user is admin and can change the Countersettings as the only one and this see admins menu. If everything is done, press the save button. If the installation was successful, you are informed and passed on. PLEASE, THE FILE INSTALL.PHP DELETES IT FOR SAFETY REASONS!

 

3. first steps
================================

3.1: Explanation to the script
---------------------------------------------------------

After the installation was successful you call the URL to the folder xt_stats on your Webspace open (such as: www.wunschdomain.de/xt_stats/). There you can log in now. You can adjust the Counter according to your wishes in the menu item Countersettings now. Here a small help to the single ones setting and menus. Like you you can tie the Counter into your page experiencedly in step 3.2 Counter install

3.1.1 Counter settings

"Time shall be closed for this IP in s:"

Here you fix how long an IP shall be regarded as online. The user is not listed in the DB still one time as a new user in this period of time. The period of time is indicated within seconds. One appropriately makes sense 24 hours (86400 sec.) lock for meaningful statistics.

"A user online applies time to it in s:"

I think, explains himself what meant is. The period of time is indicated within seconds. One appropriately makes sense 5-10 minutes (300-600 Sek.) lock for good statistics.

"Count admins of it exclude by cookie?"

I think, explains himself what meant is.

"Counterspeed: slow"

I recommend at less frequented pages (ca. < 50 user online in the minute!). There are the possibility, different user data to evaluate as Referer and so on.

"IPs by md5 Hash disguised in the DB store?"

It is thought hereby that IPs are not stored as pure IPs in the DB but as IPs encoded with the md5 hash method. I have built-inly to ensure your side this option around the protection of data privacy of the visitors.You can learn rest to md5 here http://en.wikipedia.org/wiki/MD5

"Leading statistics about single pages?"

If this function is activated, statistics about the frequented pages of your web presence are led with the pagetitles. If the page title is well-known, this is used primarily. The file name of the side otherwise is used as a title. If the Counter only is integrated into the initial page, this function does not recommend itself to activate.

"If no side title was indicated, it shall be sought?"

If you have programmed its page in pure HTML code and the page title can be found so in the source text, <title>...your title...</tilte>, can you instruct the script to look for it for any tied page around it to see page analysis listed in the statistics then. I do not recommend, though, since the search takes a little time. You indicate this one is manually tied prefer for every page titles unite on with the help of the variable $xt_title = "your title" :

<?php
################## xt-Stats ##################

$xt_title = '....your title....';

include('....relative path to the Counter.../xt_stats/xt_counter.php');

##############################################
?>

"Leading statistics about user details?"

If this function is activated, you have a try to evaluate the data of the user.These would be country of origin, operating system, browsers and robots(such as: Googlesearchbot).One then can this inspect user analysis in the menu item.

"Leading statistics about java functions?"

If this function is activated, you test data are collected so about screen resolution, cookie statuses and Java type, whether the visitor has activated the Java functions of its browser and if yes. By this test it can add to problems if you use cookies at your page since the header must already be put by the Counter. If this is the case, you turn the function off or you build the Counterscript at sufficient experience at about, that the Counter stands under your cookie set function and the database connection is produced nevertheless for the Counter.

"Path to the xt-Stats dir at your server from root?"

You indicate here the relative path to the Counter on your Webspace, please, if it does not already stand correctly there.

"Leading statistics about Referer?"

If this function is activated, so-called Referer are stored With Referer referring domains are meant. I.e. statistics are laid out on which which strange internet page has interlinked yours is shown.

"This one shall name of the domain be excluded as Referer:"

If you have activated the function "Leading statistics about browsers, country & os?", you can or must indicate your domain here so that it is not listed in the statistics. Your domain there normally is already indicated by the Counter automatically. This it is not that way or a wrong domain is shown for, you must amend this there if.

"Counterspeed: fast"

I recommend at pages gone to much (ca. > 50 user online in der minute!).The possibility of evaluating user data or recording since this simply makes the side extremely slowly under circumstances does not exist in this speed option any more. The following data are saved merely:

-Visitors
-Visitors altogether
-Visitors simultaneous online
-Hits altogether

"Accesssettings"

You can change the user and DB access data there.

"Counter manipulating"

You can manipulate various counter stands there.

"Database cleaning up"

Here you can single or empty all table in the MySQL database manually.

"Counter include"

With the help of this function you can have the source code which you need to insert the Counter in your page generated. I recommend to use this fully automatic function urgently since tie there might be so few problems. .

"Statistics include"

With the help of this function you can have a source code which interlinks a visually attractive icon with a link to small statistics or the great statistics which you then can insert to an arbitrary place at your page generated. Only the Max and current values are distributed at the small statistics. This output be carried out via a Java pop-up.

3.2 Counter include
---------------------------------------------------------

You can include the Counter about the following source code :

<?php
################## xt-Stats ##################

include( $_SERVER['DOCUMENT_ROOT'].'/xt_stats/xt_counter.php");

##############################################
?>

Attention!

The Counter simply can include about the function "Counter include" in this counter setting menu.

This source code must be inserted in every side which shall be counted. If you work with a frameset, if the Counter should be tied into the tax file of the frameset.

With the help of the variable $xt_title can you manually indicate a side title for the page statistics.

Listed small statistics distributed will include if you put the variable $xt_showvalues on 1 ( such as: $xt_showvalues = 1; ) or this line like at your page.

4. Troubleshooting
================================

I have forgotten my user name / password and can not log in now any more than admin!

Open you to web server the file "counter.config.inc.php" on yours in the directory "xt_stats/management/config/". Go to the place in the file where the following stands:

//Adminpsw
$xt_adminpsw = "...old psw...";

Copy the following to exactly this place now:

//Adminpsw
$xt_adminpsw = "098f6bcd4621d373cade4e832627b4f6";

Now you close the file again but store before and log in with the password "test". You see the Counter settings menu now again, too and can give themselves a new password.

I have installed the Counter but all desired/no sides are not counted!

The Counter must be inserted in all files which shall be counted. Only if the Counter is inserted in a file, the Counter script is executed and the visitor therefore counted at a call of the file.

No Referer etc. are reported in the Referreranalyse!

a) You should use frames: Please also insert the Counter in the file with the frameset. If the Counter is tied only in a frame, the page referring to it is not the strange home page but the file with the frameset any more and therefore is not stored.
b) quod vide FAQ "The Counter counts wrongly, only a visitor online is always announced ... "

The Counter counts wrongly, only a visitor online is always shown, only side calls are counted ..!

You have presumably tied the Counter, bspw. include ("http://www.homepage.de/xt_stats/xt_counter.php"), with a full HTTP address; the Counter can be tied only about the file system of the web server, though, however.