ChargesRestServiceProvider.php — SureCart – Ecommerce Made Easy For Selling Physical Products, Digital Downloads, Subscriptions, Donations, & Payments 2.6.1

surecart / app / src / Rest / ChargesRestServiceProvider.php

surecart / app / src / Rest Last commit date

ChargesRestServiceProvider.php

105 lines

1	<?php
2
3	namespace SureCart\Rest;
4
5	use SureCart\Controllers\Rest\ChargesController;
6	use SureCart\Rest\RestServiceInterface;
7
8	/**
9	* Service provider for Price Rest Requests
10	*/
11	class ChargesRestServiceProvider extends RestServiceProvider implements RestServiceInterface {
12	/**
13	* Endpoint.
14	*
15	* @var string
16	*/
17	protected $endpoint = 'charges';
18
19	/**
20	* Rest Controller
21	*
22	* @var string
23	*/
24	protected $controller = ChargesController::class;
25
26	/**
27	* Methods allowed for the model.
28	*
29	* @var array
30	*/
31	protected $methods = [ 'index', 'find' ];
32
33	/**
34	* Register REST Routes
35	*
36	* @return void
37	*/
38	public function registerRoutes() {
39	register_rest_route(
40	"$this->name/v$this->version",
41	$this->endpoint . '/(?P<id>\S+)/refund/',
42	[
43	[
44	'methods' => \WP_REST_Server::EDITABLE,
45	'callback' => $this->callback( $this->controller, 'refund' ),
46	'permission_callback' => [ $this, 'update_item_permissions_check' ],
47	],
48	// Register our schema callback.
49	'schema' => [ $this, 'get_item_schema' ],
50	]
51	);
52	}
53
54	/**
55	* Get our sample schema for a post.
56	*
57	* @return array The sample schema for a post
58	*/
59	public function get_item_schema() {
60	if ( $this->schema ) {
61	// Since WordPress 5.3, the schema can be cached in the $schema property.
62	return $this->schema;
63	}
64
65	$this->schema = [
66	// This tells the spec of JSON Schema we are using which is draft 4.
67	'$schema' => 'http://json-schema.org/draft-04/schema#',
68	// The title property marks the identity of the resource.
69	'title' => $this->endpoint,
70	'type' => 'object',
71	// In JSON Schema you can specify object properties in the properties attribute.
72	'properties' => [
73	'id' => [
74	'description' => esc_html__( 'Unique identifier for the object.', 'surecart' ),
75	'type' => 'string',
76	'context' => [ 'view', 'edit', 'embed' ],
77	'readonly' => true,
78	],
79	],
80	];
81
82	return $this->schema;
83	}
84
85	/**
86	* Check if the current user can read a charge.
87	*
88	* @param \WP_REST_Request $request Full details about the request.
89	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
90	*/
91	public function get_item_permissions_check( $request ) {
92	return current_user_can( 'read_sc_charge', $request['id'] );
93	}
94
95	/**
96	* Need priveleges to read checkout sessions.
97	*
98	* @param \WP_REST_Request $request Full details about the request.
99	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
100	*/
101	public function get_items_permissions_check( $request ) {
102	return current_user_can( 'read_sc_charges', $request->get_params() );
103	}
104	}
105