Abstract Chart generator base class. More...

Inheritance diagram for ilChart:

Collaboration diagram for ilChart:

Public Member Functions
	getDataInstance ($a_type=null)
	Get data series instance. More...

	setSize ($a_x, $a_y)
	Set chart size. More...

	addData (ilChartData $a_series, $a_idx=null)
	Add data series. More...

	setLegend (ilChartLegend $a_legend)
	Set chart legend. More...

	setColors ($a_values)
	Set colors. More...

	getColors ()
	Get colors. More...

	setShadow ($a_value)
	Set shadow. More...

	getShadow ()
	Get shadow. More...

	setAutoResize ($a_value)
	Toggle auto-resizing on window resize/redraw. More...

	setStacked ($a_value)
	Toggle stacking. More...

	parseGlobalOptions (stdClass $a_options)
	Convert (global) properties to flot config. More...

	getHTML ()
	Render. More...

Static Public Member Functions
static	getInstanceByType ($a_type, $a_id)
	Get type instance. More...

static	isValidColor ($a_value)
	Validate html color code. More...

static	renderColor ($a_value, $a_opacity=1)
	Render html color code. More...

Data Fields
const	TYPE_GRID = 1

const	TYPE_PIE = 2

const	TYPE_SPIDER = 3

Protected Member Functions
	__construct ($a_id)
	Constructor. More...

	isValidDataType (ilChartData $a_series)
	Validate data series. More...

	isValid ()
	Basic validation. More...

	initJS ()
	Init JS script files. More...

	addCustomJS ()
	Add type-specific JS script. More...

Protected Attributes
	$tpl

	$id

	$width

	$height

	$data

	$legend

	$shadow

	$colors

	$auto_resize

	$stacked

Detailed Description

Abstract Chart generator base class.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 13 of file class.ilChart.php.

Constructor & Destructor Documentation

◆ __construct()

ilChart::__construct ( $a_id )

protected

Constructor.

Parameters

string $a_id

Definition at line 39 of file class.ilChart.php.

References $DIC, array, data, and setShadow().

     {
         global $DIC;
 
         $this->tpl = $DIC["tpl"];
         $this->id = $a_id;
         $this->data = array();
                 
         $this->setShadow(2);
     }

Here is the call graph for this function:

Member Function Documentation

◆ addCustomJS()

ilChart::addCustomJS ( )

protected

Add type-specific JS script.

Definition at line 270 of file class.ilChart.php.

Referenced by initJS().

271 {

272 }

Here is the caller graph for this function:

◆ addData()

ilChart::addData	(	ilChartData	$a_series,
			$a_idx = `null`
	)

Add data series.

Parameters

ilChartData	$a_series
mixed	$a_id

Returns: mixed index

Definition at line 120 of file class.ilChart.php.

References $data, data, and isValidDataType().

     {
         if ($this->isValidDataType($a_series)) {
             if ($a_idx === null) {
                 $a_idx = sizeof($this->data);
             }
             $this->data[$a_idx] = $a_series;
             return $a_idx;
         }
     }

Here is the call graph for this function:

◆ getColors()

ilChart::getColors ( )

Get colors.

Returns: array

Definition at line 160 of file class.ilChart.php.

References $colors.

Referenced by getHTML().

     {
         return $this->colors;
     }

Here is the caller graph for this function:

◆ getDataInstance()

ilChart::getDataInstance ( $a_type = null )

abstract

Get data series instance.

Returns: ilChartData

Referenced by getInstanceByType().

Here is the caller graph for this function:

◆ getHTML()

ilChart::getHTML ( )

Render.

Definition at line 286 of file class.ilChart.php.

