@@ -23,6 +23,9 @@ |
||
23 | 23 | public $blog_id; |
24 | 24 | public $platform; |
25 | 25 | |
26 | + /** |
|
27 | + * @param WPORG_Platform $platform |
|
28 | + */ |
|
26 | 29 | public function __construct( $blog_id, $platform ) { |
27 | 30 | $this->blog_id = $blog_id; |
28 | 31 | $this->platform = $platform; |
@@ -16,6 +16,9 @@ discard block |
||
16 | 16 | public $context; |
17 | 17 | public $site; |
18 | 18 | |
19 | + /** |
|
20 | + * @param Jetpack_Site $site |
|
21 | + */ |
|
19 | 22 | function __construct( $site, $post, $context ) { |
20 | 23 | $this->post = $post; |
21 | 24 | $this->context = $context; |
@@ -508,6 +511,9 @@ discard block |
||
508 | 511 | return $suggestions; |
509 | 512 | } |
510 | 513 | |
514 | + /** |
|
515 | + * @param string $context |
|
516 | + */ |
|
511 | 517 | private function format_taxonomy( $taxonomy, $taxonomy_type, $context ) { |
512 | 518 | // Permissions |
513 | 519 | switch ( $context ) { |
@@ -29,7 +29,6 @@ discard block |
||
29 | 29 | * |
30 | 30 | * Used to construct meta links in API responses |
31 | 31 | * |
32 | - * @param mixed $args Optional arguments to be appended to URL |
|
33 | 32 | * @return string Endpoint URL |
34 | 33 | **/ |
35 | 34 | function get_link() { |
@@ -129,7 +128,7 @@ discard block |
||
129 | 128 | * This method is used in get_link() to construct meta links for API responses. |
130 | 129 | * |
131 | 130 | * @param $template_path string The generic endpoint path, e.g. /sites/%s |
132 | - * @param $path string The current endpoint path, relative to the version, e.g. /sites/12345 |
|
131 | + * @param string $path string The current endpoint path, relative to the version, e.g. /sites/12345 |
|
133 | 132 | * @param $request_method string Request method used to access the endpoint path |
134 | 133 | * @return string The current version, or otherwise the maximum version available |
135 | 134 | */ |
@@ -4,10 +4,20 @@ discard block |
||
4 | 4 | require_once dirname( __FILE__ ) . '/class.json-api-site-base.php'; |
5 | 5 | |
6 | 6 | abstract class Abstract_Jetpack_Site extends SAL_Site { |
7 | + |
|
8 | + /** |
|
9 | + * @param string $name |
|
10 | + */ |
|
7 | 11 | abstract protected function get_constant( $name ); |
8 | 12 | |
13 | + /** |
|
14 | + * @param string $feature_name |
|
15 | + */ |
|
9 | 16 | abstract protected function current_theme_supports( $feature_name ); |
10 | 17 | |
18 | + /** |
|
19 | + * @param string $feature_name |
|
20 | + */ |
|
11 | 21 | abstract protected function get_theme_support( $feature_name ); |
12 | 22 | |
13 | 23 | abstract protected function get_mock_option( $name ); |
@@ -16,6 +26,9 @@ discard block |
||
16 | 26 | |
17 | 27 | abstract public function get_updates(); |
18 | 28 | |
29 | + /** |
|
30 | + * @return string |
|
31 | + */ |
|
19 | 32 | abstract protected function main_network_site(); |
20 | 33 | |
21 | 34 | abstract protected function wp_version(); |
@@ -177,6 +177,9 @@ |
||
177 | 177 | return true; |
178 | 178 | } |
179 | 179 | |
180 | + /** |
|
181 | + * @param string $role |
|
182 | + */ |
|
180 | 183 | function current_user_can( $role ) { |
181 | 184 | return current_user_can( $role ); |
182 | 185 | } |
@@ -140,7 +140,7 @@ discard block |
||
140 | 140 | * @param string $vendorPath Path to the vendor directory. |
141 | 141 | * @param string $basePath Base Path. |
142 | 142 | * |
143 | - * @return array $classMap |
|
143 | + * @return string $classMap |
|
144 | 144 | */ |
145 | 145 | private function getClassMap( array $autoloads, Filesystem $filesystem, $vendorPath, $basePath ) { |
146 | 146 | $blacklist = null; // not supported for now. |
@@ -178,7 +178,7 @@ discard block |
||
178 | 178 | /** |
179 | 179 | * Generate the PHP that will be used in the autoload_classmap_package.php files. |
180 | 180 | * |
181 | - * @param srting $classMap class map array string that is to be written out to the file. |
|
181 | + * @param string $classMap class map array string that is to be written out to the file. |
|
182 | 182 | * |
183 | 183 | * @return string |
184 | 184 | */ |
@@ -16,7 +16,7 @@ discard block |
||
16 | 16 | * |
17 | 17 | * @param string $type The type of option to return. Defaults to 'compact'. |
18 | 18 | * |
19 | - * @return array |
|
19 | + * @return string[] |
|
20 | 20 | */ |
21 | 21 | public static function get_option_names( $type = 'compact' ) { |
22 | 22 | switch ( $type ) { |
@@ -199,6 +199,9 @@ discard block |
||
199 | 199 | return $value; |
200 | 200 | } |
201 | 201 | |
202 | + /** |
|
203 | + * @param string $name |
|
204 | + */ |
|
202 | 205 | private static function update_grouped_option( $group, $name, $value ) { |
203 | 206 | $options = get_option( self::$grouped_options[ $group ] ); |
204 | 207 | if ( ! is_array( $options ) ) { |
@@ -301,6 +304,9 @@ discard block |
||
301 | 304 | return $result; |
302 | 305 | } |
303 | 306 | |
307 | + /** |
|
308 | + * @param string $name |
|
309 | + */ |
|
304 | 310 | private static function get_grouped_option( $group, $name, $default ) { |
305 | 311 | $options = get_option( self::$grouped_options[ $group ] ); |
306 | 312 | if ( is_array( $options ) && isset( $options[ $name ] ) ) { |
@@ -420,7 +426,7 @@ discard block |
||
420 | 426 | * This function checks for a constant that, if present, will disable direct DB queries Jetpack uses to manage certain options and force Jetpack to always use Options API instead. |
421 | 427 | * Options can be selectively managed via a blacklist by filtering option names via the jetpack_disabled_raw_option filter. |
422 | 428 | * |
423 | - * @param $name Option name |
|
429 | + * @param string $name Option name |
|
424 | 430 | * |
425 | 431 | * @return bool |
426 | 432 | */ |
@@ -445,7 +451,7 @@ discard block |
||
445 | 451 | * @since 5.4.0 |
446 | 452 | * |
447 | 453 | * @param boolean $strip_unsafe_options If true, and by default, will strip out options necessary for the connection to WordPress.com. |
448 | - * @return array An array of all options managed via the Jetpack_Options class. |
|
454 | + * @return string[] An array of all options managed via the Jetpack_Options class. |
|
449 | 455 | */ |
450 | 456 | static function get_all_jetpack_options( $strip_unsafe_options = true ) { |
451 | 457 | $jetpack_options = self::get_option_names(); |
@@ -488,7 +494,7 @@ discard block |
||
488 | 494 | * |
489 | 495 | * @since 5.4.0 |
490 | 496 | * |
491 | - * @return array |
|
497 | + * @return string[] |
|
492 | 498 | */ |
493 | 499 | static function get_all_wp_options() { |
494 | 500 | // A manual build of the wp options |
@@ -321,6 +321,9 @@ discard block |
||
321 | 321 | return $sync_modules; |
322 | 322 | } |
323 | 323 | |
324 | + /** |
|
325 | + * @return string |
|
326 | + */ |
|
324 | 327 | static function sanitize_filtered_sync_cron_schedule( $schedule ) { |
325 | 328 | $schedule = sanitize_key( $schedule ); |
326 | 329 | $schedules = wp_get_schedules(); |
@@ -358,6 +361,9 @@ discard block |
||
358 | 361 | ); |
359 | 362 | } |
360 | 363 | |
364 | + /** |
|
365 | + * @param string $hook |
|
366 | + */ |
|
361 | 367 | static function maybe_schedule_sync_cron( $schedule, $hook ) { |
362 | 368 | if ( ! $hook ) { |
363 | 369 | return; |
@@ -148,6 +148,7 @@ discard block |
||
148 | 148 | * Helper function that is used when getting home or siteurl values. Decides |
149 | 149 | * whether to get the raw or filtered value. |
150 | 150 | * |
151 | + * @param string $url_type |
|
151 | 152 | * @return string |
152 | 153 | */ |
153 | 154 | public static function get_raw_or_filtered_url( $url_type ) { |
@@ -197,6 +198,9 @@ discard block |
||
197 | 198 | return self::get_protocol_normalized_url( 'main_network_site_url', network_site_url() ); |
198 | 199 | } |
199 | 200 | |
201 | + /** |
|
202 | + * @param string $callable |
|
203 | + */ |
|
200 | 204 | public static function get_protocol_normalized_url( $callable, $new_value ) { |
201 | 205 | $option_key = self::HTTPS_CHECK_OPTION_PREFIX . $callable; |
202 | 206 | |
@@ -236,6 +240,9 @@ discard block |
||
236 | 240 | return $value; |
237 | 241 | } |
238 | 242 | |
243 | + /** |
|
244 | + * @param string $url_function |
|
245 | + */ |
|
239 | 246 | public static function normalize_www_in_url( $option, $url_function ) { |
240 | 247 | $url = wp_parse_url( call_user_func( $url_function ) ); |
241 | 248 | $option_url = wp_parse_url( get_option( $option ) ); |