EXT: B-Net1 Piwik¶

Table of Contents¶

EXT: B-Net1 Piwik 1

Introduction 1

What does it do? 1

Features 1

Users manual 2

Configuration 2

Required parameters 2

Configuration Options 3

TypoScript Examples 3

Known problems 4

To-Do list 4

Changelog 4

Introduction¶

The extension implements Piwik tracking in TYPO3-based websites.

Piwik is a new open source (GPL license) web analytics product. It gives interesting reports on your website visitors, your popular pages, the search engines keywords they used, the language they speak… and so much more. To learn more about Piwik, go to http://www.piwik.org .

This extension is a reimplementation of m1_google_analytics, but for Piwik. It uses documentation and some code resemblance from Frank Naegler's original Piwik extension and from Ulrich Wünsche's Piwika2 extension.

Users manual¶

To install Piwik on your website follow these steps:

Install Piwik and create your Piwik account, for more information see http://piwik.org/

To enable Piwik tracking in your website, we need to know your site ID and hostname of the piwik installation.

Install the plugin from TYPO3 online repository and enable it

Add this configuration options to your template (both parameters are required):

config.tx_bn1piwik {
  piwik_idsite = (your site id)
  piwik_host   = (host/path of your piwik installation without URL-scheme)
}

That's all you need to start tracking your visitors. See “Configuration” section for more config options and description of the parameters.

Configuration¶

All configuration parameters for this extension should be in your template TypoScript, inside the config.tx_bn1piwik container. Please see the option descriptions below.

config.tx_bn1piwik {
      piwik_idsite = 3
        piwik_host   = stats.myhost.rl/piwik/
}

<!-- Start B-Net1 Piwik Tag →
<script language="javascript" src="http://stats.myhost.rl/piwik/piwik.js" type="text/javascript"></script>
<script type="text/javascript">
<!--
try {
var piwikTracker = Piwik.getTracker("http://stats.myhost.rl/piwik/piwik.php", 3);
piwikTracker.enableLinkTracking();
piwikTracker.trackPageView();
} catch( err ) {}
//-->
</script>
<noscript>
<p><img src="http://stats.myhost.rl/piwik/piwik.php?idsite=3" style="border:0" alt="piwik"/></p>
</noscript>
<!-- End B-Net1 Piwik Tag →
</body>

config.tx_bn1piwik {
             piwik_idsite = 3
             piwik_host   = stats.myhost.rl/piwik/
             actionName= TYPO3
             actionName {
                     stdWrap {
                             cObject = HMENU
                             cObject {
                                     special=rootline
                                     special.range= 1 | -1
                                     includeNotInMenu = 1
                                     wrap = |/index
                                     1=TMENU
                                     1.itemArrayProcFunc = user_UrteileItemArrayProcFunc
                                     1.NO.allWrap=  |   /   |*| |   /   |*| |
                                     1.NO.doNotLinkIt = 1
                             }
                     }
             }
     }

Known problems¶

The function to prevent FE-Pagehits from tracking for logged in BE- Users will only work if FE and BE are on the same Domain.

To-Do list¶

• Function to register a conversion for a goal with a custom Revenue .
• Function to send custom JSON data to the piwik.php tracking scripts.

Changelog¶

2.1.0: added stdWrap functionality to “actionName” property

2.0.2: fix problem with not processing setIgnoreClasses, setDownloadClasses and setLinkClasses typoscript parameters

2.0.1: fix errors with typoscript parameter and wrong javascript

2.0.0: first beta release

EXT: B-Net1 Piwik - 4