[ReleaseInfo] mx_sitestats module for MX-System (1.3.1)
 
 
This forum is locked: you cannot post, reply to, or edit topics.   This topic is locked: you cannot edit posts or make replies.   printer-friendly view    phpMiX.org Forum Index -> mxBB Modules -> mxBB Module: mx_sitestats
View previous topic :: View next topic  
Author Message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sun Aug 10, 2003 5:29 am    Post subject: [ReleaseInfo] mx_sitestats module for MX-System (1.3.1) Reply with quote

Note:
This module is now supported and maintained by the mxBB Team as an official module. Please, visit MX-System for further information, Thanks.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

mx_sitestats module for MX-System
Latest version released by phpMiX: 1.3.1
Download: Please, visit MX-System site.


  • FEATURES:

    • Hits and Sessions Counter.
    • Text or Graphic based Digits.
    • HTTP Referers management.
    • Several phpBB statistics blocks.

  • WISHLIST:

    • Ability to exclude words from the Top Words block (cryptoknight).






 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sat Sep 13, 2003 5:59 pm    Post subject: mx_sitestats description... Reply with quote



DESCRIPTION:

  • mx_sitestats is a global site statistics module.
  • While probably your hosting provider offers you powerfull web log analizers working at server level, it is very difficult to provide a consistent solution to display such information embeded into portal pages due to very different file formats used by such tools. So... best approach, IMHO, is collect this kind of information again, trying to add as little overhead as possible... also, try to manage information and offer statistics related to the Content, which is something unknown at server level...
  • This module currently manages separate counters for Hits (each page) and Sessions (unique visits) as well as HTTP Referers information.
  • Ability to customize the look of the counters using simple CSS tricks or small graphics.
  • Easy installation, as any other portal module Smile, but... it also requires to apply a small MOD to page_header.php (both Portal and phpBB sides) to hook all page loads and enable the collector.
  • This module also comes with several 3rd party's statistics and board information phpBB MODs ready for you to use as any other Portal block without further script modifications.
  • Note: Probably, next step will be to collect UserAgent information (Browser, Version, Platform, Resolution...).

Statistics and Board Information Blocks included (mostly based on 3rd party code):
  • AdminStats: based on Administrative Statistics v.2.1.0 by Nivisec, Acyd Burn.
  • MonthlyPosts: based on New Posts By Month v.1.0.0 by Tommy Jensen.
  • MonthlyTopics: based on New Topics By Month v.1.0.0 by Tommy Jensen.
  • MonthlyUsers: based on New Users By Month v.1.0.0 by Tommy Jensen.
  • TopPosters: based on Top Posters v.2.1.0 by Nivisec, Acyd Burn.
  • TopPosters (Tiny): Only shows username and posts count.
  • TopStarters: based on Most Active Topic Starter v.1.2.0 by Rusty Dragon.
  • FastestUsers: based on Fastest Users v.1.1.0 by Rusty Dragon.
  • TopTopics: based on Most Viewed/Active Topics v.2.1.0 by Nivisec, Acyd Burn.
  • MostInTopics: based on Most Interesting Topics v.1.3.0 by Rusty Dragon.
  • TopSmilies: based on Top Smilies v.2.1.0 by Acyd Burn.
  • TopAvatars: based on Top Avatars v.1.5.0 by Rusty Dragon.
  • TopWords: based on Top Words v.1.2.0 by Rusty Dragon.
  • UsersRanks: based on Users Ranks v.1.3.1 by Rusty Dragon.
  • SiteStaff: based on Staff v.2.0.3 by Acid.

Languages:
  • Catalan, Spanish and English.

< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sat Sep 13, 2003 6:05 pm    Post subject: mx_sitestats installation... Reply with quote



INSTALLATION/UPGRADE:

  • Remove possible old installation:
    In the Administration Panel -> Module Administration, delete previous instance of this module.
    Delete all module files within /modules/mx_sitestats.

  • Copy and upload new files:
    Unzip the distributed files into your portal modules directory: /modules/mx_sitestats.

  • Import the module definition file:
    In the Administration Panel -> Module Administration, import Module Pack for this module.

  • Configure Module Settings:
    In the Administration Panel, select the new module options.

  • Required step: apply Collector MOD to page_header.php (see below).

  • Add module blocks to any Portal page:
    In the Administration Panel -> Block Administration (or Page Administration).