References $chart, $colors, $ret, $series, array, data, getColors(), getShadow(), initJS(), isValid(), and parseGlobalOptions().

     {
         if (!$this->isValid()) {
             return;
         }
         
         $this->initJS();
     
         $chart = new ilTemplate("tpl.grid.html", true, true, "Services/Chart");
         $chart->setVariable("ID", $this->id);
         
         if ($this->width) {
             if (is_numeric($this->width)) {
                 $chart->setVariable("WIDTH", "width:" . $this->width . "px;");
             } else {
                 $chart->setVariable("WIDTH", "width:" . $this->width . ";");
             }
         }
         if ($this->height) {
             if (is_numeric($this->height)) {
                 $chart->setVariable("HEIGHT", "height:" . $this->height . "px;");
             } else {
                 $chart->setVariable("HEIGHT", "height:" . $this->height . ";");
             }
         }
         
         
         // (series) data
         
         $json_series = array();
         foreach ($this->data as $series) {
             $series->parseData($json_series);
         }
         $chart->setVariable("SERIES", json_encode($json_series));
         
         
         // global options
         
         $json_options = new stdClass();
         $json_options->series = new stdClass();
         $json_options->series->shadowSize = (int) $this->getShadow();
         $json_options->series->lines = new stdClass();
         $json_options->series->lines->show = false;
         $json_options->series->stack = (bool) $this->stacked;
         
         foreach ($this->data as $series) {
             $series->parseGlobalOptions($json_options, $this);
         }
         
         $this->parseGlobalOptions($json_options);
         
         $colors = $this->getColors();
         if ($colors) {
             $json_options->colors = array();
             foreach ($colors as $color) {
                 $json_options->colors[] = self::renderColor($color);
             }
         }
 
         // legend
         $json_options->legend = new stdClass();
         if (!$this->legend) {
             $json_options->legend->show = false;
         } else {
             $this->legend->parseOptions($json_options->legend);
         }
     
         $chart->setVariable("OPTIONS", json_encode($json_options));
         
         $ret = $chart->get();
         return $ret;
     }

Here is the call graph for this function:

◆ getInstanceByType()

static ilChart::getInstanceByType	(	$a_type,
		$a_id
	)

static

Get type instance.

Parameters

int	$a_type
string	$a_id

Returns: ilChart

Definition at line 57 of file class.ilChart.php.

References $a_type, getDataInstance(), and isValidDataType().

