give / includes / api / class-give-api-v2.php

class-give-api-v2.php in GiveWP – Donation Plugin and Fundraising Platform 2.12.0, at includes/api/class-give-api-v2.php

213 lines 4.1 KB

Raw Download Zip

1	<?php
2	/**
3	* Give API V2
4	*
5	* @package Give
6	* @subpackage Classes/API
7	* @copyright Copyright (c) 2018, GiveWP
8	* @license https://opensource.org/licenses/gpl-license GNU Public License
9	* @since 2.1
10	*/
11
12	// Exit if accessed directly.
13	if ( ! defined( 'ABSPATH' ) ) {
14	exit;
15	}
16
17
18	/**
19	* Give_API_V2 Class
20	*
21	* The base version API class
22	*
23	* @since 2.1
24	*/
25	class Give_API_V2 {
26	/**
27	* API base prefix
28	*
29	* @since 2.1
30	* @access private
31	*
32	* @var string
33	*/
34	private $rest_base = 'give-api/v2';
35
36	/**
37	* Instance.
38	*
39	* @since 2.1
40	* @access private
41	*
42	* @var Give_API_V2
43	*/
44	private static $instance;
45
46	/**
47	* Singleton pattern.
48	*
49	* @since 2.1
50	* @access private
51	*/
52	private function __construct() {
53	}
54
55
56	/**
57	* Get instance.
58	*
59	* @since 2.1
60	* @access public
61	* @return Give_API_V2
62	*/
63	public static function get_instance() {
64	if ( null === static::$instance ) {
65	self::$instance = new static();
66
67	self::$instance->init();
68	}
69
70	return self::$instance;
71	}
72
73
74	/**
75	* Initialize API
76	*
77	* @since 2.1
78	* @access private
79	*/
80	private function init() {
81	// Setup hooks.
82	add_action( 'rest_api_init', [ $this, 'register_routes' ] );
83	add_action( 'wp_enqueue_scripts', [ $this, 'localize_script' ], 999 );
84	add_action( 'admin_enqueue_scripts', [ $this, 'localize_script' ], 999 );
85	}
86
87
88	/**
89	* Register API routes
90	* Note: only for internal purpose.
91	*
92	* @todo : prevent cross domain api request
93	*
94	* @since 2.1
95	* @access private
96	*/
97	public function register_routes() {
98	register_rest_route(
99	$this->rest_base,
100	'/form/(?P<id>[\d]+)',
101	[
102	'methods' => 'GET',
103	'callback' => [ $this, 'get_forms_data' ],
104	'permission_callback' => '__return_true',
105	]
106	);
107
108	register_rest_route(
109	$this->rest_base,
110	'/form-grid',
111	[
112	'methods' => 'GET',
113	'callback' => [ $this, 'get_donation_grid' ],
114	'permission_callback' => '__return_true',
115	]
116	);
117
118	register_rest_route(
119	$this->rest_base,
120	'/donor-wall',
121	[
122	'methods' => 'GET',
123	'callback' => [ $this, 'get_donor_wall' ],
124	'permission_callback' => '__return_true',
125	]
126	);
127	}
128
129	/**
130	* Add api localize data
131	*
132	* @since 2.1
133	* @access public
134	*/
135	public function localize_script() {
136	$data = [
137	'root' => esc_url_raw( self::get_rest_api() ),
138	'rest_base' => $this->rest_base,
139	];
140
141	if ( is_admin() ) {
142	wp_localize_script( 'give-admin-scripts', 'giveApiSettings', $data );
143	} else {
144	wp_localize_script( 'give', 'giveApiSettings', $data );
145	}
146	}
147
148	/**
149	* Rest fetch form data callback
150	*
151	* @param WP_REST_Request $request
152	*
153	* @access public
154	* @return array\|mixed\|object
155	*/
156	public function get_forms_data( $request ) {
157	$parameters = $request->get_params();
158
159	// Bailout
160	if ( ! isset( $parameters['id'] ) \|\| empty( $parameters['id'] ) ) {
161	return [ 'error' => 'no_parameter_given' ];
162	}
163
164	return give_form_shortcode( $parameters );
165	}
166
167	/**
168	* Rest fetch form data callback
169	*
170	* @param WP_REST_Request $request
171	*
172	* @access public
173	* @return array\|mixed\|object
174	*/
175	public function get_donation_grid( $request ) {
176	$parameters = $request->get_params();
177
178	return give_form_grid_shortcode( $parameters );
179	}
180
181	/**
182	* Rest fetch form data callback
183	*
184	* @param WP_REST_Request $request
185	*
186	* @access public
187	* @return array\|mixed\|object
188	*/
189	public function get_donor_wall( $request ) {
190	$parameters = $request->get_params();
191
192	return Give_Donor_Wall::get_instance()->render_shortcode( $parameters );
193	}
194
195	/**
196	* Get api reset url
197	*
198	* @since 2.1
199	* @access public
200	*
201	* @param int $blog_id Optional. Blog ID. Default of null returns URL for current blog.
202	* @param string $path Optional. REST route. Default '/'.
203	* @param string $scheme Optional. Sanitization scheme. Default 'rest'.
204	*
205	* @return string Full URL to the endpoint.
206	*/
207	public static function get_rest_api( $blog_id = null, $path = '/', $scheme = 'rest' ) {
208	return trailingslashit( get_rest_url( $blog_id, $path, $scheme ) . self::$instance->rest_base );
209	}
210	}
211
212	Give_API_V2::get_instance();
213