@@ -183,7 +183,6 @@ |
||
183 | 183 | /** |
184 | 184 | * Record an event in Tracks - this is the preferred way to record events from PHP. |
185 | 185 | * |
186 | - * @param mixed $identity username, user_id, or WP_user object |
|
187 | 186 | * @param string $event_name The name of the event |
188 | 187 | * @param array $properties Custom properties to send with the event |
189 | 188 | * @param int $event_timestamp_millis The time in millis since 1970-01-01 00:00:00 when the event occurred |
@@ -295,7 +295,7 @@ |
||
295 | 295 | * @access private |
296 | 296 | * |
297 | 297 | * @param string $status Comment status. |
298 | - * @return string|bool New comment_approved value, false if the status doesn't affect it. |
|
298 | + * @return string|false New comment_approved value, false if the status doesn't affect it. |
|
299 | 299 | */ |
300 | 300 | private function comment_status_to_approval_value( $status ) { |
301 | 301 | switch ( $status ) { |
@@ -20,6 +20,7 @@ discard block |
||
20 | 20 | * Empty and reset the replicastore. |
21 | 21 | * |
22 | 22 | * @access public |
23 | + * @return void |
|
23 | 24 | */ |
24 | 25 | public function reset(); |
25 | 26 | |
@@ -29,6 +30,7 @@ discard block |
||
29 | 30 | * @access public |
30 | 31 | * |
31 | 32 | * @param array $config Full sync configuration for this sync module. |
33 | + * @return void |
|
32 | 34 | */ |
33 | 35 | public function full_sync_start( $config ); |
34 | 36 | |
@@ -38,6 +40,7 @@ discard block |
||
38 | 40 | * @access public |
39 | 41 | * |
40 | 42 | * @param string $checksum Deprecated since 7.3.0. |
43 | + * @return void |
|
41 | 44 | */ |
42 | 45 | public function full_sync_end( $checksum ); |
43 | 46 | |
@@ -51,6 +54,7 @@ discard block |
||
51 | 54 | * @param string $status Post status. |
52 | 55 | * @param int $min_id Minimum post ID. |
53 | 56 | * @param int $max_id Maximum post ID. |
57 | + * @return integer |
|
54 | 58 | */ |
55 | 59 | public function post_count( $status = null, $min_id = null, $max_id = null ); |
56 | 60 | |
@@ -81,6 +85,7 @@ discard block |
||
81 | 85 | * |
82 | 86 | * @param \WP_Post $post Post object. |
83 | 87 | * @param bool $silent Whether to perform a silent action. |
88 | + * @return void |
|
84 | 89 | */ |
85 | 90 | public function upsert_post( $post, $silent = false ); |
86 | 91 | |
@@ -90,6 +95,7 @@ discard block |
||
90 | 95 | * @access public |
91 | 96 | * |
92 | 97 | * @param int $post_id Post ID. |
98 | + * @return void |
|
93 | 99 | */ |
94 | 100 | public function delete_post( $post_id ); |
95 | 101 | |
@@ -121,6 +127,7 @@ discard block |
||
121 | 127 | * @param string $status Comment status. |
122 | 128 | * @param int $min_id Minimum comment ID. |
123 | 129 | * @param int $max_id Maximum comment ID. |
130 | + * @return integer |
|
124 | 131 | */ |
125 | 132 | public function comment_count( $status = null, $min_id = null, $max_id = null ); |
126 | 133 | |
@@ -150,6 +157,7 @@ discard block |
||
150 | 157 | * @access public |
151 | 158 | * |
152 | 159 | * @param \WP_Comment $comment Comment object. |
160 | + * @return void |
|
153 | 161 | */ |
154 | 162 | public function upsert_comment( $comment ); |
155 | 163 | |
@@ -159,6 +167,7 @@ discard block |
||
159 | 167 | * @access public |
160 | 168 | * |
161 | 169 | * @param int $comment_id Comment ID. |
170 | + * @return void |
|
162 | 171 | */ |
163 | 172 | public function trash_comment( $comment_id ); |
164 | 173 | |
@@ -168,6 +177,7 @@ discard block |
||
168 | 177 | * @access public |
169 | 178 | * |
170 | 179 | * @param int $comment_id Comment ID. |
180 | + * @return void |
|
171 | 181 | */ |
172 | 182 | public function spam_comment( $comment_id ); |
173 | 183 | |
@@ -177,6 +187,7 @@ discard block |
||
177 | 187 | * @access public |
178 | 188 | * |
179 | 189 | * @param int $comment_id Comment ID. |
190 | + * @return void |
|
180 | 191 | */ |
181 | 192 | public function delete_comment( $comment_id ); |
182 | 193 | |
@@ -187,6 +198,7 @@ discard block |
||
187 | 198 | * |
188 | 199 | * @param int $post_id Post ID. |
189 | 200 | * @param array $statuses Post statuses. |
201 | + * @return void |
|
190 | 202 | */ |
191 | 203 | public function trashed_post_comments( $post_id, $statuses ); |
192 | 204 | |
@@ -196,6 +208,7 @@ discard block |
||
196 | 208 | * @access public |
197 | 209 | * |
198 | 210 | * @param int $post_id Post ID. |
211 | + * @return void |
|
199 | 212 | */ |
200 | 213 | public function untrashed_post_comments( $post_id ); |
201 | 214 | |
@@ -226,6 +239,7 @@ discard block |
||
226 | 239 | * |
227 | 240 | * @param string $option Option name. |
228 | 241 | * @param mixed $value Option value. |
242 | + * @return boolean |
|
229 | 243 | */ |
230 | 244 | public function update_option( $option, $value ); |
231 | 245 | |
@@ -245,6 +259,7 @@ discard block |
||
245 | 259 | * @access public |
246 | 260 | * |
247 | 261 | * @param string $option Name of option to remove. |
262 | + * @return boolean |
|
248 | 263 | */ |
249 | 264 | public function delete_option( $option ); |
250 | 265 | |
@@ -254,6 +269,7 @@ discard block |
||
254 | 269 | * @access public |
255 | 270 | * |
256 | 271 | * @param array $theme_support Features that the theme supports. |
272 | + * @return void |
|
257 | 273 | */ |
258 | 274 | public function set_theme_support( $theme_support ); |
259 | 275 | |
@@ -288,6 +304,7 @@ discard block |
||
288 | 304 | * @param string $meta_key Meta key. |
289 | 305 | * @param mixed $meta_value Meta value. |
290 | 306 | * @param int $meta_id ID of the meta. |
307 | + * @return boolean |
|
291 | 308 | */ |
292 | 309 | public function upsert_metadata( $type, $object_id, $meta_key, $meta_value, $meta_id ); |
293 | 310 | |
@@ -299,6 +316,7 @@ discard block |
||
299 | 316 | * @param string $type Meta type. |
300 | 317 | * @param int $object_id ID of the object. |
301 | 318 | * @param array $meta_ids IDs of the meta objects to delete. |
319 | + * @return false|null |
|
302 | 320 | */ |
303 | 321 | public function delete_metadata( $type, $object_id, $meta_ids ); |
304 | 322 | |
@@ -310,6 +328,7 @@ discard block |
||
310 | 328 | * @param string $type Meta type. |
311 | 329 | * @param array $object_ids IDs of the objects. |
312 | 330 | * @param string $meta_key Meta key. |
331 | + * @return false|null |
|
313 | 332 | */ |
314 | 333 | public function delete_batch_metadata( $type, $object_ids, $meta_key ); |
315 | 334 | |
@@ -329,6 +348,7 @@ discard block |
||
329 | 348 | * |
330 | 349 | * @param string $constant Name of constant to retrieve. |
331 | 350 | * @param mixed $value Value set for the constant. |
351 | + * @return void |
|
332 | 352 | */ |
333 | 353 | public function set_constant( $constant, $value ); |
334 | 354 | |
@@ -339,6 +359,7 @@ discard block |
||
339 | 359 | * @access public |
340 | 360 | * |
341 | 361 | * @param string $type Type of updates to retrieve. |
362 | + * @return integer|null |
|
342 | 363 | */ |
343 | 364 | public function get_updates( $type ); |
344 | 365 | |
@@ -350,6 +371,7 @@ discard block |
||
350 | 371 | * |
351 | 372 | * @param string $type Type of updates to set. |
352 | 373 | * @param int $updates Total number of updates. |
374 | + * @return void |
|
353 | 375 | */ |
354 | 376 | public function set_updates( $type, $updates ); |
355 | 377 | |
@@ -369,6 +391,7 @@ discard block |
||
369 | 391 | * |
370 | 392 | * @param string $callable Callable name. |
371 | 393 | * @param mixed $value Callable value. |
394 | + * @return void |
|
372 | 395 | */ |
373 | 396 | public function set_callable( $callable, $value ); |
374 | 397 | |
@@ -388,6 +411,7 @@ discard block |
||
388 | 411 | * |
389 | 412 | * @param string $option Network option name. |
390 | 413 | * @param mixed $value Network option value. |
414 | + * @return boolean |
|
391 | 415 | */ |
392 | 416 | public function update_site_option( $option, $value ); |
393 | 417 | |
@@ -397,6 +421,7 @@ discard block |
||
397 | 421 | * @access public |
398 | 422 | * |
399 | 423 | * @param string $option Name of option to remove. |
424 | + * @return boolean |
|
400 | 425 | */ |
401 | 426 | public function delete_site_option( $option ); |
402 | 427 | |
@@ -458,6 +483,7 @@ discard block |
||
458 | 483 | * @param string $taxonomy The context in which to relate the term to the object. |
459 | 484 | * @param string|int|array $terms A single term slug, single term id, or array of either term slugs or ids. |
460 | 485 | * @param bool $append Optional. If false will delete difference of terms. Default false. |
486 | + * @return void |
|
461 | 487 | */ |
462 | 488 | public function update_object_terms( $object_id, $taxonomy, $terms, $append ); |
463 | 489 | |
@@ -470,6 +496,7 @@ discard block |
||
470 | 496 | * |
471 | 497 | * @param int $object_id ID of the object. |
472 | 498 | * @param array $tt_ids Term taxonomy IDs. |
499 | + * @return boolean |
|
473 | 500 | */ |
474 | 501 | public function delete_object_terms( $object_id, $tt_ids ); |
475 | 502 | |
@@ -477,6 +504,7 @@ discard block |
||
477 | 504 | * Retrieve the number of users. |
478 | 505 | * |
479 | 506 | * @access public |
507 | + * @return void |
|
480 | 508 | */ |
481 | 509 | public function user_count(); |
482 | 510 | |
@@ -495,6 +523,7 @@ discard block |
||
495 | 523 | * @access public |
496 | 524 | * |
497 | 525 | * @param \WP_User $user User object. |
526 | + * @return void |
|
498 | 527 | */ |
499 | 528 | public function upsert_user( $user ); |
500 | 529 | |
@@ -504,6 +533,7 @@ discard block |
||
504 | 533 | * @access public |
505 | 534 | * |
506 | 535 | * @param int $user_id User ID. |
536 | + * @return void |
|
507 | 537 | */ |
508 | 538 | public function delete_user( $user_id ); |
509 | 539 | |
@@ -514,6 +544,7 @@ discard block |
||
514 | 544 | * |
515 | 545 | * @param int $user_id User ID. |
516 | 546 | * @param string $locale The user locale. |
547 | + * @return void |
|
517 | 548 | */ |
518 | 549 | public function upsert_user_locale( $user_id, $locale ); |
519 | 550 | |
@@ -523,6 +554,7 @@ discard block |
||
523 | 554 | * @access public |
524 | 555 | * |
525 | 556 | * @param int $user_id User ID. |
557 | + * @return void |
|
526 | 558 | */ |
527 | 559 | public function delete_user_locale( $user_id ); |
528 | 560 | |
@@ -532,6 +564,7 @@ discard block |
||
532 | 564 | * @access public |
533 | 565 | * |
534 | 566 | * @param int $user_id User ID. |
567 | + * @return string |
|
535 | 568 | */ |
536 | 569 | public function get_user_locale( $user_id ); |
537 | 570 | |
@@ -541,6 +574,7 @@ discard block |
||
541 | 574 | * @access public |
542 | 575 | * |
543 | 576 | * @param int $user_id User ID. |
577 | + * @return void |
|
544 | 578 | */ |
545 | 579 | public function get_allowed_mime_types( $user_id ); |
546 | 580 |
@@ -53,7 +53,7 @@ discard block |
||
53 | 53 | * |
54 | 54 | * @param string $object_type Type of the sync object. |
55 | 55 | * @param int $id ID of the sync object. |
56 | - * @return mixed Object, or false if the object is invalid. |
|
56 | + * @return boolean Object, or false if the object is invalid. |
|
57 | 57 | */ |
58 | 58 | public function get_object_by_id( $object_type, $id ) { |
59 | 59 | return false; |
@@ -152,8 +152,8 @@ discard block |
||
152 | 152 | * @access protected |
153 | 153 | * |
154 | 154 | * @param array $action_names Action names we're interested in. |
155 | - * @param array $actions_to_count Unfiltered list of actions we want to count. |
|
156 | - * @return array Number of actions that we're interested in. |
|
155 | + * @param string[] $actions_to_count Unfiltered list of actions we want to count. |
|
156 | + * @return integer Number of actions that we're interested in. |
|
157 | 157 | */ |
158 | 158 | protected function count_actions( $action_names, $actions_to_count ) { |
159 | 159 | return count( array_intersect( $action_names, $actions_to_count ) ); |
@@ -33,6 +33,9 @@ discard block |
||
33 | 33 | public $extra_headers = array(); |
34 | 34 | |
35 | 35 | /** |
36 | + * @param string $method |
|
37 | + * @param string $url |
|
38 | + * @param string $post_body |
|
36 | 39 | * @return WPCOM_JSON_API instance |
37 | 40 | */ |
38 | 41 | static function init( $method = null, $url = null, $post_body = null ) { |
@@ -337,6 +340,9 @@ discard block |
||
337 | 340 | return call_user_func_array( array( $endpoint, 'callback' ), $path_pieces ); |
338 | 341 | } |
339 | 342 | |
343 | + /** |
|
344 | + * @param integer $status_code |
|
345 | + */ |
|
340 | 346 | function output_early( $status_code, $response = null, $content_type = 'application/json' ) { |
341 | 347 | $exit = $this->exit; |
342 | 348 | $this->exit = false; |
@@ -545,11 +551,18 @@ discard block |
||
545 | 551 | return wp_json_encode( $data ); |
546 | 552 | } |
547 | 553 | |
554 | + /** |
|
555 | + * @param string $needle |
|
556 | + */ |
|
548 | 557 | function ends_with( $haystack, $needle ) { |
549 | 558 | return $needle === substr( $haystack, -strlen( $needle ) ); |
550 | 559 | } |
551 | 560 | |
552 | 561 | // Returns the site's blog_id in the WP.com ecosystem |
562 | + |
|
563 | + /** |
|
564 | + * @return integer |
|
565 | + */ |
|
553 | 566 | function get_blog_id_for_output() { |
554 | 567 | return $this->token_details['blog_id']; |
555 | 568 | } |
@@ -572,6 +585,10 @@ discard block |
||
572 | 585 | } |
573 | 586 | |
574 | 587 | // Returns true if the specified blog ID is a restricted blog |
588 | + |
|
589 | + /** |
|
590 | + * @param integer $blog_id |
|
591 | + */ |
|
575 | 592 | function is_restricted_blog( $blog_id ) { |
576 | 593 | /** |
577 | 594 | * Filters all REST API access and return a 403 unauthorized response for all Restricted blog IDs. |
@@ -621,7 +638,7 @@ discard block |
||
621 | 638 | /** |
622 | 639 | * Counts the number of comments on a site, excluding certain comment types. |
623 | 640 | * |
624 | - * @param $post_id int Post ID. |
|
641 | + * @param integer $post_id int Post ID. |
|
625 | 642 | * @return array Array of counts, matching the output of https://developer.wordpress.org/reference/functions/get_comment_count/. |
626 | 643 | */ |
627 | 644 | public function wp_count_comments( $post_id ) { |
@@ -783,7 +783,7 @@ discard block |
||
783 | 783 | * This is ported over from the manage module, which has been deprecated and baked in here. |
784 | 784 | * |
785 | 785 | * @param $domains |
786 | - * @return array |
|
786 | + * @return string[] |
|
787 | 787 | */ |
788 | 788 | function allow_wpcom_domain( $domains ) { |
789 | 789 | if ( empty( $domains ) ) { |
@@ -1241,7 +1241,7 @@ discard block |
||
1241 | 1241 | } |
1242 | 1242 | /** |
1243 | 1243 | * Does the network allow admins to add new users. |
1244 | - * @return boolian |
|
1244 | + * @return boolean |
|
1245 | 1245 | */ |
1246 | 1246 | static function network_add_new_users( $option = null ) { |
1247 | 1247 | return (bool) get_site_option( 'add_new_users' ); |
@@ -1346,7 +1346,7 @@ discard block |
||
1346 | 1346 | * database which could be set to anything as opposed to what this function returns. |
1347 | 1347 | * @param bool $option |
1348 | 1348 | * |
1349 | - * @return boolean |
|
1349 | + * @return string |
|
1350 | 1350 | */ |
1351 | 1351 | public function is_main_network_option( $option ) { |
1352 | 1352 | // return '1' or '' |
@@ -1357,7 +1357,7 @@ discard block |
||
1357 | 1357 | * Return true if we are with multi-site or multi-network false if we are dealing with single site. |
1358 | 1358 | * |
1359 | 1359 | * @param string $option |
1360 | - * @return boolean |
|
1360 | + * @return string |
|
1361 | 1361 | */ |
1362 | 1362 | public function is_multisite( $option ) { |
1363 | 1363 | return (string) (bool) is_multisite(); |
@@ -1419,7 +1419,7 @@ discard block |
||
1419 | 1419 | |
1420 | 1420 | /** |
1421 | 1421 | * Returns true if the site has file write access false otherwise. |
1422 | - * @return string ( '1' | '0' ) |
|
1422 | + * @return integer ( '1' | '0' ) |
|
1423 | 1423 | **/ |
1424 | 1424 | public static function file_system_write_access() { |
1425 | 1425 | if ( ! function_exists( 'get_filesystem_method' ) ) { |
@@ -2154,6 +2154,7 @@ discard block |
||
2154 | 2154 | * @param int $user_id |
2155 | 2155 | * @param string $token |
2156 | 2156 | * return bool |
2157 | + * @param boolean $is_master_user |
|
2157 | 2158 | */ |
2158 | 2159 | public static function update_user_token( $user_id, $token, $is_master_user ) { |
2159 | 2160 | // not designed for concurrent updates |
@@ -2598,7 +2599,7 @@ discard block |
||
2598 | 2599 | * |
2599 | 2600 | * @param string $tag Tag as it appears in each module heading. |
2600 | 2601 | * |
2601 | - * @return mixed |
|
2602 | + * @return string |
|
2602 | 2603 | */ |
2603 | 2604 | public static function translate_module_tag( $tag ) { |
2604 | 2605 | return jetpack_get_module_i18n_tag( $tag ); |
@@ -2770,8 +2771,8 @@ discard block |
||
2770 | 2771 | * Rewrites ABSPATH (eg `/home/jetpack/wordpress/`) to ABSPATH, and if WP_CONTENT_DIR |
2771 | 2772 | * is located outside of ABSPATH, rewrites that to WP_CONTENT_DIR. |
2772 | 2773 | * |
2773 | - * @param $string |
|
2774 | - * @return mixed |
|
2774 | + * @param string $string |
|
2775 | + * @return string|null |
|
2775 | 2776 | */ |
2776 | 2777 | public static function alias_directories( $string ) { |
2777 | 2778 | // ABSPATH has a trailing slash. |
@@ -3031,6 +3032,9 @@ discard block |
||
3031 | 3032 | return self::update_active_modules( $new ); |
3032 | 3033 | } |
3033 | 3034 | |
3035 | + /** |
|
3036 | + * @param string $module |
|
3037 | + */ |
|
3034 | 3038 | public static function enable_module_configurable( $module ) { |
3035 | 3039 | $module = Jetpack::get_module_slug( $module ); |
3036 | 3040 | add_filter( 'jetpack_module_configurable_' . $module, '__return_true' ); |
@@ -3059,6 +3063,9 @@ discard block |
||
3059 | 3063 | } |
3060 | 3064 | |
3061 | 3065 | /* Installation */ |
3066 | + /** |
|
3067 | + * @param string $message |
|
3068 | + */ |
|
3062 | 3069 | public static function bail_on_activation( $message, $deactivate = true ) { |
3063 | 3070 | ?> |
3064 | 3071 | <!doctype html> |
@@ -3774,7 +3781,7 @@ discard block |
||
3774 | 3781 | * Add help to the Jetpack page |
3775 | 3782 | * |
3776 | 3783 | * @since Jetpack (1.2.3) |
3777 | - * @return false if not the Jetpack page |
|
3784 | + * @return false|null if not the Jetpack page |
|
3778 | 3785 | */ |
3779 | 3786 | function admin_help() { |
3780 | 3787 | $current_screen = get_current_screen(); |
@@ -4505,6 +4512,9 @@ discard block |
||
4505 | 4512 | return $raw ? esc_url_raw( $url ) : esc_url( $url ); |
4506 | 4513 | } |
4507 | 4514 | |
4515 | + /** |
|
4516 | + * @return string |
|
4517 | + */ |
|
4508 | 4518 | public static function build_authorize_url( $redirect = false, $iframe = false ) { |
4509 | 4519 | if ( defined( 'JETPACK__GLOTPRESS_LOCALES_PATH' ) && include_once JETPACK__GLOTPRESS_LOCALES_PATH ) { |
4510 | 4520 | $gp_locale = GP_Locales::by_field( 'wp_locale', get_locale() ); |
@@ -4644,6 +4654,9 @@ discard block |
||
4644 | 4654 | return $url; |
4645 | 4655 | } |
4646 | 4656 | |
4657 | + /** |
|
4658 | + * @return string |
|
4659 | + */ |
|
4647 | 4660 | public static function nonce_url_no_esc( $actionurl, $action = -1, $name = '_wpnonce' ) { |
4648 | 4661 | $actionurl = str_replace( '&', '&', $actionurl ); |
4649 | 4662 | return add_query_arg( $name, wp_create_nonce( $action ), $actionurl ); |
@@ -4947,7 +4960,8 @@ discard block |
||
4947 | 4960 | * Note these tokens are unique per call, NOT static per site for connecting. |
4948 | 4961 | * |
4949 | 4962 | * @since 2.6 |
4950 | - * @return array |
|
4963 | + * @param string $action |
|
4964 | + * @return boolean |
|
4951 | 4965 | */ |
4952 | 4966 | public static function generate_secrets( $action, $user_id = false, $exp = 600 ) { |
4953 | 4967 | if ( false === $user_id ) { |
@@ -5236,7 +5250,6 @@ discard block |
||
5236 | 5250 | /** |
5237 | 5251 | * Report authentication status to the WP REST API. |
5238 | 5252 | * |
5239 | - * @param WP_Error|mixed $result Error from another authentication handler, null if we should handle it, or another value if not |
|
5240 | 5253 | * @return WP_Error|boolean|null {@see WP_JSON_Server::check_authentication} |
5241 | 5254 | */ |
5242 | 5255 | public function wp_rest_authentication_errors( $value ) { |
@@ -5338,6 +5351,7 @@ discard block |
||
5338 | 5351 | * @param string $key |
5339 | 5352 | * @param string $value |
5340 | 5353 | * @param bool $restate private |
5354 | + * @return string |
|
5341 | 5355 | */ |
5342 | 5356 | public static function state( $key = null, $value = null, $restate = false ) { |
5343 | 5357 | static $state = array(); |
@@ -5394,6 +5408,9 @@ discard block |
||
5394 | 5408 | Jetpack::state( null, null, true ); |
5395 | 5409 | } |
5396 | 5410 | |
5411 | + /** |
|
5412 | + * @param string $file |
|
5413 | + */ |
|
5397 | 5414 | public static function check_privacy( $file ) { |
5398 | 5415 | static $is_site_publicly_accessible = null; |
5399 | 5416 | |
@@ -5476,6 +5493,9 @@ discard block |
||
5476 | 5493 | } |
5477 | 5494 | } |
5478 | 5495 | |
5496 | + /** |
|
5497 | + * @param string $url |
|
5498 | + */ |
|
5479 | 5499 | public static function staticize_subdomain( $url ) { |
5480 | 5500 | |
5481 | 5501 | // Extract hostname from URL |
@@ -6031,9 +6051,7 @@ discard block |
||
6031 | 6051 | * |
6032 | 6052 | * Attached to `style_loader_src` filter. |
6033 | 6053 | * |
6034 | - * @param string $tag The tag that would link to the external asset. |
|
6035 | 6054 | * @param string $handle The registered handle of the script in question. |
6036 | - * @param string $href The url of the asset in question. |
|
6037 | 6055 | */ |
6038 | 6056 | public static function set_suffix_on_min( $src, $handle ) { |
6039 | 6057 | if ( false === strpos( $src, '.min.css' ) ) { |
@@ -6221,8 +6239,8 @@ discard block |
||
6221 | 6239 | * - Absolute URLs `http://domain.com/feh.png` |
6222 | 6240 | * - Domain root relative URLs `/feh.png` |
6223 | 6241 | * |
6224 | - * @param $css string: The raw CSS -- should be read in directly from the file. |
|
6225 | - * @param $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
6242 | + * @param string $css string: The raw CSS -- should be read in directly from the file. |
|
6243 | + * @param string $css_file_url : The URL that the file can be accessed at, for calculating paths from. |
|
6226 | 6244 | * |
6227 | 6245 | * @return mixed|string |
6228 | 6246 | */ |
@@ -6483,7 +6501,7 @@ discard block |
||
6483 | 6501 | /** |
6484 | 6502 | * Stores and prints out domains to prefetch for page speed optimization. |
6485 | 6503 | * |
6486 | - * @param mixed $new_urls |
|
6504 | + * @param string[] $new_urls |
|
6487 | 6505 | */ |
6488 | 6506 | public static function dns_prefetch( $new_urls = null ) { |
6489 | 6507 | static $prefetch_urls = array(); |
@@ -6539,7 +6557,6 @@ discard block |
||
6539 | 6557 | } |
6540 | 6558 | |
6541 | 6559 | /** |
6542 | - * @param mixed $result Value for the user's option |
|
6543 | 6560 | * @return mixed |
6544 | 6561 | */ |
6545 | 6562 | function get_user_option_meta_box_order_dashboard( $sorted ) { |
@@ -273,7 +273,7 @@ discard block |
||
273 | 273 | /** |
274 | 274 | * Verifies the signature of the current request. |
275 | 275 | * |
276 | - * @return false|array |
|
276 | + * @return boolean |
|
277 | 277 | */ |
278 | 278 | public function verify_xml_rpc_signature() { |
279 | 279 | if ( is_null( $this->xmlrpc_verification ) ) { |
@@ -1029,6 +1029,7 @@ discard block |
||
1029 | 1029 | * @param String $action The action name. |
1030 | 1030 | * @param Integer $user_id The user identifier. |
1031 | 1031 | * @param Integer $exp Expiration time in seconds. |
1032 | + * @return string |
|
1032 | 1033 | */ |
1033 | 1034 | public function generate_secrets( $action, $user_id = false, $exp = 600 ) { |
1034 | 1035 | $callable = $this->get_secret_callable(); |
@@ -1419,7 +1420,7 @@ discard block |
||
1419 | 1420 | * |
1420 | 1421 | * @param int|false $user_id false: Return the Blog Token. int: Return that user's User Token. |
1421 | 1422 | * @param string|false $token_key If provided, check that the token matches the provided input. |
1422 | - * @param bool|true $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found. |
|
1423 | + * @param boolean $suppress_errors If true, return a falsy value when the token isn't found; When false, return a descriptive WP_Error when the token isn't found. |
|
1423 | 1424 | * |
1424 | 1425 | * @return object|false |
1425 | 1426 | */ |
@@ -36,6 +36,9 @@ |
||
36 | 36 | add_action( 'init', array( &$this, 'action_init' ) ); |
37 | 37 | } |
38 | 38 | |
39 | + /** |
|
40 | + * @param string $file |
|
41 | + */ |
|
39 | 42 | function wpcom_static_url($file) { |
40 | 43 | $i = hexdec( substr( md5( $file ), -1 ) ) % 2; |
41 | 44 | return 'https://s' . $i . '.wp.com' . $file; |