Metadata-Version: 1.1
Name: googleanalytics
Version: 0.3
Summary: Trac plugin to enable your trac environment to be logged by Google Analytics
Home-page: http://google.ufsoft.org
Author: Pedro Algarvio
Author-email: ufs@ufsoft.org
License: BSD
Download-URL: http://python.org/pypi/googleanalytics
Description: Google Analytics Integration
        ============================
        
        Previously known as `(Trac) Google Analytics Plugin`, this plugin will 
        enable your Trac environment to be logged by Google Analytics.
        
        It adds the necessary javascript code to log your environment, plus, it also
        logs the downloads of regular filenames which end with a specific extension;
        these extensions are defined by you; and also external links.
        
        Download and Install
        --------------------
        
        The easiest way to install is using EasyInstall_:
        
        ::
        
          sudo easy_install GoogleAnalyticsIntegration
          [NOTE: This does not currently work.]
        
        
        Then, to enable the plugin add to the ``[components]`` section in your
        ``trac.ini``:
        
        ::
        
          [components]
          googleanalytics.* = enabled
        
        
        Configuration
        -------------
        
        The necessary configuration is:
         * **Web Property ID**: Google Analytics' Web Property ID. The Web Property 
           ID is needed for Google Analytics to log your website stats. Your Web 
           Property ID can be found by looking in the JavaScript Google Analytics 
           gives you to put on your page. Look for your Web Property ID in between 
           the javascript::
        
             _gaq.push(['_setAccount', 'UA-1111111-1']);
        
           In this example you would put **UA-1111111-1** in the UID box.
        
        There are other, more advanced configuration options:
         * **admin_logging**: Disabling this option will prevent all logged in
           ``TRAC_ADMIN``'s from showing up on your Google Analytics reports.
         * **authenticated_logging**: Disabling this option will prevent all
           authenticated users from showing up on your Google Analytics reports.
         * **outbound_link_tracking**: Disabling this option will turn off the
           tracking of outbound links.
           It's recommended not to disable this option unless you're a privacy
           advocate (now why would you be using Google Analytics in the first place?)
           or it's causing some kind of weird issue.
         * **google_external_path**: This will be the path shown on Google Analytics
           regarding external links. The default is '/external/'. Consider the 
           following link::
        
             <a href="http://trac.edgewall.org/">Trac</a>
        
           The above link will be shown as::
        
             /external/trac.edgewall.org/
        
           This way you will be able to track outgoing links. Outbound link tracking
           must be enabled for external links to be tracked.
         * **extensions**: Enter any extensions of files you would like to be tracked
           as a download. For example to track all MP3s and PDFs enter **mp3,pdf**.
           Outbound link tracking must be enabled for downloads to be tracked.
         * **tracking_domain_name**: If you're tracking multiple subdomains with the
           same Google Analytics profile, as is discussed in:
             https://www.google.com/support/googleanalytics/bin/answer.py?answer=55524
           enter your main domain here.
        
        
        Bugs and/or New Features
        ------------------------
        
        Please submit bugs of new features to::
        
          http://trac-hacks.org/wiki/GoogleAnalyticsIntegration
        
        
        Source Code
        -----------
        
        If you wish to be on the bleeding edge and get the latest available code:
        
        ::
        
          svn co http://trac-hacks.org/svn/GoogleAnalyticsIntegration
        
Keywords: trac plugin google analytics
Platform: UNKNOWN
Classifier: Framework :: Trac
