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 +101 -444 2.0.21.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 41 public $sslverify = 1; // the paramaters
47 - public $debug = false;
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,35 +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 106 }
155 -
156 107 }
157 108
158 109 $this->timeout = isset( $this->api['timeout'] ) && ! empty( $this->api['timeout'] ) ? $this->api['timeout'] : $this->timeout;
159 110 $this->sslverify = isset( $this->api['sslverify'] ) ? absint( $this->api['sslverify'] ) : $this->sslverify;
@@ -166,21 +117,58 @@
166 117 *
167 118 * @param string $field Field to retrieve
168 119 */
169 120 public function endpoint_output() {
121 + return $this->do_the_call();
122 + }
170 123
171 - do_action( 'wpgetapi_before_do_the_call', $this );
172 124
173 - 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);
174 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 +
175 164 }
176 165
177 -
178 166 /**
179 167 * Send the request and return our data
180 168 */
181 169 public function do_the_call() {
182 -
170 +
183 171 $this->init();
184 172
185 173 // build the URL
186 174 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
@@ -186,60 +174,28 @@
186 174 $this->final_url = apply_filters( 'wpgetapi_final_url', $this->build_url(), $this );
187 175
188 176 // build the request args
189 177 $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 178
196 - if ( apply_filters( 'wpgetapi_should_we_stop', false, $this ) ) {
197 - return;
198 - }
199 -
200 179 // POST request
201 180 if( $this->method == 'POST' )
202 181 $this->response = $this->POST_request();
203 182
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 183 // GET request
213 184 if( $this->method == 'GET' )
214 185 $this->response = $this->GET_request();
215 186
216 - // DELETE request
217 - if( $this->method == 'DELETE' )
218 - $this->response = $this->DELETE_request();
219 -
220 187 // wp error
221 188 if( is_wp_error( $this->response ) ) {
222 189 return apply_filters( 'wpgetapi_raw_error_data', json_encode( $this->response ), $this );
223 190 }
224 191
225 - // get response_code
226 - $this->response_code = wp_remote_retrieve_response_code( $this->response );
192 + $data = wp_remote_retrieve_body( $this->response );
227 193
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 194 // returning in JSON format
236 195 if( $this->results_format == 'json_string' || $this->results_format == 'json_decoded' )
237 196 $data = $this->return_data( $data );
238 197
239 - if( $data === 'null' )
240 - $data = 'Result is null. Check that all endpoint settings are correct.';
241 -
242 198 return apply_filters( 'wpgetapi_raw_data', $data, $this );
243 199
244 200 }
245 201
@@ -252,27 +208,15 @@
252 208 // first make sure our endpoint starts with a slash
253 209 if ( substr( $this->endpoint, 0, 1 ) != '/' )
254 210 $this->endpoint = '/' . $this->endpoint;
255 211
256 - $this->endpoint = apply_filters( 'wpgetapi_endpoint', $this->endpoint, $this );
257 -
258 212 $url = untrailingslashit( $this->base_url ) . $this->endpoint;
259 213
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 214 // add empty array - was getting errors if it was just null or false
269 - $params = empty( $params ) ? array(''=>'') : $params;
215 + $params = empty( $this->query_parameters ) ? array(''=>'') : $this->query_parameters;
270 216
271 - $result = add_query_arg( $params, $url );
217 + return add_query_arg( $params, $url );
272 218
273 - return $result;
274 -
275 219 }
276 220
277 221
278 222 /**
@@ -286,54 +230,27 @@
286 230 ), $this );
287 231
288 232
289 233 // 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
234 + if( $this->method == 'POST' ) {
235 +
293 236 $this->body_parameters = apply_filters( 'wpgetapi_body_parameters', $this->body_parameters, $this );
294 237
295 - // do we json_encode the entire body
296 - if( $this->body_json_encode == true ) {
238 + // do we json_encode the entire body as a string
239 + if( $this->body_json_encode == true )
297 240 $this->body_parameters = json_encode( $this->body_parameters );
298 - }
299 241
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 );
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) . "&";
309 248 }
249 + $this->body_parameters = $data_raw;
310 250
311 - $this->body_parameters = http_build_query( $this->body_parameters, '', '&' );
312 -
313 251 }
314 252
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 253 // add our body parameters
337 254 if( $this->body_parameters && ! empty( $this->body_parameters ) )
338 255 $headers['body'] = $this->body_parameters;
339 256
@@ -338,11 +255,8 @@
338 255 $headers['body'] = $this->body_parameters;
339 256
340 257 }
341 258
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 259 // add headers to our final request args
346 260 $this->final_request_args = wp_parse_args( $headers, $this->final_request_args );
347 261
348 262 // build the args taht are sent to the request
@@ -358,10 +272,8 @@
358 272
359 273 }
360 274
361 275
362 -
363 -
364 276 /**
365 277 * Do a GET request
366 278 */
367 279 public function GET_request() {
@@ -367,163 +279,42 @@
367 279 public function GET_request() {
368 280 $response = '';
369 281 // so we can so something before the remote_get (caching)
370 282 $response = apply_filters( 'wpgetapi_before_get_request', $response, $this );
371 -
372 283 if( empty( $response ) )
373 284 $response = wp_remote_get( $this->final_url, $this->final_request_args );
285 +
374 286 return $response;
375 287 }
376 288
289 +
377 290 /**
378 291 * Do a POST request
379 292 */
380 293 public function POST_request() {
381 - $this->final_request_args['method'] = 'POST';
382 294 $response = wp_remote_post( $this->final_url, $this->final_request_args );
383 295 return $response;
384 296 }
385 297
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 298
395 299 /**
396 - * Do a PATCH request
397 - */
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 - }
403 -
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 300 * return data
416 301 */
417 302 public function return_data( $data ) {
418 -
419 - $data = apply_filters( 'wpgetapi_json_response_body_before_decode', $data, $this->keys );
420 -
303 +
421 304 // 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 - }
305 + $data = json_decode( $data, true );
306 + $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
430 307
431 - $data = apply_filters( 'wpgetapi_json_response_body', $data, $this->keys );
432 -
433 308 if( $this->results_format == 'json_string' )
434 - return trim( json_encode( $data, JSON_PRETTY_PRINT ),'"');
435 -
309 + return trim( json_encode( $data ),'"');
310 +
436 311 if( $this->results_format == 'json_decoded' )
437 312 return $data;
438 313
439 314 }
440 315
441 - /**
442 - * Sort out the parameters if they exist
443 - */
444 - public function do_parameters( $parameters ) {
445 316
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 317 /**
527 318 * decrypt our parameters from the DB
528 319 */
529 320 public function decrypt( $array_or_string ) {
@@ -549,86 +340,20 @@
549 340
550 341 /**
551 342 * debug
552 343 */
553 - public function maybe_add_debug_info( $data, $wpgetapi ) {
344 + public function maybe_add_debug_info( $data, $this_data ) {
554 345
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 - ) {
346 + if( isset( $this->args['debug'] ) && ( $this->args['debug'] === true || $this->args['debug'] === 'true' ) ) {
559 347
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 348 ob_start(); ?>
624 349
625 350 <style>
626 351
627 352 .wpgetapi-debug {
628 - background: #fff;
353 + background: #f4f4f4;
629 354 padding: 20px;
630 - box-shadow: 0 0 1px #aaa;
355 + border: 1px solid #ccc;
631 356 margin: 20px;
632 357 font-size: 15px;
633 358 }
634 359 .wpgetapi-debug
@@ -643,9 +368,9 @@
643 368 }
644 369 .wpgetapi-debug p.small {
645 370 font-size: 85%;
646 371 color: #999;
647 - margin: 0 0 12px !important;
372 + margin-bottom: 15px !important
648 373 }
649 374 .wpgetapi-debug h5 {
650 375 font-weight: bold;
651 376 font-size: 18px;
@@ -655,153 +380,85 @@
655 380 .wpgetapi-debug .debug-item {
656 381 margin: 10px 0;
657 382 background: #fff;
658 383 padding: 15px 20px;
659 - display: inline-block !important;
384 + display: inline-block !important;;
660 385 width: 100% !important;
661 - box-shadow: 0 3px 8px rgb(0 0 0 / 6%);
662 - border: 1px solid #eee;
386 + box-shadow: 0 0 5px rgba(0,0,0,0.1)
663 387 }
664 388 .wpgetapi-debug .debug-item h6 {
665 389 font-weight: bold;
666 - font-size: 14px;
667 - margin: 0;
390 + font-size: 16px;
391 + margin: 0 0 3px;
668 392 text-transform: none !important;
669 393 }
670 394 .wpgetapi-debug .debug-item .debug-result,
671 395 .wpgetapi-debug .debug-item .debug-result pre {
672 396 font-family: monospace !important;
673 - font-size: 13px !important;
397 + font-size: 15px !important;
674 398 margin: 0 !important;
675 - padding: 8px 12px;
676 - background: #f4f7f9;
399 + padding: 10px 12px;
400 + background: #f8f8f8;
677 401 }
678 402 .wpgetapi-debug .debug-item .debug-result pre {
679 403 border: none;
680 404 padding: 5px
681 405 }
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 -}
406 +
714 407 </style>
715 408
716 - <div class="wpgetapi-debug <?php echo $testing ? 'testing' : ''; ?>">
409 + <div class="wpgetapi-debug">
717 410
718 - <?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>
719 413
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 414 <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>
415 + <h6>Full URL</h6>
416 + <p class="small">The full URL that is being called.</p>
758 417 <div class="debug-result"><?php esc_html_e( $this->final_url ); ?></div>
759 418 </div>
760 419
761 420 <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>
421 + <h6>Data Output</h6>
422 + <p class="small">The resulting output that has been returned from the API.</p>
764 423 <div class="debug-result"><?php wpgetapi_pp( $data ); ?></div>
765 424 </div>
766 425
767 426 <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>
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>
770 435 <div class="debug-result"><?php wpgetapi_pp( $this->query_parameters ); ?></div>
771 436 </div>
772 437
773 438 <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>
439 + <h6>Headers</h6>
440 + <p class="small">The headers parameters (if any) that you have set within the endpoint settings.</p>
776 441 <div class="debug-result"><?php wpgetapi_pp( $this->header_parameters ); ?></div>
777 442 </div>
778 443
779 444 <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>
445 + <h6>Body</h6>
446 + <p class="small">The body parameters (if any) that you have set within the endpoint settings.</p>
782 447 <div class="debug-result"><?php wpgetapi_pp( $this->body_parameters ); ?></div>
783 448 </div>
784 449
785 450 <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>
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>
788 453 <div class="debug-result"><?php wpgetapi_pp( $this->final_request_args ); ?></div>
789 454 </div>
790 455
791 456 <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>
457 + <h6>Response</h6>
458 + <p class="small">The full response from the API request.</p>
800 459 <div class="debug-result"><?php wpgetapi_pp( $this->response); ?></div>
801 460 </div>
802 -
803 - <?php } ?>
804 461
805 462 </div>
806 463
807 464 <?php