neat-charts/README.md
2016-07-03 03:53:26 -04:00

82 lines
2.2 KiB
Markdown

# seigler/neat-charts [![GitHub stars](https://img.shields.io/github/stars/seigler/neat-charts.svg)](https://github.com/seigler/neat-charts/stargazers) [![Packagist](https://img.shields.io/packagist/dt/seigler/neat-charts.svg)](https://packagist.org/packages/seigler/neat-charts) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/seigler/neat-charts/blob/master/LICENSE.txt)
PHP project to generate clean-looking SVG price charts
![Dash 24h price in BTC from Poloniex](http://cryptohistory.org/charts/dark/dash-btc/7d/svg)
7d of Dash price in Bitcoin from Poloniex.com
## Requirements
* PHP >=5.3.0
## Installation
### Using Composer
To install using Composer, you will have to install Composer first.
`curl -s https://getcomposer.org/installer | php`
Create a composer.json file in your project root.
```json
{
"require": {
"seigler/neat-charts": "@dev"
}
}
```
Tell Composer to install the required dependencies.
`php composer.phar install`
If you want to use the autoloading provided by Composer, add the following line to your application file.
`require 'vendor/autoload.php';`
You are now ready to use NeatCharts.
### Install NeatCharts manually
Just download the folder `NeatCharts` (in `src`) and place it alongside your php file. Add the following at the top of your PHP file:
```php
spl_autoload_extensions(".php");
spl_autoload_register();
```
This will automatically require the correct files when they are referenced, since the namespace and class names match the folder structure.
## Usage
```php
Header('Content-type: image/svg+xml; charset=utf-8');
$chart = new NeatCharts/LineChart($chartData, [ // all parameters optional
'width'=>800,
'height'=>250,
'lineColor'=>"#1C75BC",
'labelColor'=>"#777",
'smoothed'=>false
]);
print $chart->render();
```
In your HTML:
`<img src="path to the PHP file">`
## Available Options
| Option | Default |
| --- | --- |
| width | 800 |
| height | 250 |
| lineColor | '#000' |
| markerColor | '#000' |
| labelColor | '#000' |
| smoothed | false |
| fontSize | 15 |
| yAxisEnabled | true |
| xAxisEnabled | false |
## Credits
* Chart appearance based on advice found at http://vis4.net/blog/posts/doing-the-line-charts-right/