.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================= EXT: B-Net1 Piwik ================= :Author: Kasper Skårhøj :Created: 2002-11-01T00:32:00 :Changed by: Jörg Winter :Changed: 2009-10-06T13:53:09 :Author: Jörg Winter :Email: winter@b-net1.de :Info 2: Ulrich Wünsche :Info 3: :Info 4: .. _EXT-B-Net1-Piwik: EXT: B-Net1 Piwik ================= Extension Key: **bn1\_piwik** Copyright 2009, Jörg Winter, **Please report all bugs and feature request at `http://dev.b-net1.de/ `_** This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.com .. _Table-of-Contents: 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: 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. |img-1| .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ The extension inserts the javascript-code used for tracking website users with Piwik, into the end of the body-tag. .. _Features: Features ^^^^^^^^ - Implements the Javascript Tracking Code for the New Piwik Javascript Tracking API that commes with Piwik 0.4 - The following Piwik Tracking Functions can be configured with Typoscript. - piwikTracker.setDocumentTitle() - piwikTracker.trackGoal() - piwikTracker.setDomains() - piwikTracker.enableLinkTracking() - piwikTracker.setIgnoreClasses() - piwikTracker.setDownloadClasses() - piwikTracker.setLinkClasses() - piwikTracker.setLinkTrackingTimer() - piwikTracker.setDownloadExtensions() - piwikTracker.addDownloadExtensions() - If You are logged in as a BE-User your FE-Hits will not be tracked. .. _Users-manual: 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: 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. .. _Required-parameters: Required parameters ^^^^^^^^^^^^^^^^^^^ Defines your Piwik site id and host/path to your piwik installation. This parameter **needs to be set** for the extension to work. If your Sites ID is 3 and the path your piwik installation is stats.myhost.rl/piwik/piwik.php, your TypoScript in the template should look like: :: config.tx_bn1piwik { piwik_idsite = 3 piwik_host = stats.myhost.rl/piwik/ } Once you set up this parameter, you can check if everything worked correctly by looking at your pages HTML source. The piece of code that drives Piwik is inserted right before the closing tag of container: ::