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: 29 days ago
JSON representation
Lavacharts is a graphing / charting library for PHP 5.4+ that wraps Google's Javascript Chart API.
- Host: GitHub
- URL: https://github.com/kevinkhill/lavacharts
- Owner: kevinkhill
- License: other
- Created: 2013-08-29T18:27:11.000Z (about 11 years ago)
- Default Branch: 3.1
- Last Pushed: 2024-04-26T19:57:44.000Z (7 months ago)
- Last Synced: 2024-09-30T22:40:59.774Z (about 1 month ago)
- Topics: charting-library, charts, composer, google-charts, graphing, php
- Language: PHP
- Homepage: http://lavacharts.com
- Size: 10.9 MB
- Stars: 619
- Watchers: 23
- Forks: 142
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-laravel - Lavacharts - Charts and Graphs for PHP Powered by the Google Chart API (Popular Packages)
README
# Lavacharts 3.1.12
[](https://packagist.org/packages/khill/lavacharts)
[](http://opensource.org/licenses/MIT)
[](https://php.net/)
[](https://gitter.im/kevinkhill/lavacharts?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://www.paypal.me/kevinkhill/)
Lavacharts is a graphing / chart library for PHP5.4+ that wraps the Google Chart API.
Stable:
[](https://github.com/kevinkhill/lavacharts/releases)
[](https://travis-ci.org/kevinkhill/lavacharts)
[](https://coveralls.io/r/kevinkhill/lavacharts?branch=3.1)
Dev:
[](https://github.com/kevinkhill/lavacharts/tree/master)
[](https://travis-ci.org/kevinkhill/lavacharts)
[](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
[](https://starchart.cc/kevinkhill/lavacharts)