rgsystemes/olark-bundle

Integrate easily Olark into your Symfony2 projects

Introduction

Easily integrate Olark into your Symfony2 projects., _(*1)

Installation

1. Add this bundle to your vendor/ dir using the vendors script:, _(*2)

   Add the following lines in your deps file:, _(*3)

   [RGOlarkBundle]
       git=git://github.com/rgsystemes/OlarkBundle.git
       target=/bundles/RG/OlarkBundle

   and run the vendors script:, _(*4)

   ./bin/vendors install

   Or add the following to your composer.json:, _(*5)

   "rgsystemes/olark-bundle": "dev-master"

   and run:, _(*6)

   php composer.phar install

   The bundle is compatible with Symfony 2.0 upwards., _(*7)

2. If you're not using Composer, add the RG namespace to your autoloader:, _(*8)

   // app/autoload.php
   $loader->registerNamespaces(array(
       'RG' => __DIR__.'/../vendor/bundles',
   ));

3. Add this bundle to your application's kernel:, _(*9)

   // app/AppKernel.php
   public function registerBundles()
   {
       return array(
           // ...
           new RG\OlarkBundle\RGOlarkBundle(),
           // ...
       );
   }

4. Configure the rg_olark service in your config.yml:, _(*10)

   rg_olark:
       id: xxxx-xxx-xx-xxxx

That's it for basic configuration., _(*11)

Usage

In your template:, _(*12)

{% include "OlarkBundle::olark.html.twig" %}

In your controllers:, _(*13)

$olarkOptions = $this->container->get('rg_olark_options');
$olarkOptions["name"] = $this->getUser()->getUsername();

Available Olark options:, _(*14)

• api.chat.updateVisitorNickname (through $olarkOptions["name"])
• api.chat.updateVisitorStatus (through $olarkOptions["status"])

Overriding the template

You can override the template used by copying the Resources/views/olark.html.twig file out of the bundle and placing it into app/Resources/RGOlarkBundle/views, then customising as you see fit., _(*15)