# sfLlooggPlugin plugin

[LLOOGG](http://www.lloogg.com) is a service that lets you check who is visiting your site in real time: which pages are being visited, with which operating system and browser, the referrer of each visit etc.
This plugin easily adds tracking code for [lloogg](http://www.lloogg.com) to your presentation layer.

## Installation

You can install sfLlooggPlugin plugin via PEAR (recommended) package manager, via SVN repository or manually.

### PEAR installation

 1. The easiest way to install sfLlooggPlugin is to use PEAR package manager.

     
     $ symfony plugin-install http://plugins.symfony-project.com/sfLlooggPlugin
     

 2. Now clear the cache with symfony clear-cache command

     
     $ symfony cc
     

### SVN installation

 1. Enter your `plugins/` directory
 2. Checkout the plugin from svn

     
     $ svn co http://svn.symfony-project.com/plugins/sfLlooggPlugin/
     

 3. Now clear the cache with symfony clear-cache command

     
     $ symfony cc
     

### Manual installation

 1. Alternatively, if you don&#039;t have PEAR or SVN installed, you can download the latest package attached to this plugin&#039;s wiki page and extract it under your project&#039;s `plugins/` directory

 2. Now clear the cache with symfony clear-cache command

     
     $ symfony cc
     

## Configuration

  * Configure your Lloogg account in `app.yml`:

      
      prod:
        lloogg:
          enabled:     on
          clientid:          xxxxxxxxxx # &lt;-- put your site&#039;s account id here
    
      all:
        lloogg:
          enabled:     off
      

  * Add `sfLlooggFilter` to `filters.yml` just after `web_debug`:

      
      rendering: ~
      web_debug: ~
      lloogg:
        class: sfLlooggFilter
      # etc...
      

## Usage

Just by adding the filter and enabling the plugin in `app.yml` your site should begin tracking on your Lloogg account. Beyond this, there are a few more pieces of functionality that allow you finer control over how your site interacts with Lloogg.

### Specify where tracking code should be inserted

By changing the `insertion` configuration variable, you can specify where in the response content the tracking code should be placed. The plugin comes with two options pre-built, `top` and `bottom`; `bottom` is the recommended option to use. 

      
      prod:
        lloogg:
          enabled:    on
    
      all:
        lloogg:
          clientid:   xxxxxxxxxx
          insertion:  top
      

These settings will place the tracking code just inside the response&#039;s opening `&lt;body&gt;` tag (in the `prod` environment). The plugin defaults to placing the tracking code just before the response&#039;s closing `&lt;/body&gt;` tag.

## Changelog

2007-11-10: 0.1.0 beta

  * Initial release

## Contacts

If you have any questions or feedback feel free to contact me at [manuel@sonsof.net](mailto:manuel@sonsof.net).

Please include sfLlooggPlugin in the mail subject, this will help me tracking the conversation.

## License

sfLlooggPlugin is a Symfony plugin created by Manuel Dalla Lana, inspired by sfUrchinPlugin created by Kris Wallsmith.

For the full copyright and license information, please view the LICENSE file that was distributed with this source code.