WPInv_REST_Items_Controller::get_items()

Complexity

Conditions	5
Paths	9

Size

Total Lines	66
Code Lines	20

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

3 Methods

Rating	Name	Duplication	Size	Complexity
A	WPInv_REST_Items_Controller::get_allowed_query_vars()	0	3	1
A	WPInv_REST_Items_Controller::prepare_items_query()	0	22	4
A	WPInv_REST_Items_Controller::get_post_statuses()	0	2	1

<?php
/**
 * REST items controllers.
 *
 * @version 1.0.19
 */

defined( 'ABSPATH' ) || exit;

/**
 * REST API items controller class.
 *
 * @package Invoicing
 */
class WPInv_REST_Items_Controller extends GetPaid_REST_Posts_Controller {

    /**
	 * Post type.
	 *
	 * @var string
	 */
	protected $post_type = 'wpi_item';
	
	/**
	 * The base of this controller's route.
	 *
	 * @since 1.0.13
	 * @var string
	 */
	protected $rest_base = 'items';

	/** Contains this controller's class name.
	 *
	 * @var string
	 */
	public $crud_class = 'WPInv_Item';

	/**
	 * Registers the routes for the objects of the controller.
	 *
	 * @since 1.0.19
	 *
	 * @see register_rest_route()
	 */
	public function register_namespace_routes( $namespace ) {

		parent::register_namespace_routes( $namespace );

		register_rest_route(
			$this->namespace,
			'/' . $this->rest_base . '/item-types',
			array(
				array(
					'methods'             => WP_REST_Server::READABLE,
					'callback'            => array( $this, 'get_item_types' ),
					'permission_callback' => array( $this, 'get_items_permissions_check' ),
				),
			)
		);

	}

	/**
	 * Handles rest requests for item types.
	 *
	 * @since 1.0.13
	 * 
	 * 
	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
	 */
	public function get_item_types() {
		return rest_ensure_response( wpinv_get_item_types() );
	}

    /**
	 * Retrieves the query params for the items collection.
	 *
	 * @since 1.0.13
	 *
	 * @return array Collection parameters.
	 */
	public function get_collection_params() {

		$params = array_merge(

			parent::get_collection_params(),

        	array(

				// Item types
				'type'                  => array(
					'description'       => __( 'Type of items to fetch.', 'invoicing' ),
					'type'              => array( 'array', 'string' ),
					'default'           => 'any',
					'items'             => array(
						'enum'          => array_merge( array( 'any' ), wpinv_item_types() ),
						'type'          => 'string',
					),
				),

			)
		);

		// Filter collection parameters for the items controller.
		return apply_filters( 'getpaid_rest_items_collection_params', $params, $this );

	}
	
	/**
	 * Get all the WP Query vars that are allowed for the API request.
	 *
	 * @return array
	 */
	protected function get_allowed_query_vars() {
		$vars = array_merge( array( 'type' ), parent::get_allowed_query_vars() );
		return apply_filters( 'getpaid_rest_items_allowed_query_vars', $vars, $this );
	}

	/**
	 * Determine the allowed query_vars for a get_items() response and
	 * prepare for WP_Query.
	 *
	 * @param array           $prepared_args Prepared arguments.
	 * @param WP_REST_Request $request Request object.
	 * @return array          $query_args
	 */
	protected function prepare_items_query( $prepared_args = array(), $request = null ) {

		$query_args = parent::prepare_items_query( $prepared_args );

		// Retrieve items by type.
		if (  isset( $query_args['type'] ) && 'any' != $query_args['type'] ) {

			if ( empty( $query_args['meta_query'] ) ) {
				$query_args['meta_query'] = array();
			}

			$types = wpinv_parse_list( $query_args['type'] );
			$query_args['meta_query'][] = array(
				'key'     => '_wpinv_type',
				'value'   => implode( ',', $types ),
				'compare' => 'IN',
			);
			unset( $query_args['type'] );

		}

		return apply_filters( 'getpaid_rest_items_prepare_items_query', $query_args, $request, $this );

	}

	/**
	 * Retrieves a valid list of post statuses.
	 *
	 * @since 1.0.15
	 *
	 * @return array A list of registered item statuses.
	 */
	public function get_post_statuses() {
		return array( 'draft', 'pending', 'publish' );
	}

}