class-wp-job-manager-api.php — WP Job Manager 2.4.7

wp-job-manager / includes / class-wp-job-manager-api.php

wp-job-manager / includes Last commit date

class-wp-job-manager-api.php

108 lines

1	<?php
2	/**
3	* File containing the class WP_Job_Manager_API.
4	*
5	* @package wp-job-manager
6	*/
7
8	if ( ! defined( 'ABSPATH' ) ) {
9	exit;
10	}
11
12	/**
13	* Handles API requests for WP Job Manager.
14	*
15	* @package wp-job-manager
16	* @since 1.0.0
17	*/
18	class WP_Job_Manager_API {
19
20	/**
21	* The single instance of the class.
22	*
23	* @var self
24	* @since 1.26.0
25	*/
26	private static $instance = null;
27
28	/**
29	* Allows for accessing single instance of class. Class should only be constructed once per call.
30	*
31	* @since 1.26.0
32	* @static
33	* @return self Main instance.
34	*/
35	public static function instance() {
36	if ( is_null( self::$instance ) ) {
37	self::$instance = new self();
38	}
39	return self::$instance;
40	}
41
42	/**
43	* Constructor.
44	*/
45	public function __construct() {
46	add_filter( 'query_vars', [ $this, 'add_query_vars' ], 0 );
47	add_action( 'parse_request', [ $this, 'api_requests' ], 0 );
48	}
49
50	/**
51	* Adds query vars used in API calls.
52	*
53	* @param array $vars the query vars.
54	* @return array
55	*/
56	public function add_query_vars( $vars ) {
57	$vars[] = 'job-manager-api';
58	return $vars;
59	}
60
61	/**
62	* Adds endpoint for API requests.
63	*/
64	public function add_endpoint() {
65	add_rewrite_endpoint( 'job-manager-api', EP_ALL );
66	}
67
68	/**
69	* API request - Trigger any API requests (handy for third party plugins/gateways).
70	*/
71	public function api_requests() {
72	global $wp;
73
74	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- If necessary/possible, nonce should be checked by API handler.
75	if ( ! empty( $_GET['job-manager-api'] ) ) {
76	// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- If necessary/possible, nonce should be checked by API handler.
77	$wp->query_vars['job-manager-api'] = sanitize_text_field( wp_unslash( $_GET['job-manager-api'] ) );
78	}
79
80	if ( ! empty( $wp->query_vars['job-manager-api'] ) ) {
81	// Buffer, we won't want any output here.
82	ob_start();
83
84	// Get API trigger.
85	$api = strtolower( esc_attr( $wp->query_vars['job-manager-api'] ) );
86
87	// Load class if exists.
88	if ( has_action( 'job_manager_api_' . $api ) && class_exists( $api ) ) {
89	$api_class = new $api();
90	}
91
92	/**
93	* Performs an API action.
94	* The dynamic part of the action, $api, is the API action.
95	*
96	* @since 1.0.0
97	*/
98	do_action( 'job_manager_api_' . $api );
99
100	// Done, clear buffer and exit.
101	ob_end_clean();
102	wp_die();
103	}
104	}
105	}
106
107	WP_Job_Manager_API::instance();
108