aboutsummaryrefslogtreecommitdiffstats
path: root/addon/piwik
diff options
context:
space:
mode:
Diffstat (limited to 'addon/piwik')
-rw-r--r--addon/piwik/README43
-rw-r--r--addon/piwik/piwik.php2
2 files changed, 45 insertions, 0 deletions
diff --git a/addon/piwik/README b/addon/piwik/README
new file mode 100644
index 000000000..20b78b51e
--- /dev/null
+++ b/addon/piwik/README
@@ -0,0 +1,43 @@
+____ Piwik Plugin ____
+by Tobias Diekershoff
+ tobias.diekershoff(at)gmx.net
+
+This addon allows you to embed the code necessary for the FLOSS webanalytics
+tool piwik into the Friendika pages.
+
+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 ___
+
+In the Friendika git repository @/addon/piwik/piwik.php@ and a CSS file for
+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
+Friendika installation. The *optout* parameter (true|false) defines whether or
+not a short notice about the utilization of piwik will be displayed on every
+page of your Friendika site (at the bottom of the page with some spacing to the
+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).
+
diff --git a/addon/piwik/piwik.php b/addon/piwik/piwik.php
index aad2fd831..52bdaeb0d 100644
--- a/addon/piwik/piwik.php
+++ b/addon/piwik/piwik.php
@@ -18,6 +18,8 @@
* installation has. Alter the baseurl to fit your needs, don't care
* about http/https but beware to put the trailing / at the end of your
* setting.
+ *
+ * Documentation see http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Piwik_Plugin
*/
function piwik_install() {