Skip to content

Lavacharts is a graphing / charting library for PHP 5.4+ that wraps Google's Javascript Chart API.

License

Notifications You must be signed in to change notification settings

yong0011/lavacharts

 
 

Repository files navigation

Lavacharts v3.0

Total Downloads License Minimum PHP Version Gitter PayPayl

Lavacharts is a graphing / chart library for PHP5.4+ that wraps Google's Javascript Chart API

Stable: Current Release Build Status Coverage Status

Dev: Development Release Build Status Coverage Status

Version 3.0

Upgrade guide: Migrating from 2.5.x to 3.0.x

Package Features

  • Lava.js module for interacting with charts client-side
    • AJAX data reloading
    • Fetching charts
    • Events integration
  • Column Formatters
  • Column Roles
  • Blade template extensions for laravel
  • Twig template extensions for Symfony
  • Carbon support for date/datetime/timeofday columns
  • Now supporting 12 Charts!
    • Area, Bar, Calendar, Column, Combo, Donut, Gauge, Geo, Line, Pie, Scatter, Table
  • DataTablePlus package can be added to parse CSV files or Eloquent collections into DataTables.

For complete documentation, please visit lavacharts.com


Installing

In your project's main composer.json file, add this line to the requirements:

"khill/lavacharts": "~3.0"

Run Composer to install Lavacharts:

$ composer update

Framework Agnostic

If you are using Lavacharts with Silex, Lumen or your own Composer project, that's no problem! Just make sure to: require 'vendor/autoload.php'; within you project and create an instance of Lavacharts: $lava = new Khill\Lavacharts\Lavacharts;

Laravel

To integrate lavacharts into Laravel, a ServiceProvider has been included.

Laravel 5.x

Register Lavacharts in your app by adding this line to the end of the providers array in config/app.php:

<?php
// config/app.php

// ...
'providers' => [
    ...

    Khill\Lavacharts\Laravel\LavachartsServiceProvider::class,
],

The Lava:: alias will be registered automatically via the service provider.

Laravel 4.x

Register Lavacharts in your app by adding this line to the end of the providers array in app/config/app.php:

<?php
// app/config/app.php

// ...
'providers' => array(
    // ...

    "Khill\Lavacharts\Laravel\LavachartsServiceProvider",
),

The Lava:: alias will be registered automatically via the service provider.

Symfony 2.x

Also included is a Bundle for Symfony to create a service that can be pulled from the Container.

Add Bundle

Add the bundle to the AppKernel:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new Khill\Lavacharts\Symfony\Bundle\LavachartsBundle(),
        );

        // ...
    }

    // ...
}

Import Config

Add the service definition to the app/config/config.yml file

imports:
  # ...
  - { resource: @LavachartsBundle/Resources/config/services.yml

Usage

The creation of charts is separated into two parts: First, within a route or controller, you define the chart, the data table, and the customization of the output.

Second, within a view, you use one line and the library will output all the necessary javascript code for you.

Basic Example

Here is an example of the simplest chart you can create: A line chart with one dataset and a title, no configuration.

Controller

    $stocksTable = $lava->DataTable();  // Lava::DataTable() if using Laravel

    $stocksTable->addDateColumn('Day of Month')
                ->addNumberColumn('Projected')
                ->addNumberColumn('Official');

    // Random Data For Example
    for ($a = 1; $a < 30; $a++)
    {
        $rowData = [
          "2014-8-$a", rand(800,1000), rand(800,1000)
        ];

        $stocksTable->addRow($rowData);
    }

Arrays work for datatables as well...

  $stocksTable->addColumns([
    ['date', 'Day of Month'],
    ['number', 'Projected'],
    ['number', 'Official']
  ]];

...and for setting chart options!

  $lava->LineChart('Stocks', $stocksTable, ['title' => 'Stock Market Trends']);

View

If you are using Laravel and the Blade templating engine, there are some nifty extensions thrown in for a cleaner view

@linechart('Stocks', 'stocks-div');
// Behind the scenes this just calls Lava::renderLineChart('Stocks', 'stocks-div')
// which is an alias for the render method, seen below

Or you can use the new render method, passing in the chart type, label, and element id.

echo Lava::render('LineChart', 'Stocks', 'stocks-div');

This is all assuming you already have a div in your page with the id "stocks-div": <div id="stocks-div"></div>

If you don't have a div ready to accept the charts, add one more parameter to @linechart() or render() and it will be created for you.

Add true to for the library to create a plain div, or an array with keys width & height

Example:

@linechart('Stocks', 'stocks-div', true)
// Or
echo Lava::render('LineChart', 'Stocks', 'stocks-div', ['width'=>1024, 'height'=>768]);

Changelog

The complete changelog can be found here

About

Lavacharts is a graphing / charting library for PHP 5.4+ that wraps Google's Javascript Chart API.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 97.4%
  • JavaScript 2.6%