collective.gacontext
====================

:Author:    $Author: ramonski $
:Date:      $Date: 2008-03-20 17:32:39 +0100 (Do, 20 Mär 2008) $
:Revision:  $Revision: 60988 $

Abstract
--------

Add Google Analytics context dependent to your Plone Site


Introduction
------------

Google Analytics can cope with different URLs of a site, e.g. with
http://plone.org and http://plone.org/products. So if you have a hierarchical
structure of your site and you want to analyze it with Google Analytics, you
need different ga-code-snippets per URL. With this package you can handle it.


Usage
-----

There is a formlib form registered on the interface
**collective.gacontext.interfaces.IGAContextMarker**. Each context which is
marked with that Interface becomes *Google Analytics* aware. A new object
tab is displayed where you can edit a ga-code-snippet.

A viewlet, registered for PortalFooter, will find the responsible code snippet
for it. It calls a utility which walks the acquisition chain up for the next
object which provides the IGAContextMarker Interface and returns its code
snippet (if there is one set).

Example:
--------

- http://plone.org is  marked with *IGAContextMarker* and has the following ga code::

      <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
      </script>
      <script type="text/javascript">
      _uacct = "UA-00000-0";
      urchinTracker();
      </script>

- http://plone.org/events will find the same code snippet::

      <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
      </script>
      <script type="text/javascript">
      _uacct = "UA-00000-0";
      urchinTracker();
      </script>

- If http://plone.org/events/conferences is marked with a *IGAContextMarker* and
  has the following ga code::

      <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
      </script>
      <script type="text/javascript">
      _uacct = "UA-99999-9";
      urchinTracker();
      </script>

- Then http://plone.org/events/conferences/2008-location-tbd will find the code
  snippet from http://plone.org/events/conferences::

      <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
      </script>
      <script type="text/javascript">
      _uacct = "UA-99999-9";
      urchinTracker();
      </script>

::

 vim: set ft=rst tw=75 nocin nosi ai sw=4 ts=4 expandtab spell spelllang=en:
