PluginProbe
WPGet API – Connect to any external REST API / 1.4.6
WPGet API – Connect to any external REST API v1.4.6
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 +102 -486 2.1.31.4.6 View file →
@@ -28,11 +28,8 @@
28 28 public $header_parameters = ''; // the header paramaters
29 29 public $body_parameters = ''; // the body paramaters
30 30 public $body_json_encode = ''; // body_json_encode body
31 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
35 32
36 33 public $response = ''; // the returned response
37 34
38 35 public $final_url = ''; // final URL
@@ -37,15 +34,12 @@
37 34
38 35 public $final_url = ''; // final URL
39 36 public $final_request_args = array(); // final request_args
40 37
41 - public $results_format = 'json_string'; // results format
38 + public $results_format = 'json_string'; // reseults format
42 39
43 - public $response_code = ''; // the response code from the call
44 -
45 40 public $timeout = 10; // the timeout
46 - public $sslverify = 1; // ssl verify
47 - public $debug = false;
41 + public $sslverify = 1; // the paramaters
48 42
49 43
50 44 /**
51 45 * Main constructor
@@ -63,9 +57,9 @@
63 57 $this->endpoint_id = sanitize_text_field( $endpoint_id );
64 58 $this->keys = $keys;
65 59 $this->args = $args;
66 60
67 - add_filter( 'wpgetapi_raw_data', array( $this, 'maybe_add_debug_info' ), 99, 2 );
61 + add_filter( 'wpgetapi_raw_data', array( $this, 'maybe_add_debug_info' ), 5, 2 );
68 62
69 63 }
70 64
71 65
@@ -73,29 +67,8 @@
73 67 * Init our api data
74 68 */
75 69 public function init() {
76 70
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 71 // do some checks
99 72 if( empty( $this->setup ) || ! isset( $this->setup['apis'] ) || empty( $this->setup['apis'] ) )
100 73 return 'No API found.';
101 74
@@ -114,9 +87,9 @@
114 87 // loop through endpoints
115 88 foreach ( $this->api['endpoints'] as $index => $endpoint ) {
116 89
117 90 if( $this->endpoint_id == $endpoint['id'] ) {
118 -
91 +
119 92 $this->method = isset( $endpoint['method'] ) && $endpoint['method'] != '' ? sanitize_text_field( $endpoint['method'] ) : 'GET';
120 93 $this->cache_time = isset( $endpoint['cache_time'] ) && ! empty( $endpoint['cache_time'] ) ? absint( $endpoint['cache_time'] ) : '';
121 94 $this->endpoint = isset( $endpoint['endpoint'] ) && ! empty( $endpoint['endpoint'] ) ? sanitize_text_field( $endpoint['endpoint'] ) : '';
122 95
@@ -125,40 +98,13 @@
125 98 $this->header_parameters = isset( $endpoint['header_parameters'] ) && ! empty( $endpoint['header_parameters'] ) ? $this->do_parameters( $endpoint['header_parameters'] ) : array();
126 99
127 100 $this->body_parameters = isset( $endpoint['body_parameters'] ) && ! empty( $endpoint['body_parameters'] ) ? $this->do_parameters( $endpoint['body_parameters'] ) : array();
128 101
129 - // how to encode the body
130 102 $this->body_json_encode = isset( $endpoint['body_json_encode'] ) && $endpoint['body_json_encode'] == 'true' ? true : false;
131 103 $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 104
135 - $this->xml_root_node = isset( $endpoint['xml_root'] ) && ! empty( $endpoint['xml_root'] ) ? $endpoint['xml_root'] : $this->xml_root_node;
136 -
137 105 $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 106 }
160 -
161 107 }
162 108
163 109 $this->timeout = isset( $this->api['timeout'] ) && ! empty( $this->api['timeout'] ) ? $this->api['timeout'] : $this->timeout;
164 110 $this->sslverify = isset( $this->api['sslverify'] ) ? absint( $this->api['sslverify'] ) : $this->sslverify;
@@ -171,21 +117,58 @@
171 117 *
172 118 * @param string $field Field to retrieve
173 119 */
174 120 public function endpoint_output() {
121 + return $this->do_the_call();
122 + }
175 123
176 - do_action( 'wpgetapi_before_do_the_call', $this );
177 124
178 - return $this->do_the_call();
125 + /**
126 + * Sort out the parameters if they exist
127 + */
128 + public function do_parameters( $parameters ) {
129 +
130 + $new_array = array();
131 + $parameters = $this->decrypt($parameters);
179 132
133 + if( is_array( $parameters ) ) {
134 + foreach ( $parameters as $key => $parameter ) {
135 + if( ! empty( $parameter['name'] ) && ! empty( $parameter['value'] ) ) {
136 + $parameter['value'] = stripslashes( $parameter['value'] );
137 + $new_array[ sanitize_text_field( $parameter['name'] ) ] = $parameter['value'];
138 + }
139 + }
140 + }
141 +
142 + // look for array or json string and sort these out - for using such things in shortcode
143 + if( is_array( $new_array ) ) {
144 +
145 + foreach ( $new_array as $key => $value ) {
146 +
147 + // checking if the parameters have a json string
148 + if ( substr( $value, 0, 1 ) === '{' && substr( $value, -1 ) === '}' ) {
149 + $new_array[ $key ] = json_decode( $value, true);
150 + }
151 +
152 + // checking if the parameters have an array within the string
153 + // if they do, create them as an actual array
154 + if ( substr( $value, 0, 1 ) === '[' && substr( $value, -1 ) === ']' ) {
155 + $new_array[ $key ] = array( $value );
156 + }
157 +
158 + }
159 +
160 + }
161 +
162 + return $new_array;
163 +
180 164 }
181 165
182 -
183 166 /**
184 167 * Send the request and return our data
185 168 */
186 169 public function do_the_call() {
187 -
170 +
188 171 $this->init();
189 172
190 173 // build the URL
191 174 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
@@ -191,60 +174,28 @@
191 174 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
192 175
193 176 // build the request args
194 177 $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 178
201 - if ( apply_filters( 'wpgetapi_should_we_stop', false, $this ) ) {
202 - return;
203 - }
204 -
205 179 // POST request
206 180 if( $this->method == 'POST' )
207 181 $this->response = $this->POST_request();
208 182
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 183 // GET request
218 184 if( $this->method == 'GET' )
219 185 $this->response = $this->GET_request();
220 186
221 - // DELETE request
222 - if( $this->method == 'DELETE' )
223 - $this->response = $this->DELETE_request();
224 -
225 187 // wp error
226 188 if( is_wp_error( $this->response ) ) {
227 189 return apply_filters( 'wpgetapi_raw_error_data', json_encode( $this->response ), $this );
228 190 }
229 191
230 - // get response_code
231 - $this->response_code = wp_remote_retrieve_response_code( $this->response );
192 + $data = wp_remote_retrieve_body( $this->response );
232 193
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 194 // returning in JSON format
241 195 if( $this->results_format == 'json_string' || $this->results_format == 'json_decoded' )
242 196 $data = $this->return_data( $data );
243 197
244 - if( $data === 'null' )
245 - $data = 'Result is null. Check that all endpoint settings are correct.';
246 -
247 198 return apply_filters( 'wpgetapi_raw_data', $data, $this );
248 199
249 200 }
250 201
@@ -257,33 +208,15 @@
257 208 // first make sure our endpoint starts with a slash
258 209 if ( substr( $this->endpoint, 0, 1 ) != '/' )
259 210 $this->endpoint = '/' . $this->endpoint;
260 211
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 212 $url = untrailingslashit( $this->base_url ) . $this->endpoint;
270 213
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 214 // add empty array - was getting errors if it was just null or false
280 - $params = empty( $params ) ? array(''=>'') : $params;
215 + $params = empty( $this->query_parameters ) ? array(''=>'') : $this->query_parameters;
281 216
282 - $result = add_query_arg( $params, $url );
217 + return add_query_arg( $params, $url );
283 218
284 - return $result;
285 -
286 219 }
287 220
288 221
289 222 /**
@@ -297,60 +230,27 @@
297 230 ), $this );
298 231
299 232
300 233 // 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
234 + if( $this->method == 'POST' ) {
235 +
304 236 $this->body_parameters = apply_filters( 'wpgetapi_body_parameters', $this->body_parameters, $this );
305 237
306 - // do we json_encode the entire body
307 - if( $this->body_json_encode == true ) {
238 + // do we json_encode the entire body as a string
239 + if( $this->body_json_encode == true )
308 240 $this->body_parameters = json_encode( $this->body_parameters );
309 - }
310 241
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 );
242 +
243 + // do we urlencode the entire body as a string
244 + if( $this->body_url_encode == true ) {
245 + $data_raw = '';
246 + foreach ($this->body_parameters as $key => $value){
247 + $data_raw = $data_raw . $key . "=" . urlencode($value) . "&";
320 248 }
249 + $this->body_parameters = $data_raw;
321 250
322 - $this->body_parameters = http_build_query( $this->body_parameters, '', '&' );
323 -
324 251 }
325 252
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 253 // add our body parameters
354 254 if( $this->body_parameters && ! empty( $this->body_parameters ) )
355 255 $headers['body'] = $this->body_parameters;
356 256
@@ -355,12 +255,8 @@
355 255 $headers['body'] = $this->body_parameters;
356 256
357 257 }
358 258
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 259 // add headers to our final request args
364 260 $this->final_request_args = wp_parse_args( $headers, $this->final_request_args );
365 261
366 262 // build the args taht are sent to the request
@@ -376,194 +272,49 @@
376 272
377 273 }
378 274
379 275
380 -
381 -
382 276 /**
383 277 * Do a GET request
384 278 */
385 279 public function GET_request() {
386 -
387 280 $response = '';
388 281 // so we can so something before the remote_get (caching)
389 282 $response = apply_filters( 'wpgetapi_before_get_request', $response, $this );
390 -
391 283 if( empty( $response ) )
392 284 $response = wp_remote_get( $this->final_url, $this->final_request_args );
393 285
394 286 return $response;
287 + }
395 288
396 - }
397 289
398 290 /**
399 291 * Do a POST request
400 292 */
401 293 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 -
294 + $response = wp_remote_post( $this->final_url, $this->final_request_args );
412 295 return $response;
413 296 }
414 297
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 298
424 299 /**
425 - * Do a PATCH request
426 - */
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 - }
432 -
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 300 * return data
445 301 */
446 302 public function return_data( $data ) {
447 -
448 - $data = apply_filters( 'wpgetapi_json_response_body_before_decode', $data, $this->keys );
449 -
303 +
450 304 // 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 - }
305 + $data = json_decode( $data, true );
306 + $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
459 307
460 - $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
461 -
462 308 if( $this->results_format == 'json_string' )
463 - return trim( json_encode( $data, JSON_PRETTY_PRINT ),'"');
464 -
309 + return trim( json_encode( $data ),'"');
310 +
465 311 if( $this->results_format == 'json_decoded' )
466 312 return $data;
467 313
468 314 }
469 315
470 - /**
471 - * Sort out the parameters if they exist
472 - */
473 - public function do_parameters( $parameters ) {
474 316
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 317 /**
567 318 * decrypt our parameters from the DB
568 319 */
569 320 public function decrypt( $array_or_string ) {
@@ -589,86 +340,20 @@
589 340
590 341 /**
591 342 * debug
592 343 */
593 - public function maybe_add_debug_info( $data, $wpgetapi ) {
344 + public function maybe_add_debug_info( $data, $this_data ) {
594 345
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 - ) {
346 + if( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) {
599 347
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 348 ob_start(); ?>
664 349
665 350 <style>
666 351
667 352 .wpgetapi-debug {
668 - background: #fff;
353 + background: #f4f4f4;
669 354 padding: 20px;
670 - box-shadow: 0 0 1px #aaa;
355 + border: 1px solid #ccc;
671 356 margin: 20px;
672 357 font-size: 15px;
673 358 }
674 359 .wpgetapi-debug
@@ -683,9 +368,9 @@
683 368 }
684 369 .wpgetapi-debug p.small {
685 370 font-size: 85%;
686 371 color: #999;
687 - margin: 0 0 12px !important;
372 + margin-bottom: 15px !important
688 373 }
689 374 .wpgetapi-debug h5 {
690 375 font-weight: bold;
691 376 font-size: 18px;
@@ -695,154 +380,85 @@
695 380 .wpgetapi-debug .debug-item {
696 381 margin: 10px 0;
697 382 background: #fff;
698 383 padding: 15px 20px;
699 - display: inline-block !important;
384 + display: inline-block !important;;
700 385 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;
386 + box-shadow: 0 0 5px rgba(0,0,0,0.1)
704 387 }
705 388 .wpgetapi-debug .debug-item h6 {
706 389 font-weight: bold;
707 - font-size: 14px;
708 - margin: 0;
390 + font-size: 16px;
391 + margin: 0 0 3px;
709 392 text-transform: none !important;
710 393 }
711 394 .wpgetapi-debug .debug-item .debug-result,
712 395 .wpgetapi-debug .debug-item .debug-result pre {
713 396 font-family: monospace !important;
714 - font-size: 13px !important;
397 + font-size: 15px !important;
715 398 margin: 0 !important;
716 - padding: 8px 12px;
717 - background: #f4f7f9;
399 + padding: 10px 12px;
400 + background: #f8f8f8;
718 401 }
719 402 .wpgetapi-debug .debug-item .debug-result pre {
720 403 border: none;
721 404 padding: 5px
722 405 }
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 -}
406 +
755 407 </style>
756 408
757 - <div class="wpgetapi-debug <?php echo $testing ? 'testing' : ''; ?>">
409 + <div class="wpgetapi-debug">
758 410
759 - <?php if( $testing ) { ?>
411 + <h5><strong>WPGetAPI, Debug Mode - Plugin Version <?php esc_html_e( WpGetApi()->version ); ?></strong></h5>
412 + <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 413
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 414 <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>
415 + <h6>Full URL</h6>
416 + <p class="small">The full URL that is being called.</p>
799 417 <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
800 418 </div>
801 419
802 420 <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>
421 + <h6>Data Output</h6>
422 + <p class="small">The resulting output that has been returned from the API.</p>
805 423 <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
806 424 </div>
807 425
808 426 <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>
427 + <h6>Arguments</h6>
428 + <p class="small">The arguments set within your shortcode or template tag.</p>
429 + <div class="debug-result"><?php wpgetapi_pp( $this->args ); ?></div>
430 + </div>
431 +
432 + <div class="debug-item">
433 + <h6>Query String</h6>
434 + <p class="small">The query string parameters (if any) that you have set within the endpoint settings.</p>
811 435 <div class="debug-result"><?php wpgetapi_pp( $this->query_parameters ); ?></div>
812 436 </div>
813 437
814 438 <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>
439 + <h6>Headers</h6>
440 + <p class="small">The headers parameters (if any) that you have set within the endpoint settings.</p>
817 441 <div class="debug-result"><?php wpgetapi_pp( $this->header_parameters ); ?></div>
818 442 </div>
819 443
820 444 <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>
445 + <h6>Body</h6>
446 + <p class="small">The body parameters (if any) that you have set within the endpoint settings.</p>
823 447 <div class="debug-result"><?php wpgetapi_pp( $this->body_parameters ); ?></div>
824 448 </div>
825 449
826 450 <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>
451 + <h6>Final Request Arguments</h6>
452 + <p class="small">The final request arguments sent in the API request. Includes headers and body arguments.</p>
829 453 <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
830 454 </div>
831 455
832 456 <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>
457 + <h6>Response</h6>
458 + <p class="small">The full response from the API request.</p>
841 459 <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
842 460 </div>
843 -
844 - <?php } ?>
845 461
846 462 </div>
847 463
848 464 <?php