initial commit

2021-12-10 12:03:04 +00:00
commit c46c7ddbf0
3643 changed files with 582794 additions and 0 deletions
--- a/packages/woocommerce-admin/src/API/Marketing.php
+++ b/packages/woocommerce-admin/src/API/Marketing.php
@ -0,0 +1,120 @@
+<?php
+/**
+ * REST API Marketing Controller
+ *
+ * Handles requests to /marketing.
+ */
+
+namespace Automattic\WooCommerce\Admin\API;
+
+use Automattic\WooCommerce\Admin\Features\Marketing as MarketingFeature;
+use Automattic\WooCommerce\Admin\PluginsHelper;
+
+defined( 'ABSPATH' ) || exit;
+
+/**
+ * Marketing Controller.
+ *
+ * @extends WC_REST_Data_Controller
+ */
+class Marketing extends \WC_REST_Data_Controller {
+
+	/**
+	 * Endpoint namespace.
+	 *
+	 * @var string
+	 */
+	protected $namespace = 'wc-admin';
+
+	/**
+	 * Route base.
+	 *
+	 * @var string
+	 */
+	protected $rest_base = 'marketing';
+
+	/**
+	 * Register routes.
+	 */
+	public function register_routes() {
+		register_rest_route(
+			$this->namespace,
+			'/' . $this->rest_base . '/recommended',
+			array(
+				array(
+					'methods'             => \WP_REST_Server::READABLE,
+					'callback'            => array( $this, 'get_recommended_plugins' ),
+					'permission_callback' => array( $this, 'get_items_permissions_check' ),
+					'args'                => array(
+						'per_page' => $this->get_collection_params()['per_page'],
+						'category' => array(
+							'type'              => 'string',
+							'validate_callback' => 'rest_validate_request_arg',
+							'sanitize_callback' => 'sanitize_title_with_dashes',
+						),
+					),
+				),
+				'schema' => array( $this, 'get_public_item_schema' ),
+			)
+		);
+
+		register_rest_route(
+			$this->namespace,
+			'/' . $this->rest_base . '/knowledge-base',
+			array(
+				array(
+					'methods'             => \WP_REST_Server::READABLE,
+					'callback'            => array( $this, 'get_knowledge_base_posts' ),
+					'permission_callback' => array( $this, 'get_items_permissions_check' ),
+					'args'                => array(
+						'category' => array(
+							'type'              => 'string',
+							'validate_callback' => 'rest_validate_request_arg',
+							'sanitize_callback' => 'sanitize_title_with_dashes',
+						),
+					),
+				),
+				'schema' => array( $this, 'get_public_item_schema' ),
+			)
+		);
+	}
+
+	/**
+	 * Return installed marketing extensions data.
+	 *
+	 * @param \WP_REST_Request $request Request data.
+	 *
+	 * @return \WP_Error|\WP_REST_Response
+	 */
+	public function get_recommended_plugins( $request ) {
+		// Default to marketing category (if no category set).
+		$category      = ( ! empty( $request->get_param( 'category' ) ) ) ? $request->get_param( 'category' ) : 'marketing';
+		$all_plugins   = MarketingFeature::get_instance()->get_recommended_plugins();
+		$valid_plugins = [];
+		$per_page      = $request->get_param( 'per_page' );
+
+		foreach ( $all_plugins as $plugin ) {
+
+			// default to marketing if 'categories' is empty on the plugin object (support for legacy api while testing).
+			$plugin_categories = ( ! empty( $plugin['categories'] ) ) ? $plugin['categories'] : [ 'marketing' ];
+
+			if ( ! PluginsHelper::is_plugin_installed( $plugin['plugin'] ) && in_array( $category, $plugin_categories, true ) ) {
+				$valid_plugins[] = $plugin;
+			}
+		}
+
+		return rest_ensure_response( array_slice( $valid_plugins, 0, $per_page ) );
+	}
+
+	/**
+	 * Return installed marketing extensions data.
+	 *
+	 * @param \WP_REST_Request $request Request data.
+	 *
+	 * @return \WP_Error|\WP_REST_Response
+	 */
+	public function get_knowledge_base_posts( $request ) {
+		$category = $request->get_param( 'category' );
+		return rest_ensure_response( MarketingFeature::get_instance()->get_knowledge_base_posts( $category ) );
+	}
+}