PluginProbe
WPGet API – Connect to any external REST API / 1.4.0
WPGet API – Connect to any external REST API v1.4.0
1.9.2 1.9.3 1.9.4 1.9.5 1.9.6 1.9.7 1.9.8 1.9.9 2.0.0 2.0.1 2.0.2 2.0.3 2.0.4 2.0.5 2.0.6 2.1.0 2.1.1 2.1.3 2.1.4 2.1.5 2.2.0 2.2.1 2.2.10 2.2.2 2.2.3 All 97 releases
← All changes | includes/class-api.php +103 -459 2.0.31.4.0 View file →
@@ -26,13 +26,9 @@
26 26 public $endpoint = ''; // the endpoint that we will get
27 27 public $query_parameters = ''; // the query paramaters appended to url
28 28 public $header_parameters = ''; // the header paramaters
29 29 public $body_parameters = ''; // the body paramaters
30 - public $body_json_encode = ''; // body_json_encode body
31 - public $body_url_encode = ''; // urlencode body
32 - public $body_base64_encode = ''; // base64 encode body
33 - public $body_xml_format = ''; // xml format body
34 - public $xml_root_node = 'root'; // root node for xml
30 + public $body_json_encode = ''; // the body_json_encode
35 31
36 32 public $response = ''; // the returned response
37 33
38 34 public $final_url = ''; // final URL
@@ -37,15 +33,12 @@
37 33
38 34 public $final_url = ''; // final URL
39 35 public $final_request_args = array(); // final request_args
40 36
41 - public $results_format = 'json_string'; // results format
37 + public $results_format = 'json_string'; // reseults format
42 38
43 - public $response_code = ''; // the response code from the call
44 -
45 39 public $timeout = 10; // the timeout
46 40 public $sslverify = 1; // the paramaters
47 - public $debug = false;
48 41
49 42
50 43 /**
51 44 * Main constructor
@@ -63,9 +56,9 @@
63 56 $this->endpoint_id = sanitize_text_field( $endpoint_id );
64 57 $this->keys = $keys;
65 58 $this->args = $args;
66 59
67 - add_filter( 'wpgetapi_raw_data', array( $this, 'maybe_add_debug_info' ), 99, 2 );
60 + add_filter( 'wpgetapi_raw_data', array( $this, 'maybe_add_debug_info' ), 5, 2 );
68 61
69 62 }
70 63
71 64
@@ -73,29 +66,8 @@
73 66 * Init our api data
74 67 */
75 68 public function init() {
76 69
77 - // if we are doing importer plugin,
78 - // we need to intercept and modify most of our methods values
79 - if( $this->api_id == 'wpgetapi_importer' ) {
80 -
81 - $data = apply_filters( 'wpgetapi_api_importer_init', $this );
82 -
83 - if( $data ) {
84 -
85 - foreach ($data as $key => $value) {
86 - $this->{$key} = $value;
87 - }
88 -
89 - $this->query_parameters = ! empty( $this->query_parameters ) ? $this->do_parameters( $this->query_parameters ) : array();
90 - $this->header_parameters = ! empty( $this->header_parameters ) ? $this->do_parameters( $this->header_parameters ) : array();
91 - $this->body_parameters = ! empty( $this->body_parameters ) ? $this->do_parameters( $this->body_parameters ) : array();
92 - return;
93 -
94 - }
95 -
96 - }
97 -
98 70 // do some checks
99 71 if( empty( $this->setup ) || ! isset( $this->setup['apis'] ) || empty( $this->setup['apis'] ) )
100 72 return 'No API found.';
101 73
@@ -114,9 +86,9 @@
114 86 // loop through endpoints
115 87 foreach ( $this->api['endpoints'] as $index => $endpoint ) {
116 88
117 89 if( $this->endpoint_id == $endpoint['id'] ) {
118 -
90 +
119 91 $this->method = isset( $endpoint['method'] ) && $endpoint['method'] != '' ? sanitize_text_field( $endpoint['method'] ) : 'GET';
120 92 $this->cache_time = isset( $endpoint['cache_time'] ) && ! empty( $endpoint['cache_time'] ) ? absint( $endpoint['cache_time'] ) : '';
121 93 $this->endpoint = isset( $endpoint['endpoint'] ) && ! empty( $endpoint['endpoint'] ) ? sanitize_text_field( $endpoint['endpoint'] ) : '';
122 94
@@ -125,35 +97,11 @@
125 97 $this->header_parameters = isset( $endpoint['header_parameters'] ) && ! empty( $endpoint['header_parameters'] ) ? $this->do_parameters( $endpoint['header_parameters'] ) : array();
126 98
127 99 $this->body_parameters = isset( $endpoint['body_parameters'] ) && ! empty( $endpoint['body_parameters'] ) ? $this->do_parameters( $endpoint['body_parameters'] ) : array();
128 100
129 - // how to encode the body
130 - $this->body_json_encode = isset( $endpoint['body_json_encode'] ) && $endpoint['body_json_encode'] == 'true' ? true : false;
131 - $this->body_url_encode = isset( $endpoint['body_json_encode'] ) && $endpoint['body_json_encode'] == 'url' ? true : false;
132 - $this->body_base64_encode = isset( $endpoint['body_json_encode'] ) && $endpoint['body_json_encode'] == 'base64' ? true : false;
133 - $this->body_xml_format = isset( $endpoint['body_json_encode'] ) && $endpoint['body_json_encode'] == 'xml' ? true : false;
134 -
135 - $this->xml_root_node = isset( $endpoint['xml_root'] ) && ! empty( $endpoint['xml_root'] ) ? $endpoint['xml_root'] : $this->xml_root_node;
136 -
101 + $this->body_json_encode = isset( $endpoint['body_json_encode'] ) && ! empty( $endpoint['body_json_encode'] ) ? sanitize_text_field( $endpoint['body_json_encode'] ) : true;
137 102 $this->results_format = isset( $endpoint['results_format'] ) ? sanitize_text_field( $endpoint['results_format'] ) : $this->results_format;
138 -
139 -
140 - if(
141 - // set the format to php array data if html format is set
142 - ( isset( $this->args['format'] ) && $this->args['format'] == 'html' && $this->results_format != 'xml_array' ) ||
143 - // set the format to php array data if it is set in the args (coming from the importer)
144 - ( isset( $this->args['results_format'] ) && $this->args['results_format'] == 'json_decoded' )
145 - ) {
146 - $this->results_format = 'json_decoded';
147 - }
148 -
149 - // set the format to JSON string if it is set in the args (coming from the wpdatatables integration)
150 - if( isset( $this->args['results_format'] ) && $this->args['results_format'] == 'json_string' ) {
151 - $this->results_format = 'json_string';
152 - }
153 -
154 103 }
155 -
156 104 }
157 105
158 106 $this->timeout = isset( $this->api['timeout'] ) && ! empty( $this->api['timeout'] ) ? $this->api['timeout'] : $this->timeout;
159 107 $this->sslverify = isset( $this->api['sslverify'] ) ? absint( $this->api['sslverify'] ) : $this->sslverify;
@@ -166,21 +114,58 @@
166 114 *
167 115 * @param string $field Field to retrieve
168 116 */
169 117 public function endpoint_output() {
118 + return $this->do_the_call();
119 + }
170 120
171 - do_action( 'wpgetapi_before_do_the_call', $this );
172 121
173 - return $this->do_the_call();
122 + /**
123 + * Sort out the parameters if they exist
124 + */
125 + public function do_parameters( $parameters ) {
126 +
127 + $new_array = array();
128 + $parameters = $this->decrypt($parameters);
174 129
130 + if( is_array( $parameters ) ) {
131 + foreach ( $parameters as $key => $parameter ) {
132 + if( ! empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
133 + $parameter['value'] = stripslashes( $parameter['value'] );
134 + $new_array[ sanitize_text_field( $parameter['name'] ) ] = $parameter['value'];
135 + }
136 + }
137 + }
138 +
139 + // look for array or json string and sort these out - for using such things in shortcode
140 + if( is_array( $new_array ) ) {
141 +
142 + foreach ( $new_array as $key => $value ) {
143 +
144 + // checking if the parameters have a json string
145 + if ( substr( $value, 0, 1 ) === '{' && substr( $value, -1 ) === '}' ) {
146 + $new_array[ $key ] = json_decode( $value, true);
147 + }
148 +
149 + // checking if the parameters have an array within the string
150 + // if they do, create them as an actual array
151 + if ( substr( $value, 0, 1 ) === '[' && substr( $value, -1 ) === ']' ) {
152 + $new_array[ $key ] = array( $value );
153 + }
154 +
155 + }
156 +
157 + }
158 +
159 + return $new_array;
160 +
175 161 }
176 162
177 -
178 163 /**
179 164 * Send the request and return our data
180 165 */
181 166 public function do_the_call() {
182 -
167 +
183 168 $this->init();
184 169
185 170 // build the URL
186 171 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
@@ -186,60 +171,28 @@
186 171 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
187 172
188 173 // build the request args
189 174 $this->final_request_args = apply_filters( 'wpgetapi_final_request_args', $this->build_request_args(), $this );
190 -
191 - /**
192 - * Check if we should stop or not. Setting $on to true, will stop us calling the api.
193 - * @param bool $on Whether on is set or not.
194 - */
195 175
196 - if ( apply_filters( 'wpgetapi_should_we_stop', false, $this ) ) {
197 - return;
198 - }
199 -
200 176 // POST request
201 177 if( $this->method == 'POST' )
202 178 $this->response = $this->POST_request();
203 179
204 - // PUT request
205 - if( $this->method == 'PUT' )
206 - $this->response = $this->PUT_request();
207 -
208 - // PATCH request
209 - if( $this->method == 'PATCH' )
210 - $this->response = $this->PATCH_request();
211 -
212 180 // GET request
213 181 if( $this->method == 'GET' )
214 182 $this->response = $this->GET_request();
215 183
216 - // DELETE request
217 - if( $this->method == 'DELETE' )
218 - $this->response = $this->DELETE_request();
219 -
220 184 // wp error
221 185 if( is_wp_error( $this->response ) ) {
222 - return apply_filters( 'wpgetapi_raw_error_data', json_encode( $this->response ), $this );
186 + return apply_filters( 'wpgetapi_raw_data', json_encode( $this->response ), $this );
223 187 }
224 188
225 - // get response_code
226 - $this->response_code = wp_remote_retrieve_response_code( $this->response );
189 + $data = wp_remote_retrieve_body( $this->response );
227 190
228 - // action to intercept call depending on response_code
229 - $this->response = apply_filters( 'wpgetapi_before_retrieve_body', $this->response, $this->response_code, $this );
230 -
231 - // get body
232 - // modified in version 1.6.1 to allow for OAuth 2.0 plugin returning body already
233 - $data = isset( $this->response['body'] ) ? $this->response['body'] : $this->response;
234 -
235 191 // returning in JSON format
236 192 if( $this->results_format == 'json_string' || $this->results_format == 'json_decoded' )
237 - $data = $this->return_data( $data );
193 + $data = $this->output_json( $data );
238 194
239 - if( $data === 'null' )
240 - $data = 'Result is null. Check that all endpoint settings are correct.';
241 -
242 195 return apply_filters( 'wpgetapi_raw_data', $data, $this );
243 196
244 197 }
245 198
@@ -252,27 +205,15 @@
252 205 // first make sure our endpoint starts with a slash
253 206 if ( substr( $this->endpoint, 0, 1 ) != '/' )
254 207 $this->endpoint = '/' . $this->endpoint;
255 208
256 - $this->endpoint = apply_filters( 'wpgetapi_endpoint', $this->endpoint, $this );
257 -
258 209 $url = untrailingslashit( $this->base_url ) . $this->endpoint;
259 210
260 - // if we have a URL pagination event from the import plugin
261 - // we need to modify the URL here
262 - if( isset( $this->args['paginate_url'] ) )
263 - $url = $this->args['paginate_url'];
264 -
265 - // filter our params - added for use in Oauth 2.0 plugin
266 - $params = apply_filters( 'wpgetapi_query_parameters', $this->query_parameters, $this );
267 -
268 211 // add empty array - was getting errors if it was just null or false
269 - $params = empty( $params ) ? array(''=>'') : $params;
212 + $params = empty( $this->query_parameters ) ? array(''=>'') : $this->query_parameters;
270 213
271 - $result = add_query_arg( $params, $url );
214 + return add_query_arg( $params, $url );
272 215
273 - return $result;
274 -
275 216 }
276 217
277 218
278 219 /**
@@ -286,63 +227,21 @@
286 227 ), $this );
287 228
288 229
289 230 // if doing POST request, include body paramters
290 - if( $this->method == 'POST' || $this->method == 'PUT' || $this->method == 'DELETE' || $this->method == 'PATCH' ) {
291 -
292 - // tokens are sent through here
231 + if( $this->method == 'POST' ) {
232 +
293 233 $this->body_parameters = apply_filters( 'wpgetapi_body_parameters', $this->body_parameters, $this );
294 234
295 - // do we json_encode the entire body
296 - if( $this->body_json_encode == true ) {
235 + // do we json_encode the entire body as a string
236 + if( $this->body_json_encode === true || $this->body_json_encode === 'true' )
297 237 $this->body_parameters = json_encode( $this->body_parameters );
298 - }
299 238
300 - // do we urlencode the entire body
301 - if( $this->body_parameters && $this->body_url_encode == true ) {
302 -
303 - // checking if the parameters have a json string (raw)
304 - if (
305 - ( ! is_array( $this->body_parameters ) ) &&
306 - ( substr( $this->body_parameters, 0, 1 ) === '{' || substr( $this->body_parameters, 0, 1 ) === '[' )
307 - ) {
308 - $this->body_parameters = json_decode( $this->body_parameters, true );
309 - }
310 -
311 - $this->body_parameters = http_build_query( $this->body_parameters, '', '&' );
239 + // add our body parameters
240 + $headers['headers']['body'] = $this->body_parameters;
312 241
313 - }
314 -
315 - // do we xml the entire body
316 - if( $this->body_parameters && $this->body_xml_format == true ) {
317 -
318 - $xml = new SimpleXmlElement( '<' . $this->xml_root_node . '/>' );
319 -
320 - foreach( $this->body_parameters as $key => $value) {
321 - $xml->addChild( $key, $value );
322 - }
323 -
324 - $this->body_parameters = $xml->asXML();
325 -
326 - }
327 -
328 - // do we base64 encode the entire body
329 - if( $this->body_parameters && $this->body_base64_encode == true ) {
330 -
331 - $this->body_parameters = is_array( $this->body_parameters ) ? json_encode( $this->body_parameters ) : $this->body_parameters;
332 - $this->body_parameters = base64_encode( $this->body_parameters );
333 -
334 - }
335 -
336 - // add our body parameters
337 - if( $this->body_parameters && ! empty( $this->body_parameters ) )
338 - $headers['body'] = $this->body_parameters;
339 -
340 242 }
341 243
342 - // get our body paramters as they are formatted
343 - $this->body_parameters = apply_filters( 'wpgetapi_final_body_parameters', $this->body_parameters, $this );
344 -
345 244 // add headers to our final request args
346 245 $this->final_request_args = wp_parse_args( $headers, $this->final_request_args );
347 246
348 247 // build the args taht are sent to the request
@@ -358,10 +257,8 @@
358 257
359 258 }
360 259
361 260
362 -
363 -
364 261 /**
365 262 * Do a GET request
366 263 */
367 264 public function GET_request() {
@@ -367,163 +264,42 @@
367 264 public function GET_request() {
368 265 $response = '';
369 266 // so we can so something before the remote_get (caching)
370 267 $response = apply_filters( 'wpgetapi_before_get_request', $response, $this );
371 -
372 268 if( empty( $response ) )
373 269 $response = wp_remote_get( $this->final_url, $this->final_request_args );
270 +
374 271 return $response;
375 272 }
376 273
274 +
377 275 /**
378 276 * Do a POST request
379 277 */
380 278 public function POST_request() {
381 - $this->final_request_args['method'] = 'POST';
382 279 $response = wp_remote_post( $this->final_url, $this->final_request_args );
383 280 return $response;
384 281 }
385 282
386 - /**
387 - * Do a PUT request
388 - */
389 - public function PUT_request() {
390 - $this->final_request_args['method'] = 'PUT';
391 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
392 - return $response;
393 - }
394 283
395 284 /**
396 - * Do a PATCH request
285 + * return JSON data
397 286 */
398 - public function PATCH_request() {
399 - $this->final_request_args['method'] = 'PATCH';
400 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
401 - return $response;
402 - }
287 + public function output_json( $data ) {
403 288
404 - /**
405 - * Do a DELETE request
406 - */
407 - public function DELETE_request() {
408 - $this->final_request_args['method'] = 'DELETE';
409 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
410 - return $response;
411 - }
412 -
413 -
414 - /**
415 - * return data
416 - */
417 - public function return_data( $data ) {
418 -
419 - $data = apply_filters( 'wpgetapi_json_response_body_before_decode', $data, $this->keys );
420 -
421 289 // converts all data to arrays, removing objects
422 - if( is_string( $data ) ) {
423 - $decode = json_decode( $data, true );
424 - if( json_last_error() ) {
425 - return esc_html( $data );
426 - } else {
427 - $data = $decode;
428 - }
429 - }
290 + $data = json_decode( $data, true );
291 + $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
430 292
431 - $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
432 -
433 293 if( $this->results_format == 'json_string' )
434 - return trim( json_encode( $data, JSON_PRETTY_PRINT ),'"');
435 -
294 + return trim( json_encode( $data ),'"');
295 +
436 296 if( $this->results_format == 'json_decoded' )
437 297 return $data;
438 298
439 299 }
440 300
441 - /**
442 - * Sort out the parameters if they exist
443 - */
444 - public function do_parameters( $parameters ) {
445 301
446 - $new_array = array();
447 - $raw = '';
448 - $parameters = $this->decrypt( $parameters );
449 -
450 - if( is_array( $parameters ) ) {
451 - foreach ( $parameters as $key => $parameter ) {
452 -
453 - if( ! empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
454 -
455 - $parameter['value'] = stripslashes( $parameter['value'] );
456 -
457 - // if we have wpgetapi_on, delete it so we don't send to api
458 - if( $parameter['name'] == 'wpgetapi_on' ) {
459 - unset( $parameters[ $key ] );
460 - continue;
461 - }
462 -
463 - $new_array[ sanitize_text_field( $parameter['name'] ) ] = $parameter['value'];
464 -
465 - // if we are sending raw body
466 - } else if( empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
467 -
468 - $raw = stripslashes( $parameter['value'] );
469 -
470 - }
471 -
472 - }
473 - }
474 -
475 - // look for array or json string and sort these out - for using such things in shortcode
476 - if( ! empty( $new_array ) ) {
477 -
478 - foreach ( $new_array as $key => $value ) {
479 -
480 - // checking if the parameters have a json string
481 - if ( strpos( $value, '{"' ) !== false && strpos( $value, '"}' ) !== false ) {
482 - //if ( substr( $value, 0, 1 ) === '{' && substr( $value, -1 ) === '}' ) {
483 - $new_array[ $key ] = json_decode( $value, true );
484 - } else
485 -
486 - // checking if the parameters have an array within the string
487 - // if they do, create them as an actual array
488 - if ( substr( $value, 0, 1 ) === '[' && substr( $value, -1 ) === ']' ) {
489 - $value = trim( $value,"[]" );
490 - $new_array[ $key ] = array( $value );
491 - }
492 -
493 - // set value as integer
494 - if ( strpos( $value, 'integer(' ) !== false && substr( $value, -1 ) === ')' ) {
495 - preg_match("/\(([^\)]*)\)/", $value, $match );
496 - $result = $match[1];
497 - $new_array[ $key ] = absint( $result );
498 - }
499 -
500 - // set value as float
501 - if ( strpos( $value, 'float(' ) !== false && substr( $value, -1 ) === ')' ) {
502 - preg_match("/\(([^\)]*)\)/", $value, $match );
503 - $result = $match[1];
504 - $new_array[ $key ] = (float) $result;
505 -
506 - }
507 -
508 - // set value as boolean
509 - if ( strpos( $value, 'boolean(' ) !== false && substr( $value, -1 ) === ')' ) {
510 - preg_match("/\(([^\)]*)\)/", $value, $match );
511 - $result = $match[1];
512 - $result = filter_var( $result, FILTER_VALIDATE_BOOLEAN );
513 - $new_array[ $key ] = $result;
514 -
515 - }
516 -
517 - }
518 -
519 - }
520 -
521 - return $raw ? $raw : $new_array;
522 -
523 - }
524 -
525 -
526 302 /**
527 303 * decrypt our parameters from the DB
528 304 */
529 305 public function decrypt( $array_or_string ) {
@@ -549,86 +325,20 @@
549 325
550 326 /**
551 327 * debug
552 328 */
553 - public function maybe_add_debug_info( $data, $wpgetapi ) {
329 + public function maybe_add_debug_info( $data, $this_data ) {
554 330
555 - if(
556 - ( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) ||
557 - ( isset( $this->args['test_endpoint'] ) && ( $this->args['test_endpoint'] === true ) )
558 - ) {
331 + if( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) {
559 332
560 - $this->debug = true;
561 -
562 - // admin test endpoint button
563 - $testing = isset( $this->args['test_endpoint'] ) && ( $this->args['test_endpoint'] === true ) ? true : false;
564 -
565 - // get api status from response code
566 - $status = array(
567 - 'title' => 'Error in API response.',
568 - 'desc' => 'Check all details within your endpoint. Something is misconfigured.',
569 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
570 - );
571 -
572 - if( $this->response_code == 200 ) {
573 - $status = array(
574 - 'title' => 'Success!',
575 - 'desc' => 'Your API is returning a success message and is returning the data as shown in the Data Output section below. You can modify this by changing the Results Format option or see <a href="https://wpgetapi.com/docs/format-api-data-as-html/">here</a> for info on formatting this data.',
576 - 'type' => '<span class="dashicons dashicons-yes-alt"></span>'
577 - );
578 - }
579 - if( $this->response_code == 400 || $this->response_code == 404 ) {
580 - $status = array(
581 - 'title' => 'Bad Request',
582 - 'desc' => 'This could indicate that the URL you are calling is incorrect or that some other data is missing or incorrect. Please check your Base URL and Endpoint are correct as well as the Request Method.',
583 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
584 - );
585 - }
586 - if( $this->response_code == 401 ) {
587 - $status = array(
588 - 'title' => 'Unauthorised',
589 - 'desc' => 'You are successfully connecting to your API. But your API key, login or API credentials are incorrect. See <a href="https://wpgetapi.com/docs/authentication-authorization/">here</a> for info on correctly authorizing your API requests.',
590 - 'type' => '<span class="dashicons dashicons-warning"></span>'
591 - );
592 - }
593 - if( $this->response_code == 403 ) {
594 - $status = array(
595 - 'title' => 'Forbidden',
596 - 'desc' => 'This could indicate that you may need to get your IP address whitelisted with your API provider or that you do not have access to this API.',
597 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
598 - );
599 - }
600 - if( $this->response_code == 405 ) {
601 - $status = array(
602 - 'title' => 'Method Not Allowed',
603 - 'desc' => 'Try changing the Request Method within the endpoint settings.',
604 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
605 - );
606 - }
607 - if( $this->response_code == 415 ) {
608 - $status = array(
609 - 'title' => 'Unsupported Media Type',
610 - 'desc' => 'Try adding "Content-type" to the Headers with the Value of "json/application" as shown <a href="https://wpgetapi.com/docs/troubleshooting/">here</a>.',
611 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
612 - );
613 - }
614 - if( $this->response_code == 500 ) {
615 - $status = array(
616 - 'title' => 'Internal Server Error',
617 - 'desc' => 'This indicates an issue with the server. Contact your API provider.',
618 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
619 - );
620 - }
621 -
622 -
623 333 ob_start(); ?>
624 334
625 335 <style>
626 336
627 337 .wpgetapi-debug {
628 - background: #fff;
338 + background: #f4f4f4;
629 339 padding: 20px;
630 - box-shadow: 0 0 1px #aaa;
340 + border: 1px solid #ccc;
631 341 margin: 20px;
632 342 font-size: 15px;
633 343 }
634 344 .wpgetapi-debug
@@ -643,9 +353,9 @@
643 353 }
644 354 .wpgetapi-debug p.small {
645 355 font-size: 85%;
646 356 color: #999;
647 - margin: 0 0 12px !important;
357 + margin-bottom: 15px !important
648 358 }
649 359 .wpgetapi-debug h5 {
650 360 font-weight: bold;
651 361 font-size: 18px;
@@ -655,154 +365,86 @@
655 365 .wpgetapi-debug .debug-item {
656 366 margin: 10px 0;
657 367 background: #fff;
658 368 padding: 15px 20px;
659 - display: inline-block !important;
369 + display: inline-block !important;;
660 370 width: 100% !important;
661 - box-shadow: 0 3px 8px rgb(0 0 0 / 6%);
662 - border: 1px solid #eee;
371 + box-shadow: 0 0 5px rgba(0,0,0,0.1)
663 372 }
664 373 .wpgetapi-debug .debug-item h6 {
665 374 font-weight: bold;
666 - font-size: 14px;
667 - margin: 0;
375 + font-size: 16px;
376 + margin: 0 0 3px;
668 377 text-transform: none !important;
669 378 }
670 379 .wpgetapi-debug .debug-item .debug-result,
671 380 .wpgetapi-debug .debug-item .debug-result pre {
672 381 font-family: monospace !important;
673 - font-size: 13px !important;
382 + font-size: 15px !important;
674 383 margin: 0 !important;
675 - padding: 8px 12px;
676 - background: #f4f7f9;
384 + padding: 10px 12px;
385 + background: #f8f8f8;
677 386 }
678 387 .wpgetapi-debug .debug-item .debug-result pre {
679 388 border: none;
680 389 padding: 5px
681 390 }
682 -.wpgetapi-debug.testing {
683 - background: transparent;
684 - padding: 0;
685 - box-shadow: none;
686 -}
687 -.wpgetapi-debug.testing .debug-item {
688 - margin: 5px 0;
689 -}
690 -.wpgetapi-debug.testing .debug-item.status {
691 - border: none;
692 - box-shadow: none;
693 - margin-bottom: 15px;
694 -}
695 -.wpgetapi-debug .debug-item.status h5 {
696 - font-size: 15px;
697 -}
698 -.wpgetapi-debug .status .dashicons {
699 - margin: 0 5px 3px 0;
700 -}
701 -.wpgetapi-debug .status .dashicons-yes-alt {
702 - color: #5e9929;
703 -}
704 -.wpgetapi-debug .status .dashicons-dismiss {
705 - color: #cc4646;
706 -}
707 -.wpgetapi-debug .status .dashicons-warning {
708 - color: #dfa12e;
709 -}
710 -.wpgetapi-debug .status .desc {
711 - font-size: 14px;
712 - font-weight: 400 !important;
713 -}
391 +
714 392 </style>
715 393
716 - <div class="wpgetapi-debug <?php echo $testing ? 'testing' : ''; ?>">
394 + <div class="wpgetapi-debug">
717 395
718 - <?php if( $testing ) { ?>
396 + <h5><strong>WPGetAPI, Debug Mode - Plugin Version <?php esc_html_e( WpGetApi()->version ); ?></strong></h5>
397 + <p class="small">Below you will find debug info for the current API call. To turn this off, set debug to false in your shortcode or template tag.<br>Connecting to API's can be tricky - if you require help, please see the <a target="_blank" href="https://wpgetapi.com/docs/">Documentation</a> and if you can't find the answer then please use the contact form on our <a target="_blank" title="Connect WordPress with external API" href="https://wpgetapi.com/">website</a> to get assistance.</p>
719 398
720 - <div class="debug-item status">
721 - <div class="">
722 - <h5><?php _e( $status['type'] ); ?> <?php esc_html_e( $status['title'] ); ?></h5>
723 - <span class="desc"><?php _e( $status['desc'] ); ?></span>
724 - </div>
725 - </div>
726 - <div class="debug-item">
727 - <h6><?php esc_html_e( 'Full URL', 'wpgetapi' ); ?></h6>
728 - <p class="small"><?php esc_html_e( 'The full URL that is being called.', 'wpgetapi' ); ?></p>
729 - <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
730 - </div>
731 -
732 - <div class="debug-item">
733 - <h6><?php esc_html_e( 'Data Output', 'wpgetapi' ); ?></h6>
734 - <p class="small"><?php esc_html_e( 'The output that has been returned from the API. This is what the shortcode or template tag will display and can be formatted however you like.', 'wpgetapi' ); ?></p>
735 - <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
736 - </div>
737 -
738 - <div class="debug-item">
739 - <h6><?php esc_html_e( 'Final Request Arguments', 'wpgetapi' ); ?></h6>
740 - <p class="small"><?php esc_html_e( 'The final request arguments sent in the API request. Includes headers and body arguments.', 'wpgetapi' ); ?></p>
741 - <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
742 - </div>
743 -
744 - <div class="debug-item">
745 - <h6><?php esc_html_e( 'Response', 'wpgetapi' ); ?></h6>
746 - <p class="small"><?php esc_html_e( 'The full response from the API request.', 'wpgetapi' ); ?></p>
747 - <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
748 - </div>
749 -
750 - <?php } else { ?>
751 -
752 - <h5><strong><?php esc_html_e( 'WPGetAPI, Debug Mode - Plugin Version', 'wpgetapi' ); ?> <?php esc_html_e( WpGetApi()->version ); ?></strong></h5>
753 - <p class="small"><?php esc_html_e( 'Below you will find debug info for the current API call. To turn this off, set debug to false in your shortcode or template tag.', 'wpgetapi' ); ?><br><?php esc_html_e( 'Connecting to API\'s can be tricky - if you require help, please see the', 'wpgetapi' ); ?> <a target="_blank" href="https://wpgetapi.com/docs/"><?php esc_html_e( 'Documentation', 'wpgetapi' ); ?></a>.</p>
754 -
755 399 <div class="debug-item">
756 - <h6><?php esc_html_e( 'Full URL', 'wpgetapi' ); ?></h6>
757 - <p class="small"><?php esc_html_e( 'The full URL that is being called.', 'wpgetapi' ); ?></p>
400 + <h6>Full URL</h6>
401 + <p class="small">The full URL that is being called.</p>
758 402 <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
759 403 </div>
760 404
761 405 <div class="debug-item">
762 - <h6><?php esc_html_e( 'Data Output', 'wpgetapi' ); ?></h6>
763 - <p class="small"><?php esc_html_e( 'The resulting output that has been returned from the API.', 'wpgetapi' ); ?></p>
406 + <h6>Data Output</h6>
407 + <p class="small">The resulting output that has been returned from the API.</p>
764 408 <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
765 409 </div>
766 410
767 411 <div class="debug-item">
768 - <h6><?php esc_html_e( 'Query String', 'wpgetapi' ); ?></h6>
769 - <p class="small"><?php esc_html_e( 'The query string parameters (if any) that you have set within the endpoint settings.', 'wpgetapi' ); ?></p>
412 + <h6>Arguments</h6>
413 + <p class="small">The arguments set within your shortcode or template tag.</p>
414 + <div class="debug-result"><?php wpgetapi_pp( $this->args ); ?></div>
415 + </div>
416 +
417 + <div class="debug-item">
418 + <h6>Query String</h6>
419 + <p class="small">The query string parameters (if any) that you have set within the endpoint settings.</p>
770 420 <div class="debug-result"><?php wpgetapi_pp( $this->query_parameters ); ?></div>
771 421 </div>
772 422
773 423 <div class="debug-item">
774 - <h6><?php esc_html_e( 'Headers', 'wpgetapi' ); ?></h6>
775 - <p class="small"><?php esc_html_e( 'The header parameters (if any) that you have set within the endpoint settings.', 'wpgetapi' ); ?></p>
424 + <h6>Headers</h6>
425 + <p class="small">The headers parameters (if any) that you have set within the endpoint settings.</p>
776 426 <div class="debug-result"><?php wpgetapi_pp( $this->header_parameters ); ?></div>
777 427 </div>
778 428
779 429 <div class="debug-item">
780 - <h6><?php esc_html_e( 'Body', 'wpgetapi' ); ?></h6>
781 - <p class="small"><?php esc_html_e( 'The body parameters (if any) that you have set within the endpoint settings.', 'wpgetapi' ); ?></p>
430 + <h6>Body</h6>
431 + <p class="small">The body parameters (if any) that you have set within the endpoint settings.</p>
782 432 <div class="debug-result"><?php wpgetapi_pp( $this->body_parameters ); ?></div>
783 433 </div>
784 434
785 435 <div class="debug-item">
786 - <h6><?php esc_html_e( 'Final Request Arguments', 'wpgetapi' ); ?></h6>
787 - <p class="small"><?php esc_html_e( 'The final request arguments sent in the API request. Includes headers and body arguments.', 'wpgetapi' ); ?></p>
436 + <h6>Final Request Arguments</h6>
437 + <p class="small">The final request arguments sent in the API request. Includes headers and body arguments.</p>
788 438 <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
789 439 </div>
790 440
791 441 <div class="debug-item">
792 - <h6><?php esc_html_e( 'Arguments', 'wpgetapi' ); ?></h6>
793 - <p class="small"><?php esc_html_e( 'The arguments set within your shortcode or template tag.', 'wpgetapi' ); ?></p>
794 - <div class="debug-result"><?php wpgetapi_pp( $this->args ); ?></div>
795 - </div>
796 -
797 - <div class="debug-item">
798 - <h6><?php esc_html_e( 'Response', 'wpgetapi' ); ?></h6>
799 - <p class="small"><?php esc_html_e( 'The full response from the API request.', 'wpgetapi' ); ?></p>
442 + <h6>Response</h6>
443 + <p class="small">The full response from the API request.</p>
800 444 <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
801 445 </div>
802 446
803 - <?php } ?>
804 -
805 447 </div>
806 448
807 449 <?php
808 450
@@ -812,9 +454,11 @@
812 454
813 455 return $data;
814 456
815 457 }
458 +
459 +
816 460
817 461 }
818 462
819 463
820 464 }