@@ -48,7 +48,7 @@ discard block |
||
48 | 48 | * @param string $locale Locale/Language to add data for, identical with locale identifier, |
49 | 49 | * see Zend_Locale for more information |
50 | 50 | * @param string $filename XMLTM file to add, full path must be given for access |
51 | - * @param array $option OPTIONAL Options to use |
|
51 | + * @param array $options OPTIONAL Options to use |
|
52 | 52 | * @throws Zend_Translation_Exception |
53 | 53 | * @return array |
54 | 54 | */ |
@@ -116,6 +116,9 @@ discard block |
||
116 | 116 | } |
117 | 117 | } |
118 | 118 | |
119 | + /** |
|
120 | + * @param string $filename |
|
121 | + */ |
|
119 | 122 | private function _findEncoding($filename) |
120 | 123 | { |
121 | 124 | $file = file_get_contents($filename, null, null, 0, 100); |
@@ -48,7 +48,7 @@ discard block |
||
48 | 48 | * @param string $locale Locale/Language to add data for, identical with locale identifier, |
49 | 49 | * see Zend_Locale for more information |
50 | 50 | * @param string $filename XMLTM file to add, full path must be given for access |
51 | - * @param array $option OPTIONAL Options to use |
|
51 | + * @param array $options OPTIONAL Options to use |
|
52 | 52 | * @throws Zend_Translation_Exception |
53 | 53 | * @return array |
54 | 54 | */ |
@@ -116,6 +116,9 @@ discard block |
||
116 | 116 | } |
117 | 117 | } |
118 | 118 | |
119 | + /** |
|
120 | + * @param string $filename |
|
121 | + */ |
|
119 | 122 | private function _findEncoding($filename) |
120 | 123 | { |
121 | 124 | $file = file_get_contents($filename, null, null, 0, 100); |
@@ -48,7 +48,7 @@ discard block |
||
48 | 48 | * @param string $locale Locale/Language to add data for, identical with locale identifier, |
49 | 49 | * see Zend_Locale for more information |
50 | 50 | * @param string $filename XMLTM file to add, full path must be given for access |
51 | - * @param array $option OPTIONAL Options to use |
|
51 | + * @param array $options OPTIONAL Options to use |
|
52 | 52 | * @throws Zend_Translation_Exception |
53 | 53 | * @return array |
54 | 54 | */ |
@@ -116,6 +116,9 @@ discard block |
||
116 | 116 | } |
117 | 117 | } |
118 | 118 | |
119 | + /** |
|
120 | + * @param string $filename |
|
121 | + */ |
|
119 | 122 | private function _findEncoding($filename) |
120 | 123 | { |
121 | 124 | $file = file_get_contents($filename, null, null, 0, 100); |
@@ -38,6 +38,7 @@ discard block |
||
38 | 38 | |
39 | 39 | /** |
40 | 40 | * @todo Move this to SS_Database or DB |
41 | + * @param string $class |
|
41 | 42 | */ |
42 | 43 | public static function hasTable($class) { |
43 | 44 | // Cache the list of all table names to reduce on DB traffic |
@@ -219,6 +220,7 @@ discard block |
||
219 | 220 | |
220 | 221 | /** |
221 | 222 | * Returns true if the given class implements the given interface |
223 | + * @param string $interfaceName |
|
222 | 224 | */ |
223 | 225 | public static function classImplements($className, $interfaceName) { |
224 | 226 | return in_array($className, self::implementorsOf($interfaceName)); |
@@ -269,6 +271,9 @@ discard block |
||
269 | 271 | |
270 | 272 | private static $method_from_cache = array(); |
271 | 273 | |
274 | + /** |
|
275 | + * @param string $method |
|
276 | + */ |
|
272 | 277 | public static function has_method_from($class, $method, $compclass) { |
273 | 278 | $lClass = strtolower($class); |
274 | 279 | $lMethod = strtolower($method); |
@@ -157,7 +157,7 @@ discard block |
||
157 | 157 | * Returns a new DataList instance with the specified query parameter assigned |
158 | 158 | * |
159 | 159 | * @param string|array $keyOrArray Either the single key to set, or an array of key value pairs to set |
160 | - * @param mixed $val If $keyOrArray is not an array, this is the value to set |
|
160 | + * @param string $val If $keyOrArray is not an array, this is the value to set |
|
161 | 161 | * @return DataList |
162 | 162 | */ |
163 | 163 | public function setDataQueryParam($keyOrArray, $val = null) { |
@@ -520,7 +520,7 @@ discard block |
||
520 | 520 | * Check if the given field specification could be interpreted as an unquoted relation name |
521 | 521 | * |
522 | 522 | * @param string $field |
523 | - * @return bool |
|
523 | + * @return integer |
|
524 | 524 | */ |
525 | 525 | protected function isValidRelationName($field) { |
526 | 526 | return preg_match('/^[A-Z0-9._]+$/i', $field); |
@@ -635,7 +635,7 @@ discard block |
||
635 | 635 | * @param int $order A numerical index to control the order that joins are added to the query; lower order values |
636 | 636 | * will cause the query to appear first. The default is 20, and joins created automatically by the |
637 | 637 | * ORM have a value of 10. |
638 | - * @param array $parameters Any additional parameters if the join is a parameterised subquery |
|
638 | + * @param string[] $parameters Any additional parameters if the join is a parameterised subquery |
|
639 | 639 | * @return DataList |
640 | 640 | */ |
641 | 641 | public function innerJoin($table, $onClause, $alias = null, $order = 20, $parameters = array()) { |
@@ -653,7 +653,7 @@ discard block |
||
653 | 653 | * @param int $order A numerical index to control the order that joins are added to the query; lower order values |
654 | 654 | * will cause the query to appear first. The default is 20, and joins created automatically by the |
655 | 655 | * ORM have a value of 10. |
656 | - * @param array $parameters Any additional parameters if the join is a parameterised subquery |
|
656 | + * @param string[] $parameters Any additional parameters if the join is a parameterised subquery |
|
657 | 657 | * @return DataList |
658 | 658 | */ |
659 | 659 | public function leftJoin($table, $onClause, $alias = null, $order = 20, $parameters = array()) { |
@@ -780,7 +780,7 @@ discard block |
||
780 | 780 | * Return the maximum value of the given field in this DataList |
781 | 781 | * |
782 | 782 | * @param string $fieldName |
783 | - * @return mixed |
|
783 | + * @return string |
|
784 | 784 | */ |
785 | 785 | public function max($fieldName) { |
786 | 786 | return $this->dataQuery->max($fieldName); |
@@ -790,7 +790,7 @@ discard block |
||
790 | 790 | * Return the minimum value of the given field in this DataList |
791 | 791 | * |
792 | 792 | * @param string $fieldName |
793 | - * @return mixed |
|
793 | + * @return string |
|
794 | 794 | */ |
795 | 795 | public function min($fieldName) { |
796 | 796 | return $this->dataQuery->min($fieldName); |
@@ -800,7 +800,7 @@ discard block |
||
800 | 800 | * Return the average value of the given field in this DataList |
801 | 801 | * |
802 | 802 | * @param string $fieldName |
803 | - * @return mixed |
|
803 | + * @return string |
|
804 | 804 | */ |
805 | 805 | public function avg($fieldName) { |
806 | 806 | return $this->dataQuery->avg($fieldName); |
@@ -810,7 +810,7 @@ discard block |
||
810 | 810 | * Return the sum of the values of the given field in this DataList |
811 | 811 | * |
812 | 812 | * @param string $fieldName |
813 | - * @return mixed |
|
813 | + * @return string |
|
814 | 814 | */ |
815 | 815 | public function sum($fieldName) { |
816 | 816 | return $this->dataQuery->sum($fieldName); |
@@ -862,7 +862,7 @@ discard block |
||
862 | 862 | /** |
863 | 863 | * Restrict the columns to fetch into this DataList |
864 | 864 | * |
865 | - * @param array $queriedColumns |
|
865 | + * @param string[] $queriedColumns |
|
866 | 866 | * @return DataList |
867 | 867 | */ |
868 | 868 | public function setQueriedColumns($queriedColumns) { |
@@ -1135,7 +1135,7 @@ discard block |
||
1135 | 1135 | /** |
1136 | 1136 | * Returns item stored in list with index $key |
1137 | 1137 | * |
1138 | - * @param mixed $key |
|
1138 | + * @param integer $key |
|
1139 | 1139 | * @return DataObject |
1140 | 1140 | */ |
1141 | 1141 | public function offsetGet($key) { |
@@ -732,6 +732,9 @@ discard block |
||
732 | 732 | return $result; |
733 | 733 | } |
734 | 734 | |
735 | + /** |
|
736 | + * @param string $mode |
|
737 | + */ |
|
735 | 738 | protected function _get($dir, $mode, $tags = array()) |
736 | 739 | { |
737 | 740 | if (!is_dir($dir)) { |
@@ -819,6 +822,7 @@ discard block |
||
819 | 822 | /** |
820 | 823 | * Compute & return the expire time |
821 | 824 | * |
825 | + * @param integer $lifetime |
|
822 | 826 | * @return int expire time (unix timestamp) |
823 | 827 | */ |
824 | 828 | protected function _expireTime($lifetime) |
@@ -293,7 +293,7 @@ discard block |
||
293 | 293 | * |
294 | 294 | * @param string $action |
295 | 295 | * |
296 | - * @return HTMLText |
|
296 | + * @return DBField |
|
297 | 297 | */ |
298 | 298 | public function defaultAction($action) { |
299 | 299 | return $this->getViewer($action)->process($this); |
@@ -429,7 +429,7 @@ discard block |
||
429 | 429 | * |
430 | 430 | * @param array $params |
431 | 431 | * |
432 | - * @return string |
|
432 | + * @return DBField |
|
433 | 433 | */ |
434 | 434 | public function render($params = null) { |
435 | 435 | $template = $this->getViewer($this->getAction()); |
@@ -594,7 +594,7 @@ discard block |
||
594 | 594 | * Tests whether a redirection has been requested. If redirect() has been called, it will return |
595 | 595 | * the URL redirected to. Otherwise, it will return null. |
596 | 596 | * |
597 | - * @return null|string |
|
597 | + * @return boolean |
|
598 | 598 | */ |
599 | 599 | public function redirectedTo() { |
600 | 600 | return $this->getResponse() && $this->getResponse()->getHeader('Location'); |
@@ -59,6 +59,10 @@ discard block |
||
59 | 59 | */ |
60 | 60 | protected $config; |
61 | 61 | |
62 | + /** |
|
63 | + * @param string $name |
|
64 | + * @param string $title |
|
65 | + */ |
|
62 | 66 | public function __construct($name, $title = null, $value = ""){ |
63 | 67 | $this->config = $this->config()->default_config; |
64 | 68 | |
@@ -71,6 +75,9 @@ discard block |
||
71 | 75 | parent::__construct($name, $title, $value); |
72 | 76 | } |
73 | 77 | |
78 | + /** |
|
79 | + * @param Form $form |
|
80 | + */ |
|
74 | 81 | public function setForm($form) { |
75 | 82 | parent::setForm($form); |
76 | 83 | |
@@ -81,6 +88,9 @@ discard block |
||
81 | 88 | return $this; |
82 | 89 | } |
83 | 90 | |
91 | + /** |
|
92 | + * @param string $name |
|
93 | + */ |
|
84 | 94 | public function setName($name) { |
85 | 95 | parent::setName($name); |
86 | 96 | |
@@ -93,7 +103,7 @@ discard block |
||
93 | 103 | |
94 | 104 | /** |
95 | 105 | * @param array $properties |
96 | - * @return HTMLText |
|
106 | + * @return string |
|
97 | 107 | */ |
98 | 108 | public function FieldHolder($properties = array()) { |
99 | 109 | $config = array( |
@@ -108,7 +118,7 @@ discard block |
||
108 | 118 | |
109 | 119 | /** |
110 | 120 | * @param array $properties |
111 | - * @return HTMLText |
|
121 | + * @return DBField |
|
112 | 122 | */ |
113 | 123 | public function Field($properties = array()) { |
114 | 124 | Requirements::css(FRAMEWORK_DIR . '/css/DatetimeField.css'); |
@@ -243,6 +253,7 @@ discard block |
||
243 | 253 | |
244 | 254 | /** |
245 | 255 | * @param FormField |
256 | + * @param DateField $field |
|
246 | 257 | */ |
247 | 258 | public function setDateField($field) { |
248 | 259 | $expected = $this->getName() . '[date]'; |
@@ -268,6 +279,7 @@ discard block |
||
268 | 279 | |
269 | 280 | /** |
270 | 281 | * @param FormField |
282 | + * @param TimeField $field |
|
271 | 283 | */ |
272 | 284 | public function setTimeField($field) { |
273 | 285 | $expected = $this->getName() . '[time]'; |
@@ -306,7 +318,7 @@ discard block |
||
306 | 318 | * to set field-specific config options. |
307 | 319 | * |
308 | 320 | * @param string $name |
309 | - * @param mixed $val |
|
321 | + * @param string $val |
|
310 | 322 | */ |
311 | 323 | public function setConfig($name, $val) { |
312 | 324 | $this->config[$name] = $val; |
@@ -324,7 +336,7 @@ discard block |
||
324 | 336 | * to get field-specific config options. |
325 | 337 | * |
326 | 338 | * @param String $name Optional, returns the whole configuration array if empty |
327 | - * @return mixed |
|
339 | + * @return string|null |
|
328 | 340 | */ |
329 | 341 | public function getConfig($name = null) { |
330 | 342 | if($name) { |
@@ -334,6 +346,9 @@ discard block |
||
334 | 346 | } |
335 | 347 | } |
336 | 348 | |
349 | + /** |
|
350 | + * @param RequiredFields $validator |
|
351 | + */ |
|
337 | 352 | public function validate($validator) { |
338 | 353 | $dateValid = $this->dateField->validate($validator); |
339 | 354 | $timeValid = $this->timeField->validate($validator); |
@@ -199,7 +199,7 @@ discard block |
||
199 | 199 | * |
200 | 200 | * @todo refactor this into GridFieldComponent |
201 | 201 | * |
202 | - * @param mixed $value |
|
202 | + * @param string $value |
|
203 | 203 | * @param string|array $castingDefinition |
204 | 204 | * |
205 | 205 | * @return mixed |
@@ -286,7 +286,7 @@ discard block |
||
286 | 286 | * |
287 | 287 | * @param array $properties |
288 | 288 | * |
289 | - * @return HTMLText |
|
289 | + * @return DBField |
|
290 | 290 | */ |
291 | 291 | public function FieldHolder($properties = array()) { |
292 | 292 | Requirements::css(THIRDPARTY_DIR . '/jquery-ui-themes/smoothness/jquery-ui.css'); |
@@ -571,7 +571,7 @@ discard block |
||
571 | 571 | * @param int $index |
572 | 572 | * @param DataObject $record |
573 | 573 | * |
574 | - * @return array |
|
574 | + * @return string[] |
|
575 | 575 | */ |
576 | 576 | protected function newRowClasses($total, $index, $record) { |
577 | 577 | $classes = array('ss-gridfield-item'); |
@@ -596,7 +596,7 @@ discard block |
||
596 | 596 | /** |
597 | 597 | * @param array $properties |
598 | 598 | * |
599 | - * @return HTMLText |
|
599 | + * @return DBField |
|
600 | 600 | */ |
601 | 601 | public function Field($properties = array()) { |
602 | 602 | return $this->FieldHolder($properties); |