@@ -149,6 +149,9 @@ discard block |
||
149 | 149 | |
150 | 150 | /** |
151 | 151 | * Helper function for Jetpack_Color::fromHsl() |
152 | + * @param double $p |
|
153 | + * @param double $q |
|
154 | + * @param integer $t |
|
152 | 155 | */ |
153 | 156 | private function hue2rgb( $p, $q, $t ) { |
154 | 157 | if ( $t < 0 ) $t += 1; |
@@ -278,7 +281,7 @@ discard block |
||
278 | 281 | * Get HSV values for color |
279 | 282 | * (integer values from 0-255, fast but less accurate) |
280 | 283 | * |
281 | - * @return int |
|
284 | + * @return string |
|
282 | 285 | */ |
283 | 286 | public function toHsvInt() |
284 | 287 | { |
@@ -498,7 +501,7 @@ discard block |
||
498 | 501 | * |
499 | 502 | * @param Jetpack_Color $color |
500 | 503 | * |
501 | - * @return int |
|
504 | + * @return double |
|
502 | 505 | */ |
503 | 506 | public function getDistanceRgbFrom(Jetpack_Color $color) |
504 | 507 | { |
@@ -682,6 +685,9 @@ discard block |
||
682 | 685 | return $this->incrementLightness( $amount ); |
683 | 686 | } |
684 | 687 | |
688 | + /** |
|
689 | + * @param integer $amount |
|
690 | + */ |
|
685 | 691 | public function incrementLightness( $amount ) { |
686 | 692 | $hsl = $this->toHsl(); |
687 | 693 | extract( $hsl ); |
@@ -699,6 +705,9 @@ discard block |
||
699 | 705 | return $this->incrementSaturation( - $amount ); |
700 | 706 | } |
701 | 707 | |
708 | + /** |
|
709 | + * @param integer $amount |
|
710 | + */ |
|
702 | 711 | public function incrementSaturation( $amount ) { |
703 | 712 | $hsl = $this->toHsl(); |
704 | 713 | extract( $hsl ); |
@@ -739,6 +748,9 @@ discard block |
||
739 | 748 | return $this->incrementHue( $incr ); |
740 | 749 | } |
741 | 750 | |
751 | + /** |
|
752 | + * @param integer $amount |
|
753 | + */ |
|
742 | 754 | public function incrementHue( $amount ) { |
743 | 755 | $hsl = $this->toHsl(); |
744 | 756 | extract( $hsl ); |
@@ -183,6 +183,9 @@ |
||
183 | 183 | } |
184 | 184 | } |
185 | 185 | |
186 | +/** |
|
187 | + * @param string $text |
|
188 | + */ |
|
186 | 189 | function jetpack_sha1_base64( $text ) { |
187 | 190 | return base64_encode( sha1( $text, true ) ); |
188 | 191 | } |
@@ -48,7 +48,7 @@ discard block |
||
48 | 48 | |
49 | 49 | /** |
50 | 50 | * record_event |
51 | - * @param mixed $event Event object to send to Tracks. An array will be cast to object. Required. |
|
51 | + * @param Jetpack_Tracks_Event $event Event object to send to Tracks. An array will be cast to object. Required. |
|
52 | 52 | * Properties are included directly in the pixel query string after light validation. |
53 | 53 | * @return mixed True on success, WP_Error on failure |
54 | 54 | */ |
@@ -71,6 +71,7 @@ discard block |
||
71 | 71 | |
72 | 72 | /** |
73 | 73 | * Synchronously request the pixel |
74 | + * @param string $pixel |
|
74 | 75 | */ |
75 | 76 | static function record_pixel( $pixel ) { |
76 | 77 | // Add the Request Timestamp and URL terminator just before the HTTP request. |
@@ -74,7 +74,7 @@ |
||
74 | 74 | * NOTE: If you want IMAGES, call extract( $blog_id, $post_id, ...) which will give you more/better image extraction |
75 | 75 | * This method will give you an error if you ask for IMAGES. |
76 | 76 | * |
77 | - * @param $content The HTML post_content of a post |
|
77 | + * @param string $content The HTML post_content of a post |
|
78 | 78 | * @param $what_to_extract (int) A mask of things to extract, e.g. Jetpack_Media_Meta_Extractor::IMAGES | Jetpack_Media_Meta_Extractor::MENTIONS |
79 | 79 | * @param $already_extracted (array) Previously extracted things, e.g. images from extract(), which can be used for x-referencing here |
80 | 80 | * @returns a structure containing metadata about the embedded things, or empty array if nothing found, or WP_Error on error |
@@ -214,6 +214,9 @@ discard block |
||
214 | 214 | } |
215 | 215 | } |
216 | 216 | |
217 | + /** |
|
218 | + * @param string $type |
|
219 | + */ |
|
217 | 220 | static function get_video_poster( $type, $id ) { |
218 | 221 | if ( 'videopress' == $type ) { |
219 | 222 | if ( function_exists( 'video_get_highest_resolution_image_url' ) ) { |
@@ -267,6 +270,9 @@ discard block |
||
267 | 270 | return str_word_count( self::clean_text( $post_content ) ); |
268 | 271 | } |
269 | 272 | |
273 | + /** |
|
274 | + * @param string $excerpt_content |
|
275 | + */ |
|
270 | 276 | static function get_word_remaining_count( $post_content, $excerpt_content ) { |
271 | 277 | return str_word_count( self::clean_text( $post_content ) ) - str_word_count( self::clean_text( $excerpt_content ) ); |
272 | 278 | } |
@@ -1341,6 +1341,7 @@ discard block |
||
1341 | 1341 | * timezone set in the options table for the blog or the GMT offset. |
1342 | 1342 | * |
1343 | 1343 | * @param datetime string |
1344 | + * @param string $date_string |
|
1344 | 1345 | * |
1345 | 1346 | * @return array( $local_time_string, $gmt_time_string ) |
1346 | 1347 | */ |
@@ -1458,6 +1459,10 @@ discard block |
||
1458 | 1459 | do_action( 'restapi_theme_init' ); |
1459 | 1460 | } |
1460 | 1461 | |
1462 | + /** |
|
1463 | + * @param string $from_hook |
|
1464 | + * @param string $to_hook |
|
1465 | + */ |
|
1461 | 1466 | function copy_hooks( $from_hook, $to_hook, $base_paths ) { |
1462 | 1467 | global $wp_filter; |
1463 | 1468 | foreach ( $wp_filter as $hook => $actions ) { |
@@ -43,7 +43,7 @@ |
||
43 | 43 | /** |
44 | 44 | * This function mirrors Jetpack_Data::is_usable_domain() in the WPCOM codebase. |
45 | 45 | * |
46 | - * @param $domain |
|
46 | + * @param string|false $domain |
|
47 | 47 | * @param array $extra |
48 | 48 | * |
49 | 49 | * @return bool|WP_Error |
@@ -699,8 +699,7 @@ discard block |
||
699 | 699 | * Render the events |
700 | 700 | * |
701 | 701 | * @param string $url (default: '') |
702 | - * @param string $context (default: 'widget') or 'shortcode' |
|
703 | - * @return mixed bool|string false on failure, rendered HTML string on success. |
|
702 | + * @return false|string bool|string false on failure, rendered HTML string on success. |
|
704 | 703 | */ |
705 | 704 | public function render( $url = '', $args = array() ) { |
706 | 705 | |
@@ -857,8 +856,7 @@ discard block |
||
857 | 856 | * Wrapper function for iCalendarReader->render() |
858 | 857 | * |
859 | 858 | * @param string $url (default: '') |
860 | - * @param string $context (default: 'widget') or 'shortcode' |
|
861 | - * @return mixed bool|string false on failure, rendered HTML string on success. |
|
859 | + * @return false|string bool|string false on failure, rendered HTML string on success. |
|
862 | 860 | */ |
863 | 861 | function icalendar_render_events( $url = '', $args = array() ) { |
864 | 862 | $ical = new iCalendarReader(); |
@@ -107,7 +107,6 @@ |
||
107 | 107 | /** |
108 | 108 | * Record an event in Tracks - this is the preferred way to record events from PHP. |
109 | 109 | * |
110 | - * @param mixed $identity username, user_id, or WP_user object |
|
111 | 110 | * @param string $event_name The name of the event |
112 | 111 | * @param array $properties Custom properties to send with the event |
113 | 112 | * @param int $event_timestamp_millis The time in millis since 1970-01-01 00:00:00 when the event occurred |