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 +104 -501 2.1.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 - public $sslverify = 1; // ssl verify
47 - public $debug = false;
40 + public $sslverify = 1; // the paramaters
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,40 +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 - // set the format to JSON string if it is set in the args (coming from the wpdatatables integration)
155 - if( isset( $this->args['results_format'] ) && $this->args['results_format'] == 'json_decoded' ) {
156 - $this->results_format = 'json_decoded';
157 - }
158 -
159 103 }
160 -
161 104 }
162 105
163 106 $this->timeout = isset( $this->api['timeout'] ) && ! empty( $this->api['timeout'] ) ? $this->api['timeout'] : $this->timeout;
164 107 $this->sslverify = isset( $this->api['sslverify'] ) ? absint( $this->api['sslverify'] ) : $this->sslverify;
@@ -171,21 +114,58 @@
171 114 *
172 115 * @param string $field Field to retrieve
173 116 */
174 117 public function endpoint_output() {
118 + return $this->do_the_call();
119 + }
175 120
176 - do_action( 'wpgetapi_before_do_the_call', $this );
177 121
178 - 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);
179 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 +
180 161 }
181 162
182 -
183 163 /**
184 164 * Send the request and return our data
185 165 */
186 166 public function do_the_call() {
187 -
167 +
188 168 $this->init();
189 169
190 170 // build the URL
191 171 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
@@ -191,60 +171,28 @@
191 171 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
192 172
193 173 // build the request args
194 174 $this->final_request_args = apply_filters( 'wpgetapi_final_request_args', $this->build_request_args(), $this );
195 -
196 - /**
197 - * Check if we should stop or not. Setting $on to true, will stop us calling the api.
198 - * @param bool $on Whether on is set or not.
199 - */
200 175
201 - if ( apply_filters( 'wpgetapi_should_we_stop', false, $this ) ) {
202 - return;
203 - }
204 -
205 176 // POST request
206 177 if( $this->method == 'POST' )
207 178 $this->response = $this->POST_request();
208 179
209 - // PUT request
210 - if( $this->method == 'PUT' )
211 - $this->response = $this->PUT_request();
212 -
213 - // PATCH request
214 - if( $this->method == 'PATCH' )
215 - $this->response = $this->PATCH_request();
216 -
217 180 // GET request
218 181 if( $this->method == 'GET' )
219 182 $this->response = $this->GET_request();
220 183
221 - // DELETE request
222 - if( $this->method == 'DELETE' )
223 - $this->response = $this->DELETE_request();
224 -
225 184 // wp error
226 185 if( is_wp_error( $this->response ) ) {
227 - return apply_filters( 'wpgetapi_raw_error_data', json_encode( $this->response ), $this );
186 + return apply_filters( 'wpgetapi_raw_data', json_encode( $this->response ), $this );
228 187 }
229 188
230 - // get response_code
231 - $this->response_code = wp_remote_retrieve_response_code( $this->response );
189 + $data = wp_remote_retrieve_body( $this->response );
232 190
233 - // action to intercept call depending on response_code
234 - $this->response = apply_filters( 'wpgetapi_before_retrieve_body', $this->response, $this->response_code, $this );
235 -
236 - // get body
237 - // modified in version 1.6.1 to allow for OAuth 2.0 plugin returning body already
238 - $data = isset( $this->response['body'] ) ? $this->response['body'] : $this->response;
239 -
240 191 // returning in JSON format
241 192 if( $this->results_format == 'json_string' || $this->results_format == 'json_decoded' )
242 - $data = $this->return_data( $data );
193 + $data = $this->output_json( $data );
243 194
244 - if( $data === 'null' )
245 - $data = 'Result is null. Check that all endpoint settings are correct.';
246 -
247 195 return apply_filters( 'wpgetapi_raw_data', $data, $this );
248 196
249 197 }
250 198
@@ -257,33 +205,15 @@
257 205 // first make sure our endpoint starts with a slash
258 206 if ( substr( $this->endpoint, 0, 1 ) != '/' )
259 207 $this->endpoint = '/' . $this->endpoint;
260 208
261 - // if we have item_key from api to posts plugin
262 - // replace our keyword with the actual item_key value
263 - if ( isset( $this->args['item_key'] ) && strpos( $this->endpoint, '(importer:item_key)' ) !== false ) {
264 - $this->endpoint = str_replace( '(importer:item_key)', $this->args['item_key'], $this->endpoint );
265 - }
266 -
267 - $this->endpoint = apply_filters( 'wpgetapi_endpoint', $this->endpoint, $this );
268 -
269 209 $url = untrailingslashit( $this->base_url ) . $this->endpoint;
270 210
271 - // if we have a URL pagination event from the import plugin
272 - // we need to modify the URL here
273 - if( isset( $this->args['paginate_url'] ) )
274 - $url = $this->args['paginate_url'];
275 -
276 - // filter our params - added for use in Oauth 2.0 plugin
277 - $params = apply_filters( 'wpgetapi_query_parameters', $this->query_parameters, $this );
278 -
279 211 // add empty array - was getting errors if it was just null or false
280 - $params = empty( $params ) ? array(''=>'') : $params;
212 + $params = empty( $this->query_parameters ) ? array(''=>'') : $this->query_parameters;
281 213
282 - $result = add_query_arg( $params, $url );
214 + return add_query_arg( $params, $url );
283 215
284 - return $result;
285 -
286 216 }
287 217
288 218
289 219 /**
@@ -297,70 +227,21 @@
297 227 ), $this );
298 228
299 229
300 230 // if doing POST request, include body paramters
301 - if( $this->method == 'POST' || $this->method == 'PUT' || $this->method == 'DELETE' || $this->method == 'PATCH' ) {
302 -
303 - // tokens are sent through here
231 + if( $this->method == 'POST' ) {
232 +
304 233 $this->body_parameters = apply_filters( 'wpgetapi_body_parameters', $this->body_parameters, $this );
305 234
306 - // do we json_encode the entire body
307 - 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' )
308 237 $this->body_parameters = json_encode( $this->body_parameters );
309 - }
310 238
311 - // do we urlencode the entire body
312 - if( $this->body_parameters && $this->body_url_encode == true ) {
313 -
314 - // checking if the parameters have a json string (raw)
315 - if (
316 - ( ! is_array( $this->body_parameters ) ) &&
317 - ( substr( $this->body_parameters, 0, 1 ) === '{' || substr( $this->body_parameters, 0, 1 ) === '[' )
318 - ) {
319 - $this->body_parameters = json_decode( $this->body_parameters, true );
320 - }
321 -
322 - $this->body_parameters = http_build_query( $this->body_parameters, '', '&' );
239 + // add our body parameters
240 + $headers['headers']['body'] = $this->body_parameters;
323 241
324 - }
325 -
326 - // do we xml the entire body
327 - if( $this->body_parameters && $this->body_xml_format == true ) {
328 -
329 - $root_node = $this->xml_root_node != '' ? '<' . $this->xml_root_node . '/>' : '';
330 -
331 - $xml_element = apply_filters( 'wpgetapi_xml_element', '<?xml version="1.0" encoding="UTF-8"?>' . $root_node );
332 -
333 - $xml = new SimpleXmlElement( $xml_element );
334 -
335 - foreach( $this->body_parameters as $key => $value) {
336 - $xml->addChild( $key, $value );
337 - }
338 -
339 - $this->body_parameters = $xml->asXML();
340 -
341 - }
342 -
343 - // do we base64 encode the entire body
344 - if( $this->body_parameters && $this->body_base64_encode == true ) {
345 -
346 - $this->body_parameters = is_array( $this->body_parameters ) ? json_encode( $this->body_parameters ) : $this->body_parameters;
347 - $this->body_parameters = base64_encode( $this->body_parameters );
348 -
349 - }
350 -
351 - $this->body_parameters = apply_filters( 'wpgetapi_modify_formatted_body_parameters', $this->body_parameters, $this );
352 -
353 - // add our body parameters
354 - if( $this->body_parameters && ! empty( $this->body_parameters ) )
355 - $headers['body'] = $this->body_parameters;
356 -
357 242 }
358 243
359 - // get our body paramters as they are formatted
360 - // this won't change anything, it just allows us to get the parameters
361 - $this->body_parameters = apply_filters( 'wpgetapi_final_body_parameters', $this->body_parameters, $this );
362 -
363 244 // add headers to our final request args
364 245 $this->final_request_args = wp_parse_args( $headers, $this->final_request_args );
365 246
366 247 // build the args taht are sent to the request
@@ -376,194 +257,49 @@
376 257
377 258 }
378 259
379 260
380 -
381 -
382 261 /**
383 262 * Do a GET request
384 263 */
385 264 public function GET_request() {
386 -
387 265 $response = '';
388 266 // so we can so something before the remote_get (caching)
389 267 $response = apply_filters( 'wpgetapi_before_get_request', $response, $this );
390 -
391 268 if( empty( $response ) )
392 269 $response = wp_remote_get( $this->final_url, $this->final_request_args );
393 270
394 271 return $response;
272 + }
395 273
396 - }
397 274
398 275 /**
399 276 * Do a POST request
400 277 */
401 278 public function POST_request() {
402 -
403 - $response = '';
404 - // so we can so something before the remote_post (caching)
405 - $response = apply_filters( 'wpgetapi_before_post_request', $response, $this );
406 -
407 - //$this->final_request_args['method'] = 'POST';
408 -
409 - if( empty( $response ) )
410 - $response = wp_remote_post( $this->final_url, $this->final_request_args );
411 -
279 + $response = wp_remote_post( $this->final_url, $this->final_request_args );
412 280 return $response;
413 281 }
414 282
415 - /**
416 - * Do a PUT request
417 - */
418 - public function PUT_request() {
419 - $this->final_request_args['method'] = 'PUT';
420 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
421 - return $response;
422 - }
423 283
424 284 /**
425 - * Do a PATCH request
285 + * return JSON data
426 286 */
427 - public function PATCH_request() {
428 - $this->final_request_args['method'] = 'PATCH';
429 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
430 - return $response;
431 - }
287 + public function output_json( $data ) {
432 288
433 - /**
434 - * Do a DELETE request
435 - */
436 - public function DELETE_request() {
437 - $this->final_request_args['method'] = 'DELETE';
438 - $response = wp_remote_request( $this->final_url, $this->final_request_args );
439 - return $response;
440 - }
441 -
442 -
443 - /**
444 - * return data
445 - */
446 - public function return_data( $data ) {
447 -
448 - $data = apply_filters( 'wpgetapi_json_response_body_before_decode', $data, $this->keys );
449 -
450 289 // converts all data to arrays, removing objects
451 - if( is_string( $data ) ) {
452 - $decode = json_decode( $data, true );
453 - if( json_last_error() ) {
454 - return esc_html( $data );
455 - } else {
456 - $data = $decode;
457 - }
458 - }
290 + $data = json_decode( $data, true );
291 + $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
459 292
460 - $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
461 -
462 293 if( $this->results_format == 'json_string' )
463 - return trim( json_encode( $data, JSON_PRETTY_PRINT ),'"');
464 -
294 + return trim( json_encode( $data ),'"');
295 +
465 296 if( $this->results_format == 'json_decoded' )
466 297 return $data;
467 298
468 299 }
469 300
470 - /**
471 - * Sort out the parameters if they exist
472 - */
473 - public function do_parameters( $parameters ) {
474 301
475 - $new_array = array();
476 - $raw = '';
477 - $parameters = $this->decrypt( $parameters );
478 -
479 - if( is_array( $parameters ) ) {
480 - foreach ( $parameters as $key => $parameter ) {
481 -
482 - if( ! empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
483 -
484 - $parameter['value'] = stripslashes( $parameter['value'] );
485 -
486 - // if we have wpgetapi_on, delete it so we don't send to api
487 - if( $parameter['name'] == 'wpgetapi_on' ) {
488 - unset( $parameters[ $key ] );
489 - continue;
490 - }
491 -
492 - // if we have item_key from api to posts plugin
493 - // replace our keyword with the actual item_key value
494 - if ( isset( $this->args['item_key'] ) && strpos( $parameter['value'], '(importer:item_key)' ) !== false ) {
495 - $parameter['value'] = str_replace( '(importer:item_key)', $this->args['item_key'], $parameter['value'] );
496 - }
497 -
498 - $new_array[ sanitize_text_field( $parameter['name'] ) ] = $parameter['value'];
499 -
500 - // if we are sending raw body
501 - } else if( empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
502 -
503 - $raw = stripslashes( $parameter['value'] );
504 -
505 - }
506 -
507 - }
508 - }
509 -
510 - // now look for array or json string and sort these out - for using such things in shortcode
511 - if( ! empty( $new_array ) ) {
512 -
513 - foreach ( $new_array as $key => $value ) {
514 -
515 - // checking if the parameters have a json string
516 - if ( strpos( $value, '{"' ) !== false && strpos( $value, '}' ) !== false ) {
517 -
518 - $tmp_val = $value;
519 - $tmp_val = json_decode( $tmp_val, true );
520 - $new_array[ $key ] = $tmp_val ? $tmp_val : $value;
521 -
522 - } else
523 -
524 - // checking if the parameters have an array within the string
525 - // if they do, create them as an actual array
526 - if ( substr( $value, 0, 1 ) === '[' && substr( $value, -1 ) === ']' ) {
527 - $value = trim( $value,"[]" );
528 - $new_array[ $key ] = array( $value );
529 - }
530 -
531 - // set value as integer
532 - if ( strpos( $value, 'integer(' ) !== false && substr( $value, -1 ) === ')' ) {
533 - preg_match("/\(([^\)]*)\)/", $value, $match );
534 - $result = $match[1];
535 - $new_array[ $key ] = absint( $result );
536 - }
537 -
538 - // set value as float
539 - if ( strpos( $value, 'float(' ) !== false && substr( $value, -1 ) === ')' ) {
540 - preg_match("/\(([^\)]*)\)/", $value, $match );
541 - $result = $match[1];
542 - if ( substr( $result, 0, 1 ) === '"' && substr( $result, -1 ) === '"' )
543 - $result = trim( $result,'""' );
544 - $new_array[ $key ] = (float) $result;
545 -
546 - }
547 -
548 - // set value as boolean
549 - if ( strpos( $value, 'boolean(' ) !== false && substr( $value, -1 ) === ')' ) {
550 - preg_match("/\(([^\)]*)\)/", $value, $match );
551 - $result = $match[1];
552 - $result = filter_var( $result, FILTER_VALIDATE_BOOLEAN );
553 - $new_array[ $key ] = $result;
554 -
555 - }
556 -
557 - }
558 -
559 - }
560 -
561 - return $raw ? $raw : $new_array;
562 -
563 - }
564 -
565 -
566 302 /**
567 303 * decrypt our parameters from the DB
568 304 */
569 305 public function decrypt( $array_or_string ) {
@@ -589,86 +325,20 @@
589 325
590 326 /**
591 327 * debug
592 328 */
593 - public function maybe_add_debug_info( $data, $wpgetapi ) {
329 + public function maybe_add_debug_info( $data, $this_data ) {
594 330
595 - if(
596 - ( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) ||
597 - ( isset( $this->args['test_endpoint'] ) && ( $this->args['test_endpoint'] === true ) )
598 - ) {
331 + if( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) {
599 332
600 - $this->debug = true;
601 -
602 - // admin test endpoint button
603 - $testing = isset( $this->args['test_endpoint'] ) && ( $this->args['test_endpoint'] === true ) ? true : false;
604 -
605 - // get api status from response code
606 - $status = array(
607 - 'title' => 'Error in API response.',
608 - 'desc' => 'Check all details within your endpoint. Something is misconfigured.',
609 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
610 - );
611 -
612 - if( $this->response_code >= 200 && $this->response_code <= 299 ) {
613 - $status = array(
614 - 'title' => 'Success!',
615 - '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.',
616 - 'type' => '<span class="dashicons dashicons-yes-alt"></span>'
617 - );
618 - }
619 - if( $this->response_code >= 400 && $this->response_code <= 499 ) {
620 - $status = array(
621 - 'title' => 'Bad Request',
622 - '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.',
623 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
624 - );
625 - }
626 - if( $this->response_code == 401 ) {
627 - $status = array(
628 - 'title' => 'Unauthorised',
629 - '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.',
630 - 'type' => '<span class="dashicons dashicons-warning"></span>'
631 - );
632 - }
633 - if( $this->response_code == 403 ) {
634 - $status = array(
635 - 'title' => 'Forbidden',
636 - '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.',
637 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
638 - );
639 - }
640 - if( $this->response_code == 405 ) {
641 - $status = array(
642 - 'title' => 'Method Not Allowed',
643 - 'desc' => 'Try changing the Request Method within the endpoint settings.',
644 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
645 - );
646 - }
647 - if( $this->response_code == 415 ) {
648 - $status = array(
649 - 'title' => 'Unsupported Media Type',
650 - '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>.',
651 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
652 - );
653 - }
654 - if( $this->response_code >= 500 && $this->response_code <= 599 ) {
655 - $status = array(
656 - 'title' => 'Internal Server Error',
657 - 'desc' => 'This indicates an issue with the API server. Contact your API provider.',
658 - 'type' => '<span class="dashicons dashicons-dismiss"></span>'
659 - );
660 - }
661 -
662 -
663 333 ob_start(); ?>
664 334
665 335 <style>
666 336
667 337 .wpgetapi-debug {
668 - background: #fff;
338 + background: #f4f4f4;
669 339 padding: 20px;
670 - box-shadow: 0 0 1px #aaa;
340 + border: 1px solid #ccc;
671 341 margin: 20px;
672 342 font-size: 15px;
673 343 }
674 344 .wpgetapi-debug
@@ -683,9 +353,9 @@
683 353 }
684 354 .wpgetapi-debug p.small {
685 355 font-size: 85%;
686 356 color: #999;
687 - margin: 0 0 12px !important;
357 + margin-bottom: 15px !important
688 358 }
689 359 .wpgetapi-debug h5 {
690 360 font-weight: bold;
691 361 font-size: 18px;
@@ -695,155 +365,86 @@
695 365 .wpgetapi-debug .debug-item {
696 366 margin: 10px 0;
697 367 background: #fff;
698 368 padding: 15px 20px;
699 - display: inline-block !important;
369 + display: inline-block !important;;
700 370 width: 100% !important;
701 - box-shadow: 0 4px 4px -2px rgb(0 0 0 / 9%);
702 - border: 1px solid #eee;
703 - margin-bottom: 20px !important;
371 + box-shadow: 0 0 5px rgba(0,0,0,0.1)
704 372 }
705 373 .wpgetapi-debug .debug-item h6 {
706 374 font-weight: bold;
707 - font-size: 14px;
708 - margin: 0;
375 + font-size: 16px;
376 + margin: 0 0 3px;
709 377 text-transform: none !important;
710 378 }
711 379 .wpgetapi-debug .debug-item .debug-result,
712 380 .wpgetapi-debug .debug-item .debug-result pre {
713 381 font-family: monospace !important;
714 - font-size: 13px !important;
382 + font-size: 15px !important;
715 383 margin: 0 !important;
716 - padding: 8px 12px;
717 - background: #f4f7f9;
384 + padding: 10px 12px;
385 + background: #f8f8f8;
718 386 }
719 387 .wpgetapi-debug .debug-item .debug-result pre {
720 388 border: none;
721 389 padding: 5px
722 390 }
723 -.wpgetapi-debug.testing {
724 - background: transparent;
725 - padding: 0;
726 - box-shadow: none;
727 -}
728 -.wpgetapi-debug.testing .debug-item {
729 - margin: 5px 0;
730 -}
731 -.wpgetapi-debug.testing .debug-item.status {
732 - border: none;
733 - box-shadow: none;
734 - margin-bottom: 15px;
735 -}
736 -.wpgetapi-debug .debug-item.status h5 {
737 - font-size: 15px;
738 -}
739 -.wpgetapi-debug .status .dashicons {
740 - margin: 0 5px 3px 0;
741 -}
742 -.wpgetapi-debug .status .dashicons-yes-alt {
743 - color: #5e9929;
744 -}
745 -.wpgetapi-debug .status .dashicons-dismiss {
746 - color: #cc4646;
747 -}
748 -.wpgetapi-debug .status .dashicons-warning {
749 - color: #dfa12e;
750 -}
751 -.wpgetapi-debug .status .desc {
752 - font-size: 14px;
753 - font-weight: 400 !important;
754 -}
391 +
755 392 </style>
756 393
757 - <div class="wpgetapi-debug <?php echo $testing ? 'testing' : ''; ?>">
394 + <div class="wpgetapi-debug">
758 395
759 - <?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>
760 398
761 - <div class="debug-item status">
762 - <div class="">
763 - <h5><?php _e( $status['type'] ); ?> <?php esc_html_e( $status['title'] ); ?></h5>
764 - <span class="desc"><?php _e( $status['desc'] ); ?></span>
765 - </div>
766 - </div>
767 - <div class="debug-item">
768 - <h6><?php esc_html_e( 'Full URL', 'wpgetapi' ); ?></h6>
769 - <p class="small"><?php esc_html_e( 'The full URL that is being called.', 'wpgetapi' ); ?></p>
770 - <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
771 - </div>
772 -
773 - <div class="debug-item">
774 - <h6><?php esc_html_e( 'Data Output', 'wpgetapi' ); ?></h6>
775 - <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>
776 - <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
777 - </div>
778 -
779 - <div class="debug-item">
780 - <h6><?php esc_html_e( 'Final Request Arguments', 'wpgetapi' ); ?></h6>
781 - <p class="small"><?php esc_html_e( 'The final request arguments sent in the API request. Includes headers and body arguments.', 'wpgetapi' ); ?></p>
782 - <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
783 - </div>
784 -
785 - <div class="debug-item">
786 - <h6><?php esc_html_e( 'Response', 'wpgetapi' ); ?></h6>
787 - <p class="small"><?php esc_html_e( 'The full response from the API request.', 'wpgetapi' ); ?></p>
788 - <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
789 - </div>
790 -
791 - <?php } else { ?>
792 -
793 - <h5><strong><?php esc_html_e( 'WPGetAPI, Debug Mode - Plugin Version', 'wpgetapi' ); ?> <?php esc_html_e( WpGetApi()->version ); ?></strong></h5>
794 - <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>
795 -
796 399 <div class="debug-item">
797 - <h6><?php esc_html_e( 'Full URL', 'wpgetapi' ); ?></h6>
798 - <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>
799 402 <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
800 403 </div>
801 404
802 405 <div class="debug-item">
803 - <h6><?php esc_html_e( 'Data Output', 'wpgetapi' ); ?></h6>
804 - <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>
805 408 <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
806 409 </div>
807 410
808 411 <div class="debug-item">
809 - <h6><?php esc_html_e( 'Query String', 'wpgetapi' ); ?></h6>
810 - <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>
811 420 <div class="debug-result"><?php wpgetapi_pp( $this->query_parameters ); ?></div>
812 421 </div>
813 422
814 423 <div class="debug-item">
815 - <h6><?php esc_html_e( 'Headers', 'wpgetapi' ); ?></h6>
816 - <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>
817 426 <div class="debug-result"><?php wpgetapi_pp( $this->header_parameters ); ?></div>
818 427 </div>
819 428
820 429 <div class="debug-item">
821 - <h6><?php esc_html_e( 'Body', 'wpgetapi' ); ?></h6>
822 - <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>
823 432 <div class="debug-result"><?php wpgetapi_pp( $this->body_parameters ); ?></div>
824 433 </div>
825 434
826 435 <div class="debug-item">
827 - <h6><?php esc_html_e( 'Final Request Arguments', 'wpgetapi' ); ?></h6>
828 - <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>
829 438 <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
830 439 </div>
831 440
832 441 <div class="debug-item">
833 - <h6><?php esc_html_e( 'Arguments', 'wpgetapi' ); ?></h6>
834 - <p class="small"><?php esc_html_e( 'The arguments set within your shortcode or template tag.', 'wpgetapi' ); ?></p>
835 - <div class="debug-result"><?php wpgetapi_pp( $this->args ); ?></div>
836 - </div>
837 -
838 - <div class="debug-item">
839 - <h6><?php esc_html_e( 'Response', 'wpgetapi' ); ?></h6>
840 - <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>
841 444 <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
842 445 </div>
843 446
844 - <?php } ?>
845 -
846 447 </div>
847 448
848 449 <?php
849 450
@@ -853,9 +454,11 @@
853 454
854 455 return $data;
855 456
856 457 }
458 +
459 +
857 460
858 461 }
859 462
860 463
861 464 }