Metadata-Version: 1.1
Name: jmbo-analytics
Version: 0.2.2
Summary: Jmbo analytics app.
Home-page: http://github.com/praekelt/jmbo-analytics
Author: Praekelt Foundation
Author-email: dev@praekelt.com
License: BSD
Description: Jmbo Analytics
        ==============
        **Jmbo analytics brings the power of Google Analytics to your Django projects**
        
        .. figure:: https://travis-ci.org/praekelt/jmbo-analytics.svg?branch=develop
           :align: center
           :alt: Travis
        
        .. contents:: Contents
            :depth: 3
        
        Required
        --------
        
        * You have to add ``jmbo_analytics`` to you ``INSTALLED_APPS``
        * You have to specify a Google Analytics `tracking code <https://support.google.com/analytics/bin/answer.py?hl=en&answer=1008080>`_.
        
        where ``xxx`` is your tracking code::
        
         JMBO_ANALYTICS = {
            'google_analytics_id': 'xxx',
         }
        
        
        Usage
        -----
        
        ``jmbo-analytics`` offers you two ways to add tracking to your pages.
        
        1. HTML tag
        ***********
        
        Using ``<img />`` and putting it in your ``base.html``::
        
         {% load jmbo_analytics_tags %}
         <div style="display: none;">
            <img src="{% google_analytics %}" width="0" height="0" />
         </div>
        
        2. Middleware and Celery
        ************************
        
        Using Django's middleware you can process every request and use Celery to make the request to Google Analytics.
        Note that this does not work behind a reverse caching proxy::
        
         MIDDLEWARE_CLASSES = (
            'jmbo_analytics.middleware.GoogleAnalyticsMiddleware',
         )
        
        You may have to add ``jmbo_analytics`` to your ``CELERY_IMPORTS``::
        
         CELERY_IMPORTS = ('jmbo_analytics.tasks')
        
        You may also specify paths that will be excluded when tracking::
        
         GOOGLE_ANALYTICS_IGNORE_PATH = ['/health/', ]
        
        Authors
        =======
        
        Praekelt Consulting
        -------------------
        
        * Hedley Roos
        
        Unomena
        -------
        
        * Euan Jonker
        
        Changelog
        =========
        
        0.2.2
        -----
        #. Fixed incorrect header key.
        
        0.2.1
        -----
        #. Send correctly named header.
        
        0.2
        ---
        #. Use requests library because it can drill through HTTP proxies.
        
        0.1
        ---
        #. Simplify dependencies.
        #. Make transparent GIF method asynchronous.
        
        0.0.4
        -----
        #. Better packaging.
        
        0.0.3
        -----
        #. Fork, rename, re-license from panomena-analytics.
        
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
