Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/kevinkhill/lavacharts

Lavacharts is a graphing / charting library for PHP 5.4+ that wraps Google's Javascript Chart API.
https://github.com/kevinkhill/lavacharts

charting-library charts composer google-charts graphing php

Last synced: 2 months ago
JSON representation

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

Lists

README 

        
# Lavacharts 3.1.12



[![Total Downloads](https://img.shields.io/packagist/dt/khill/lavacharts.svg?style=plastic)](https://packagist.org/packages/khill/lavacharts)

[![License](https://img.shields.io/packagist/l/khill/lavacharts.svg?style=plastic)](http://opensource.org/licenses/MIT)

[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%205.4-8892BF.svg?style=plastic)](https://php.net/)

[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/kevinkhill/lavacharts?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)

[![PayPal](https://img.shields.io/badge/paypal-donate-yellow.svg?style=plastic)](https://www.paypal.me/kevinkhill/)



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



Stable:

[![Current Release](https://img.shields.io/github/release/kevinkhill/lavacharts.svg?style=plastic)](https://github.com/kevinkhill/lavacharts/releases)

[![Build Status](https://img.shields.io/travis/kevinkhill/lavacharts/3.1.svg?style=plastic)](https://travis-ci.org/kevinkhill/lavacharts)

[![Coverage Status](https://img.shields.io/coveralls/kevinkhill/lavacharts/3.1.svg?style=plastic)](https://coveralls.io/r/kevinkhill/lavacharts?branch=3.1)



Dev:

[![Development Release](https://img.shields.io/badge/release-dev--master-brightgreen.svg?style=plastic)](https://github.com/kevinkhill/lavacharts/tree/master)

[![Build Status](https://img.shields.io/travis/kevinkhill/lavacharts/master.svg?style=plastic)](https://travis-ci.org/kevinkhill/lavacharts)

[![Coverage Status](https://img.shields.io/coveralls/kevinkhill/lavacharts/master.svg?style=plastic)](https://coveralls.io/r/kevinkhill/lavacharts?branch=master)



## Developer Note

Please don't be discouraged if you see that it has been "years" since an update, but rather think that Lavacharts has settled into a "stable" state and requires less tinkering from me. I would love to add new features, but my responsibilities leave little room for my projects. I am happy to field issues, answer questions, debug and help if needed. Lavacharts is not vaporware! :smile:



## Package Features

- **Updated!** Laravel 5.5+ auto-discovery

- Any option for customizing charts that Google supports, Lavacharts should as well. Just use the chart constructor to assign any customization options you wish!

 - Visit [Google's Chart Gallery](https://developers.google.com/chart/interactive/docs/gallery) for details on available options

- Custom JavaScript module for interacting with charts client-side

  - AJAX data reloading

  - Fetching charts

  - Events integration

- Column Formatters & Roles

- Blade template extensions for Laravel

- Twig template extensions for Symfony

- [Carbon](https://github.com/briannesbitt/Carbon) support for date/datetime/timeofday columns

- Now supporting **22** Charts!

  - Annotation, Area, Bar, Bubble, Calendar, Candlestick, Column, Combo, Gantt, Gauge, Geo, Histogram, Line, Org, Pie, Sankey, Scatter, SteppedArea, Table, Timeline, TreeMap, and WordTree!



### For complete documentation, please visit [lavacharts.com](http://lavacharts.com/)



#### Upgrade guide: [Migrating from 2.5.x to 3.0.x](https://github.com/kevinkhill/lavacharts/wiki/Upgrading-from-2.5-to-3.0)

#### For contributing, a handy guide [can be found here](https://github.com/kevinkhill/lavacharts/blob/master/.github/CONTRIBUTING.md)



---



## Installing

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

```json

"khill/lavacharts": "^3.1"

```



Run Composer to install Lavacharts:

```bash

$ 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.5

Thanks to the fantastic new [Package Auto-Discovery](https://laravel-news.com/package-auto-discovery) feature added in 5.5, you're ready to go, no registration required :+1:



#### Configuration

To modify the default configuration of Lavacharts, datetime formats for datatables or adding your maps api key...

Publish the configuration with `php artisan vendor:publish --tag=lavacharts`



### Laravel ~5.4

Register Lavacharts in your app by adding these lines to the respective arrays found in `config/app.php`:

```php

 [

    // ...



    Khill\Lavacharts\Laravel\LavachartsServiceProvider::class,

],



// ...

'aliases' => [

    // ...



    'Lava' => Khill\Lavacharts\Laravel\LavachartsFacade::class,

]

```

#### Configuration

To modify the default configuration of Lavacharts, datetime formats for datatables or adding your maps api key...

Publish the configuration with `php artisan vendor:publish --tag=lavacharts`



### Laravel ~4

Register Lavacharts in your app by adding these lines to the respective arrays found in `app/config/app.php`:



```php

 array(

    // ...



    "Khill\Lavacharts\Laravel\LavachartsServiceProvider",

),



// ...

'aliases' => array(

    // ...



    'Lava' => "Khill\Lavacharts\Laravel\LavachartsFacade",

)

```

#### Configuration

To modify the default configuration of Lavacharts, datetime formats for datatables or adding your maps api key...

Publish the configuration with `php artisan config:publish khill/lavacharts`



## Symfony

The package also includes a Bundle for Symfony to enable Lavacharts as a service that can be pulled from the Container.



### Add Bundle

Add the bundle to the registerBundles method in the AppKernel, found at `app/AppKernel.php`:

```php

DataTable();



$data->addDateColumn('Day of Month')

     ->addNumberColumn('Projected')

     ->addNumberColumn('Official');



// Random Data For Example

for ($a = 1; $a < 30; $a++) {

    $rowData = [

      "2017-4-$a", rand(800,1000), rand(800,1000)

    ];



    $data->addRow($rowData);

}

```



Arrays work for datatables as well...

```php

$data->addColumns([

    ['date', 'Day of Month'],

    ['number', 'Projected'],

    ['number', 'Official']

]);

```



Or you can `use \Khill\Lavacharts\DataTables\DataFactory` [to create DataTables in another way](https://gist.github.com/kevinkhill/0c7c5f6211c7fd8f9658)



#### Chart Options

Customize your chart, with any options found in Google's documentation. Break objects down into arrays and pass to the chart.

```php

$lava->LineChart('Stocks', $data, [

    'title' => 'Stock Market Trends',

    'animation' => [

        'startup' => true,

        'easing' => 'inAndOut'

    ],

    'colors' => ['blue', '#F4C1D8']

]);

```



#### Output ID

The chart will needs to be output into a div on the page, so an html ID for a div is needed.

Here is where you want your chart `
`

 - If no options for the chart are set, then the third parameter is the id of the output:

```php

$lava->LineChart('Stocks', $data, 'stocks-div');

```

 - If there are options set for the chart, then the id may be included in the options:

```php

$lava->LineChart('Stocks', $data, [

    'elementId' => 'stocks-div'

    'title' => 'Stock Market Trends'

]);

```

 - The 4th parameter will also work:

```php

$lava->LineChart('Stocks', $data, [

    'title' => 'Stock Market Trends'

], 'stocks-div');

```



## View

Pass the main Lavacharts instance to the view, because all of the defined charts are stored within, and render!

```php

= $lava->render('LineChart', 'Stocks', 'stocks-div'); ?>

```



Or if you have multiple charts, you can condense theh view code withL

```php

= $lava->renderAll(); ?>

```



# Changelog

The complete changelog can be found [here](https://github.com/kevinkhill/lavacharts/wiki/Changelog)



## Stargazers over time



[![Stargazers over time](https://starchart.cc/kevinkhill/lavacharts.svg)](https://starchart.cc/kevinkhill/lavacharts)