Metadata-Version: 1.0
Name: django-clicky
Version: 1.0.0
Summary: Clicky analytics for Django projects
Home-page: http://github.com/jcassee/django-clicky
Author: Joost Cassee
Author-email: joost@cassee.net
License: MIT License
Download-URL: http://github.com/jcassee/django-clicky/archives/master
Description: 
        =============================
        Clicky integration for Django
        =============================
        
        The django-clicky application integrates Clicky_ analytics into a
        Django_ project.
        
        .. _Clicky: http://getclicky.com/
        .. _Django: http://www.djangoproject.com
        
        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.
        
        
Keywords: django,analytics,clicky
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
