initial commit

hamrokhaanpaan/wp-content/plugins/advanced-custom-fields-pro/includes/ajax/class-acf-ajax.php

@@ -0,0 +1,230 @@
+<?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;
+		}
+
+		/**
+		 * 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 = null ) {
+			$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() {
+
+			// Store data for has() and get() functions.
+			$this->request = wp_unslash( $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Verified below in verify_request().
+
+			// Verify request and handle error.
+			$error = $this->verify_request( $this->request );
+			if ( is_wp_error( $error ) ) {
+				$this->send( $error );
+			}
+
+			// Send response.
+			$this->send( $this->get_response( $this->request ) );
+		}
+
+		/**
+		 * Verifies the request.
+		 *
+		 * @date    9/3/20
+		 * @since   5.8.8
+		 *
+		 * @param   array $request The request args.
+		 * @return  (bool|WP_Error) True on success, WP_Error on fail.
+		 */
+		function verify_request( $request ) {
+
+			// Verify nonce.
+			if ( ! acf_verify_ajax() ) {
+				return new WP_Error( 'acf_invalid_nonce', __( 'Invalid nonce.', 'acf' ), array( 'status' => 404 ) );
+			}
+			return true;
+		}
+
+		/**
+		 * 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 ) ) {
+				$this->send_error( $response );
+
+				// Return success.
+			} else {
+				wp_send_json( $response );
+			}
+		}
+
+		/**
+		 * Sends a JSON response for the given WP_Error object.
+		 *
+		 * @date    8/3/20
+		 * @since   5.8.8
+		 *
+		 * @param   WP_Error error The error object.
+		 * @return  void
+		 */
+		function send_error( $error ) {
+
+			// Get error status
+			$error_data = $error->get_error_data();
+			if ( is_array( $error_data ) && isset( $error_data['status'] ) ) {
+				$status_code = $error_data['status'];
+			} else {
+				$status_code = 500;
+			}
+
+			wp_send_json(
+				array(
+					'code'    => $error->get_error_code(),
+					'message' => $error->get_error_message(),
+					'data'    => $error->get_error_data(),
+				),
+				$status_code
+			);
+		}
+	}
+
+endif; // class_exists check