Add form responses v2 endpoint

projects/packages/forms/changelog/add-form-responses-v2-endpoint

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Add v2/v4 endpoint for form responses inbox

projects/packages/forms/composer.json

@@ -58,7 +58,7 @@
 			"link-template": "https://github.com/automattic/jetpack-forms/compare/v${old}...v${new}"
 		},
 		"branch-alias": {
-			"dev-trunk": "0.5.x-dev"
+			"dev-trunk": "0.6.x-dev"
 		},
 		"textdomain": "jetpack-forms",
 		"version-constants": {

projects/packages/forms/package.json

@@ -1,7 +1,7 @@
 {
 	"private": true,
 	"name": "@automattic/jetpack-forms",
-	"version": "0.5.1",
+	"version": "0.6.0-alpha",
 	"description": "Jetpack Forms",
 	"homepage": "https://github.com/Automattic/jetpack/tree/HEAD/projects/packages/forms/#readme",
 	"bugs": {

projects/packages/forms/src/class-jetpack-forms.php

@@ -14,7 +14,7 @@
  */
 class Jetpack_Forms {
 
-	const PACKAGE_VERSION = '0.5.1';
+	const PACKAGE_VERSION = '0.6.0-alpha';
 
 	/**
 	 * Load the contact form module.
@@ -43,6 +43,8 @@ public static function load_contact_form() {
 		}
 
 		add_action( 'init', '\Automattic\Jetpack\Forms\ContactForm\Util::register_pattern' );
+
+		add_action( 'rest_api_init', array( new WPCOM_REST_API_V2_Endpoint_Forms(), 'register_rest_routes' ) );
 	}
 
 	/**

projects/packages/forms/src/class-wpcom-rest-api-v2-endpoint-forms.php

@@ -0,0 +1,255 @@
+<?php
+/**
+ * The Forms Rest Controller class.
+ * Registers the REST routes for Jetpack Forms (taken from stats-admin).
+ *
+ * @package automattic/jetpack-forms
+ */
+
+namespace Automattic\Jetpack\Forms;
+
+use Jetpack_Options;
+use WP_Error;
+use WP_REST_Controller;
+use WP_REST_Server;
+
+/**
+ * Handles the REST routes for Form Responses, aka Feedback.
+ * Routes are defined on Jetpack Plugin as WPCOM_REST_API_V2_Endpoint_Forms.
+ */
+class WPCOM_REST_API_V2_Endpoint_Forms extends WP_REST_Controller {
+	/**
+	 * Is WPCOM or not
+	 *
+	 * @var bool
+	 */
+	protected $is_wpcom;
+
+	/**
+	 * Constructor.
+	 */
+	public function __construct() {
+		$this->is_wpcom = defined( 'IS_WPCOM' ) && IS_WPCOM;
+
+		$this->namespace = 'wpcom/v2';
+		$this->rest_base = 'forms';
+
+		add_action( 'rest_api_init', array( $this, 'register_rest_routes' ) );
+	}
+
+	/**
+	 * Registers the REST routes.
+	 *
+	 * Odyssey Stats is built from `wp-calypso`, which leverages the `public-api.wordpress.com` API.
+	 * The current Site ID is added as part of the route, so that the front end doesn't have to handle the differences.
+	 *
+	 * @access public
+	 */
+	public function register_rest_routes() {
+		// Stats for single resource type.
+
+		register_rest_route(
+			$this->namespace,
+			$this->rest_base . '/responses',
+			array(
+				'methods'           => WP_REST_Server::READABLE,
+				'callback'          => array( $this, 'get_responses' ),
+				'permissions_check' => array( $this, 'get_responses_permission_check' ),
+				'args'              => array(
+					'limit'   => array(
+						'default'           => 20,
+						'type'              => 'integer',
+						'required'          => false,
+						'validate_callback' => __CLASS__ . '::validate_posint',
+					),
+					'offset'  => array(
+						'default'           => 0,
+						'type'              => 'integer',
+						'required'          => false,
+						'validate_callback' => __CLASS__ . '::validate_non_neg_int',
+					),
+					'form_id' => array(
+						'type'              => 'integer',
+						'required'          => false,
+						'validate_callback' => __CLASS__ . '::validate_posint',
+					),
+					'search'  => array(
+						'type'              => 'text',
+						'required'          => false,
+						'validate_callback' => __CLASS__ . '::validate_string',
+					),
+				),
+			)
+		);
+	}
+
+	/**
+	 * Validates that the parameter is a positive integer.
+	 *
+	 * @since 4.3.0
+	 *
+	 * @param int             $value Value to check.
+	 * @param WP_REST_Request $request The request sent to the WP REST API.
+	 * @param string          $param Name of the parameter passed to endpoint holding $value.
+	 *
+	 * @return bool|WP_Error
+	 */
+	public static function validate_posint( $value, $request, $param ) {
+		if ( ! is_numeric( $value ) || $value <= 0 ) {
+			return new WP_Error(
+				'invalid_param',
+				sprintf(
+					/* Translators: Placeholder is a parameter name. */
+					esc_html__( '%s must be a positive integer.', 'jetpack-forms' ),
+					$param
+				)
+			);
+		}
+		return true;
+	}
+
+	/**
+	 * Validates that the parameter is a non-negative integer (includes 0).
+	 *
+	 * @since 10.4.0
+	 *
+	 * @param int             $value Value to check.
+	 * @param WP_REST_Request $request The request sent to the WP REST API.
+	 * @param string          $param Name of the parameter passed to endpoint holding $value.
+	 *
+	 * @return bool|WP_Error
+	 */
+	public static function validate_non_neg_int( $value, $request, $param ) {
+		if ( ! is_numeric( $value ) || $value < 0 ) {
+			return new WP_Error(
+				'invalid_param',
+				/* translators: %s: The literal parameter name. Should not be translated. */
+				sprintf( esc_html__( '%s must be a non-negative integer.', 'jetpack-forms' ), $param )
+			);
+		}
+		return true;
+	}
+
+	/**
+	 * Validates that the parameter is a string.
+	 *
+	 * @since 4.3.0
+	 *
+	 * @param string          $value Value to check.
+	 * @param WP_REST_Request $request The request sent to the WP REST API.
+	 * @param string          $param Name of the parameter passed to endpoint holding $value.
+	 *
+	 * @return bool|WP_Error
+	 */
+	public static function validate_string( $value, $request, $param ) {
+		if ( ! is_string( $value ) ) {
+			return new WP_Error(
+				'invalid_param',
+				sprintf(
+					/* Translators: Placeholder is a parameter name. */
+					esc_html__( '%s must be a string.', 'jetpack-forms' ),
+					$param
+				)
+			);
+		}
+		return true;
+	}
+
+	/**
+	 * Returns Jetpack Forms responses.
+	 *
+	 * @param WP_REST_Request $request The request sent to the WP REST API.
+	 *
+	 * @return WP_REST_Response A response object containing Jetpack Forms responses.
+	 */
+	public function get_responses( $request ) {
+		$args = array(
+			'post_type'   => 'feedback',
+			'post_status' => array( 'publish', 'draft' ),
+		);
+
+		if ( isset( $request['form_id'] ) ) {
+			$args['post_parent'] = $request['form_id'];
+		}
+
+		if ( isset( $request['limit'] ) ) {
+			$args['posts_per_page'] = $request['limit'];
+		}
+
+		if ( isset( $request['offset'] ) ) {
+			$args['offset'] = $request['offset'];
+		}
+
+		if ( isset( $request['search'] ) ) {
+			$args['s'] = $request['search'];
+		}
+
+		$query = new \WP_Query( $args );
+
+		$responses = array_map(
+			function ( $response ) {
+				$data = \Automattic\Jetpack\Forms\ContactForm\Contact_Form_Plugin::parse_fields_from_content( $response->ID );
+
+				return array(
+					'id'                      => $response->ID,
+					'uid'                     => $data['all_fields']['feedback_id'],
+					'date'                    => get_the_date( 'c', $data ),
+					'author_name'             => $data['_feedback_author'],
+					'author_email'            => $data['_feedback_author_email'],
+					'author_url'              => $data['_feedback_author_url'],
+					'author_avatar'           => empty( $data['_feedback_author_email'] ) ? '' : get_avatar_url( $data['_feedback_author_email'] ),
+					'email_marketing_consent' => $data['all_fields']['email_marketing_consent'],
+					'ip'                      => $data['_feedback_ip'],
+					'entry_title'             => $data['all_fields']['entry_title'],
+					'entry_permalink'         => $data['all_fields']['entry_permalink'],
+					'subject'                 => $data['_feedback_subject'],
+					'fields'                  => array_diff_key(
+						$data['all_fields'],
+						array(
+							'email_marketing_consent' => '',
+							'entry_title'             => '',
+							'entry_permalink'         => '',
+							'feedback_id'             => '',
+						)
+					),
+				);
+			},
+			$query->posts
+		);
+
+		return rest_ensure_response(
+			array(
+				'responses' => $responses,
+				'total'     => $query->found_posts,
+			)
+		);
+	}
+
+	/**
+	 * Verifies that the current user has the requird capability for viewing form responses.
+	 *
+	 * @return true|WP_Error Returns true if the user has the required capability, else a WP_Error object.
+	 */
+	public function get_responses_permission_check() {
+		if ( ! is_user_member_of_blog( get_current_user_id(), $this->get_blog_id() ) ) {
+			return new WP_Error(
+				'invalid_user_permission_jetpack_form_responses',
+				'unauthorized',
+				array( 'status' => rest_authorization_required_code() )
+			);
+		}
+
+		return true;
+	}
+
+	/**
+	 * Get blog ID selectively depending on IS_WPCOM or not
+	 */
+	protected function get_blog_id() {
+		return $this->is_wpcom ? get_current_blog_id() : Jetpack_Options::get_option( 'id' );
+	}
+}
+
+if ( defined( 'IS_WPCOM' ) && IS_WPCOM ) {
+	wpcom_rest_api_v2_load_plugin( 'Automattic\Jetpack\Forms\WPCOM_REST_API_V2_Endpoint_Forms' );
+}

projects/packages/forms/src/contact-form/class-contact-form-plugin.php

@@ -2009,6 +2009,7 @@ public static function parse_fields_from_content( $post_id ) {
 		}
 
 		$fields['_feedback_all_fields'] = $all_values;
+		$fields['all_fields']           = $all_values;
 
 		$post_fields[ $post_id ] = $fields;
 

projects/packages/forms/src/dashboard/class-dashboard.php

@@ -47,11 +47,22 @@ public function load_admin_scripts( $hook ) {
 			'../../dist/dashboard/jetpack-forms-dashboard.js',
 			__FILE__,
 			array(
-				'in_footer'  => true,
-				'textdomain' => 'jetpack-forms',
-				'enqueue'    => true,
+				'in_footer'    => true,
+				'textdomain'   => 'jetpack-forms',
+				'enqueue'      => true,
+				'dependencies' => array( 'wp-api-fetch' ), // this here just for testing, remove when done (apiFetch will be on build)
 			)
 		);
+
+		$api_root = defined( 'IS_WPCOM' ) && IS_WPCOM
+			? sprintf( '/wpcom/v2/sites/%s/', esc_url_raw( rest_url() ) ) // should we include full URL here (public-api.wordpress.com)?
+			: '/wp-json/wpcom/v2/';
+
+		wp_add_inline_script(
+			'jp-forms-dashboard',
+			'window.jetpackFormsData = ' . wp_json_encode( array( 'apiRoot' => $api_root ) ) . ';',
+			'before'
+		);
 	}
 
 	/**

projects/plugins/jetpack/changelog/add-form-responses-v2-endpoint

@@ -0,0 +1,4 @@
+Significance: minor
+Type: other
+
+Add wpcom/v2/form-responses endpoint, mapped from .com

projects/plugins/jetpack/changelog/add-form-responses-v2-endpoint#2

@@ -0,0 +1,5 @@
+Significance: patch
+Type: other
+Comment: Updated composer.lock.
+
+