Introduce EDD_Graph class

[pippinsplugins]

We need to write a new class for handling the creation and display of graphs.

The class should allow us to pass an array of data and set arguments such as tick size then generate the graph.

This will be extremely useful for add-ons, such as Commissions, that want to generate their own graphs.

Related: #1376

[pippinsplugins]

Punting to 1.9. I'm really not yet sure how to go about this one.

[pippinsplugins]

Might look at http://www.chartjs.org/

[chriscct7]

FYI "I'm currently working on a big refactor of the library into a more object oriented structure." on the Github's readme for that project. Looks like he's almost done with it, so if we want to use this we should keep in mind we should prob wait for the finish of the refactor.

[pippinsplugins]

I think to start I will use Flot, just so it stays the same as what we have, then when Charts.js is finished with the rewrite, we can migrate.

[pippinsplugins]

Flot API for reference https://github.com/flot/flot/blob/master/API.md

[pippinsplugins]

Todo:

• Option for ticksize
• Option for time format
• Option to Set number of Y axis

[evertiro]

if( class_exists( 'EDD_Graph' ) ) {
    $this = 'win';
}

[amdrew]

👍 can't wait

[pippinsplugins]

Further todo:

• Add graph type options (bar, line, pie, etc)

[pippinsplugins]

This is ready for testing!

Quick and dirty example:

// Single line example
$data = array(
    'Line Label' => array(
        array( 1, 5 ),
        array( 3, 8 ),
        array( 10, 2 )
    )
);

$graph = new EDD_Graph( $data );
$graph->display();

// Multi line example
$data = array(

    'Line Label' => array(
        array( 1, 5 ),
        array( 3, 8 ),
        array( 10, 2 )
    ),

    'Second Line Label' => array(
        array( 1, 7 ),
        array( 4, 5 ),
        array( 12, 8 )
    )
);

$graph = new EDD_Graph( $data );
$graph->display();

// Example with options set to other than default:
$data = array(

    'Line Label' => array(
        array( 1, 5 ),
        array( 3, 8 ),
        array( 10, 2 )
    ),

    'Second Line Label' => array(
        array( 1, 7 ),
        array( 4, 5 ),
        array( 12, 8 )
    )
);

$graph = new EDD_Graph( $data );
$graph->set( 'bgcolor' => '#000' );
$graph->set( 'color' => '#fff' );
$graph->display();

[pippinsplugins]

Note on the data format.

'Line Label' => array(
    array( 1, 5 ),
    array( 3, 8 ),
    array( 10, 2 )
)

Each inner array represents a data point on the graph. Each inner array should be structured as array( 'value on x axis', 'value on y axis' ).

[amdrew]

@pippinsplugins I believe your last example above is incorrect. Should be:

$graph->set( 'bgcolor', '#000' );
$graph->set( 'color', '#fff' );

Throws an unexpected double arrow error otherwise

[pippinsplugins]

Oops! You're right, thanks!

[pippinsplugins]

With scripts loaded in EDD_Graph you can now output a graph anywhere you want, including the frontend. Note, if you want to display a graph on the front end, you have to include includes/admin/reporting/class-edd-graph.php first.

[pippinsplugins]

Merged into release/1.9