Automattic / jetpack

modules/protect/math-fallback.php

Doc Comments +1 added lines, -1 removed lines

@@ -26,7 +26,7 @@
 		/**
 		 * Verifies that a user answered the math problem correctly while logging in.
 		 *
-		 * @return bool Returns true if the math is correct
+		 * @return boolean|null Returns true if the math is correct
 		 * @throws Error if insuffient $_POST variables are present.
 		 * @throws Error message if the math is wrong
 		 */

modules/publicize.php

Doc Comments +6 added lines

@@ -266,6 +266,9 @@ 
 		return trim( preg_replace( '#<p>\s*</p>#i', '', $new_string ) );
 	}
 
+	/**
+	 * @return integer
+	 */
 	function remove_innermost_last_child( $node, &$node_removed_from ) {
 		$node_removed_from = $node;
 
@@ -308,6 +311,9 @@ 
 		return str_replace( $search, $replace, $string );
 	}
 
+	/**
+	 * @param string $message
+	 */
 	public static function sanitize_message( $message ) {
 		$message = preg_replace( '@<(script|style)[^>]*?>.*?</\\1>@si', '', $message );
 		$message = wp_kses( $message, array() );

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;