@alternate-name pyga-django
@author Michal Korzeniowski mko_san@lafiel.net
@version 1.1
@date 07-2013

A wrapper class for pyga (Python Google Analitycs) providing middleware and mixin for integration with django

• pyga >= 2.2.1
• django

run from console:

pip install -e git+https://github.com/maiiku/pygawrapper.git#egg=pygawrapper

1. add pygawrapper to installed apps in your django settings

   
   INSTALLED_APPS = (
       ...
       'pygawrapper',
       ...
   )
   

2. add pygawrapper middleware in your django settings anywhere AFTER django auth middlware

   MIDDLEWARE_CLASSES = (
       ...
       'django.contrib.auth.middleware.AuthenticationMiddleware',
       ...
       'pygawrapper.middleware.PygaWrapperMiddleware',
       ...
   )
   

3. implement a reciver for pygawrapper's user request signal

   example implementation

   def pyga_user_query_listener(sender, request, user_data, **kwargs):
       from django.contrib.auth.models import User
       if request.user.is_authenticated():
           pk = request.user.pk
       else:
           pk = None
       user_data.update({'id':pk})

4. a) add PygaMixin to desired class you wish to extend with pyga's functions

   example (extending user profile):

   from pygawrapper.mixins import PygaMixin
   class Profile(PygaMixin, AccountsLanguageBaseProfile):
   ...

   b) or you can tell pygawrapper to extand request object with tracker. The advantage of that apprach is that you get access to pygawrapper function from request regardsless of user authentication, with Google Analitycs session/visitor data preserved. To achive this you should add following line to your Django settings:

   PYGA_SET_REQUEST_TRACKER = True

   You will be able to access pygawrappers function using:

   request.tracker

5. runc syncdb to create pygawrapper's table

   in your project root run

   python manage.py syncdb
   

6. See optional setup below

You cen set site and code in you django setting, and wrapper mixin will use it

GOOGLE_ANALYTICS_CODE = 'GA-XXXXXX'
GOOGLE_ANALYTICS_SITE = 'example.com'

(to be written)