Lavacharts 3.1.12
Lavacharts is a graphing / chart library for PHP5.4+ that wraps the Google Chart API.
Stable:
Dev:
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! 😄
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 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 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
Upgrade guide: Migrating from 2.5.x to 3.0.x
For contributing, a handy guide can be found here
Installing
In your project's main composer.json file, add this line to the requirements:
"khill/lavacharts": "^3.1"Run Composer to install Lavacharts:
$ composer updateFramework 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 feature added in 5.5, you're ready to go, no registration required 👍
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
// config/app.php
// ...
'providers' => [
// ...
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
// app/config/app.php
// ...
'providers' => 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
// 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
Setting up your first chart.
Data
$data = $lava->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...
$data->addColumns([
['date', 'Day of Month'],
['number', 'Projected'],
['number', 'Official']
]);Or you can use \Khill\Lavacharts\DataTables\DataFactory to create DataTables in another way
Chart Options
Customize your chart, with any options found in Google's documentation. Break objects down into arrays and pass to the chart.
$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 <div id="stocks-div"></div>
- If no options for the chart are set, then the third parameter is the id of the output:
$lava->LineChart('Stocks', $data, 'stocks-div');- If there are options set for the chart, then the id may be included in the options:
$lava->LineChart('Stocks', $data, [
'elementId' => 'stocks-div'
'title' => 'Stock Market Trends'
]);- The 4th parameter will also work:
$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!
<?= $lava->render('LineChart', 'Stocks', 'stocks-div'); ?>Or if you have multiple charts, you can condense theh view code withL
<?= $lava->renderAll(); ?>Changelog
The complete changelog can be found here
