CrazyStat

Version 1.71 RC1

This is CrazyStat's Readme-file. CrazyStat is a comfortable, comprehensive and free statistic-script with optional counter. Thanks a lot for choosing CrazyStat.

1. Content

1. Content
2. Features
   • General
   • Statistic
   • Counter
3. Requirements
   • Server-Requirements
   • Client-Requirements
4. Installation
   • Quick Installation
   • Detailed Installaion process with counter
   • Detailed Installaion process without counter
   • After Installation
5. Frequently Asked Questions (FAQ)
6. History
7. To do
8. Copyright and license

2. Features

General

• can work completely without JavaScript (which a lot of scripts can't)
• no advertisement, logos or similar stuff on the pages counted, only small remark in alt-attribute of optional counter
• independent of other service providers because it's a PHP script running on your server
• configuration of IP blocking
• IPs can optionally be saved anonymously so that visitors can not be tracked back
• Statistics and counter in just one script!
• no MySQL required
• no access to server-logs required
• your pages stay valid HTML or XHTML
• optionally, your own hits are not counted
• log-files are optionally gzip-compressed so they use minimal webspace

Statistic

• All results are displayed on a clear interface that gives you all the information with a single glance using bar charts (for browser, screen resolution and operating system also pie charts).
• For the following data, hist or visitors will be analyzed for any time span or total time:
  • total hits
  • hits this month
  • hits last month
  • users online
  • maximum hits / day
  • average hits / day
  • hits / weekday
  • hits / month
  • hits / day
  • hits / hour
  • browser used by visitor
  • files (pages) viewed by visitor
  • screen resolution of visitor
  • color depth
  • operating system
  • referrer
  • search phrases the user entered before coming to the site
• average and sum values for all modules
• optional password protection with multiple users, password saved and transferred encrypted
• individual "presets" can be saved to access your preferred statistics-view easily and fastly
• download and manage log-files from web interface (backup, delete)
• logfile-viewer (as table)
• search inside log-files (filter)
• optimized analyzing-performance achieved by multiple caching techniques
• multilingual GUI (German and English at the moment)

Counter

• can be turned off
• when counter is turned off, visitor sees an image of your choice (e.g. blank.gif => user does not see anything)
• counter design can be chosen freely upon hundreds of images available on the net for free
• count hits or visitors (blocking ips)
• number of digits can be chosen freely
• transparency possible to make the counter integrate as good as possible into your design
• any value can be added to the real counter value (e.g. value of your old counter)
• optionally the counter can display a configurable text when it's a reload
• instead of a graphical counter, a text counter which integrates nicely into any text and can be style using CSS can also be displayed

Go to top

3. Requirements

Server-Requirements

• PHP 5.1 or newer (5.3.3, 5.3.8 have been tested), for Counter and pie charts with active gdlib > 2.0.28.
  For security reasons, register_globals = Off is generally recommended (but not required). Runs also if safe_mode = On.
• no MySQL
• Sites with a lot of visitors should use a "strong" server
• The script runs on nearly any php-webspace, including free hosters.

Client-Requirements

• Browser (Internet Explorer 5.5 to 9, Opera 5 to 11.62, Firefox 1.0 to 11, Safari 3.2.1 to 5.1.5 (Win), Google Chrome 1.0 to 18 have been tested
• Images (must not be blocked, text browsers will not be counted)
• JavaScript (only) needed to detect screen resolution and color depth and some comfort functions in the back-end (but even the back-end also works without JavaScript!)

Go to top

4. Installation

See FAQ on how to update CrazyStat 1.7x (including Release Candidates) to this version.
Updating from CrazyStat 1.5x or 1.6x is described only in the German FAQ (because CrazyStat < 1.70 was German-only)

Quick Installation (Steps in brackets only for counter!)

This guide is intended for experienced users.

1. Unzip the file
2. (Choose/download counter style (graphics in stat/usr/counter_styles/ - others on http://en.christosoft.de/Crazystat/Counter_styles)
3. (Convert counter style to PNG (or gif, if your GDLib supports gif) (see FAQ) and save it to "stat/usr/counter_styles")
4. Open stat/usr/config.php and adjust settings (esp. $config_rel_path)
5. Upload the "stat"-folder with all its sub-folders and files
6. Set chmod 777 for stat/usr and all of its files and subfolders and stat/src/log-tool
7. Insert <?php @include_once("stat/src/include.php"); ?> between <body> and </body> for every page to be counted, change file extension ".html" or ".htm" to ".php" (if it's not already ".php"). See FAQ: "CrazyStat in .html-files", "Count pages in different folders"
8. Open statistic (http://www.example.com/stat/). If password protection is active, please change password when logging in. Default-user is "admin", password is "pass".

If you changed "stat" into something else, you need to adjust the code (step 7) and $config_rel_path (step 4)!

Detailed Installation process with counter

1. Unzip the file somewhere on your local hard drive (e.g. with 7-Zip)
2. The choose a counter style. You find styles in "stat/usr/counter_styles" that are ready for usage. On http://en.christosoft.de/Crazystat/Counter_styles you find more styles, links to pages with even more styles as well as hints on how to make your own style.
3. Now make sure your counter style is in PNG-format (or GIF if your server supports it). You can find instructions under FAQ on how to convert your counter style to PNG. Place your style in "stat/usr/counter_styles".
4. Open "stat/usr/config.php" in a text editor (such as Notepad or PSPad) and adjust the settings according to your needs (esp. $config_rel_path). The file name of the counter file has to be set in $config_counter_file_name and $config_counter_enabled=true; must be set to activate the counter.
   More information on all configuration settings
5. Upload the "stat"-folder with all files and sub-folders to your server (e.g. via FTP using FileZilla)
6. Set chmod 777 for "stat/usr" and all of its files and sub-folders and "stat/src/log-tool". See FAQ on how to do this.
7. Insert <?php @include_once("stat/src/include.php"); ?> between <body> and </body> for every page to be counted, change file extension ".html" or ".htm" to ".php" (if it's not already ".php"). See FAQ: "CrazyStat in .html-files", "Count pages in different folders"
8. Open statistic (http://www.example.com/stat/). If password protection is active, please change password when logging in. Default-user is "admin", password is "pass".

Detailed Installation process without counter

1. Unzip the file somewhere on your local hard drive (e.g. with 7-Zip)
2. Open "stat/usr/config.php" in a text editor (such as Notepad or PSPad) and adjust the settings according to your needs (esp. $config_rel_path). Set $config_counter_enabled=false; to disable the counter.
   More information on all configuration settings
3. Upload the "stat"-folder with all files and sub-folders to your server (e.g. via FTP using FileZilla)
4. Set chmod 777 for "stat/usr" and all of its files and sub-folders and "stat/src/log-tool". See FAQ on how to do this.
5. Insert <?php @include_once("stat/src/include.php"); ?> between <body> and </body> for every page to be counted, change file extension ".html" or ".htm" to ".php" (if it's not already ".php"). See FAQ: "CrazyStat in .html-files", "Count pages in different folders"
6. Open statistic (http://www.example.com/stat/). If password protection is active, please change password when logging in. Default-user is "admin", password is "pass".

After Installation

• You can open the statistic in your browser with "http://example.com/stat/"
• The logtool (only German up to now) is available via "http://example.com/stat/log-tool/" (see FAQ)

Go to top

5. Frequently Asked Questions (FAQ)

Please see faq_en.html

Go to top

6. History

Pleas see history.html (only German up to version 1.70).

Go to top

7. To Do

Please see todo.txt

Go to top

8. Copyright and License

Copyright (C) 2004-2012 Christopher Kramer

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Website: http://en.christosoft.de
E-Mail: webmaster AT christosoft DOT de
Version: 1.71 RC1

Go to top