@@ -46,6 +46,9 @@ discard block |
||
46 | 46 | $engine->duration = $this->chart->getDuration(); |
47 | 47 | } |
48 | 48 | |
49 | + /** |
|
50 | + * @param integer $effort_field_id |
|
51 | + */ |
|
49 | 52 | protected function getBurnDownData($effort_field_id, $type) { |
50 | 53 | $artifact_ids = explode(',', $this->artifacts['id']); |
51 | 54 | $sql = "SELECT c.artifact_id AS id, TO_DAYS(FROM_UNIXTIME(submitted_on)) - TO_DAYS(FROM_UNIXTIME(0)) as day, value |
@@ -58,6 +61,9 @@ discard block |
||
58 | 61 | return new GraphOnTrackersV5_Burndown_Data(db_query($sql), $artifact_ids); |
59 | 62 | } |
60 | 63 | |
64 | + /** |
|
65 | + * @param Tracker_FormElement_Field $effort_field |
|
66 | + */ |
|
61 | 67 | protected function isValidEffortField($effort_field, $type) { |
62 | 68 | return $effort_field && $effort_field->userCanRead(UserManager::instance()->getCurrentUser()); |
63 | 69 | } |
@@ -122,6 +122,9 @@ |
||
122 | 122 | return strcmp($a_date, $b_date); |
123 | 123 | } |
124 | 124 | |
125 | + /** |
|
126 | + * @return string |
|
127 | + */ |
|
125 | 128 | private function getSuitableDateForSorting($artifact_data) { |
126 | 129 | $date = $artifact_data['start']; |
127 | 130 | // a milestone has no start date, only a end one |
@@ -100,6 +100,9 @@ discard block |
||
100 | 100 | return $this->filterEmptyLines($result);; |
101 | 101 | } |
102 | 102 | |
103 | + /** |
|
104 | + * @param Tracker_FormElement_Field $observed_field |
|
105 | + */ |
|
103 | 106 | protected function isValidObservedField($observed_field, $type) { |
104 | 107 | return $observed_field && $observed_field->userCanRead(UserManager::instance()->getCurrentUser()); |
105 | 108 | } |
@@ -116,7 +119,6 @@ discard block |
||
116 | 119 | /** |
117 | 120 | * |
118 | 121 | * Fetch the colors, and initialize an empty result array. => $tempData[timestamp][label_id] = 0 |
119 | - * @param int $field_id ID of the observed field |
|
120 | 122 | * @return array $resultArray Initialized array for this graph |
121 | 123 | */ |
122 | 124 | private function initEmptyResultArrayFromField($engine) { |
@@ -149,7 +151,7 @@ discard block |
||
149 | 151 | /** |
150 | 152 | * |
151 | 153 | * Get the the last changeset BEFORE the timestamp for each artifact |
152 | - * @param int $beforeTimestamp |
|
154 | + * @param double $timestamp |
|
153 | 155 | * @return $changesets array of changeset_id |
154 | 156 | */ |
155 | 157 | private function getLastChangesetsBefore($timestamp) { |
@@ -60,6 +60,9 @@ |
||
60 | 60 | return $data; |
61 | 61 | } |
62 | 62 | |
63 | + /** |
|
64 | + * @param string $column |
|
65 | + */ |
|
63 | 66 | protected function extractDataFromResult($res, $ids, $column) { |
64 | 67 | $data = array(); |
65 | 68 | if ($res && db_numrows($res)) { |
@@ -61,6 +61,8 @@ |
||
61 | 61 | * If the given color is undefined(null), then we must take one from the current |
62 | 62 | * theme (in available_colors). |
63 | 63 | * |
64 | + * @param string $available_colors |
|
65 | + * @param integer $max_colors |
|
64 | 66 | * @return string hexadecimal representation of the color |
65 | 67 | */ |
66 | 68 | private function fillTheBlanks($color, $available_colors, $max_colors, &$i) { |
@@ -310,6 +310,9 @@ discard block |
||
310 | 310 | return $bar; |
311 | 311 | } |
312 | 312 | |
313 | + /** |
|
314 | + * @param integer $pos |
|
315 | + */ |
|
313 | 316 | protected function addMilestone($pos, $data, $params = array()) { |
314 | 317 | $format = "Y-m-d"; |
315 | 318 | $aLabel = isset($params['label']) ? $params['label'] : array($data['id'], html_entity_decode($data['summary'])); |
@@ -331,6 +334,9 @@ discard block |
||
331 | 334 | return $milestone; |
332 | 335 | } |
333 | 336 | |
337 | + /** |
|
338 | + * @param integer $pos |
|
339 | + */ |
|
334 | 340 | protected function addErrorBar($pos, $data) { |
335 | 341 | $format = "Y-m-d"; |
336 | 342 | |
@@ -362,6 +368,10 @@ discard block |
||
362 | 368 | $bar->SetPattern(GANTT_RDIAG,"black", 96); |
363 | 369 | } |
364 | 370 | |
371 | + /** |
|
372 | + * @param integer $pos |
|
373 | + * @param boolean $progress |
|
374 | + */ |
|
365 | 375 | protected function addLateBar($pos, $data, $progress, $params = array()) { |
366 | 376 | $bar = $this->addBar($pos, $data, $progress, $params); |
367 | 377 | $bar->SetColor($this->graph->getLateBarColor().":0.7"); |
@@ -27,6 +27,9 @@ discard block |
||
27 | 27 | protected $chart_to_edit; |
28 | 28 | protected $plugin; |
29 | 29 | |
30 | + /** |
|
31 | + * @param GraphOnTrackersV5Plugin $plugin |
|
32 | + */ |
|
30 | 33 | public function __construct($id, $report, $name, $description, $rank, $plugin) { |
31 | 34 | parent::__construct($id, $report, $name, $description, $rank); |
32 | 35 | $this->charts = null; |
@@ -124,6 +127,9 @@ discard block |
||
124 | 127 | return $html; |
125 | 128 | } |
126 | 129 | |
130 | + /** |
|
131 | + * @param boolean $readonly |
|
132 | + */ |
|
127 | 133 | protected function fetchCharts($matching_ids, PFUser $current_user, $in_dashboard = false, $readonly = null, $store_in_session = true) { |
128 | 134 | $html = ''; |
129 | 135 | $hp = Codendi_HTMLPurifier::instance(); |
@@ -28,6 +28,10 @@ |
||
28 | 28 | abstract class GraphOnTrackersV5_Widget_Chart extends Widget { |
29 | 29 | var $chart_title; |
30 | 30 | var $chart_id; |
31 | + |
|
32 | + /** |
|
33 | + * @param string $id |
|
34 | + */ |
|
31 | 35 | function GraphOnTrackersV5_Widget_Chart($id, $owner_id, $owner_type) { |
32 | 36 | $this->Widget($id); |
33 | 37 | $this->setOwner($owner_id, $owner_type); |
@@ -24,6 +24,9 @@ |
||
24 | 24 | |
25 | 25 | class GraphOnTrackersV5PluginInfo extends PluginInfo { |
26 | 26 | |
27 | + /** |
|
28 | + * @param GraphOnTrackersV5Plugin $plugin |
|
29 | + */ |
|
27 | 30 | function GraphOnTrackersV5PluginInfo(&$plugin) { |
28 | 31 | $this->PluginInfo($plugin); |
29 | 32 | $this->setPluginDescriptor(new GraphOnTrackersV5PluginDescriptor()); |