Referenced by ilPollBlockGUI\fillRow(), SurveyMetricQuestionEvaluation\getChart(), SurveyMatrixQuestionEvaluation\getChart(), SurveyQuestionEvaluation\getChart(), ilSessionStatisticsGUI\getChart(), ilPersonalSkillsGUI\getGapAnalysisHTML(), ilLPObjectStatisticsTypesTableGUI\getGraph(), ilLPObjectStatisticsDailyTableGUI\getGraph(), ilLPObjectStatisticsTableGUI\getGraph(), ilLPObjectStatisticsLPTableGUI\getGraph(), and ilWikiStatGUI\renderGraph().

     {
         switch ($a_type) {
             case self::TYPE_GRID:
                 include_once "Services/Chart/classes/class.ilChartGrid.php";
                 return new ilChartGrid($a_id);
                 
             case self::TYPE_PIE:
                 include_once "Services/Chart/classes/class.ilChartPie.php";
                 return new ilChartPie($a_id);
                 
             case self::TYPE_SPIDER:
                 include_once "Services/Chart/classes/class.ilChartSpider.php";
                 return new ilChartSpider($a_id);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getShadow()

ilChart::getShadow ( )

Get shadow.

Returns: int

Definition at line 217 of file class.ilChart.php.

References $shadow.

Referenced by getHTML().

     {
         return $this->shadow;
     }

Here is the caller graph for this function:

◆ initJS()

ilChart::initJS ( )

protected

Init JS script files.

Definition at line 245 of file class.ilChart.php.

References $tpl, addCustomJS(), and iljQueryUtil\initjQuery().

Referenced by getHTML().

     {
         $tpl = $this->tpl;
         
         include_once "Services/jQuery/classes/class.iljQueryUtil.php";
         iljQueryUtil::initjQuery();
         
         $tpl->addJavascript("Services/Chart/js/flot/excanvas.min.js");
         $tpl->addJavascript("Services/Chart/js/flot/jquery.flot.min.js");
         
         if ((bool) $this->auto_resize) {
             // #13108
             $tpl->addJavascript("Services/Chart/js/flot/jquery.flot.resize.min.js");
         }
         
         if ((bool) $this->stacked) {
             $tpl->addJavascript("Services/Chart/js/flot/jquery.flot.stack.min.js");
         }
         
         $this->addCustomJS();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isValid()

ilChart::isValid ( )

protected

Basic validation.

Returns: bool

Definition at line 93 of file class.ilChart.php.

References data.

Referenced by getHTML().

     {
         if (sizeof($this->data)) {
             return true;
         }
         return false;
     }

Here is the caller graph for this function:

◆ isValidColor()

static ilChart::isValidColor ( $a_value )

static

Validate html color code.

Parameters

string $a_value

Returns: bool

Definition at line 171 of file class.ilChart.php.

Referenced by ilChartLegend\setBackground(), ilChartData\setFill(), and ilChartLegend\setLabelBorder().

     {
         if (preg_match("/^#[0-9a-f]{3}$/i", $a_value, $match)) {
             return true;
         } elseif (preg_match("/^#[0-9a-f]{6}$/i", $a_value, $match)) {
             return true;
         }
     }

Here is the caller graph for this function:

◆ isValidDataType()

ilChart::isValidDataType ( ilChartData $a_series )

abstractprotected

Validate data series.

Returns: bool

Referenced by addData(), and getInstanceByType().

Here is the caller graph for this function:

◆ parseGlobalOptions()

ilChart::parseGlobalOptions ( stdClass $a_options )

Convert (global) properties to flot config.

Parameters

object $a_options

Definition at line 279 of file class.ilChart.php.

Referenced by getHTML().

280 {

281 }

Here is the caller graph for this function:

◆ renderColor()

static ilChart::renderColor	(	$a_value,
		$a_opacity = `1`
	)

static

Render html color code.

Parameters

string	$a_value
float	$a_opacity

Returns: string

Definition at line 187 of file class.ilChart.php.

Referenced by ilChartDataSpider\parseData(), ilChartData\parseData(), ilChartDataSpider\parseGlobalOptions(), ilChartSpider\parseGlobalOptions(), ilChartDataPie\parseGlobalOptions(), and ilChartLegend\parseOptions().

     {
         if (self::isValidColor($a_value)) {
             if (strlen($a_value) == 4) {
                 return "rgba(" . hexdec($a_value[1] . $a_value[1]) . ", " .
                     hexdec($a_value[2] . $a_value[2]) . ", " .
                     hexdec($a_value[3] . $a_value[3]) . ", " . $a_opacity . ")";
             } else {
                 return "rgba(" . hexdec($a_value[1] . $a_value[2]) . ", " .
                     hexdec($a_value[3] . $a_value[4]) . ", " .
                     hexdec($a_value[5] . $a_value[6]) . ", " . $a_opacity . ")";
             }
         }
     }

Here is the caller graph for this function:

◆ setAutoResize()

ilChart::setAutoResize ( $a_value )

Toggle auto-resizing on window resize/redraw.

Parameters

bool $a_value

Definition at line 227 of file class.ilChart.php.

     {
         $this->auto_resize = (bool) $a_value;
     }

◆ setColors()

ilChart::setColors ( $a_values )

Set colors.

Parameters

array $a_values

Definition at line 146 of file class.ilChart.php.

     {
         foreach ($a_values as $color) {
             if (self::isValidColor($color)) {
                 $this->colors[] = $color;
             }
         }
     }

◆ setLegend()

ilChart::setLegend ( ilChartLegend $a_legend )

Set chart legend.

Parameters

ilChartLegend $a_legend

Definition at line 136 of file class.ilChart.php.

Referenced by ilChartPie\parseGlobalOptions().

     {
         $this->legend = $a_legend;
     }

Here is the caller graph for this function:

◆ setShadow()

ilChart::setShadow ( $a_value )

Set shadow.

Parameters

int $a_value

Definition at line 207 of file class.ilChart.php.

Referenced by __construct().

     {
         $this->shadow = (int) $a_value;
     }

Here is the caller graph for this function:

◆ setSize()

ilChart::setSize	(	$a_x,
		$a_y
	)

Set chart size.

Parameters

int	$a_x
int	$a_y

Definition at line 107 of file class.ilChart.php.

     {
         $this->width = $a_x;
         $this->height = $a_y;
     }

◆ setStacked()

ilChart::setStacked ( $a_value )

Toggle stacking.

Parameters

bool $a_value

Definition at line 237 of file class.ilChart.php.

     {
         $this->stacked = (bool) $a_value;
     }

Field Documentation

◆ $auto_resize

ilChart::$auto_resize

protected

Definition at line 27 of file class.ilChart.php.

◆ $colors

ilChart::$colors

protected

Definition at line 26 of file class.ilChart.php.

Referenced by getColors(), and getHTML().

◆ $data

ilChart::$data

protected

Definition at line 23 of file class.ilChart.php.

Referenced by addData().

◆ $height

ilChart::$height

protected

Definition at line 22 of file class.ilChart.php.

◆ $id

ilChart::$id

protected

Definition at line 20 of file class.ilChart.php.

◆ $legend

ilChart::$legend

protected

Definition at line 24 of file class.ilChart.php.

Referenced by ilChartPie\parseGlobalOptions().

◆ $shadow

ilChart::$shadow

protected

Definition at line 25 of file class.ilChart.php.

Referenced by getShadow().

◆ $stacked

ilChart::$stacked

protected

Definition at line 28 of file class.ilChart.php.

◆ $tpl

ilChart::$tpl

protected

Definition at line 18 of file class.ilChart.php.

Referenced by ilChartPie\addCustomJS(), ilChartSpider\addCustomJS(), and initJS().

◆ $width

ilChart::$width

protected

Definition at line 21 of file class.ilChart.php.

◆ TYPE_GRID

const ilChart::TYPE_GRID = 1

Definition at line 30 of file class.ilChart.php.

Referenced by SurveyMetricQuestionEvaluation\getChart(), SurveyMatrixQuestionEvaluation\getChart(), SurveyQuestionEvaluation\getChart(), ilSessionStatisticsGUI\getChart(), ilLPObjectStatisticsTypesTableGUI\getGraph(), ilLPObjectStatisticsDailyTableGUI\getGraph(), ilLPObjectStatisticsTableGUI\getGraph(), ilLPObjectStatisticsLPTableGUI\getGraph(), and ilWikiStatGUI\renderGraph().

◆ TYPE_PIE

const ilChart::TYPE_PIE = 2

Definition at line 31 of file class.ilChart.php.

◆ TYPE_SPIDER

const ilChart::TYPE_SPIDER = 3

Definition at line 32 of file class.ilChart.php.

Referenced by ilPersonalSkillsGUI\getGapAnalysisHTML().

The documentation for this class was generated from the following file:

Services/Chart/classes/class.ilChart.php

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addCustomJS()

◆ addData()

◆ getColors()

◆ getDataInstance()

◆ getHTML()

◆ getInstanceByType()

◆ getShadow()

◆ initJS()

◆ isValid()

◆ isValidColor()

◆ isValidDataType()

◆ parseGlobalOptions()

◆ renderColor()

◆ setAutoResize()

◆ setColors()

◆ setLegend()

◆ setShadow()

◆ setSize()

◆ setStacked()

Field Documentation

◆ $auto_resize

◆ $colors

◆ $data

◆ $height

◆ $id

◆ $legend

◆ $shadow

◆ $stacked

◆ $tpl

◆ $width

◆ TYPE_GRID

◆ TYPE_PIE

◆ TYPE_SPIDER