Automattic / jetpack

modules/google-analytics/classes/wp-google-analytics-options.php

Doc Comments +4 added lines

@@ -15,6 +15,10 @@
 }
 
 class Jetpack_Google_Analytics_Options {
+
+	/**
+	 * @param string $option_name
+	 */
 	public static function get_option( $option_name, $default = false ) {
 		$o = get_option( 'jetpack_wga' );
 		return isset( $o[ $option_name ] ) ? $o[ $option_name ] : $default;

modules/protect/blocked-login-page.php

Doc Comments +3 added lines

@@ -326,6 +326,9 @@
 		return $contents;
 	}
 
+	/**
+	 * @param string $message
+	 */
 	function display_page( $title, $message, $back_button = false, $recovery_form = false ) {
 
 		if ( ! headers_sent() ) {

modules/search/class.jetpack-search-helpers.php

Doc Comments -1 removed lines

@@ -76,7 +76,6 @@
 	 * @since 5.8.0
 	 *
 	 * @param string|array $key   Query key or keys to remove.
-	 * @param bool|string  $query Optional. A URL to act upon.  Defaults to the current search URL.
 	 *
 	 * @return string New URL query string (unescaped).
 	 */

modules/theme-tools.php

Doc Comments +1 added lines, -1 removed lines

@@ -55,7 +55,7 @@
  * @access private
  * @param string $key
  * @param array $files
- * @return void
+ * @return WP_Error|null
  */
 function _jetpack_require_compat_file( $key, $files ) {
 	if ( ! is_string( $key ) ) {

modules/sharedaddy/sharing-service.php

Doc Comments +3 added lines

@@ -505,6 +505,9 @@
 	public $service = '';
 	public $total   = 0;
 
+	/**
+	 * @param integer $total
+	 */
 	public function __construct( $id, $total ) {
 		$services      = new Sharing_Service();
 		$this->id      = esc_html( $id );

modules/memberships/class-jetpack-memberships.php

Doc Comments +1 added lines, -1 removed lines

@@ -172,7 +172,7 @@
 	 * @param array $post_types - other post types.
 	 *
 	 * @see hook 'rest_api_allowed_post_types'
-	 * @return array
+	 * @return string[]
 	 */
 	public function allow_rest_api_types( $post_types ) {
 		$post_types[] = self::$post_type_plan;

modules/photon-cdn.php

Doc Comments +1 added lines, -1 removed lines

@@ -81,7 +81,7 @@
 	 *
 	 * @param String $plugin_slug plugin slug string.
 	 * @param String $current_version plugin version string.
-	 * @return null|bool
+	 * @return false|null
 	 */
 	public static function cdnize_plugin_assets( $plugin_slug, $current_version ) {
 		global $wp_scripts, $wp_styles;

modules/widgets/goodreads.php

Doc Comments +3 added lines

@@ -90,6 +90,9 @@
 		echo $args['after_widget'];
 	}
 
+	/**
+	 * @param string $user_id
+	 */
 	function goodreads_user_id_exists( $user_id ) {
 		$url      = "https://www.goodreads.com/user/show/$user_id/";
 		$response = wp_remote_head(

modules/widgets/simple-payments.php

Doc Comments +3 added lines, -3 removed lines

@@ -276,7 +276,7 @@ 
 		 * Returns the number of decimal places on string representing a price.
 		 *
 		 * @param string $number Price to check.
-		 * @return number number of decimal places.
+		 * @return null|integer number of decimal places.
 		 */
 		private function get_decimal_places( $number ) {
 			$parts = explode( '.', $number );
@@ -377,8 +377,7 @@ 
 		/**
 		 * Gets the latests field value from either the old instance or the new instance.
 		 *
-		 * @param array $mixed Array of values for the new form instance.
-		 * @param array $mixed Array of values for the old form instance.
+		 * @param string $field
 		 * @return mixed $mixed Field value.
 		 */
 		private function get_latest_field_value( $new_instance, $old_instance, $field ) {
@@ -392,6 +391,7 @@ 
 		 * it returns the default values.
 		 *
 		 * @param int Product Post ID.
+		 * @param integer $product_post_id
 		 * @return array $fields Product Fields from the Product Post.
 		 */
 		private function get_product_from_post( $product_post_id ) {