ReviewsRestServiceProvider.php at 4.2.2 · SureCart – Ecommerce Made Easy For Selling Physical Products, Digital Downloads, Subscriptions, Donations, & Payments

surecart / app / src / Rest / ReviewsRestServiceProvider.php

ReviewsRestServiceProvider.php

244 lines 7.2 KB

Raw Download Zip

1	<?php
2
3	namespace SureCart\Rest;
4
5	use SureCart\Rest\RestServiceInterface;
6	use SureCart\Controllers\Rest\ReviewsController;
7
8	/**
9	* Service provider for Review Rest Requests
10	*/
11	class ReviewsRestServiceProvider extends RestServiceProvider implements RestServiceInterface {
12	/**
13	* Endpoint.
14	*
15	* @var string
16	*/
17	protected $endpoint = 'reviews';
18
19	/**
20	* Rest Controller
21	*
22	* @var string
23	*/
24	protected $controller = ReviewsController::class;
25
26	/**
27	* Register Additional REST Routes
28	*
29	* @return void
30	*/
31	public function registerRoutes() {
32	register_rest_route(
33	"$this->name/v$this->version",
34	$this->endpoint . '/(?P<id>\S+)/publish/',
35	[
36	[
37	'methods' => \WP_REST_Server::EDITABLE,
38	'callback' => $this->callback( $this->controller, 'publish' ),
39	'permission_callback' => [ $this, 'update_item_permissions_check' ],
40	],
41	// Register our schema callback.
42	'schema' => [ $this, 'get_item_schema' ],
43	]
44	);
45
46	register_rest_route(
47	"$this->name/v$this->version",
48	$this->endpoint . '/(?P<id>\S+)/unpublish/',
49	[
50	[
51	'methods' => \WP_REST_Server::EDITABLE,
52	'callback' => $this->callback( $this->controller, 'unpublish' ),
53	'permission_callback' => [ $this, 'update_item_permissions_check' ],
54	],
55	// Register our schema callback.
56	'schema' => [ $this, 'get_item_schema' ],
57	]
58	);
59	}
60
61	/**
62	* Get our sample schema for a post.
63	*
64	* @return array The sample schema for a post
65	*/
66	public function get_item_schema() {
67	if ( $this->schema ) {
68	// Since WordPress 5.3, the schema can be cached in the $schema property.
69	return $this->schema;
70	}
71
72	$this->schema = [
73	// This tells the spec of JSON Schema we are using which is draft 4.
74	'$schema' => 'http://json-schema.org/draft-04/schema#',
75	// The title property marks the identity of the resource.
76	'title' => $this->endpoint,
77	'type' => 'object',
78	// In JSON Schema you can specify object properties in the properties attribute.
79	'properties' => [
80	'id' => [
81	'description' => esc_html__( 'Unique identifier for the object.', 'surecart' ),
82	'type' => 'string',
83	'context' => [ 'view', 'edit', 'embed' ],
84	'readonly' => true,
85	],
86	'object' => [
87	'description' => esc_html__( 'Type of object.', 'surecart' ),
88	'type' => 'string',
89	'context' => [ 'view', 'edit', 'embed' ],
90	'readonly' => true,
91	],
92	'body' => [
93	'description' => esc_html__( 'Review body content.', 'surecart' ),
94	'type' => 'string',
95	'context' => [ 'view', 'edit' ],
96	],
97	'status' => [
98	'description' => esc_html__( 'Review status.', 'surecart' ),
99	'type' => 'string',
100	'enum' => [ 'published', 'in_review', 'unpublished' ],
101	'context' => [ 'view', 'edit' ],
102	],
103	'title' => [
104	'description' => esc_html__( 'Review title.', 'surecart' ),
105	'type' => 'string',
106	'context' => [ 'view', 'edit' ],
107	],
108	'stars' => [
109	'description' => esc_html__( 'Review rating in stars (1-5).', 'surecart' ),
110	'type' => 'integer',
111	'minimum' => 1,
112	'maximum' => 5,
113	'context' => [ 'view', 'edit' ],
114	],
115	'verified' => [
116	'description' => esc_html__( 'Whether the review is verified.', 'surecart' ),
117	'type' => 'boolean',
118	'context' => [ 'view', 'edit' ],
119	'readonly' => true,
120	],
121	'customer' => [
122	'description' => esc_html__( 'The customer who wrote the review.', 'surecart' ),
123	'type' => 'string',
124	'context' => [ 'view', 'edit' ],
125	],
126	'product' => [
127	'description' => esc_html__( 'The product being reviewed.', 'surecart' ),
128	'type' => 'string',
129	'context' => [ 'view', 'edit' ],
130	],
131	'purchase' => [
132	'description' => esc_html__( 'The purchase associated with this review.', 'surecart' ),
133	'type' => [ 'string', 'null' ],
134	'context' => [ 'view', 'edit' ],
135	],
136	],
137	];
138
139	return $this->schema;
140	}
141
142	/**
143	* Get the collection params.
144	*
145	* @return array
146	*/
147	public function get_collection_params() {
148	return [
149	'status' => [
150	'description' => esc_html__( 'Filter by review status.', 'surecart' ),
151	'type' => 'string',
152	'enum' => [ 'published', 'in_review', 'unpublished' ],
153	],
154	'product_ids' => [
155	'description' => esc_html__( 'Only return reviews for the given products.', 'surecart' ),
156	'type' => 'array',
157	'items' => [
158	'type' => 'string',
159	],
160	'default' => [],
161	],
162	'customer_ids' => [
163	'description' => esc_html__( 'Only return reviews from the given customers.', 'surecart' ),
164	'type' => 'array',
165	'items' => [
166	'type' => 'string',
167	],
168	'default' => [],
169	],
170	'verified' => [
171	'description' => esc_html__( 'Only return verified or unverified reviews.', 'surecart' ),
172	'type' => 'boolean',
173	],
174	'query' => [
175	'description' => esc_html__( 'The query to be used for full text search of this collection.', 'surecart' ),
176	'type' => 'string',
177	],
178	'page' => [
179	'description' => esc_html__( 'The page of items you want returned.', 'surecart' ),
180	'type' => 'integer',
181	],
182	'per_page' => [
183	'description' => esc_html__( 'A limit on the number of items to be returned, between 1 and 100.', 'surecart' ),
184	'type' => 'integer',
185	],
186	];
187	}
188
189	/**
190	* Who can list reviews?
191	*
192	* @param \WP_REST_Request $request Full details about the request.
193	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
194	*/
195	public function get_items_permissions_check( $request ) {
196	return current_user_can( 'read_sc_reviews' );
197	}
198
199	/**
200	* Who can get a specific review?
201	*
202	* @param \WP_REST_Request $request Full details about the request.
203	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
204	*/
205	public function get_item_permissions_check( $request ) {
206	return current_user_can( 'read_sc_reviews' );
207	}
208
209	/**
210	* Create review.
211	*
212	* @param \WP_REST_Request $request Full details about the request.
213	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
214	*/
215	public function create_item_permissions_check( $request ) {
216	// If customer, product, or purchase are passed, user must have edit_sc_reviews permission.
217	if ( ! empty( $request->get_param( 'customer' ) ) \|\| ! empty( $request->get_param( 'purchase' ) ) ) {
218	return current_user_can( 'edit_sc_reviews' );
219	}
220
221	return is_user_logged_in();
222	}
223
224	/**
225	* Update review.
226	*
227	* @param \WP_REST_Request $request Full details about the request.
228	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
229	*/
230	public function update_item_permissions_check( $request ) {
231	return current_user_can( 'edit_sc_reviews' );
232	}
233
234	/**
235	* Delete review.
236	*
237	* @param \WP_REST_Request $request Full details about the request.
238	* @return true\|\WP_Error True if the request has access to create items, WP_Error object otherwise.
239	*/
240	public function delete_item_permissions_check( $request ) {
241	return current_user_can( 'delete_sc_reviews' );
242	}
243	}
244