]> git.mxchange.org Git - friendica-addons.git/commitdiff
mardownification of the README
authorTobias Diekershoff <tobias.diekershoff@gmx.net>
Sat, 1 Jun 2013 15:30:44 +0000 (17:30 +0200)
committerTobias Diekershoff <tobias.diekershoff@gmx.net>
Sat, 1 Jun 2013 15:30:44 +0000 (17:30 +0200)
piwik/README [deleted file]
piwik/README.md [new file with mode: 0755]

diff --git a/piwik/README b/piwik/README
deleted file mode 100755 (executable)
index c648a4d..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-## Piwik Plugin ##
-
-by Tobias Diekershoff 
-   http://diekershoff.homeunix.net/friendika/profile/tobias
-   tobias.diekershoff(at)gmx.net
-
-This addon allows you to embed the code necessary for the FLOSS webanalytics
-tool Piwik into the Friendica 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 Friendica git repository `/addon/piwik/piwik.php` and a CSS file for
-styling the opt-out notice.
-
-### Configuration ###
-
-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.
-
-Open the .htconfig.php file and add "piwik" to the list of activated addons.
-
-    $a->config['system']['addon'] = "piwik, ..."
-
-You have to add 4 more configuration variables for the addon:
-
-    $a->config['piwik']['baseurl'] = 'example.com/piwik/';
-    $a->config['piwik']['sideid'] = '1';
-    $a->config['piwik']['optout'] = true;
-    $a->config['piwik']['async'] = false;
-
-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
-Friendica 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 Friendica 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).
-
-The *async* parameter (true|false) defines whether or not to use asynchronous
-tracking so pages load (or appear to load) faster.
diff --git a/piwik/README.md b/piwik/README.md
new file mode 100755 (executable)
index 0000000..1005970
--- /dev/null
@@ -0,0 +1,61 @@
+Piwik Plugin
+============
+
+by Tobias Diekershoff 
+
+This addon allows you to embed the code necessary for the FLOSS webanalytics
+tool Piwik into the Friendica pages.
+
+Requirements
+------------
+
+To use this plugin you need a [piwik](http://piwik.org/) installation.
+
+Where to find
+-------------
+
+In the Friendica addon git repository `/piwik/piwik.php` and a CSS file for
+styling the opt-out notice.
+
+Configuration
+-------------
+
+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.
+
+Open the .htconfig.php file and add "piwik" to the list of activated addons.
+
+    $a->config['system']['addon'] = "piwik, ..."
+
+You have to add 4 more configuration variables for the addon:
+
+    $a->config['piwik']['baseurl'] = 'example.com/piwik/';
+    $a->config['piwik']['sideid'] = '1';
+    $a->config['piwik']['optout'] = true;
+    $a->config['piwik']['async'] = false;
+
+Configuration fields
+---------------------
+
+* 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
+Friendica 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 Friendica 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.
+* The *async* parameter (true|false) defines whether or not to use asynchronous
+tracking so pages load (or appear to load) faster.
+
+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).
+