schnti / kirby-piwik

Kirby 2 plugin that generates piwik analytics code to use in your templates.

Matomo plugin

A plugin for Kirby 2 CMS that generates piwik analytics code to use in your templates.

Installation

Copy or link the piwik directory to site/plugins/ or use the Kirby CLI:

kirby plugin:install schnti/kirby-piwik

Config Variables

Tracking

• ka.piwik.tracking: Boolean (enable tracking, default: false)
• ka.piwik.trackingIfLoggedIn: Boolean (enable tracking when user is logged in, default: true)
• ka.piwik.url: String (piwik endpoint)
• ka.piwik.id: Int (page ID in your piwik installation)

Widget

• ka.piwik.widget: Boolean (show widget, default: false)
• ka.piwik.apitoken: String (your piwik API token)

OptOut

• ka.piwik.language: String (language code, default: de)

c::set('ka.piwik.url', 'https://stats.yourpage.com');
c::set('ka.piwik.id', 28);
c::set('ka.piwik.tracking', true);
c::set('ka.piwik.trackingIfLoggedIn', true);
c::set('ka.piwik.widget', true);
c::set('ka.piwik.apitoken', 'abcdefghijklmnopqrstuvwxyz');
c::set('ka.piwik.language', 'de');

How to use it

Tracking

use this right before closing </body> tag

<?= piwik(); ?>

OptOut

In your text file you can use it as follows:

iFrame

(piwikOptOut:)

You need the Piwik Custom Opt Out Plugin

or

AJAX (Responsive)

(piwikAjaxOptOut:)

You need the Piwik Ajax Opt Out Plugin

kirby-piwik's Issues

matomo

any changes necessary for this plugin since piwik is now matomo?

Kirby error

Adding this plugin leads to error on Kirby.

Settings

• Kirby v2.5.12
• basic StarterKit them for Kirby
• added tracking code as on readme on snippet footer.php:

<?= piwik(); ?>
</body>
</html>

Error

session_start(): Cannot send session cache limiter - headers already sent

Disable tracking for logged in users

It would be great to set a config value to disable tracking when a user is logged in.