Automattic / jetpack

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

Doc Comments +13 added lines

@@ -4,16 +4,29 @@
 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_jetpack_version();
 
 	abstract protected function get_updates();
 
+	/**
+	 * @return string
+	 */
 	abstract protected function main_network_site();
 
 	abstract protected function wp_version();

json-endpoints/class.wpcom-json-api-list-terms-endpoint.php

Doc Comments +6 added lines

@@ -69,11 +69,17 @@
 		return $args;
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_found( $taxonomy, $args ) {
 		unset( $args['offset'] );
 		return wp_count_terms( $taxonomy, $args );
 	}
 
+	/**
+	 * @param string $taxonomy
+	 */
 	function get_formatted_terms( $taxonomy, $args ) {
 		$terms = get_terms( $taxonomy, $args );
 

json-endpoints/class.wpcom-json-api-update-term-endpoint.php

Doc Comments +17 added lines

@@ -44,6 +44,11 @@ 
 	}
 
 	// /sites/%s/taxonomies/%s/terms/new -> $blog_id, $taxonomy
+
+	/**
+	 * @param string $path
+	 * @param string $taxonomy
+	 */
 	function new_term( $path, $blog_id, $taxonomy ) {
 		$args = $this->query_args();
 		$input = $this->input();
@@ -90,6 +95,12 @@ 
 	}
 
 	// /sites/%s/taxonomies/%s/terms/slug:%s -> $blog_id, $taxonomy, $slug
+
+	/**
+	 * @param string $path
+	 * @param integer $slug
+	 * @param string $taxonomy
+	 */
 	function update_term( $path, $blog_id, $slug, $taxonomy ) {
 		$tax = get_taxonomy( $taxonomy );
 		if ( ! current_user_can( $tax->cap->edit_terms ) ) {
@@ -134,6 +145,12 @@ 
 	}
 
 	// /sites/%s/taxonomies/%s/terms/slug:%s/delete -> $blog_id, $taxonomy, $slug
+
+	/**
+	 * @param string $path
+	 * @param integer $slug
+	 * @param string $taxonomy
+	 */
 	function delete_term( $path, $blog_id, $slug, $taxonomy ) {
 		$term = get_term_by( 'slug', $slug, $taxonomy );
 		$tax = get_taxonomy( $taxonomy );

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 ) {

sync/class.jetpack-sync-sender.php

Doc Comments +3 added lines

@@ -172,6 +172,9 @@
 		}
 	}
 
+	/**
+	 * @param string $when
+	 */
 	private function schedule_sync( $when ) {
 		wp_schedule_single_event( strtotime( $when ), 'jetpack_sync_actions' );
 	}

sync/class.jetpack-sync-modules.php

Doc Comments +3 added lines

@@ -36,6 +36,9 @@
 		return self::$initialized_modules;
 	}
 
+	/**
+	 * @param string $module_name
+	 */
 	public static function get_module( $module_name ) {
 		foreach( self::get_modules() as $module ) {
 			if ( $module->name() === $module_name ) {

modules/theme-tools/site-logo/inc/functions.php

Doc Comments +1 added lines

@@ -165,6 +165,7 @@
  * Sanitize the string of classes used for header text.
  * Limit to A-Z,a-z,0-9,(space),(comma),_,-
  *
+ * @param string $classes
  * @return string Sanitized string of CSS classes.
  */
 function jetpack_sanitize_header_text_classes( $classes ) {

sync/class.jetpack-sync-module.php

Doc Comments +14 added lines

@@ -23,6 +23,9 @@ 
 		return array();
 	}
 
+	/**
+	 * @param string[] $actions_to_count
+	 */
 	protected function count_actions( $action_names, $actions_to_count ) {
 		return count( array_intersect( $action_names, $actions_to_count ) );
 	}
@@ -31,6 +34,9 @@ 
 		return crc32( json_encode( $values ) );
 	}
 
+	/**
+	 * @param integer $new_sum
+	 */
 	protected function still_valid_checksum( $sums_to_check, $name, $new_sum ) {
 		if ( isset( $sums_to_check[ $name ] ) && $sums_to_check[ $name ] === $new_sum ) {
 			return true;
@@ -38,6 +44,11 @@ 
 		return false;
 	}
 
+	/**
+	 * @param string $action_name
+	 * @param string $id_field
+	 * @param null|string $where_sql
+	 */
 	protected function enqueue_all_ids_as_action( $action_name, $table_name, $id_field, $where_sql ) {
 		global $wpdb;
 
@@ -71,6 +82,9 @@ 
 		return $chunk_count;
 	}
 
+	/**
+	 * @param string $meta_type
+	 */
 	protected function get_metadata( $ids, $meta_type ) {
 		global $wpdb;
 		$table = _get_meta_table( $meta_type );