@@ -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 | */ |