ShapecodePiwikBundle

A Symfony2 Bundle that helps you to use the Piwik Open Analytics Platform with your project., _(*1)

It contains a Twig function that can insert the tracking code into your website. Plus, you can turn it off with a simple configuration switch so you don't track your dev environment., _(*2)

Installation

Simply add the following to your composer.json (see http://getcomposer.org/):, _(*3)

"require": {
    "shapecode/piwik-bundle": "~1.0"
}

And enable the bundle in app/AppKernel.php:, _(*4)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Shapecode\Bundle\PiwikBundle\ShapecodePiwikBundle(),
    );
}

Usage

Somewhere in your views, right before the closing </body> tag, insert, _(*5)

{{ piwik() }}

This will add the appropriate Piwik tracking code as described in the API reference., _(*6)

You have the ability to change the config on the fly if it necessary, _(*7)

{{ piwik({
    site_id: 1,
    host_name: 'my.piwik.hostname'
    host_path: '/sub_directory/',
    no_script_tracking: false
}) }}

Configuration

You can configure the bundle in your config.yml. Full Example:, _(*8)

shapecode_piwik:
    site_id: 1                      # required, no default. site id from piwik tool
    disabled: %kernel.debug%        # not required, default %kernel.debug%. Usually, you only want to include the tracking code in a production environment
    host_name: my.piwik.hostname    # required. no default. Hostname to the piwik instance.
    host_path: "/sub_directory/"    # not required, default null. Path to the tracking script on the host.
    no_script_tracking: true        # not required, default true. Enables Image-Tracking if JavaScript is disabeld.