Arrow Upgrading from v1.3.0 to v1.3.1:
  • Unzip and Upload all distributed files.
  • Then goto AdminCP->ModuleAdmin
  • Edit SiteStats module and change description to: Site Statistics module v1.3.1


< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sat Sep 13, 2003 6:55 pm    Post subject: mx_sitestats mods... Reply with quote



COLLECTOR MODS:

  • Following MODs are required to enable the Collector to capture hits, sessions, referers, etc. for ALL portal and forum pages.

  • To enable the Collector for ALL Portal pages, apply this MOD to mxroot/includes/page_header.php:

    Code:
    #
    #---[ OPEN ]----------
    #
    mxroot/includes/page_header.php

    #
    #---[ FIND ]----------
    #
    ?>

    #
    #---[ BEFORE, ADD ]----------
    #
    // ------------------------------
    // MOD:mx_sitestats:begin
    //
    include_once( $mx_root_path . 'modules/mx_sitestats/collector.' . $phpEx );
    //
    //MOD:mx_sitestats:end
    // ------------------------------

    #
    #---[ SAVE ]----------
    #


  • To enable the Collector for ALL phpBB pages, apply this MOD to phpBB/includes/page_header.php:

    Code:
    #
    #---[ OPEN ]----------
    #
    phpbb/includes/page_header.php

    #
    #---[ FIND ]----------
    #
    ?>

    #
    #---[ BEFORE, ADD ]----------
    #
    // ------------------------------
    // MOD:mx_sitestats:begin
    //
    // You should adjust $mx_root_path to your own installation if necessary !!!
    // The $mx_root_path variable should be set to the relative path from
    // your phpBB directory to the main Portal directory...
    //
    if( !isset($mx_root_path) )
    {
       $mx_root_path = '../';   // <--- Adjust this path !!!
    }
    if( @file_exists($mx_root_path . 'modules/mx_sitestats/collector.' . $phpEx) )
    {
       include_once($mx_root_path . 'modules/mx_sitestats/collector.' . $phpEx);
    }
    //
    //MOD:mx_sitestats:end
    // ------------------------------

    #
    #---[ SAVE ]----------
    #

  • Comments:
    • Please, backup your files before.
    • That's all. Take care. Have fun.

< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sat Sep 13, 2003 6:57 pm    Post subject: mx_sitestats Collector explained... Reply with quote



THE COLLECTOR EXPLAINED:

  • How the Collector Works?

    • Applying the MOD to page_header.php (as explained in Collector MODS section above) what we're, in fact, doing is installing a hook into the page creation process, for both the Portal and phpBB sides.
    • At this point (ie. each time page_header.php is processed), the job that collector.php does is really simple. It uses an OO approach to analyze all relevant information related to Session, Headers, etc. and finally store only condensed information into your database.
    • At the cost of very little overhead, you have usefull information ready to be reported by blocks like Counter, TopReferers, etc.
    • If you're worried about this performance penalty... see for yourself the response time of this site. Smile


  • Administration Control Panel -> SiteStats -> Settings




  • Administration Control Panel -> SiteStats -> Counter Management



    Id.: It is an autoincremented identifier. Transparent to the user.
    Page: This is the logical identifier of this counter. Actually, it's default value is $board_config['sitename'] (see collector.php).
    Hits: The current hits counter value.
    Sessions: The current sessions counter value.
    Edit: Use this function to manually update the counter.
    Delete: Remove this counter.
    Add: Use this function to add more counters. This is an advanced feature which allows you to create different counters for different pages. However, this is NOT fully implemented. Please, do not use it, yet!


< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Sat Sep 13, 2003 7:06 pm    Post subject: mx_sitestats TopReferers... Reply with quote



