@@ -24,6 +24,9 @@ discard block |
||
24 | 24 | return isset( $args['arguments'] ) ? json_decode( $args['arguments'] ) : array(); |
25 | 25 | } |
26 | 26 | |
27 | + /** |
|
28 | + * @param double $gmt_time |
|
29 | + */ |
|
27 | 30 | protected function is_cron_locked( $gmt_time ) { |
28 | 31 | // The cron lock: a unix timestamp from when the cron was spawned. |
29 | 32 | $doing_cron_transient = $this->get_cron_lock(); |
@@ -33,6 +36,9 @@ discard block |
||
33 | 36 | return $doing_cron_transient; |
34 | 37 | } |
35 | 38 | |
39 | + /** |
|
40 | + * @param string $doing_wp_cron |
|
41 | + */ |
|
36 | 42 | protected function maybe_unlock_cron( $doing_wp_cron ) { |
37 | 43 | if ( $this->get_cron_lock() == $doing_wp_cron ) { |
38 | 44 | delete_transient( 'doing_cron' ); |
@@ -170,6 +170,9 @@ |
||
170 | 170 | } |
171 | 171 | |
172 | 172 | |
173 | + /** |
|
174 | + * @param string $plugin |
|
175 | + */ |
|
173 | 176 | protected function validate_plugin( $plugin ) { |
174 | 177 | if ( ! isset( $plugin) || empty( $plugin ) ) { |
175 | 178 | return new WP_Error( 'missing_plugin', __( 'You are required to specify a plugin to activate.', 'jetpack' ), 400 ); |
@@ -244,6 +244,9 @@ |
||
244 | 244 | } |
245 | 245 | } |
246 | 246 | |
247 | + /** |
|
248 | + * @param string $capability |
|
249 | + */ |
|
247 | 250 | protected function current_user_can( $capability, $plugin = null ) { |
248 | 251 | if ( $plugin ) { |
249 | 252 | return current_user_can( $capability, $plugin ); |
@@ -228,6 +228,9 @@ |
||
228 | 228 | ); |
229 | 229 | } |
230 | 230 | |
231 | + /** |
|
232 | + * @param Queue $queue |
|
233 | + */ |
|
231 | 234 | protected function get_buffer( $queue, $number_of_items ) { |
232 | 235 | $start = time(); |
233 | 236 | $max_duration = 5; // this will try to get the buffer |
@@ -129,6 +129,9 @@ discard block |
||
129 | 129 | return apply_filters( 'jp_carousel_load_for_images_linked_to_file', false ); |
130 | 130 | } |
131 | 131 | |
132 | + /** |
|
133 | + * @param string $version |
|
134 | + */ |
|
132 | 135 | function asset_version( $version ) { |
133 | 136 | /** |
134 | 137 | * Filter the version string used when enqueuing Carousel assets. |
@@ -511,6 +514,9 @@ discard block |
||
511 | 514 | return $attr; |
512 | 515 | } |
513 | 516 | |
517 | + /** |
|
518 | + * @param string $html |
|
519 | + */ |
|
514 | 520 | function add_data_to_container( $html ) { |
515 | 521 | global $post; |
516 | 522 | if ( |
@@ -757,6 +763,9 @@ discard block |
||
757 | 763 | return ( 1 == $value ) ? 1 : 0; |
758 | 764 | } |
759 | 765 | |
766 | + /** |
|
767 | + * @param string $name |
|
768 | + */ |
|
760 | 769 | function settings_checkbox( $name, $label_text, $extra_text = '', $default_to_checked = true ) { |
761 | 770 | if ( empty( $name ) ) { |
762 | 771 | return; |
@@ -772,6 +781,9 @@ discard block |
||
772 | 781 | echo '</fieldset>'; |
773 | 782 | } |
774 | 783 | |
784 | + /** |
|
785 | + * @param string $name |
|
786 | + */ |
|
775 | 787 | function settings_select( $name, $values, $extra_text = '' ) { |
776 | 788 | if ( empty( $name ) || ! is_array( $values ) || empty( $values ) ) { |
777 | 789 | return; |
@@ -289,7 +289,7 @@ discard block |
||
289 | 289 | * Get the value of a setting. |
290 | 290 | * @param string $setting |
291 | 291 | * @access public |
292 | - * @return mixed |
|
292 | + * @return string |
|
293 | 293 | * @version 1.0 |
294 | 294 | */ |
295 | 295 | function get_cfg($setting) { |
@@ -358,7 +358,7 @@ discard block |
||
358 | 358 | |
359 | 359 | /** |
360 | 360 | * Adds a token to $this->tokens |
361 | - * @param mixed $type |
|
361 | + * @param integer $type |
|
362 | 362 | * @param string $data |
363 | 363 | * @param bool $do add a token even if preserve_css is off |
364 | 364 | * @access private |
@@ -1189,6 +1189,7 @@ discard block |
||
1189 | 1189 | * format("abc, def, ghi") => format("abc, def, ghi") |
1190 | 1190 | * |
1191 | 1191 | * @param string |
1192 | + * @param string $value |
|
1192 | 1193 | * @return array |
1193 | 1194 | */ |
1194 | 1195 |
@@ -38,6 +38,9 @@ |
||
38 | 38 | /* ctype_alpha Check for alphabetic character(s) */ |
39 | 39 | if (!function_exists('ctype_alpha')) { |
40 | 40 | |
41 | + /** |
|
42 | + * @param string $text |
|
43 | + */ |
|
41 | 44 | function ctype_alpha($text) { |
42 | 45 | return preg_match("/[a-zA-Z]/", $text); |
43 | 46 | } |
@@ -1404,7 +1404,7 @@ |
||
1404 | 1404 | /** |
1405 | 1405 | * Migration routine for moving safecss from wp_options to wp_posts to support revisions |
1406 | 1406 | * |
1407 | - * @return void |
|
1407 | + * @return false|null |
|
1408 | 1408 | */ |
1409 | 1409 | static function upgrade() { |
1410 | 1410 | $css = get_option( 'safecss' ); |
@@ -77,6 +77,9 @@ discard block |
||
77 | 77 | return null; |
78 | 78 | } |
79 | 79 | |
80 | + /** |
|
81 | + * @param string $name |
|
82 | + */ |
|
80 | 83 | protected function fileExists($name) { |
81 | 84 | return is_file($name); |
82 | 85 | } |
@@ -260,6 +263,9 @@ discard block |
||
260 | 263 | return $scope; |
261 | 264 | } |
262 | 265 | |
266 | + /** |
|
267 | + * @param string[] $selectors |
|
268 | + */ |
|
263 | 269 | protected function compileNestedBlock($block, $selectors) { |
264 | 270 | $this->pushEnv($block); |
265 | 271 | $this->scope = $this->makeOutputBlock($block->type, $selectors); |
@@ -278,6 +284,9 @@ discard block |
||
278 | 284 | $this->popEnv(); |
279 | 285 | } |
280 | 286 | |
287 | + /** |
|
288 | + * @param stdClass $out |
|
289 | + */ |
|
281 | 290 | protected function compileProps($block, $out) { |
282 | 291 | foreach ($this->sortProps($block->props) as $prop) { |
283 | 292 | $this->compileProp($prop, $block, $out); |
@@ -388,6 +397,9 @@ discard block |
||
388 | 397 | return $out; |
389 | 398 | } |
390 | 399 | |
400 | + /** |
|
401 | + * @param stdClass $env |
|
402 | + */ |
|
391 | 403 | protected function multiplyMedia($env, $childQueries = null) { |
392 | 404 | if (is_null($env) || |
393 | 405 | !empty($env->block->type) && $env->block->type != "media") |
@@ -1288,6 +1300,9 @@ discard block |
||
1288 | 1300 | $this->throwError($error); |
1289 | 1301 | } |
1290 | 1302 | |
1303 | + /** |
|
1304 | + * @param integer $expectedArgs |
|
1305 | + */ |
|
1291 | 1306 | public function assertArgs($value, $expectedArgs, $name="") { |
1292 | 1307 | if ($expectedArgs == 1) { |
1293 | 1308 | return $value; |
@@ -1342,6 +1357,11 @@ discard block |
||
1342 | 1357 | return $out; |
1343 | 1358 | } |
1344 | 1359 | |
1360 | + /** |
|
1361 | + * @param double $comp |
|
1362 | + * @param double $temp1 |
|
1363 | + * @param double $temp2 |
|
1364 | + */ |
|
1345 | 1365 | protected function toRGB_helper($comp, $temp1, $temp2) { |
1346 | 1366 | if ($comp < 0) $comp += 1.0; |
1347 | 1367 | elseif ($comp > 1) $comp -= 1.0; |
@@ -2317,6 +2337,9 @@ discard block |
||
2317 | 2337 | // caches preg escaped literals |
2318 | 2338 | static protected $literalCache = array(); |
2319 | 2339 | |
2340 | + /** |
|
2341 | + * @param lessc $lessc |
|
2342 | + */ |
|
2320 | 2343 | public function __construct($lessc, $sourceName = null) { |
2321 | 2344 | $this->eatWhiteDefault = true; |
2322 | 2345 | // reference to less needed for vPrefix, mPrefix, and parentSelector |
@@ -2617,6 +2640,7 @@ discard block |
||
2617 | 2640 | |
2618 | 2641 | /** |
2619 | 2642 | * recursively parse infix equation with $lhs at precedence $minP |
2643 | + * @param integer $minP |
|
2620 | 2644 | */ |
2621 | 2645 | protected function expHelper($lhs, $minP) { |
2622 | 2646 | $this->inExp = true; |
@@ -2843,6 +2867,11 @@ discard block |
||
2843 | 2867 | } |
2844 | 2868 | |
2845 | 2869 | // an unbounded string stopped by $end |
2870 | + |
|
2871 | + /** |
|
2872 | + * @param string $end |
|
2873 | + * @param string[] $rejectStrs |
|
2874 | + */ |
|
2846 | 2875 | protected function openString($end, &$out, $nestingOpen=null, $rejectStrs = null) { |
2847 | 2876 | $oldWhite = $this->eatWhiteDefault; |
2848 | 2877 | $this->eatWhiteDefault = false; |
@@ -3423,6 +3452,9 @@ discard block |
||
3423 | 3452 | |
3424 | 3453 | /* raw parsing functions */ |
3425 | 3454 | |
3455 | + /** |
|
3456 | + * @param boolean $eatWhitespace |
|
3457 | + */ |
|
3426 | 3458 | protected function literal($what, $eatWhitespace = null) { |
3427 | 3459 | if ($eatWhitespace === null) $eatWhitespace = $this->eatWhiteDefault; |
3428 | 3460 | |
@@ -3446,6 +3478,9 @@ discard block |
||
3446 | 3478 | return $this->match(self::$literalCache[$what], $m, $eatWhitespace); |
3447 | 3479 | } |
3448 | 3480 | |
3481 | + /** |
|
3482 | + * @param string $parseItem |
|
3483 | + */ |
|
3449 | 3484 | protected function genericList(&$out, $parseItem, $delim="", $flatten=true) { |
3450 | 3485 | $s = $this->seek(); |
3451 | 3486 | $items = array(); |
@@ -3519,6 +3554,10 @@ discard block |
||
3519 | 3554 | } |
3520 | 3555 | |
3521 | 3556 | // match something without consuming it |
3557 | + |
|
3558 | + /** |
|
3559 | + * @param string $regex |
|
3560 | + */ |
|
3522 | 3561 | protected function peek($regex, &$out = null, $from=null) { |
3523 | 3562 | if (is_null($from)) $from = $this->count; |
3524 | 3563 | $r = '/'.$regex.'/Ais'; |
@@ -3574,6 +3613,10 @@ discard block |
||
3574 | 3613 | } |
3575 | 3614 | |
3576 | 3615 | // push a block that doesn't multiply tags |
3616 | + |
|
3617 | + /** |
|
3618 | + * @param string $type |
|
3619 | + */ |
|
3577 | 3620 | protected function pushSpecialBlock($type) { |
3578 | 3621 | return $this->pushBlock(null, $type); |
3579 | 3622 | } |