friendica-addons/piwik/README

44 lines
1.7 KiB
Plaintext
Raw Normal View History

2011-09-25 10:56:03 +02:00
____ Piwik Plugin ____
by Tobias Diekershoff
tobias.diekershoff(at)gmx.net
This addon allows you to embed the code necessary for the FLOSS webanalytics
2012-01-31 12:08:46 +01:00
tool piwik into the Friendica pages.
2011-09-25 10:56:03 +02:00
Online version of this Document: http://ur1.ca/35m2x
___ Requirements ___
To use this plugin you need a "piwik":http://piwik.org installation.
___ Where to find ___
2012-01-31 12:08:46 +01:00
In the Friendica git repository @/addon/piwik/piwik.php@ and a CSS file for
2011-09-25 10:56:03 +02:00
styling the opt-out notice.
___ Configuration ___
Open the .htconfig.php file and add "piwik" to the list of activated addons.
$a->config['system']['addon'] = "piwik, ..."
You have to add 3 more configuration variables for the addon:
$a->config['piwik']['baseurl'] = 'example.com/piwik/';
$a->config['piwik']['sideid'] = '1';
$a->config['piwik']['optout'] = true;
The *baseurl* points to your piwik installation. Use the absolute path,
remember trailing slashes but ignore the protocol (http/s) part of the URL.
Change the *sideid* parameter to whatever ID you want to use for tracking your
2012-01-31 12:08:46 +01:00
Friendica installation. The *optout* parameter (true|false) defines whether or
2011-09-25 10:56:03 +02:00
not a short notice about the utilization of piwik will be displayed on every
2012-01-31 12:08:46 +01:00
page of your Friendica site (at the bottom of the page with some spacing to the
2011-09-25 10:56:03 +02:00
other content). Part of the note is a link that allows the visitor to set an
_opt-out_ cookie which will prevent visits from that user be tracked by piwik.
Currently the optional notice states the following:
This website is tracked using the Piwik analytics tool. If you do not want
that your visits are logged this way you can set a cookie to prevent Piwik
from tracking further visits of the site (opt-out).