Automattic / jetpack

modules/sharedaddy/sharing-service.php

Doc Comments +3 added lines

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

modules/sharedaddy/sharing-sources.php

Doc Comments +12 added lines

@@ -40,6 +40,9 @@ 
 		return $this->id;
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_share_url( $post_id ) {
 		/**
 		 * Filter the sharing permalink.
@@ -77,6 +80,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $url
+	 */
 	public function get_link( $url, $text, $title, $query = '', $id = false ) {
 		$args = func_get_args();
 		$klasses = array( 'share-'.$this->get_class(), 'sd-button' );
@@ -311,6 +317,9 @@ 
 		do_action( 'sharing_bump_stats', array( 'service' => $this, 'post' => $post ) );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	public function js_dialog( $name, $params = array() ) {
 		if ( true !== $this->open_link_in_new )
 			return;
@@ -1393,6 +1402,9 @@ 
 		return __( 'Pinterest', 'jetpack' );
 	}
 
+	/**
+	 * @return string
+	 */
 	public function get_image( $post ) {
 		if ( class_exists( 'Jetpack_PostImages' ) ) {
 			$image = Jetpack_PostImages::get_image( $post->ID, array( 'fallback_to_avatars' => true ) );

modules/shortcodes/polldaddy.php

Doc Comments +3 added lines

@@ -22,6 +22,9 @@
 		add_action( 'infinite_scroll_render', array( $this, 'polldaddy_shortcode_infinite' ), 11 );
 	}
 
+	/**
+	 * @param string $survey_link
+	 */
 	private function get_async_code( array $settings, $survey_link ) {
 		$embed_src     = 'http://i0.poll.fm/survey.js';
 		$embed_src_ssl = 'https://polldaddy.com/survey.js';

modules/shortcodes/slideshow.php

Doc Comments +3 added lines

@@ -82,6 +82,9 @@
 		$this->settings_select( 'jetpack_slideshow_background_color', $options );
 	}
 
+	/**
+	 * @param string $name
+	 */
 	function settings_select( $name, $values, $extra_text = '' ) {
 		if ( empty( $name ) || empty( $values ) || ! is_array( $values ) ) {
 			return;

modules/shortcodes/soundcloud.php

Doc Comments +1 added lines, -1 removed lines

@@ -129,7 +129,7 @@
 
 /**
  * Plugin options getter
- * @param  {string|array}  $option   Option name
+ * @param  string  $option   Option name
  * @param  {mixed}         $default  Default value
  * @return {mixed}                   Option value
  */

modules/site-icon/jetpack-site-icon.php

Doc Comments +1 added lines, -2 removed lines

@@ -592,7 +592,7 @@ 
 	 *
 	 * @param $id
 	 *
-	 * @return mixed
+	 * @return boolean
 	 */
 	public static function delete_site_icon( $id ) {
 		// We add the filter to make sure that we also delete all the added images
@@ -715,7 +715,6 @@ 
 	 * Save Blavatar files to Media Library
 	 *
 	 * @param  string  	$title
-	 * @param  string  	$filename
 	 * @param  string  	$file_type
 	 * @param  boolean 	$generate_meta
 	 * @return int 		$attactment_id

modules/sso.php

Doc Comments +3 added lines, -3 removed lines

@@ -229,7 +229,7 @@ 
 	 * Validate the require  two step checkbox in Settings > General
 	 *
 	 * @since 2.7
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_require_two_step( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;
@@ -252,7 +252,7 @@ 
 	 * Validate the match by email check in Settings > General
 	 *
 	 * @since 2.9
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_jetpack_sso_match_by_email( $input ) {
 		return ( ! empty( $input ) ) ? 1 : 0;
@@ -279,7 +279,7 @@ 
 	 * Validate settings input from Settings > General
 	 *
 	 * @since 2.7
-	 * @return boolean
+	 * @return integer
 	 **/
 	public function validate_settings_remove_login_form_checkbox( $input ) {
 		return ( isset( $input['remove_login_form'] ) )? 1: 0;

modules/stats.php

Doc Comments +3 added lines

@@ -203,6 +203,9 @@
 	return $options;
 }
 
+/**
+ * @param string $option
+ */
 function stats_get_option( $option ) {
 	$options = stats_get_options();
 

modules/subscriptions.php

Doc Comments +1 added lines, -1 removed lines

@@ -406,7 +406,7 @@
 	 * Send a synchronous XML-RPC subscribe to blog posts or subscribe to post comments request.
 	 *
 	 * @param string $email
-	 * @param array  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
+	 * @param integer  $post_ids (optional) defaults to 0 for blog posts only: array of post IDs to subscribe to blog's posts
 	 * @param bool   $async    (optional) Should the subscription be performed asynchronously?  Defaults to true.
 	 *
 	 * @return true|Jetpack_Error true on success