django-clicky 1.2.1

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

Clicky data can be annotated with custom properties. The most obviously useful information is whether the visitor is a logged in user. The track_clicky template tag will automatically provide Clicky with the visitor username if a user has logged into Django.

Ignoring internal visitors

Often you do not want to track clicks from your development or internal IP addresses. For this reason you can set the CLICKY_INTERNAL_IPS to a list or tuple of addresses that the template tag will not be rendered on:

CLICKY_INTERNAL_IPS = ['192.168.45.2', '192.168.45.5']

If you already use the INTERNAL_IPS setting, you could set the clicky internal addreses to this value. This will be the default from version 2.0.0 upwards.