rcousens / AmChartsBundle

Symfony2 Bundle for AmCharts

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

RCAmChartsBundle

RCAmChartsBundle eases the use of AmCharts to display rich graph and charts in your Symfony2 application by providing Twig extensions and PHP objects to do the heavy lifting. The bundle incorporates the JS charting library AmCharts.

DRY out your chart code by writing it all in PHP!

Content

License

RCAmChartsBundle is released under the MIT License. See the bundled LICENSE file for details.

Please note that the AmCharts JS library bundled with the project is free for commercial use provided you retain the advertisement.

How to get started

Installation

  1. Add the following to your composer.json file

        "require": {
            ...
            "rcousens/amcharts-bundle": "dev-master@dev"
            ...
        }
  2. Run php composer.phar update "rcousens/amcharts-bundle"

  3. Register the bundle in your app/AppKernel.php:

        <?php
        ...
        public function registerBundles()
        {
            $bundles = array(
                ...
                new RC\AmChartsBundle\RCAmChartsBundle(),
                ...
            );
        ...
  4. Install the static assets

    php app/console assets:install --symlink web

Usage

Basic Pie Chart

In your controller ...

    <?php
    use RC\AmChartsBundle\AmCharts\AmPieChart;

    // ...
    public function chartAction()
    {
        // Chart
        $pieChart = new \RC\AmChartsBundle\AmCharts\AmPieChart();
        
        $pieChart->renderTo('piechart');
        $pieChart->setTitleField('number');
        $pieChart->setValueField('column-1');
        $pieChart->addData(array('number' => '1', 'column-1' => 10));
        $pieChart->addData(array('number' => '2', 'column-1' => 40));
        $pieChart->addData(array('number' => '3', 'column-1' => 30));

        return $this->render('::template.html.twig', array(
            'chart' => $chart
        ));
    }

In your template ...

<!-- Load jQuery from Google's CDN if needed -->
<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js" type="text/javascript"></script>

<script src="{{ asset('bundles/rcamcharts/js/amcharts/amcharts.js') }}"></script>
<script src="{{ asset('bundles/rcamcharts/js/amcharts/pie.js') }}"></script>
<script src="{{ asset('bundles/rcamcharts/js/amcharts/themes/none.js') }}"></script>

<script type="text/javascript">
    {{ amchart(chart) }}
</script>

<div id="piechart" style="min-width: 400px; height: 400px; margin: 0 auto"></div>

VoilĂ  !

About

Symfony2 Bundle for AmCharts

License:MIT License


Languages

Language:JavaScript 89.1%Language:PHP 10.7%Language:CSS 0.2%