exs/lander-tracking-cambuilder-bundle

This bundle adds a new Cambuilder's specific extracter and formatter for EXSLanderTrackingHouseBundle.

EXS-LanderTrackingCambuilderBundle

, _(*1)

What is this bundle doing ?

This bundle is not a standalone bundle and requires EXS-LanderTrackingHouseBundle., _(*2)

It will add an extracter and a formatter to be added to EXS-LanderTrackingHouseBundle to manage CamBuilder tracking parameter., _(*3)

The extracter service searches for parameters : - AFNO which contains a string composed of 1-{cmp}-{exid}, _(*4)

The formatter service will add the parameters if : - AFNO will contains a string composed of 1-{cmp}-{exid}, _(*5)

Installation

Download the bundle using composer, _(*6)

$ composer require exs/lander-tracking-awe-bundle

Enable the bundle, and the EXS-LanderTrackingHouseBundle that is installed as a requirement., _(*7)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new EXS\LanderTrackingHouseBundle\EXSLanderTrackingHouseBundle(),
        new EXS\LanderTrackingCambuilderBundle\EXSLanderTrackingCambuilderBundle(),
        // ...
    );
}

Configuration

The cmp parameter has a default value configurable with this configuration key :, _(*8)

# Default values.
exs_lander_tracking_cambuilder:
    default_cmp: 1

This default value will be used over EXS-LanderTrackingHouseBundle's cmp default value., _(*9)

Usage

Example :, _(*10)

    <a href="{{ 'http://www.test.tld/' | appendTracking('cambuilder') }}">Some link</a>
    <!-- Will generate : "http://www.test.tld/?AFNO=1-123-987654321" -->

    <a href="{{ 'http://www.test.tld/?foo=bar' | appendTracking('cambuilder') }}">Some link</a>
    <!-- Will generate : "http://www.test.tld?foo=bar&AFNO=1-123-987654321" -->

See EXS-LanderTrackingHouseBundle's documentation for more information., _(*11)