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

surecart / app / src / Rest / SubscriptionRestServiceProvider.php

surecart / app / src / Rest Last commit date

SubscriptionRestServiceProvider.php

208 lines

1	<?php
2
3	namespace SureCart\Rest;
4
5	use SureCart\Rest\RestServiceInterface;
6	use SureCart\Controllers\Rest\SubscriptionsController;
7	/**
8	* Service provider for Price Rest Requests
9	*/
10	class SubscriptionRestServiceProvider extends RestServiceProvider implements RestServiceInterface {
11	/**
12	* Endpoint.
13	*
14	* @var string
15	*/
16	protected $endpoint = 'subscriptions';
17
18	/**
19	* Rest Controller
20	*
21	* @var string
22	*/
23	protected $controller = SubscriptionsController::class;
24
25	/**
26	* Methods allowed for the model.
27	*
28	* @var array
29	*/
30	protected $methods = [ 'index', 'find', 'edit' ];
31
32	/**
33	* Register REST Routes
34	*
35	* @return void
36	*/
37	public function registerRoutes() {
38	register_rest_route(
39	"$this->name/v$this->version",
40	$this->endpoint . '/(?P<id>\S+)/cancel/',
41	[
42	[
43	'methods' => \WP_REST_Server::EDITABLE,
44	'callback' => $this->callback( $this->controller, 'cancel' ),
45	'permission_callback' => [ $this, 'cancel_permissions_check' ],
46	],
47	// Register our schema callback.
48	'schema' => [ $this, 'get_item_schema' ],
49	]
50	);
51
52	register_rest_route(
53	"$this->name/v$this->version",
54	$this->endpoint . '/(?P<id>\S+)/complete/',
55	[
56	[
57	'methods' => \WP_REST_Server::EDITABLE,
58	'callback' => $this->callback( $this->controller, 'complete' ),
59	'permission_callback' => [ $this, 'cancel_permissions_check' ],
60	],
61	// Register our schema callback.
62	'schema' => [ $this, 'get_item_schema' ],
63	]
64	);
65
66	register_rest_route(
67	"$this->name/v$this->version",
68	$this->endpoint . '/(?P<id>\S+)/restore/',
69	[
70	[
71	'methods' => \WP_REST_Server::EDITABLE,
72	'callback' => $this->callback( $this->controller, 'restore' ),
73	'permission_callback' => [ $this, 'cancel_permissions_check' ],
74	],
75	// Register our schema callback.
76	'schema' => [ $this, 'get_item_schema' ],
77	]
78	);
79
80	register_rest_route(
81	"$this->name/v$this->version",
82	$this->endpoint . '/(?P<id>\S+)/renew/',
83	[
84	[
85	'methods' => \WP_REST_Server::EDITABLE,
86	'callback' => $this->callback( $this->controller, 'renew' ),
87	'permission_callback' => [ $this, 'update_item_permissions_check' ],
88	],
89	// Register our schema callback.
90	'schema' => [ $this, 'get_item_schema' ],
91	]
92	);
93
94	register_rest_route(
95	"$this->name/v$this->version",
96	$this->endpoint . '/(?P<id>\S+)/preserve/',
97	[
98	[
99	'methods' => \WP_REST_Server::EDITABLE,
100	'callback' => $this->callback( $this->controller, 'preserve' ),
101	'permission_callback' => [ $this, 'update_item_permissions_check' ],
102	],
103	// Register our schema callback.
104	'schema' => [ $this, 'get_item_schema' ],
105	]
106	);
107
108	register_rest_route(
109	"$this->name/v$this->version",
110	$this->endpoint . '/(?P<id>\S+)/upcoming_period/',
111	[
112	[
113	'methods' => \WP_REST_Server::EDITABLE,
114	'callback' => $this->callback( $this->controller, 'upcomingPeriod' ),
115	'permission_callback' => [ $this, 'get_item_permissions_check' ],
116	],
117	// Register our schema callback.
118	'schema' => [ $this, 'get_item_schema' ],
119	]
120	);
121	}
122
123	/**
124	* Get our sample schema for a post.
125	*
126	* @return array The sample schema for a post
127	*/
128	public function get_item_schema() {
129	if ( $this->schema ) {
130	// Since WordPress 5.3, the schema can be cached in the $schema property.
131	return $this->schema;
132	}
133
134	$this->schema = [
135	// This tells the spec of JSON Schema we are using which is draft 4.
136	'$schema' => 'http://json-schema.org/draft-04/schema#',
137	// The title property marks the identity of the resource.
138	'title' => $this->endpoint,
139	'type' => 'object',
140	// In JSON Schema you can specify object properties in the properties attribute.
141	'properties' => [
142	'id' => [
143	'description' => esc_html__( 'Unique identifier for the object.', 'surecart' ),
144	'type' => 'string',
145	'context' => [ 'view', 'edit', 'embed' ],
146	'readonly' => true,
147	],
148	'trial_end_at' => [
149	'type' => 'integer',
150	'admin_only' => true,
151	],
152	],
153	];
154
155	return $this->schema;
156	}
157
158	/**
159	* Anyone can get a specific subscription
160	*
161	* @param \WP_REST_Request $request Full details about the request.
162	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
163	*/
164	public function get_item_permissions_check( $request ) {
165	return current_user_can( 'read_sc_subscription', $request['id'] );
166	}
167
168	/**
169	* Need priveleges to read checkout sessions.
170	*
171	* @param \WP_REST_Request $request Full details about the request.
172	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
173	*/
174	public function get_items_permissions_check( $request ) {
175	return current_user_can( 'read_sc_subscriptions', $request->get_params() );
176	}
177
178	/**
179	* Check update permissions.
180	*
181	* @param \WP_REST_Request $request Full details about the request.
182	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
183	*/
184	public function update_item_permissions_check( $request ) {
185	return current_user_can( 'edit_sc_subscription', $request['id'], $request->get_params() );
186	}
187
188	/**
189	* Check cancel permissions.
190	*
191	* @param \WP_REST_Request $request Full details about the request.
192	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
193	*/
194	public function cancel_permissions_check( $request ) {
195	return current_user_can( 'cancel_sc_subscription', $request['id'] );
196	}
197
198	/**
199	* Nobody can delete.
200	*
201	* @param \WP_REST_Request $request Full details about the request.
202	* @return false
203	*/
204	public function delete_item_permissions_check( $request ) {
205	return false;
206	}
207	}
208