You are here

README.txt in Piwik Web Analytics 7.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 5 README.txt
  3. 6.2 README.txt
  4. 6 README.txt
  5. 7 README.txt
Module: Piwik - Web analytics
Author: Alexander Hass <http://www.hass.de/>


Description
===========
Adds the Piwik tracking system to your website.

Requirements
============

* Piwik installation
* Piwik website account


Installation
============
* Copy the 'piwik' module directory in to your Drupal
sites/all/modules directory as usual.


Usage
=====
In the settings page enter your Piwik website ID.

You will also need to define what user roles should be tracked.
Simply tick the roles you would like to monitor.

All pages will now have the required JavaScript added to the
HTML footer can confirm this by viewing the page source from
your browser.


Custom variables
=================
One example for custom variables tracking is the "User roles" tracking. Enter
the below configuration data into the custom variables settings form under
admin/config/system/piwik.

Slot: 1
Name: User roles
Value: [current-user:piwik-role-names]
Scope: Visitor

Slot: 1
Name: User ids
Value: [current-user:piwik-role-ids]
Scope: Visitor

More details about custom variables can be found in the Piwik API documentation
at http://piwik.org/docs/javascript-tracking/#toc-custom-variables.


Advanced Settings
=================
You can include additional JavaScript snippets in the advanced
textarea. These can be found on various blog posts, or on the
official Piwik pages. Support is not provided for any customisations
you include.

To speed up page loading you may also cache the piwik.js
file locally. You need to make sure the site file system is in public
download mode.


Known issues
============
Drupal requirements (http://drupal.org/requirements) tell you to configure 
PHP with "session.save_handler = user", but your Piwik installation may
not work with this configuration and gives you a server error 500.

1. You are able to workaround with the PHP default in your php.ini:

   [Session]
   session.save_handler = files

2. With Apache you may overwrite the PHP setting for the Piwik directory only.
   If Piwik is installed in /piwik you are able to create a .htaccess file in
   this directory with the below code:

   # PHP 4, Apache 1.
   <IfModule mod_php4.c>
     php_value session.save_handler files
   </IfModule>

   # PHP 4, Apache 2.
   <IfModule sapi_apache2.c>
     php_value session.save_handler files
   </IfModule>

   # PHP 5, Apache 1 and 2.
   <IfModule mod_php5.c>
     php_value session.save_handler files
   </IfModule>

File

README.txt
View source
  1. Module: Piwik - Web analytics
  2. Author: Alexander Hass
  3. Description
  4. ===========
  5. Adds the Piwik tracking system to your website.
  6. Requirements
  7. ============
  8. * Piwik installation
  9. * Piwik website account
  10. Installation
  11. ============
  12. * Copy the 'piwik' module directory in to your Drupal
  13. sites/all/modules directory as usual.
  14. Usage
  15. =====
  16. In the settings page enter your Piwik website ID.
  17. You will also need to define what user roles should be tracked.
  18. Simply tick the roles you would like to monitor.
  19. All pages will now have the required JavaScript added to the
  20. HTML footer can confirm this by viewing the page source from
  21. your browser.
  22. Custom variables
  23. =================
  24. One example for custom variables tracking is the "User roles" tracking. Enter
  25. the below configuration data into the custom variables settings form under
  26. admin/config/system/piwik.
  27. Slot: 1
  28. Name: User roles
  29. Value: [current-user:piwik-role-names]
  30. Scope: Visitor
  31. Slot: 1
  32. Name: User ids
  33. Value: [current-user:piwik-role-ids]
  34. Scope: Visitor
  35. More details about custom variables can be found in the Piwik API documentation
  36. at http://piwik.org/docs/javascript-tracking/#toc-custom-variables.
  37. Advanced Settings
  38. =================
  39. You can include additional JavaScript snippets in the advanced
  40. textarea. These can be found on various blog posts, or on the
  41. official Piwik pages. Support is not provided for any customisations
  42. you include.
  43. To speed up page loading you may also cache the piwik.js
  44. file locally. You need to make sure the site file system is in public
  45. download mode.
  46. Known issues
  47. ============
  48. Drupal requirements (http://drupal.org/requirements) tell you to configure
  49. PHP with "session.save_handler = user", but your Piwik installation may
  50. not work with this configuration and gives you a server error 500.
  51. 1. You are able to workaround with the PHP default in your php.ini:
  52. [Session]
  53. session.save_handler = files
  54. 2. With Apache you may overwrite the PHP setting for the Piwik directory only.
  55. If Piwik is installed in /piwik you are able to create a .htaccess file in
  56. this directory with the below code:
  57. # PHP 4, Apache 1.
  58. php_value session.save_handler files
  59. # PHP 4, Apache 2.
  60. php_value session.save_handler files
  61. # PHP 5, Apache 1 and 2.
  62. php_value session.save_handler files