Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Analytics support for pages using Piwik

Project Description

Introduction

collective.piwik.pageviews is a view that displays unique visits and pageviews, using Piwik!

The Piwik open source analytics system (http://piwik.org/) is used to store and retrieve the page views.

Works with Plone 4 sites, not tested on Plone 3. Needs Piwik version 1.6 or higher.

How to get it working

  • You need to have access to a working Piwik installation. The architecture allows API calls to be sent on the Piwik server, in case authentication is needed to view the site’s stats (which is the default case on Piwik).

To use it, you have to do the following steps:

  • In case it’s not already there, add the Piwik Tracking Tag to Javascript web stats support field at <SITEURL>/@@site-controlpanel (we have to use Piwik obviously!)
  • On the eggs section of your buildout.cfg add collective.piwik.pageviews and run ./bin/buildout -vN buildout.cfg for the product to be installed
  • Log in as admin and go to the Add-ons configuration section (<SITEURL>/prefs_install_products_form) and activate collective.piwik.core. This is a package dependancy necessary for piwik.pageviews to function.
  • Next, go to <SITEURL>/@@piwik-settings and provide the following information: - the Piwik server’s url with the slash on the end (example http://piwik.unweb.me/piwik/) - the Site id of Piwik (example 12). A piwik installation can track multiple sites, and each one has a unique site id
    • Piwik’s API key, which is a token auth key (example 5f298e9c697ec59b68d080cd9be47416), or anonymous if anonymous read access is granted.
  • If you do the above steps, a view appears below the IBelowContentTitle displaying the number of views of a page (both unique views and pageviews). The view is loaded after the page has loaded, so your site won’t slow down while quering the piwik server.

Tweaks

If you want to change the behavior, edit collective/piwik/pageviews/viewlet.pt (apply styles, remove page hits or page views, etc)

If you don’t see any view appearing below the Title, check that the Piwik’s setting are correct (<SITEURL>/@@piwik-settings)

You might also like to try these two products:

collective.piwik.flowplayer (http://pypi.python.org/pypi/collective.piwik.flowplayer) that displays a video play counter in Plone sites that use flowplayer, and collective.piwik.now (http://pypi.python.org/pypi/collective.piwik.now) that displays a portlet with the number of users currently using your Plone site.

Credits

Created by unweb.me and Giorgos Logiotatidis during the Bristol 2010 Plone conference.

Thanks to Engagemedia.org for sponsoring our tickets and registrations.

TODO

Contributors

  • Markos Gogoulos, mgogoulos at unweb.me
  • Dimitris Moraitis, dimo at unweb.me
  • Giorgos Logiotatidis, seadog at sealabs.net

Contributors

  • Markos Gogoulos, mgogoulos at unweb.me
  • Dimitris Moraitis, dimo at unweb.me
  • Giorgos Logiotatidis, seadog at sealabs.net

Release history Release notifications

This version
History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
collective.piwik.pageviews-0.2.zip (24.5 kB) Copy SHA256 hash SHA256 Source None Nov 2, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page