Automattic / jetpack

modules/publicize/publicize-jetpack.php

Doc Comments +6 added lines

@@ -328,6 +328,9 @@ 
 		), menu_page_url( 'sharing', false ) );
 	}
 
+	/**
+	 * @param string $filter
+	 */
 	function get_services( $filter ) {
 		if ( !in_array( $filter, array( 'all', 'connected' ) ) )
 			$filter = 'all';
@@ -663,6 +666,9 @@ 
 	function options_save_path() { $this->options_save_other( 'path' ); }
 	function options_save_google_plus() { $this->options_save_other( 'google_plus' ); }
 
+	/**
+	 * @param string $service_name
+	 */
 	function options_save_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( 'save_' . $service_name . '_token_' . $_REQUEST['connection'] );

modules/publicize/ui.php

Doc Comments +3 added lines

@@ -261,6 +261,9 @@
 		</div><?php
 	}
 
+	/**
+	 * @param string $service_name
+	 */
 	public static function options_page_other( $service_name ) {
 		// Nonce check
 		check_admin_referer( "options_page_{$service_name}_" . $_REQUEST['connection'] );

modules/related-posts/jetpack-related-posts.php

Doc Comments +2 added lines

@@ -1220,6 +1220,8 @@
 	 * Enqueues assets needed to do async loading of related posts.
 	 *
 	 * @uses wp_enqueue_script, wp_enqueue_style, plugins_url
+	 * @param boolean $script
+	 * @param boolean $style
 	 * @return null
 	 */
 	protected function _enqueue_assets( $script, $style ) {

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/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/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();