File "class-acf-ajax.php"

Full Path: /home/vantageo/public_html/cache/cache/cache/cache/.wp-cli/wp-content/plugins/advanced-custom-fields-pro/includes/ajax/class-acf-ajax.php
File size: 3.18 KB
MIME-type: text/x-php
Charset: utf-8

<?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

?>