TOP REFERERS:

  • Administration Control Panel -> SiteStats -> Referers Management

    This page (screenshot below) allows you to manage (enable, disable or delete) HTTP Referers stored in your database (by the Collector).

    Please, see above the SiteStats->Settings screenshot for information on specific parameters related to HTTP Referers (enable/disable logging, etc.).

    More information related to HTTP Referers:

    • Quoted from the PHP manual:

      Quote:
      HTTP_REFERER:

      The address of the page (if any) which referred the user agent to the current page. This is set by the user agent. Not all user agents will set this, and some provide the ability to modify HTTP_REFERER as a feature. In short, it cannot really be trusted.

      http://www.php.net/manual/en/reserved.variables.php#reserved.variables.server



< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
markus
[Administrator]
[Administrator]


Joined: 28 Jul 2003
Posts: 1124

PostPosted: Thu May 27, 2004 3:13 am    Post subject: mx_sitestats history... Reply with quote



HISTORY OF CHANGES:

  • New in v.1.3.1 (2004/07/13):
    • Fixed a problem related to PHP Session Management.

  • New in v.1.3.0 (2004/06/12):
    • Added unique sessions counter (finally, we can count hits and sessions).
    • Added option to display the counter with graphics.
    • Added option to show more statistics from Counter block.
    • Added javascript function to preload graph images.
    • Added db_upgrade.php script.
    • Added Top HTTP Referers functionality.
    • Removed block parameters for the Counter... and added new AdminCP script to manage Counter/Referer settings.
    • Changed the way collector.php works.
    • Now page_header.php MOD is required to activate the collector !!!
    • Added TopPosters (Tiny) block (only shows username and posts).
    • Code cleanup here and there.

  • New in v.1.2.0 (2003/09/12):
    • Added AdminStats block (based on Administrative Statistics v.2.1.0 by Nivisec, Acyd Burn).
    • Added MonthlyPosts block (based on New Posts By Month v.1.0.0 by Tommy Jensen).
    • Added MonthlyTopics block (based on New Topics By Month v.1.0.0 by Tommy Jensen).
    • Added MonthlyUsers block (based on New Users By Month v.1.0.0 by Tommy Jensen).
    • Added TopPosters block (based on Top Posters v.2.1.0 by Nivisec, Acyd Burn).
    • Added TopStarters block (based on Most Active Topic Starter v.1.2.0 by Rusty Dragon).
    • Added FastestUsers block (based on Fastest Users v.1.1.0 by Rusty Dragon).
    • Added TopTopics block (based on Most Viewed/Active Topics v.2.1.0 by Nivisec, Acyd Burn).
    • Added MostInTopics block (based on Most Intersenting Topics v.1.3.0 by Rusty Dragon).
    • Added TopSmilies block (based on Top Smilies v.2.1.0 by Acyd Burn).
    • Added TopAvatars block (based on Top Avatars v.1.5.0 by Rusty Dragon).
    • Added TopWords block (based on Top Words v.1.2.0 by Rusty Dragon).
    • Added UsersRanks block (based on Users Ranks v.1.3.1 by Rusty Dragon).

  • New in v.1.1.0 (2003/09/07):
    • Added SiteStaff block (based on Staff v.2.0.3 by Acid).

  • New in v.1.0.2 (2003/07/31):
    • Fixed problem with collector.php and $module_root_path (not set or pointing to another module).
    • Fixed the hacking attempt message when calling collector.php from phpBB pages.
    • Fixed problem causing error editing Welcome block. $mx_table_prefix was not set, now explicitly set if required (loading mx/config.php).

  • New in v.1.0.1 (2003/07/22):
    • Added db_uninstall.php script.
    • Added AdminCP option to manage counters.
    • General cleanup of common classes.
    • Added collector.php which should be included in page_header.php.

  • New in v.1.0.0 (2003/07/10):
    • Very first beta.

< Back to Top >

 
 
_________________
http://www.phpmix.org
 
Back to top
View user's profile Send private message
Display posts from previous:   
This forum is locked: you cannot post, reply to, or edit topics.   This topic is locked: you cannot edit posts or make replies.   printer-friendly view    phpMiX.org Forum Index -> mxBB Modules -> mxBB Module: mx_sitestats All times are GMT + 1 Hour
 
Page 1 of 1


 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You can download files in this forum