##############################################################
## MOD Title: chCounter Integration in phpBB3
## MOD Author: Volker S. Latainski < me@expblog.net > http://chcounter.expblog.net
## MOD Description: Includes the chCouter into every phpBB3 page.
## MOD Version: 1.0
##
## Installation Level: easy
## Installation Time: 5 Minutes
## Files To Edit: (3)
##          includes/functions.php
##          styles/{$templatename}/template/overall_footer.tpl
##          styles/{$templatename}/template/simple_footer.php
##############################################################
### Author Notes:
##
##      The chCounter must be installed first.
##
###
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##############################################################


#
#-----[ OPEN ]------------------------------------------
#
includes/functions.php

#
#-----[ FIND ]------------------------------------------
#
// The following assigns all _common_ variables that may be used at any point in a template.

#
#-----[ BEFORE, ADD ]------------------------------------------
#
//
// chCounter
//
ob_start();
$chCounter_force_new_db_connection = FALSE;
include('path/to/counter/directory/counter.php'); // replace "path/to/counter/directory/" with the full path to your counter
$chCounter = ob_get_contents();
ob_end_clean();

#
#-----[ FIND ]------------------------------------------
#
  'SITENAME'                        => $config['sitename'],

#
#-----[ AFTER, ADD ]------------------------------------------
#
  'COUNTER' => $chCounter,


#
#-----[ OPEN ]------------------------------------------
#
styles/{$templatename}/overall_footer.tpl

#
#-----[ FIND ]------------------------------------------
#
<!-- IF TRANSLATION_INFO --><br />{TRANSLATION_INFO}<!-- ENDIF -->

#
#-----[ OR FIND ]------------------------------------------
#
<span class="copyright">Powered by <a href="http://www.phpbb.com/">phpBB</a> &copy; 2000, 2002, 2005, 2007 phpBB Group

#
#-----[ AFTER, ADD ]------------------------------------------
#
<!-- IF COUNTER --><br />{COUNTER}<!-- ENDIF -->


#
#-----[ OPEN ]------------------------------------------
#
styles/{$templatename}/simple_footer.tpl

#
#-----[ FIND ]------------------------------------------
#
<span class="copyright">Powered by <a href="http://www.phpbb.com/">phpBB</a> &copy; 2000, 2002, 2005, 2007 phpBB Group</span>

#
#-----[ AFTER, ADD ]------------------------------------------
# 
<br />
{COUNTER}


#
#-----[ SAVE/CLOSE ALL FILES ]--------------------------
#


#
# ADDITIONAL INSTRUCTIONS/HINTS
#
# 1. The counter must be installed first.
# 2. You must customize the path to the counter directory that is added to the file includes/functions.php.
# 3. The placeholder {COUNTER} _must_ be noted within the templates. To be able to count JavaScript and screen resolutions,
#    an (invisible) output of the counter has to be transferred to the visitors. But of course you can note this placeholder
#    whereever you like.
# 4. To pretend that the phpBB session IDs are stored by the counter (which would be a serious security issue),
#    you have to tell the counter to remove the "sid" variable (without quotes)
#    (Administration Area -> Settings -> Statistics -> Common -> Pages statistic: purge of the query string)
#    You may even add every GET variable that is used by phpBB to this list. The variables:
#    sid; mode; u; search_author; t; p; f; highlight; folder; logout; start; postdays; postorder; search_id; mark; view; agreed; vote; watch; unwatch; c; redirect; topicdays; coppa; order; 
#


# EoM