stOfcPlugin
1.0.0stable
for sf 1.2sf 1.1 MIT
stOfcPlugin Creates Flash Chart based on an array of data
Integrates Open Flash Chart
Need Help?
Feel free to conctact me via e-mail. Or Click here to post a message.
Developers
License
Plugin by RASHID Dawood (drashid). (daud55[at]gmail.com)
Original library by John Glazebrook (http://teethgrinder.co.uk/open-flash-chart/index.php)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
and associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies
or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
To Read original library's license see README.txt in plugin's lib folder
stOfcPlugin
stOfcPlugin class provides abstraction for Open Flash Chart.
Creates Flash Chart based on an array of data/values.
Installation
Install the plugin
symfony plugin-install http://plugins.symfony-project.com/stOfcPlugin
or download it and unzip in your /plugins directory
Clear you cache
symfony cc
Usage
Bar Chart
Following is an example of a bar chart:
public function executeBarChartData()
{
$chartData = array();
//Array with sample random data
for( $i = 0; $i < 7; $i++ )
{
$chartData[] = rand(1,20);
}
//To create a bar chart we need to create a stBarOutline Object
$bar = new stBarOutline( 80, '#78B9EC', '#3495FE' );
$bar->key( 'Number of downloads per day', 10 );
//Passing the random data to bar chart
$bar->data = $chartData;
//Creating a stGraph object
$g = new stGraph();
$g->title( 'stOfcPlugin example', '{font-size: 20px;}' );
$g->bg_colour = '#E4F5FC';
$g->set_inner_background( '#E3F0FD', '#CBD7E6', 90 );
$g->x_axis_colour( '#8499A4', '#E4F5FC' );
$g->y_axis_colour( '#8499A4', '#E4F5FC' );
//Pass stBarOutline object i.e. $bar to graph
$g->data_sets[] = $bar;
//Setting labels for X-Axis
$g->set_x_labels(array( 'Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday' ));
// to set the format of labels on x-axis e.g. font, color, step
$g->set_x_label_style( 10, '#18A6FF', 0, 2 );
// To tick the values on x-axis
// 2 means tick every 2nd value
$g->set_x_axis_steps( 2 );
//set maximum value for y-axis
//we can fix the value as 20, 10 etc.
//but its better to use max of data
$g->set_y_max( max($chartData) );
$g->y_label_steps( 4 );
$g->set_y_legend( 'stOfcPlugin', 12, '#18A6FF' );
echo $g->render();
return sfView::NONE;
}
Line Chart
Following is an example of a line chart:
public function executeLineChartData()
{
$chartData = array();
for( $i = 0; $i < 7; $i++ )
{
$chartData[] = rand(0, 50);
}
//Create new stGraph object
$g = new stGraph();
// Chart Title
$g->title( 'stOfcPlugin example', '{font-size: 20px;}' );
$g->bg_colour = '#E4F5FC';
$g->set_inner_background( '#E3F0FD', '#CBD7E6', 90 );
$g->x_axis_colour( '#8499A4', '#E4F5FC' );
$g->y_axis_colour( '#8499A4', '#E4F5FC' );
//Use line_dot to set line dots diameter, text, color etc.
$g->line_dot(2, 3, '#3495FE', 'Number of downloads per day', 10);
//In case of line chart data should be passed to stGraph object
//unsing set_data
$g->set_data( $chartData );
//Setting labels for X-Axis
$g->set_x_labels( array( 'Mon','Tue','Wed','Thu','Fri','Sat','Sun' ) );
//to set the format of labels on x-axis e.g. font, color, step
$g->set_x_label_style( 10, '#18A6FF', 0, 1 );
//set maximum value for y-axis
//we can fix the value as 20, 10 etc.
//but its better to use max of data
$g->set_y_max( max($chartData) );
$g->y_label_steps( 5 );
// display the data
echo $g->render();
echo $g->render();
return sfView::NONE;
}
Pie Chart
Following is an example of pie chart,
public function executePieChartData()
{
$chatData = array();
for( $i = 0; $i < 7; $i++ )
{
$data[] = rand(5,20);
}
//Creating a stGraph object
$g = new stGraph();
//set background color
$g->bg_colour = '#E4F5FC';
//Set the transparency, line colour to separate each slice etc.
$g->pie(80,'#78B9EC','{font-size: 12px; color: #78B9EC;');
//array two arrray one containing data while other contaning labels
$g->pie_values($data, array('Monday','Tuesday','Wednesday','Thursday','Friday','Saturday','Sunday'));
//Set the colour for each slice. Here we are defining three colours
//while we need 7 colours. So, the same colours will be
//repeated for the all remaining slices in the same order
$g->pie_slice_colours( array('#d01f3c','#356aa0','#c79810') );
//To display value as tool tip
$g->set_tool_tip( '#val#%' );
$g->title( 'stOfcPlugin example', '{font-size:18px; color: #18A6FF}' );
echo $g->render();
return sfView::NONE;
}
3D Bar Chart
Following is an example of 3D bar chart,
public function execute3DBarChartData()
{
//Create new stBar3D object and set the transparency and colour.
$redBar = new stBar3D( 75, '#d01f3c' );
$redBar->key( '2007', 10 );
//random data
for( $i = 0; $i < 12; $i++ )
{
$redBar->data[] = rand(200,500);
}
//2nd Bar
$blueBar = new stBar3D( 75, '#356aa0' );
$blueBar->key( '2008', 10 );
//random data for 2nd bar
for( $i = 0; $i < 12; $i++ )
{
$blueBar->data[] = rand(200,500);
}
$g = new stGraph();
$g->bg_colour = '#E4F5FC';
$g->title( 'Number of downloads in 2008 and 2009', '{font-size:20px; color: #18A6FF;}' );
$g->data_sets[] = $redBar;
$g->data_sets[] = $blueBar;
//to create 3d x-axis
$g->set_x_axis_3d( 10 );
$g->x_axis_colour( '#8499A4', '#E4F5FC' );
$g->y_axis_colour( '#8499A4', '#E4F5FC' );
$g->set_x_labels( array( 'Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct', 'Nov', 'Dec' ) );
$g->set_y_max( 500 );
$g->y_label_steps( 5 );
$g->set_y_legend( 'stOfcPlugin', 12, '#18A6FF' );
echo $g->render();
return sfView::NONE;
}
See stOfcExample module for details.
Configuration
- To test stOfcPlugin, enable the stOfcExample module in your settings.yml file, then call stOfcExample in your browser
setting.yml
all:
.settings:
enabled_modules: [stOfcExample]
Plugin support
- Please report bugs/feeback in the plugin section of the forum
- You can also contact me by email (at plugin's homepage)
Stay tuned for detailed documentation
cheers :)
This plugin is sponsored by SQL Technologies
RASHID Dawood 