2012-02-23 04:38:35 +00:00
|
|
|
## Piwik Plugin ##
|
|
|
|
|
|
|
|
|
|
by Tobias Diekershoff
|
2012-04-07 07:21:49 +00:00
|
|
|
http://diekershoff.homeunix.net/friendika/profile/tobias
|
2011-09-25 08:56:03 +00:00
|
|
|
tobias.diekershoff(at)gmx.net
|
|
|
|
|
|
|
|
|
|
This addon allows you to embed the code necessary for the FLOSS webanalytics
|
2012-02-19 09:17:38 +00:00
|
|
|
tool Piwik into the Friendica pages.
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
[Online version of this Document](http://ur1.ca/35m2x)
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
### Requirements ###
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
To use this plugin you need a [piwik](http://piwik.org/) installation.
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
### Where to find ###
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
In the Friendica git repository `/addon/piwik/piwik.php` and a CSS file for
|
2011-09-25 08:56:03 +00:00
|
|
|
styling the opt-out notice.
|
|
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
### Configuration ###
|
|
|
|
|
|
2012-04-07 07:21:49 +00:00
|
|
|
The easiest way to configure this addon is by activating the admin panels of
|
|
|
|
|
your ~friendica server and then enter the needed details on the config page
|
|
|
|
|
for the addon.
|
|
|
|
|
|
|
|
|
|
If you don't want to use the admin panel, you can configure the addon through
|
|
|
|
|
the .htconfig file.
|
|
|
|
|
|
2012-02-23 04:38:35 +00:00
|
|
|
Open the .htconfig.php file and add "piwik" to the list of activated addons.
|
2011-09-25 08:56:03 +00:00
|
|
|
|
|
|
|
|
$a->config['system']['addon'] = "piwik, ..."
|
|
|
|
|
|
2012-02-19 09:17:38 +00:00
|
|
|
You have to add 4 more configuration variables for the addon:
|
2012-02-23 04:38:35 +00:00
|
|
|
|
2012-02-19 09:17:38 +00:00
|
|
|
$a->config['piwik']['baseurl'] = 'example.com/piwik/';
|
|
|
|
|
$a->config['piwik']['sideid'] = '1';
|
|
|
|
|
$a->config['piwik']['optout'] = true;
|
|
|
|
|
$a->config['piwik']['async'] = false;
|
2011-09-25 08:56:03 +00:00
|
|
|
|
2012-02-19 09:17:38 +00:00
|
|
|
The *baseurl* points to your Piwik installation. Use the absolute path,
|
2011-09-25 08:56:03 +00:00
|
|
|
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 11:08:46 +00:00
|
|
|
Friendica installation. The *optout* parameter (true|false) defines whether or
|
2012-02-19 09:17:38 +00:00
|
|
|
not a short notice about the utilization of Piwik will be displayed on every
|
2012-01-31 11:08:46 +00:00
|
|
|
page of your Friendica site (at the bottom of the page with some spacing to the
|
2011-09-25 08:56:03 +00: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).
|
|
|
|
|
|
2012-02-19 09:17:38 +00:00
|
|
|
The *async* parameter (true|false) defines whether or not to use asynchronous
|
|
|
|
|
tracking so pages load (or appear to load) faster.
|
