= sfLlooggPlugin plugin =

[http://www.lloogg.com LLOOGG] 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 [http://www.lloogg.com lloogg] 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 [mailto:manuel@sonsof.net 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.