Clicky analytics for Django projects
Project description
The django-clicky application integrates Clicky analytics into a Django project.
Overview
Clicky is an online web analytics tool. It is similar to Google Analytics in that it provides statistics on who is visiting your website and what they are doing. Clicky provides its data in real time and is designed to be very easy to use. This Django application provides a template tag to add the tracking code to HTML templates.
Installation
To install django-clicky, simply place the django_clicky package somewhere on the Python path. The application is configured in the project settings.py file. In order to use the template tags, the django_clicky package must be present in the INSTALLED_APPS list:
INSTALLED_APPS = [
...
'django_clicky',
...
]
You set your Clicky Site ID in the CLICKY_SITE_ID setting:
CLICKY_SITE_ID = '12345678'
(You can find the Site ID in the Info tab of the website Preferences page on your Clicky account.)
Usage
The django-clicky application currently provides one template tags that tracks visitor clicks. In order to use the tag in a template, first load the django-clicky template library by adding {% load clicky %} at the top.
Tracking visitor clicks
Clicky uses Javascript to track every visitor click. The track_clicky tag inserts the tracking code in the HTML page. The Clicky web pages recommend adding the code directly before the closing </body> HTML tag:
...
{% track_clicky %}
</body>
</html>
The Javascript code added by the template tag is asynchronous and works on both plain HTTP and secure HTTPS pages. It also contains fallback HTML code that uses <a> and <img> tags to track browsers with Javascript disabled. If you want to skip this fallback code (for example, if you want to add it to the HTML head section) you can use the CLICKY_RENDER_NON_JS_CODE setting:
CLICKY_RENDER_NON_JS_CODE = False
Changelog
- 1.0.0
Initial release.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
