DucksboardBundle for Symfony2

, _(*1)

This bundle integrates Symfony2 applications with the Ducksboard API., _(*2)

Dependencies

PHP Curl library http://php.net/manual/en/book.curl.php, _(*3)

Instalation

With composer

Add the project in the composer.json file:, _(*4)

...
"require": {
...
    "sfm/ducksboard-bundle": "dev-master"
...
}

and in the AppKernel.php file:, _(*5)

    $bundles = array(
        ...
        new SFM\DucksboardBundle\SFMDucksboardBundle(),
    ...
        );

Execute php composer.phar install, _(*6)

With deps files

Add the project in the deps file:, _(*7)

[DucksboardBundle]
    git=https://github.com/mgallego/DucksboardBundle.git
    target=/bundles/SFM/DucksboardBundle

and in the `autoload.php' file:, _(*8)

$loader->registerNamespaces(array(
    ...
    'SFM'         => __DIR__.'/../vendor/bundles',
    ...

and in the AppKernel.php file:, _(*9)

    $bundles = array(
        ...
        new SFM\DucksboardBundle\SFMDucksboardBundle(),
    ...
        );

Use like an own service

First you need to include the Ducksboard apiKey into the parameters file (ini/yml):, _(*10)

ducksboard_api    =  xxxxxxxxxxxxxxx

Second, create the service:, _(*11)

services:
...
...
    example.ducksboard:
        class: SFM\DucksboardBundle\Adapter\Widget
        arguments: [@sfm.ducksboard.connector]  
        calls:
            - [setApiKey, [%ducksboard_api%]]

Now you can use your own service that set automatically the apikey, _(*12)

Use the bundle service

The bundle has a service prepared to use. Example:, _(*13)

$widget = $this->container->get('sfm.ducksboard.widget');
$widget->setApiKey($this->container->getParameter('ducksboard_api'));

Examples of use

Push method

Simple Widget, _(*14)

        $widget = $this->container->get('screencast.ducksboard');
        $widget->setData(array($widgetID => array('value' => $val1)));
        $widget->push();

Double Widget, _(*15)

        $widget = $this->container->get('screencast.ducksboard');
        $dateData1 = array(
            array('timestamp' => time(), 'value' => '130'),
            array('timestamp' => time() - ((24*60*60)) , 'value' => '50'),
            array('timestamp' => time() - ((2*24*60*60)) , 'value' => '70'),
            array('timestamp' => time() - ((3*24*60*60)) , 'value' => '20'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '50'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '80'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '100'));

        $dateData2 = array(
            array('timestamp' => time(), 'value' => '80'),
            array('timestamp' => time() - ((24*60*60)) , 'value' => '20'),
            array('timestamp' => time() - ((2*24*60*60)) , 'value' => '70'),
            array('timestamp' => time() - ((3*24*60*60)) , 'value' => '80'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '50'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '90'),
            array('timestamp' => time() - ((4*24*60*60)) , 'value' => '30'));

        $widgetGraphData = array(
            $widgetId1=> $dateData1,
            $widgetId2 => $dateData2
            );

        $widget->setData($widgetGraphData);
        $widget->push();

Delta Values, _(*16)

        $widget = $this->container->get('screencast.ducksboard');
    $widgetData = array($widgetId => array('delta' => 1 ));
    $widget->setData($widgetData);
    $widget->push();

Pull method

Get the 3 last data of a widget, _(*17)

   $widget->getLastValues($widgetId, 3);
   $widgetActualData = $widget->getArrayResponse();          
   //or
   $widgetActualData = $widget->getRawResponse();

Find data by seconds, _(*18)

   $widget->findBySeconds($widgetId, $seconds);
   $widgetActualData = $widget->getArrayResponse();          
   //or
   $widgetActualData = $widget->getRawResponse();

Find data by timespan, _(*19)

   $widget->findByTimespan($widgetId, 'monthly', $timezone);
   $widgetActualData = $widget->getArrayResponse();          
   //or
   $widgetActualData = $widget->getRawResponse();