@@ -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 | } |