XOOP-Stats v0.45 for XOOPS 2

XOOPS@IBDeeming! announces a new release of XOOP-Stats v0.45 for XOOPS 2.0.7+. XOOP-Stats continues to evolve and become a better, more enhanced offerring for XOOPS 2 administrators. There are a number of enhancements to make this an integral part of your XOOPS site!

This version has the following features:

XOOP-Stats V0.3 for XOOPS 2

Version 0.3

This version has the following features:

Version 0.2

Version 0.1

The is more planned for the future, and we are always open to suggestions or needs!

Make a BACKUP if UNSURE prior to Installing or Upgrading!!!

FRESH INSTALLATION

NOTE: If you are upgrading, skip this step!

The installation of this module is standard to any XOOPS site. There is one exception to the installation noted below to have Statistics running on your site.
  1. Log in to your XOOPS site as ADMIN
  2. Go to your XOOPS administration cPanel
  3. Copy the Statistics package to the modules directory
  4. Install Statistics module
    1. select the System Admin->Modules link.
    2. Locate the Statistics module in the lower list of the screen
    3. Select the icon to install the module
    4. Confirm your installation
    5. You should see a screen with the information showing the module has been installed. You can return to Module administration.
  5. There is a minor requirement to make this thing go.
    1. Add the following to your header.php file located in the root of XOOPS

      // for stats by XOOPS@IBDeeming!
      include_once XOOPS_ROOT_PATH.'/modules/statistics/include/hitcounter.php';


      at the top of the file header.php under the line

      include_once XOOPS_ROOT_PATH.'/class/xoopsblock.php';
  6. You should now be collecting data
  7. There are two blocks included with this module, activate as you would any block on your XOOPS site.
    1. Hitcounter - shows a graphical representation of the hits to your site. Check the options as listed above.
    2. Referers - shows the referers that have come to your site.

UPGRADE V0.1-V0.2 TO V0.3

There has been a minor table change to allow the new functionality of tracking referers, and a new table for holding your blacklist. I have supplied the proper update0-1or0-2to0-3.sql file in the statistics/sql folder. Please follow these recommended steps for a successful upgrade!
  1. Log in to your XOOPS site as ADMIN
  2. Go to your XOOPS administration cPanel
  3. Deactivate the Statistics module
    1. Uncheck the Active box for Statistics
    2. Select Submit
  4. Copy the Statistics package to the modules directory
  5. Apply the update0-1or0-2to0-3.sql file. This can be done through your favorite mySql tool. phpMyAdmin is the generator of the sql file. NOTE: if your prefix on your tables is NOT xoops, then you must edit the upgrade.sql file prior to installing. Make sure you replace xoops with your prefix is needed!
  6. Go to the Admin cPanel of your XOOPS site.
  7. Update the Statistics module
    1. select the System Admin->Modules link.
    2. select the upgrade option for Statistics
  8. Activate the statistics module
    1. Check the Active box for Statistics
    2. Select Submit
  9. Don't foget to check the settings for the Referers block!

UPGRADE V0.3 TO V0.45

There has been a minor table change to allow the new functionality of tracking screen width and color depth (not fully functioning yet!!!), and a new table for holding this data. I have supplied the proper update0-3to0-4-5.sql file in the statistics/sql folder. Please follow these recommended steps for a successful upgrade!
  1. Log in to your XOOPS site as ADMIN
  2. Go to your XOOPS administration cPanel
  3. Deactivate the Statistics module
    1. Uncheck the Active box for Statistics
    2. Select Submit
  4. Copy the Statistics package to the modules directory
  5. Apply the update0-3to0-4-5.sql file. This can be done through your favorite mySql tool. phpMyAdmin is the generator of the sql file. NOTE: if your prefix on your tables is NOT xoops, then you must edit the update0-3to0-4-5.sql file prior to installing. Make sure you replace xoops with your prefix is needed!
  6. Go to the Admin cPanel of your XOOPS site.
  7. Update the Statistics module
    1. select the System Admin->Modules link.
    2. select the upgrade option for Statistics
  8. Activate the statistics module
    1. Check the Active box for Statistics
    2. Select Submit
  9. Don't foget to check the settings for the Referers block!

Upgrade 0.4.5 BETA RC3 to 0.4.5 PROD

If you have been running the RC3 Version 0.4.5 - then your upgrade is simple!

ALL INSTALLATIONS - Activating User Screen Width and Color Depth

The capturing of screen width and color depth is not required for the active collection of stats data for your site. If you would like to capture this addtional data, you will need to activate the javascript required for reading this data from the users screen. This is very simple!

  1. Use the following script code:
    <script language="javascript">
    <!--
    writeCookie();
    
    function writeCookie() 
    {
     var today = new Date();
     var the_date = new Date("December 25, 2012");
     var the_cookie_date = the_date.toGMTString();
     var the_cookie = "sw=" + screen.width +
          "; expires=" + the_cookie_date +
          "; path=/" +
          "; domain="; 
    
     document.cookie=the_cookie
    
     var today = new Date();
     var the_date = new Date("December 25, 2012");
     var the_cookie_date = the_date.toGMTString();
     var the_cookie = "sc=" + screen.colorDepth +
          "; expires=" + the_cookie_date +
          "; path=/" +
          "; domain="; 
    
     document.cookie=the_cookie
    }
    //-->
    </script>
    
    Make sure it is contained within the valid script tags for Javascript!!!
  2. Log in as admin to your site
  3. Select Sytem Admin->Preferences
  4. Select Edit Meta Tags and Footer
  5. Add the Javascript provided anywhere within the FOOTER text entry field (this will activate for all themes that are properly supporting the xoops_footer Smarty tag. They all should be!
  6. Save your settings!
  7. This counts for visitors in your site, not admin pages.

SUPPORT

Go to XOOPS@IBDeeming! and check the forums. You can also contact us at the site for more support!

Thanks for using this mod!