121 lines
3.3 KiB
PHP
121 lines
3.3 KiB
PHP
<?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 ) );
|
|
}
|
|
}
|