ILIAS  Release_4_2_x_branch Revision 61807
 All Data Structures Namespaces Files Functions Variables Groups Pages
class.ilChart.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (c) 1998-2010 ILIAS open source, Extended GPL, see docs/LICENSE */
3 
4 include_once "Services/Chart/classes/class.ilChartData.php";
5 include_once "Services/Chart/classes/class.ilChartLegend.php";
6 
14 class ilChart
15 {
16  protected $id; // [string]
17  protected $renderer; // [string]
18  protected $width; // [string]
19  protected $height; // [string]
20  protected $data; // [array]
21  protected $legend; // [ilChartLegend]
22  protected $shadow; // [int]
23  protected $colors; // [array]
24  protected $ticks; // [array]
25  protected $integer_axis; // [array]
26 
35  public function __construct($a_id, $a_width = 500, $a_height = 500, $a_renderer = "flot")
36  {
37  $this->id = $a_id;
38  $this->data = array();
39  $this->setXAxisToInteger(false);
40  $this->setYAxisToInteger(false);
41  $this->setSize($a_width, $a_height);
42  $this->setRenderer($a_renderer);
43  $this->setShadow(2);
44  }
45 
51  public function setRenderer($a_value)
52  {
53  if(in_array((string)$a_value, $this->getAllRenderers()))
54  {
55  $this->renderer = (string)$a_value;
56  }
57  }
58 
64  public function getAllRenderers()
65  {
66  return array("flot");
67  }
68 
75  public function setSize($a_x, $a_y)
76  {
77  $this->width = (int)$a_x;
78  $this->height = (int)$a_y;
79  }
80 
88  public function addData(ilChartData $a_series, $a_idx = null)
89  {
90  if($a_idx === null)
91  {
92  $a_idx = sizeof($this->data);
93  }
94  $this->data[$a_idx] = $a_series;
95  return $a_idx;
96  }
97 
103  public function setLegend(ilChartLegend $a_legend)
104  {
105  $this->legend = $a_legend;
106  }
107 
114  public static function isValidColor($a_value)
115  {
116  if(preg_match("/^#[0-9a-f]{3}$/i", $a_value, $match))
117  {
118  return true;
119  }
120  else if(preg_match("/^#[0-9a-f]{6}$/i", $a_value, $match))
121  {
122  return true;
123  }
124  }
125 
133  protected static function renderColor($a_value, $a_opacity = 1)
134  {
135  if(self::isValidColor($a_value))
136  {
137  if(strlen($a_value) == 4)
138  {
139  return "\"rgba(".hexdec($a_value[1].$a_value[1]).", ".
140  hexdec($a_value[2].$a_value[2]).", ".
141  hexdec($a_value[3].$a_value[3]).", ".$a_opacity.")\"";
142  }
143  else
144  {
145  return "\"rgba(".hexdec($a_value[1].$a_value[2]).", ".
146  hexdec($a_value[3].$a_value[4]).", ".
147  hexdec($a_value[5].$a_value[6]).", ".$a_opacity.")\"";
148  }
149  }
150  }
151 
157  public function setShadow($a_value)
158  {
159  $this->shadow = (int)$a_value;
160  }
161 
167  public function getShadow()
168  {
169  return $this->shadow;
170  }
171 
177  public function setColors($a_values)
178  {
179  foreach($a_values as $color)
180  {
181  if(self::isValidColor($color))
182  {
183  $this->colors[] = $color;
184  }
185  }
186  }
187 
193  public function getColors()
194  {
195  return $this->colors;
196  }
197 
205  public function setTicks($a_x, $a_y, $a_labeled = false)
206  {
207  $this->ticks = array("x" => $a_x, "y" => $a_y, "labeled" => (bool)$a_labeled);
208  }
209 
215  public function getTicks()
216  {
217  return $this->ticks;
218  }
219 
223  public function getHTML()
224  {
225  global $tpl;
226 
227  include_once "Services/jQuery/classes/class.iljQueryUtil.php";
228  iljQueryUtil::initjQuery();
229 
230  // $tpl->addJavascript("Services/Chart/js/flot/jquery.min.js");
231  $tpl->addJavascript("Services/Chart/js/flot/excanvas.min.js");
232  $tpl->addJavascript("Services/Chart/js/flot/jquery.flot.min.js");
233  $tpl->addJavascript("Services/Chart/js/flot/jquery.flot.pie.js");
234 
235  $chart = new ilTemplate("tpl.grid.html", true, true, "Services/Chart");
236  $chart->setVariable("ID", $this->id);
237  $chart->setVariable("WIDTH", $this->width);
238  $chart->setVariable("HEIGHT", $this->height);
239 
240  $last = array_keys($this->data);
241  $last = array_pop($last);
242  $has_pie = false;
243  foreach($this->data as $idx => $series)
244  {
245  $chart->setCurrentBlock("series");
246  $chart->setVariable("SERIES_LABEL", str_replace("\"", "\\\"", $series->getLabel()));
247  $chart->setVariable("SERIES_TYPE", $series->getType());
248 
249  $type = $series->getType();
250 
251  $points = array();
252  if($type != "pie")
253  {
254  foreach($series->getData() as $point)
255  {
256  $points[] = "[".$point[0].",".$point[1]."]";
257  }
258  $chart->setVariable("SERIES_DATA", "[ ".implode(",", $points)." ]");
259  }
260  else
261  {
262  $has_pie = true;
263  $chart->setVariable("SERIES_DATA", array_pop($series->getData()));
264  }
265  if($idx != $last)
266  {
267  $chart->setVariable("SERIES_END", ",");
268  }
269 
270  $options = array("show: ".($series->isHidden() ? "false" : "true"));
271  if($type != "points")
272  {
273  $width = $series->getLineWidth();
274  if($width !== null)
275  {
276  $options[] = "lineWidth:".$width;
277  }
278  if($type == "bars")
279  {
280  $bar_options = $series->getBarOptions();
281  if($bar_options["width"] !== null)
282  {
283  $options[] = "barWidth:".str_replace(",", ".", $bar_options["width"]);
284  $options[] = "align: \"".$bar_options["align"]."\"";
285  if($bar_options["horizontal"])
286  {
287  $options[] = "horizontal: true";
288  }
289  }
290  }
291  else if($type == "lines")
292  {
293  if($series->getLineSteps())
294  {
295  $options[] = "steps: true";
296  }
297  }
298  }
299  else
300  {
301  $radius = $series->getPointRadius();
302  if($radius !== null)
303  {
304  $options[] = "radius:".$radius;
305  }
306  }
307  $fill = $series->getFill();
308  if($fill["fill"])
309  {
310  $options[] = "fill: ".$fill["fill"];
311  if($fill["color"])
312  {
313  $options[] = "fillColor: ".self::renderColor($fill["color"], $fill["fill"]);
314  }
315  }
316  $chart->setVariable("SERIES_OPTIONS", implode(", ", $options));
317 
318  $chart->parseCurrentBlock();
319  }
320 
321 
322  // global options
323 
324  $chart->setVariable("SHADOW", (int)$this->getShadow());
325  $chart->setVariable("IS_PIE", ($has_pie ? "true" : "false"));
326 
327  $colors = $this->getColors();
328  if($colors)
329  {
330  $tmp = array();
331  foreach($colors as $color)
332  {
333  $tmp[] = self::renderColor($color);
334  }
335  }
336  if(sizeof($tmp))
337  {
338  $chart->setVariable("COLORS", implode(",", $tmp));
339  }
340 
341  // legend
342  if(!$this->legend)
343  {
344  $chart->setVariable("LEGEND", "show: false");
345  }
346  else
347  {
348  $margin = $this->legend->getMargin();
349  $legend = array();
350  $legend[] = "show: true";
351  $legend[] = "noColumns: ".$this->legend->getColumns();
352  $legend[] = "position: \"".$this->legend->getPosition()."\"";
353  $legend[] = "margin: [".$margin["x"].", ".$margin["y"]."]";
354  $legend[] = "backgroundColor: ".self::renderColor($this->legend->getBackground());
355  $legend[] = "backgroundOpacity: ".str_replace(",",".",$this->legend->getOpacity());
356  $legend[] = "labelBoxBorderColor: ".self::renderColor($this->legend->getLabelBorder());
357 
358  $chart->setVariable("LEGEND", implode(", ", $legend));
359  }
360 
361  // axis/ticks
362  $tmp = array();
363  $ticks = $this->getTicks();
364  if($ticks)
365  {
366  foreach($ticks as $axis => $def)
367  {
368  if(is_numeric($def))
369  {
370  $tmp[$axis] = $axis."axis: { ticks: ".$def." }";
371  }
372  else if(is_array($def))
373  {
374  $ttmp = array();
375  foreach($def as $idx => $value)
376  {
377  if($ticks["labeled"])
378  {
379  $ttmp[] = "[".$idx.", \"".$value."\"]";
380  }
381  else
382  {
383  $ttmp[] = $value;
384  }
385  }
386  $tmp[$axis] = $axis."axis: { ticks: [".implode(", ", $ttmp)."] }";
387  }
388  }
389  }
390 
391  // optional: remove decimals
392  if(!isset($tmp["x"]) && $this->integer_axis["x"])
393  {
394  $tmp["x"] = "xaxis: { tickDecimals: 0 }";
395  }
396  if(!isset($tmp["y"]) && $this->integer_axis["y"])
397  {
398  $tmp["y"] = "yaxis: { tickDecimals: 0 }";
399  }
400 
401  if(sizeof($tmp))
402  {
403  $chart->setVariable("AXIS", ",".implode(", ", $tmp));
404  }
405 
406  return $chart->get();
407  }
408 
409  function setYAxisToInteger($a_status)
410  {
411  $this->integer_axis["y"] = (bool)$a_status;
412  }
413 
414  function setXAxisToInteger($a_status)
415  {
416  $this->integer_axis["x"] = (bool)$a_status;
417  }
418 
419  /*
420  ilChart
421  ->setColors
422  ->setHover() [tooltip?]
423  [->setClick]
424  ->setZooming
425  ->setPanning
426  ->setTooltip
427  ->addData[Series]
428  - labels
429  - type
430  - pie: nur 1x
431  - bar, lines, points, steps, stacked?
432  - highlight?!
433  => min/max, transmission type (google api)
434 
435 
436  grid-based
437  ->setGrid
438  ->setTicks(color, size, decimals, length)
439  ->addAxisX (multiple, Zero) [id, mode, position, color, label]
440  ->addAxisY (multiple?) [id, mode, position, color, label]
441  ->setBackgroundFill(opacity, color/gradient)
442  ->setThreshold(int/float)
443  ->setToggles(bool)
444 
445  pie
446  ->setCollapse(int/float, color, label)
447  ->setRotation(int angle?)
448  ->setRadius(inner, outer)
449  */
450 }
451 
452 ?>