@@ -243,6 +243,9 @@ discard block |
||
243 | 243 | } |
244 | 244 | } |
245 | 245 | |
246 | +/** |
|
247 | + * @param integer $lvl |
|
248 | + */ |
|
246 | 249 | function debug ($debugmsg, $lvl=E_USER_NOTICE) { |
247 | 250 | trigger_error("MagpieRSS [debug] $debugmsg", $lvl); |
248 | 251 | } |
@@ -289,6 +292,9 @@ discard block |
||
289 | 292 | Input: an HTTP response object (see Snoopy) |
290 | 293 | Output: parsed RSS object (see rss_parse) |
291 | 294 | \*=======================================================================*/ |
295 | +/** |
|
296 | + * @param Snoopy $resp |
|
297 | + */ |
|
292 | 298 | function _response_to_rss ($resp) { |
293 | 299 | $rss = new MagpieRSS( $resp->results, MAGPIE_OUTPUT_ENCODING, MAGPIE_INPUT_ENCODING, MAGPIE_DETECT_ENCODING ); |
294 | 300 |
@@ -48,6 +48,9 @@ discard block |
||
48 | 48 | Input: url from wich the rss file was fetched |
49 | 49 | Output: true on sucess |
50 | 50 | \*=======================================================================*/ |
51 | + /** |
|
52 | + * @param string $url |
|
53 | + */ |
|
51 | 54 | function set ($url, $rss) { |
52 | 55 | $this->ERROR = ""; |
53 | 56 | $cache_file = $this->file_name( $url ); |
@@ -74,6 +77,9 @@ discard block |
||
74 | 77 | Input: url from wich the rss file was fetched |
75 | 78 | Output: cached object on HIT, false on MISS |
76 | 79 | \*=======================================================================*/ |
80 | + /** |
|
81 | + * @param string $url |
|
82 | + */ |
|
77 | 83 | function get ($url) { |
78 | 84 | $this->ERROR = ""; |
79 | 85 | $cache_file = $this->file_name( $url ); |
@@ -110,6 +116,9 @@ discard block |
||
110 | 116 | Input: url from wich the rss file was fetched |
111 | 117 | Output: cached object on HIT, false on MISS |
112 | 118 | \*=======================================================================*/ |
119 | + /** |
|
120 | + * @param string $url |
|
121 | + */ |
|
113 | 122 | function check_cache ( $url ) { |
114 | 123 | $this->ERROR = ""; |
115 | 124 | $filename = $this->file_name( $url ); |
@@ -156,6 +165,9 @@ discard block |
||
156 | 165 | /*=======================================================================*\ |
157 | 166 | Function: unserialize |
158 | 167 | \*=======================================================================*/ |
168 | + /** |
|
169 | + * @param string $data |
|
170 | + */ |
|
159 | 171 | function unserialize ( $data ) { |
160 | 172 | return unserialize( $data ); |
161 | 173 | } |
@@ -515,6 +515,9 @@ discard block |
||
515 | 515 | $this->setDroptables(false); |
516 | 516 | } |
517 | 517 | |
518 | + /** |
|
519 | + * @param boolean $state |
|
520 | + */ |
|
518 | 521 | public function setDroptables($state) |
519 | 522 | { |
520 | 523 | $this->_isDroptables = $state; |
@@ -722,6 +725,9 @@ discard block |
||
722 | 725 | $_SESSION['result_msg'] = $result_code; |
723 | 726 | } |
724 | 727 | |
728 | +/** |
|
729 | + * @param string $dumpstring |
|
730 | + */ |
|
725 | 731 | function dumpSql(&$dumpstring) |
726 | 732 | { |
727 | 733 | global $modx; |
@@ -741,6 +747,9 @@ discard block |
||
741 | 747 | return true; |
742 | 748 | } |
743 | 749 | |
750 | +/** |
|
751 | + * @param string $dumpstring |
|
752 | + */ |
|
744 | 753 | function snapshot(&$dumpstring) |
745 | 754 | { |
746 | 755 | global $path; |
@@ -33,6 +33,10 @@ |
||
33 | 33 | } |
34 | 34 | |
35 | 35 | if( ! function_exists('parse')) { |
36 | + |
|
37 | + /** |
|
38 | + * @param string $src |
|
39 | + */ |
|
36 | 40 | function parse($src, $ph, $left = '[+', $right = '+]') |
37 | 41 | { |
38 | 42 | foreach ($ph as $k => $v) { |
@@ -18,6 +18,7 @@ |
||
18 | 18 | /** |
19 | 19 | * get_langs_by_key |
20 | 20 | * |
21 | + * @param string $key |
|
21 | 22 | * @return array of languages that define the key in their file |
22 | 23 | */ |
23 | 24 | function get_langs_by_key($key) { |
@@ -6,6 +6,9 @@ |
||
6 | 6 | { |
7 | 7 | } |
8 | 8 | |
9 | + /** |
|
10 | + * @param integer $flags |
|
11 | + */ |
|
9 | 12 | function htmlspecialchars($str='', $flags = ENT_COMPAT, $encode='') |
10 | 13 | { |
11 | 14 | global $modx; |
@@ -72,6 +72,9 @@ discard block |
||
72 | 72 | */ |
73 | 73 | public $cdelim; |
74 | 74 | |
75 | + /** |
|
76 | + * @param null|string $id |
|
77 | + */ |
|
75 | 78 | public function __construct($id, $ds, $pageSize = 20, $pageNumber = -1) { |
76 | 79 | global $__DataGridCnt; |
77 | 80 | |
@@ -207,6 +210,9 @@ discard block |
||
207 | 210 | |
208 | 211 | // format column values |
209 | 212 | |
213 | + /** |
|
214 | + * @param integer $n |
|
215 | + */ |
|
210 | 216 | public function RenderRowFnc($n, $row) { |
211 | 217 | if($this->_alt == 0) { |
212 | 218 | $Style = $this->_itemStyle; |
@@ -31,6 +31,9 @@ discard block |
||
31 | 31 | public $renderPagerFnc; |
32 | 32 | public $renderPagerFncArgs; |
33 | 33 | |
34 | + /** |
|
35 | + * @param boolean|string $id |
|
36 | + */ |
|
34 | 37 | public function __construct($id, $ds, $pageSize = 10, $pageNumber = -1) { |
35 | 38 | global $_PAGE; // use view state object |
36 | 39 | |
@@ -77,6 +80,9 @@ discard block |
||
77 | 80 | $this->pageSize = $ps; |
78 | 81 | } |
79 | 82 | |
83 | + /** |
|
84 | + * @param DataGrid $fncName |
|
85 | + */ |
|
80 | 86 | public function setRenderRowFnc($fncName, $args = "") { |
81 | 87 | $this->renderRowFnc = &$fncName; |
82 | 88 | $this->renderRowFncArgs = $args; // extra agruments |
@@ -256,7 +256,7 @@ discard block |
||
256 | 256 | * MODX_MANAGER_PATH."includes/extenders/ex_{$extname}.inc.php" |
257 | 257 | * $extname - extension name in lowercase |
258 | 258 | * |
259 | - * @param $extname |
|
259 | + * @param string $extname |
|
260 | 260 | * @param bool $reload |
261 | 261 | * @return bool |
262 | 262 | */ |
@@ -299,7 +299,7 @@ discard block |
||
299 | 299 | * @param int $count_attempts |
300 | 300 | * @param string $type $type |
301 | 301 | * @param string $responseCode |
302 | - * @return bool |
|
302 | + * @return false|null |
|
303 | 303 | * @global string $base_url |
304 | 304 | * @global string $site_url |
305 | 305 | */ |
@@ -999,7 +999,7 @@ discard block |
||
999 | 999 | } |
1000 | 1000 | |
1001 | 1001 | /** |
1002 | - * @param $contents |
|
1002 | + * @param string $contents |
|
1003 | 1003 | * @return mixed |
1004 | 1004 | */ |
1005 | 1005 | public function RecoveryEscapedTags($contents) |
@@ -1023,7 +1023,7 @@ discard block |
||
1023 | 1023 | } |
1024 | 1024 | |
1025 | 1025 | /** |
1026 | - * @param $tstart |
|
1026 | + * @param double $tstart |
|
1027 | 1027 | * @return array |
1028 | 1028 | */ |
1029 | 1029 | public function getTimerStats($tstart) |
@@ -1775,7 +1775,7 @@ discard block |
||
1775 | 1775 | |
1776 | 1776 | /** |
1777 | 1777 | * Remove Comment-Tags from output like <!--@- Comment -@--> |
1778 | - * @param $content |
|
1778 | + * @param string $content |
|
1779 | 1779 | * @param string $left |
1780 | 1780 | * @param string $right |
1781 | 1781 | * @return mixed |
@@ -1948,7 +1948,7 @@ discard block |
||
1948 | 1948 | /** |
1949 | 1949 | * Run snippets as per the tags in $documentSource and replace the tags with the returned values. |
1950 | 1950 | * |
1951 | - * @param $content |
|
1951 | + * @param string $content |
|
1952 | 1952 | * @return string |
1953 | 1953 | * @internal param string $documentSource |
1954 | 1954 | */ |
@@ -2980,7 +2980,7 @@ discard block |
||
2980 | 2980 | |
2981 | 2981 | /** |
2982 | 2982 | * @param $templateID |
2983 | - * @return mixed |
|
2983 | + * @return string |
|
2984 | 2984 | */ |
2985 | 2985 | public function _getTemplateCodeFromDB($templateID) |
2986 | 2986 | { |
@@ -3021,9 +3021,9 @@ discard block |
||
3021 | 3021 | } |
3022 | 3022 | |
3023 | 3023 | /** |
3024 | - * @param $id |
|
3024 | + * @param integer $id |
|
3025 | 3025 | * @param int $top |
3026 | - * @return mixed |
|
3026 | + * @return string |
|
3027 | 3027 | */ |
3028 | 3028 | public function getUltimateParentId($id, $top = 0) |
3029 | 3029 | { |
@@ -3354,7 +3354,7 @@ discard block |
||
3354 | 3354 | * |
3355 | 3355 | * @param int $type Types: 1=template, 2=tv, 3=chunk, 4=snippet, 5=plugin, 6=module, 7=resource, 8=role |
3356 | 3356 | * @param int $id Element- / Resource-id |
3357 | - * @return bool |
|
3357 | + * @return false|null |
|
3358 | 3358 | */ |
3359 | 3359 | public function lockElement($type, $id) |
3360 | 3360 | { |
@@ -3376,7 +3376,7 @@ discard block |
||
3376 | 3376 | * @param int $type Types: 1=template, 2=tv, 3=chunk, 4=snippet, 5=plugin, 6=module, 7=resource, 8=role |
3377 | 3377 | * @param int $id Element- / Resource-id |
3378 | 3378 | * @param bool $includeAllUsers true = Deletes not only own user-locks |
3379 | - * @return bool |
|
3379 | + * @return false|null |
|
3380 | 3380 | */ |
3381 | 3381 | public function unlockElement($type, $id, $includeAllUsers = false) |
3382 | 3382 | { |
@@ -3484,7 +3484,7 @@ discard block |
||
3484 | 3484 | * @param array $params |
3485 | 3485 | * @param string $msg |
3486 | 3486 | * @param array $files |
3487 | - * @return mixed |
|
3487 | + * @return boolean |
|
3488 | 3488 | */ |
3489 | 3489 | public function sendmail($params = array(), $msg = '', $files = array()) |
3490 | 3490 | { |
@@ -3980,7 +3980,7 @@ discard block |
||
3980 | 3980 | * |
3981 | 3981 | * @param string $type |
3982 | 3982 | * @param bool $report |
3983 | - * @return bool |
|
3983 | + * @return boolean|null |
|
3984 | 3984 | */ |
3985 | 3985 | public function clearCache($type = '', $report = false) |
3986 | 3986 | { |
@@ -5024,7 +5024,7 @@ discard block |
||
5024 | 5024 | * Returns a record for the web user |
5025 | 5025 | * |
5026 | 5026 | * @param int $uid |
5027 | - * @return boolean|string |
|
5027 | + * @return boolean|null |
|
5028 | 5028 | */ |
5029 | 5029 | public function getWebUserInfo($uid) |
5030 | 5030 | { |
@@ -5322,7 +5322,7 @@ discard block |
||
5322 | 5322 | * Remove event listener - only for use within the current execution cycle |
5323 | 5323 | * |
5324 | 5324 | * @param string $evtName |
5325 | - * @return boolean |
|
5325 | + * @return false|null |
|
5326 | 5326 | */ |
5327 | 5327 | public function removeEventListener($evtName) |
5328 | 5328 | { |
@@ -5346,7 +5346,7 @@ discard block |
||
5346 | 5346 | * |
5347 | 5347 | * @param string $evtName |
5348 | 5348 | * @param array $extParams Parameters available to plugins. Each array key will be the PHP variable name, and the array value will be the variable value. |
5349 | - * @return boolean|array |
|
5349 | + * @return false|null |
|
5350 | 5350 | */ |
5351 | 5351 | public function invokeEvent($evtName, $extParams = array()) |
5352 | 5352 | { |
@@ -5767,7 +5767,7 @@ discard block |
||
5767 | 5767 | |
5768 | 5768 | /** |
5769 | 5769 | * @param string $string |
5770 | - * @return mixed|string |
|
5770 | + * @return string |
|
5771 | 5771 | */ |
5772 | 5772 | public function removeSanitizeSeed($string = '') |
5773 | 5773 | { |
@@ -5782,7 +5782,7 @@ discard block |
||
5782 | 5782 | |
5783 | 5783 | /** |
5784 | 5784 | * @param string $content |
5785 | - * @return mixed|string |
|
5785 | + * @return string |
|
5786 | 5786 | */ |
5787 | 5787 | public function cleanUpMODXTags($content = '') |
5788 | 5788 | { |
@@ -5945,7 +5945,7 @@ discard block |
||
5945 | 5945 | |
5946 | 5946 | /** |
5947 | 5947 | * @param string $str |
5948 | - * @return bool|mixed|string |
|
5948 | + * @return string |
|
5949 | 5949 | */ |
5950 | 5950 | public function atBindFileContent($str = '') |
5951 | 5951 | { |
@@ -5996,8 +5996,8 @@ discard block |
||
5996 | 5996 | } |
5997 | 5997 | |
5998 | 5998 | /** |
5999 | - * @param $str |
|
6000 | - * @return bool|string |
|
5999 | + * @param string $str |
|
6000 | + * @return false|string |
|
6001 | 6001 | */ |
6002 | 6002 | public function getExtFromFilename($str) |
6003 | 6003 | { |
@@ -6025,7 +6025,7 @@ discard block |
||
6025 | 6025 | * @param string $text Error message |
6026 | 6026 | * @param string $file File where the error was detected |
6027 | 6027 | * @param string $line Line number within $file |
6028 | - * @return boolean |
|
6028 | + * @return boolean|null |
|
6029 | 6029 | */ |
6030 | 6030 | public function phpError($nr, $text, $file, $line) |
6031 | 6031 | { |
@@ -6077,7 +6077,7 @@ discard block |
||
6077 | 6077 | * @param string $text |
6078 | 6078 | * @param string $line |
6079 | 6079 | * @param string $output |
6080 | - * @return bool |
|
6080 | + * @return null|boolean |
|
6081 | 6081 | */ |
6082 | 6082 | public function messageQuit($msg = 'unspecified error', $query = '', $is_error = true, $nr = '', $file = '', $source = '', $text = '', $line = '', $output = '') |
6083 | 6083 | { |
@@ -6499,7 +6499,7 @@ discard block |
||
6499 | 6499 | |
6500 | 6500 | /** |
6501 | 6501 | * @param string $str |
6502 | - * @return bool|mixed|string |
|
6502 | + * @return string |
|
6503 | 6503 | */ |
6504 | 6504 | public function atBindInclude($str = '') |
6505 | 6505 | { |
@@ -6550,7 +6550,7 @@ discard block |
||
6550 | 6550 | * @param $str |
6551 | 6551 | * @param int $flags |
6552 | 6552 | * @param string $encode |
6553 | - * @return mixed |
|
6553 | + * @return string |
|
6554 | 6554 | */ |
6555 | 6555 | public function htmlspecialchars($str, $flags = ENT_COMPAT, $encode = '') |
6556 | 6556 | { |
@@ -6559,7 +6559,7 @@ discard block |
||
6559 | 6559 | } |
6560 | 6560 | |
6561 | 6561 | /** |
6562 | - * @param $string |
|
6562 | + * @param string $string |
|
6563 | 6563 | * @param bool $returnData |
6564 | 6564 | * @return bool|mixed |
6565 | 6565 | */ |