Piwik Analytics for your Django project
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
piwik_analytics
.gitignore
README.org
setup.py

README.org

Piwik Analytics for Django

Piwik Analytics for Django provides an easy way to intergrate Piwik into your Django Project.

Piwik is an open source / free software alternative to Google Analytics and allows you to have your analytics server.

This application provides a template tag that injects the required html snippet in your pages. Support different site ids and hosts using the sites django application.

It is an extension to the django-google-analytics application and requires it to be installed.

Installation

  1. Download and install django-google-analytics. You need django-google-analytics with changes. Until merge upstream get it from this repo

    ~$ pip install -e git://github.com/glogiotatidis/django-google-analytics.git#egg=google_analytics

  2. Download and install django-piwik-analytics

    ~$ pip install -e git://github.com/glogiotatidis/django-piwik-analytics.git#egg=piwik_analytics

Usage

Simple direct use

  1. Add the piwik_analytics application to your INSTALLED_APPS section of your settings.py
  2. In your based template, usally a base.html, insert this tag at the very top:

    {% load piwik_analytics %}

  3. In the same template, insert the following code right before the closing body tag:

    {% piwik_analytics “url example.com/piwik/ id 1” %}

    Make sure that you replace example.com/piwik/ with your piwik installation url and 1 with your site id.

Through the sites django application

  1. Add the piwik_analytics application to your INSTALLED_APPS section of your settings.py
  2. Add the google_analytics application to your INSTALLED_APPS section of your settings.py
  3. Add GOOGLE_ANALYTICS_MODEL = True to your settings.py.
  4. Run a ./manage.py syncdb to add the database tables
  5. Go to your project’s admin page (usally admin) and click Google Analytics/Sites
  6. In your based template, usally a base.html, insert this tag at the very top:

    {% load piwik_analytics %}

  7. In the same template, insert the following code right before the closing body tag:

    {% piwik_analytics %}

    Make sure that you replace example.com/piwik/ with your piwik installation url and 1 with your site id.

License

This project is distributed under the Affero GPL License v3