chCounter v2.3 ReadMe |
Welcome! chCounter is a textcounter with detailed statistics. Features:
|
System requirements |
|
Installation |
|
1. configuration file |
First, there must be made some changes in the file config.inc.php in the directory /include:
$chCounter_dbconfig['server'] $chCounter_dbconfig['user'] $chCounter_dbconfig['passwort'] $chCounter_dbconfig['database'] Furthermore, you can find in the config file the default names for the chCounter database tables, and environment variables. They usually don't need to be edited. |
3. Customize the templates |
Open in the directory /templates of the counter and change the layout of the counter, if you want to.
|
4. Upload the counter files und directories |
Upload now all files and directories (apart from update.php, analyse_useragents.php) with your ftp accountper FTP to your webspace into any directory. |
5. Online installation |
Now follows the real installation via web interface:
Open the file install.php in the counter directory with your internet browser und follow the installation routine. |
6. Administration panel |
Log in the administration area at
http://www.yourdomain.de/pathtoscript/administration/index.php and customize the counter as far as you want. |
2. Insertion of the counter into your homepage. |
In the administration area under "help" you can create your individual code to include the counter. Neverless, here's a tutorial: Including with PHPThe site where you use PHP-Code must have the file extension *.php, otherwise the PHP-Code won't be parsed. <?php include("PATH_TO_SCRIPT/counter.php"); ?> PATH_TO_SCRIPT must be replaced with the path to the counter directory (relative or absolute from server root, not a path with "http://"!). The layout of the counter is set in the template file "templates/counter.tpl.html". $chCounter_visible = "0"; If you add the following line, the counter will be inactive: $chCounter_status = "inactive"; If you want that the counter is displayed in a different layout as defined in the template file "counter.tpl.html", you can assign an individual template: <?php $chCounter_template = <<<TEMPLATE Here comes the individual template, e.g. visitors: {TOTAL_VISITORS}<br> online: {VISITORS_ONLINE} after this line here ends the template TEMPLATE; include("PATH_TO_SCRIPT/counter.php"); ?> You can find the needed placeholders in the template file. TEMPLATE; must not be noted anything else (the line must not be intended with blanks, too)!! Including the counter with JavaScriptAlternativly can be included with JavaScript (thus the file into which the counter is included doesn't need the extension "php"). Anyway, use JavaScript to include the counter only, if PHP is absolutely not possible. That's all yet, |
Administration Area |
The following subpages are available:
|
Documentations |
Some functions and/or attributes of the counter script are more precisely described here. |
Templates |
The template files are located in the directory "templates/". The templates are responsible for the layout of the files counter.php, statistics.php and onlineusers.php, you can customize them (nearly) completely. Special placeholders, encluded within curly brackets are later replaced with the corresponding content. Placeholders can be deleted without any problem to suppress for example the output of a special value. Templates can be also defined locally within the PHP code which includes the counter, for more information see here. For the locally defined templates apply the same rules as mentioned above. |
Page Titles |
In order not to show the file names and paths as title in the online users- and pages statistics, the counter searches in die file in which the counter is included for one of the following tags:
Alternatively, a page title can be assigned directly in the php code. To use this function must be added the following line before the include command: $chCounter_pagetitle = "HERE_COMES THE PAGE_TITLE"; |
Homepage-URL |
In the administration area, the URL of your homepage must be specified. If you have xour own domain, it would look like: http://www.domainname.tld/ If you don't have an own domain and your homepage is available under e.g. www.domain.tld/members/name/, the URL must look like: http://www.domain.tld/members/name/. It's important that you insert the whole path to your homepage root, not only the domain name. If you use a redirection, e.g. like "www.mydomain.de.vu", don't insert this address, but the real address of your homepage files. |
Miscellaneous |
FAQ's |
The counter isn't visible, only the PHP code is displayed in the page source code! Is it sufficient to include the counter into one page? Will all other pages be counted, too? |
Update from version 2.1.x or 2.2.x to 2.3 |
|
History |
Here a list of the chCounter versions: v2.3 - 03|07|2004 v2.2.1 - 08|19|2003 v2.2.0 - 08|17|2003 v2.1.1 - 04|05|2003 v2.1 - 03|07|2003 v2.0 - 02|18|2003 v1.03 - 07.01.2002 v1.02 - 01|06|2003 v1.01 - 01|04|2003
v1.0 - 01|03|2003 |
License |
chCounter, Copyright by Christoph Bachner, 2004
chCounter 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. chCounter 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 chCounter; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
Contact |
|
(c) by Christoph Bachner, 2004 |