Automattic / jetpack

projects/plugins/jetpack/sal/class.json-api-post-base.php

Doc Comments +6 added lines

@@ -16,6 +16,9 @@ 
 	public $context;
 	public $site;
 
+	/**
+	 * @param Jetpack_Site $site
+	 */
 	function __construct( $site, $post, $context ) {
 		$this->post = $post;
 		$this->context = $context;
@@ -508,6 +511,9 @@ 
 		return $suggestions;
 	}
 
+	/**
+	 * @param string $context
+	 */
 	private function format_taxonomy( $taxonomy, $taxonomy_type, $context ) {
 		// Permissions
 		switch ( $context ) {

projects/plugins/jetpack/sal/class.json-api-site-base.php

Doc Comments +3 added lines

@@ -23,6 +23,9 @@
 	public $blog_id;
 	public $platform;
 
+	/**
+	 * @param WPORG_Platform $platform
+	 */
 	public function __construct( $blog_id, $platform ) {
 		$this->blog_id = $blog_id;
 		$this->platform = $platform;

projects/plugins/jetpack/sal/class.json-api-site-jetpack-base.php

Doc Comments +13 added lines

@@ -4,10 +4,20 @@ 
 require_once dirname( __FILE__ ) . '/class.json-api-site-base.php';
 
 abstract class Abstract_Jetpack_Site extends SAL_Site {
+
+	/**
+	 * @param string $name
+	 */
 	abstract protected function get_constant( $name );
 
+	/**
+	 * @param string $feature_name
+	 */
 	abstract protected function current_theme_supports( $feature_name );
 
+	/**
+	 * @param string $feature_name
+	 */
 	abstract protected function get_theme_support( $feature_name );
 
 	abstract protected function get_mock_option( $name );
@@ -16,6 +26,9 @@ 
 
 	abstract public function get_updates();
 
+	/**
+	 * @return string
+	 */
 	abstract protected function main_network_site();
 
 	abstract protected function wp_version();

projects/plugins/jetpack/modules/sharedaddy/sharing-sources.php

Doc Comments +19 added lines

@@ -388,6 +388,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;
@@ -1039,6 +1042,9 @@ 
 	public $icon = '\f204';
 	private $share_type = 'default';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1186,6 +1192,10 @@ 
 class Share_Print extends Sharing_Source {
 	public $shortname = 'print';
 	public $icon = '\f469';
+
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1585,6 +1595,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 ) );
@@ -1724,6 +1737,9 @@ 
 	public $shortname = 'pocket';
 	public $icon = '\f224';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 
@@ -1839,6 +1855,9 @@ 
 class Jetpack_Share_WhatsApp extends Sharing_Source {
 	public $shortname = 'jetpack-whatsapp';
 
+	/**
+	 * @param string $id
+	 */
 	public function __construct( $id, array $settings ) {
 		parent::__construct( $id, $settings );
 	}

projects/plugins/jetpack/modules/shortcodes/youtube.php

Doc Comments +1 added lines, -1 removed lines

@@ -382,7 +382,7 @@
  *
  * @param array $query_args The query args of the URL.
  *
- * @return array The width and height of the shortcode.
+ * @return integer[] The width and height of the shortcode.
  */
 function jetpack_shortcode_youtube_dimensions( $query_args ) {
 	global $content_width;

projects/plugins/jetpack/modules/sitemaps/sitemap-buffer.php

Doc Comments +1 added lines, -1 removed lines

@@ -263,7 +263,7 @@
 	 * @param DOMElement  $parent (optional) an element to which new children should be added.
 	 * @param DOMDocument $root (optional) the parent document.
 	 *
-	 * @return string|DOMDocument The rendered XML string or an object if root element is specified.
+	 * @return null|DOMNode The rendered XML string or an object if root element is specified.
 	 */
 	protected function array_to_xml_string( $array, $parent = null, $root = null ) {
 		$return_string = false;

projects/plugins/jetpack/modules/sso/class.jetpack-sso-helpers.php

Doc Comments +2 added lines, -2 removed lines

@@ -177,10 +177,10 @@
 	 * @since 4.3.0
 	 * @since 4.6.0 Added public-api.wordpress.com as an allowed redirect
 	 *
-	 * @param array $hosts
+	 * @param string[] $hosts
 	 * @param string $api_base
 	 *
-	 * @return array
+	 * @return string[]
 	 */
 	static function allowed_redirect_hosts( $hosts, $api_base = JETPACK__API_BASE ) {
 		if ( empty( $hosts ) ) {

projects/plugins/jetpack/modules/videopress/utility-functions.php

Doc Comments +1 added lines, -1 removed lines

@@ -308,7 +308,7 @@
  *
  * @since 4.4
  * @param string $title
- * @return int|WP_Error
+ * @return string
  */
 function videopress_create_new_media_item( $title, $guid = null ) {
 	$post = array(

projects/plugins/jetpack/sal/class.json-api-site-jetpack.php

Doc Comments +7 added lines

@@ -165,6 +165,9 @@ 
 		return $this->get_atomic_cloud_site_option( 'launch-status' );
 	}
 
+	/**
+	 * @param string $option
+	 */
 	function get_atomic_cloud_site_option( $option ) {
 		if ( ! jetpack_is_atomic_site() ) {
 			return false;
@@ -247,6 +250,9 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $role
+	 */
 	function current_user_can( $role ) {
 		return current_user_can( $role );
 	}
@@ -306,6 +312,7 @@ 
 
 	/**
 	 * Post functions
+	 * @param string $context
 	 */
 
 	function wrap_post( $post, $context ) {