184 lines
3.2 KiB
PHP
184 lines
3.2 KiB
PHP
<?php
|
|
|
|
if( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
|
|
|
|
if( ! class_exists('ACF_Ajax') ) :
|
|
|
|
class ACF_Ajax {
|
|
|
|
/** @var string The AJAX action name. */
|
|
var $action = '';
|
|
|
|
/** @var array The $_REQUEST data. */
|
|
var $request;
|
|
|
|
/** @var bool Prevents access for non-logged in users. */
|
|
var $public = false;
|
|
|
|
/**
|
|
* __construct
|
|
*
|
|
* Sets up the class functionality.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param void
|
|
* @return void
|
|
*/
|
|
function __construct() {
|
|
$this->initialize();
|
|
$this->add_actions();
|
|
}
|
|
|
|
/**
|
|
* has
|
|
*
|
|
* Returns true if the request has data for the given key.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param string $key The data key.
|
|
* @return boolean
|
|
*/
|
|
function has( $key = '' ) {
|
|
return isset($this->request[$key]);
|
|
}
|
|
|
|
/**
|
|
* get
|
|
*
|
|
* Returns request data for the given key.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param string $key The data key.
|
|
* @return mixed
|
|
*/
|
|
function get( $key = '' ) {
|
|
return isset($this->request[$key]) ? $this->request[$key] : null;
|
|
}
|
|
|
|
/**
|
|
* set
|
|
*
|
|
* Sets request data for the given key.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param string $key The data key.
|
|
* @param mixed $value The data value.
|
|
* @return ACF_Ajax
|
|
*/
|
|
function set( $key = '', $value ) {
|
|
$this->request[$key] = $value;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* initialize
|
|
*
|
|
* Allows easy access to modifying properties without changing constructor.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param void
|
|
* @return void
|
|
*/
|
|
function initialize() {
|
|
/* do nothing */
|
|
}
|
|
|
|
/**
|
|
* add_actions
|
|
*
|
|
* Adds the ajax actions for this response.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param void
|
|
* @return void
|
|
*/
|
|
function add_actions() {
|
|
|
|
// add action for logged-in users
|
|
add_action( "wp_ajax_{$this->action}", array($this, 'request') );
|
|
|
|
// add action for non logged-in users
|
|
if( $this->public ) {
|
|
add_action( "wp_ajax_nopriv_{$this->action}", array($this, 'request') );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* request
|
|
*
|
|
* Callback for ajax action. Sets up properties and calls the get_response() function.
|
|
*
|
|
* @date 1/8/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param void
|
|
* @return void
|
|
*/
|
|
function request() {
|
|
|
|
// Verify ajax request
|
|
if( !acf_verify_ajax() ) {
|
|
wp_send_json_error();
|
|
}
|
|
|
|
// Store data for has() and get() functions.
|
|
$this->request = wp_unslash($_REQUEST);
|
|
|
|
// Send response.
|
|
$this->send( $this->get_response( $this->request ) );
|
|
}
|
|
|
|
/**
|
|
* get_response
|
|
*
|
|
* Returns the response data to sent back.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param array $request The request args.
|
|
* @return mixed The response data or WP_Error.
|
|
*/
|
|
function get_response( $request ) {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* send
|
|
*
|
|
* Sends back JSON based on the $response as either success or failure.
|
|
*
|
|
* @date 31/7/18
|
|
* @since 5.7.2
|
|
*
|
|
* @param mixed $response The response to send back.
|
|
* @return void
|
|
*/
|
|
function send( $response ) {
|
|
|
|
// Return error.
|
|
if( is_wp_error($response) ) {
|
|
wp_send_json_error(array( 'error' => $response->get_error_message() ));
|
|
|
|
// Return success.
|
|
} else {
|
|
wp_send_json_success($response);
|
|
}
|
|
}
|
|
}
|
|
|
|
endif; // class_exists check
|
|
|
|
?>
|