@@ -26,7 +26,7 @@ discard block |
||
26 | 26 | /** |
27 | 27 | * Verifies that a user answered the math problem correctly while logging in. |
28 | 28 | * |
29 | - * @return bool Returns true if the math is correct |
|
29 | + * @return boolean|null Returns true if the math is correct |
|
30 | 30 | * @throws Error if insuffient $_POST variables are present. |
31 | 31 | * @throws Error message if the math is wrong |
32 | 32 | */ |
@@ -109,7 +109,7 @@ discard block |
||
109 | 109 | /** |
110 | 110 | * Requires a user to solve a simple equation. Added to any WordPress login form. |
111 | 111 | * |
112 | - * @return VOID outputs html |
|
112 | + * @return string|null outputs html |
|
113 | 113 | */ |
114 | 114 | static function math_form() { |
115 | 115 | // Check if jpp_math_pass cookie is set and it matches valid transient |
@@ -415,7 +415,7 @@ |
||
415 | 415 | * |
416 | 416 | * @param array $connections_data |
417 | 417 | * |
418 | - * @return array { |
|
418 | + * @return string { |
|
419 | 419 | * Array of content for generating connection form. |
420 | 420 | * |
421 | 421 | * @type string HTML content of form |
@@ -682,6 +682,9 @@ |
||
682 | 682 | $this->options_save_other( 'linkedin' ); |
683 | 683 | } |
684 | 684 | |
685 | + /** |
|
686 | + * @param string $service_name |
|
687 | + */ |
|
685 | 688 | function options_save_other( $service_name ) { |
686 | 689 | // Nonce check |
687 | 690 | check_admin_referer( 'save_' . $service_name . '_token_' . $_REQUEST['connection'] ); |
@@ -142,7 +142,7 @@ discard block |
||
142 | 142 | /** |
143 | 143 | * Plugin options getter |
144 | 144 | * |
145 | - * @param string|array $option Option name. |
|
145 | + * @param string $option Option name. |
|
146 | 146 | * @param mixed $default Default value. |
147 | 147 | * |
148 | 148 | * @return mixed Option value |
@@ -158,7 +158,7 @@ discard block |
||
158 | 158 | * |
159 | 159 | * @param string $url Soundcloud URL. |
160 | 160 | * |
161 | - * @return boolean |
|
161 | + * @return integer |
|
162 | 162 | */ |
163 | 163 | function soundcloud_url_has_tracklist( $url ) { |
164 | 164 | return preg_match( '/^(.+?)\/(sets|groups|playlists)\/(.+?)$/', $url ); |
@@ -339,6 +339,9 @@ discard block |
||
339 | 339 | do_action( 'sharing_bump_stats', array( 'service' => $this, 'post' => $post ) ); |
340 | 340 | } |
341 | 341 | |
342 | + /** |
|
343 | + * @param string $name |
|
344 | + */ |
|
342 | 345 | public function js_dialog( $name, $params = array() ) { |
343 | 346 | if ( true !== $this->open_link_in_new ) { |
344 | 347 | return; |
@@ -1458,6 +1461,9 @@ discard block |
||
1458 | 1461 | return __( 'Pinterest', 'jetpack' ); |
1459 | 1462 | } |
1460 | 1463 | |
1464 | + /** |
|
1465 | + * @return string |
|
1466 | + */ |
|
1461 | 1467 | public function get_image( $post ) { |
1462 | 1468 | if ( class_exists( 'Jetpack_PostImages' ) ) { |
1463 | 1469 | $image = Jetpack_PostImages::get_image( $post->ID, array( 'fallback_to_avatars' => true ) ); |
@@ -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; |
@@ -30,6 +30,7 @@ discard block |
||
30 | 30 | * Used to construct meta links in API responses |
31 | 31 | * |
32 | 32 | * @param mixed ...$args Optional arguments to be appended to URL |
33 | + * @param string $args |
|
33 | 34 | * @return string Endpoint URL |
34 | 35 | **/ |
35 | 36 | function get_link( ...$args ) { |
@@ -128,7 +129,7 @@ discard block |
||
128 | 129 | * This method is used in get_link() to construct meta links for API responses. |
129 | 130 | * |
130 | 131 | * @param $template_path string The generic endpoint path, e.g. /sites/%s |
131 | - * @param $path string The current endpoint path, relative to the version, e.g. /sites/12345 |
|
132 | + * @param string $path string The current endpoint path, relative to the version, e.g. /sites/12345 |
|
132 | 133 | * @param $request_method string Request method used to access the endpoint path |
133 | 134 | * @return string The current version, or otherwise the maximum version available |
134 | 135 | */ |
@@ -165,7 +165,7 @@ |
||
165 | 165 | * @param string $url Request URL. |
166 | 166 | * @param mixed $body Request body. |
167 | 167 | * @param bool $verify_body_hash Whether to verify the body hash against the body. |
168 | - * @return string|WP_Error Request signature, or a WP_Error on failure. |
|
168 | + * @return string Request signature, or a WP_Error on failure. |
|
169 | 169 | */ |
170 | 170 | public function sign_request( $token = '', $timestamp = 0, $nonce = '', $body_hash = '', $method = '', $url = '', $body = null, $verify_body_hash = true ) { |
171 | 171 | if ( ! $this->secret ) { |
@@ -27,7 +27,7 @@ discard block |
||
27 | 27 | * |
28 | 28 | * @param string $type The type of option to return. Defaults to 'compact'. |
29 | 29 | * |
30 | - * @return array |
|
30 | + * @return string[] |
|
31 | 31 | */ |
32 | 32 | public static function get_option_names( $type = 'compact' ) { |
33 | 33 | switch ( $type ) { |
@@ -505,7 +505,7 @@ discard block |
||
505 | 505 | * @since 5.4.0 |
506 | 506 | * |
507 | 507 | * @param boolean $strip_unsafe_options If true, and by default, will strip out options necessary for the connection to WordPress.com. |
508 | - * @return array An array of all options managed via the Jetpack_Options class. |
|
508 | + * @return string[] An array of all options managed via the Jetpack_Options class. |
|
509 | 509 | */ |
510 | 510 | public static function get_all_jetpack_options( $strip_unsafe_options = true ) { |
511 | 511 | $jetpack_options = self::get_option_names(); |
@@ -548,7 +548,7 @@ discard block |
||
548 | 548 | * |
549 | 549 | * @since 5.4.0 |
550 | 550 | * |
551 | - * @return array |
|
551 | + * @return string[] |
|
552 | 552 | */ |
553 | 553 | public static function get_all_wp_options() { |
554 | 554 | // A manual build of the wp options. |