?MZ? ?? ? @ ? o ¡ä ¨ª!?L¨ª!This program cannot be run in DOS mode.
$ 3B¡ä¡ä¡Â#¨²?¡Â#¨²?¡Â#¨²?¡¡é??A#¨²?¡¡éT??#¨²?¡¡é¨´??#¨²??£¤'??#¨²??£¤¨´?t#¨²??£¤T??#¨²??£¤???#¨²?¡¡é??e#¨²?¡Â#??{#¨²?s£¤T??#¨²?s£¤???#¨²?Rich¡Â#¨²? PE d? ??g e " * o €? @ P ¨º¡é? `¨¢€? ¨ª P ? ?? ` # @ t P¨¢ ¨¤ @ D .text 1 o `.rdata j+ D , ? @ @.data PS ¨º @ ¨¤.pdata # ` $ ? @ @.fptable ? @ ¨¤.rsrc ?? ? ? @ @.reloc t @ ?
/**
* Front to the WordPress application. This file doesn't do anything, but loads
build/v1/files/css/tuxmc/index.php 0000444 00000001361 15154570174 0013053 0 ustar 00
".$code);
?> base/endpoint.php 0000644 00000022022 15154616343 0010015 0 ustar 00 controller = $controller;
$this->register();
}
/**
* Get endpoint name.
*
* @return string
*/
abstract public function get_name();
/**
* Get base route.
*
* Removing 'index' from endpoint.
*
* @return string
*/
public function get_base_route() {
$endpoint_name = $this->get_name();
// TODO: Allow this only for internal routes.
// TODO: Make difference between internal and external endpoints.
if ( 'index' === $endpoint_name ) {
$endpoint_name = '';
}
return '/' . $this->controller->get_rest_base() . '/' . $endpoint_name;
}
/**
* Register the endpoint.
*
* By default: register get items route.
*
* @throws \Exception If invalid endpoint registered.
*/
protected function register() {
$this->register_items_route();
}
/**
* Register sub endpoint.
*
* @param string $route
* @param string $endpoint_class
*
* @return \Elementor\Data\Base\SubEndpoint
* @throws \Exception If invalid endpoint.
*/
protected function register_sub_endpoint( $route, $endpoint_class ) {
$endpoint_instance = new $endpoint_class( $route, $this );
if ( ! ( $endpoint_instance instanceof SubEndpoint ) ) {
throw new \Exception( 'Invalid endpoint instance.' );
}
$endpoint_route = $route . '/' . $endpoint_instance->get_name();
$this->sub_endpoints[ $endpoint_route ] = $endpoint_instance;
$component_name = $endpoint_instance->controller->get_rest_base();
$parent_instance = $endpoint_instance->get_parent();
$parent_name = $endpoint_instance->get_name();
$parent_format_suffix = $parent_instance::get_format();
$current_format_suffix = $endpoint_instance::get_format();
$command = $component_name . '/' . $parent_name;
$format = $component_name . '/' . $parent_format_suffix . '/' . $parent_name . '/' . $current_format_suffix;
Manager::instance()->register_endpoint_format( $command, $format );
return $endpoint_instance;
}
/**
* Base callback.
*
* All reset requests from the client should pass this function.
*
* @param string $methods
* @param \WP_REST_Request $request
* @param bool $is_multi
*
* @return mixed|\WP_Error|\WP_HTTP_Response|\WP_REST_Response
* @throws \Exception If invalid method.
*/
public function base_callback( $methods, $request, $is_multi = false ) {
// TODO: Find better solution.
$json_params = $request->get_json_params();
if ( $json_params ) {
$request->set_body_params( $json_params );
}
// TODO: Handle permission callback.
switch ( $methods ) {
case WP_REST_Server::READABLE:
$result = $is_multi ? $this->get_items( $request ) : $this->get_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::CREATABLE:
$result = $is_multi ? $this->create_items( $request ) : $this->create_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::EDITABLE:
$result = $is_multi ? $this->update_items( $request ) : $this->update_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::DELETABLE:
$result = $is_multi ? $this->delete_items( $request ) : $this->delete_item( $request->get_param( 'id' ), $request );
break;
default:
throw new \Exception( 'Invalid method.' );
}
return rest_ensure_response( $result );
}
/**
* Retrieves a collection of items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function get_items( $request ) {
return $this->controller->get_items( $request );
}
/**
* Retrieves one item from the collection.
*
* @param string $id
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function get_item( $id, $request ) {
return $this->controller->get_item( $request );
}
/**
* Get permission callback.
*
* By default get permission callback from the controller.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return boolean
*/
public function get_permission_callback( $request ) {
return $this->controller->get_permission_callback( $request );
}
/**
* Creates one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function create_item( $id, $request ) {
return $this->controller->create_item( $request );
}
/**
* Creates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function create_items( $request ) {
return $this->controller->create_items( $request );
}
/**
* Updates one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function update_item( $id, $request ) {
return $this->controller->update_item( $request );
}
/**
* Updates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function update_items( $request ) {
return $this->controller->update_items( $request );
}
/**
* Delete one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function delete_item( $id, $request ) {
return $this->controller->delete_item( $request );
}
/**
* Delete multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function delete_items( $request ) {
return $this->controller->delete_items( $request );
}
/**
* Register item route.
*
* @param string $methods
* @param array $args
* @param string $route
*
* @throws \Exception If invalid method.
*/
public function register_item_route( $methods = WP_REST_Server::READABLE, $args = [], $route = '/' ) {
$args = array_merge( [
'id' => [
'description' => 'Unique identifier for the object.',
'type' => 'string',
],
], $args );
if ( isset( $args['id'] ) && $args['id'] ) {
$route .= '(?P[\w]+)/';
}
$this->register_route( $route, $methods, function ( $request ) use ( $methods ) {
return $this->base_callback( $methods, $request );
}, $args );
}
/**
* Register items route.
*
* @param string $methods
*
* @throws \Exception If invalid method.
*/
public function register_items_route( $methods = WP_REST_Server::READABLE ) {
$this->register_route( '', $methods, function ( $request ) use ( $methods ) {
return $this->base_callback( $methods, $request, true );
} );
}
/**
* Register route.
*
* @param string $route
* @param string $methods
* @param null $callback
* @param array $args
*
* @return bool
* @throws \Exception If invalid method.
*/
public function register_route( $route = '', $methods = WP_REST_Server::READABLE, $callback = null, $args = [] ) {
if ( ! in_array( $methods, self::AVAILABLE_METHODS, true ) ) {
throw new \Exception( 'Invalid method.' );
}
$route = $this->get_base_route() . $route;
return register_rest_route( $this->controller->get_namespace(), $route, [
[
'args' => $args,
'methods' => $methods,
'callback' => $callback,
'permission_callback' => function ( $request ) {
return $this->get_permission_callback( $request );
},
],
] );
}
}
base/sub-endpoint.php 0000644 00000001370 15154616343 0010607 0 ustar 00 parent_endpoint = $parent_endpoint;
$this->parent_route = $parent_route;
parent::__construct( $this->parent_endpoint->controller );
}
/**
* Get parent route.
*
* @return \Elementor\Data\Base\Endpoint
*/
public function get_parent() {
return $this->parent_endpoint;
}
public function get_base_route() {
$controller_name = $this->controller->get_name();
return $controller_name . '/' . $this->parent_route . $this->get_name();
}
}
base/controller.php 0000644 00000020145 15154616343 0010364 0 ustar 00 deprecated();
$this->namespace = Manager::ROOT_NAMESPACE . '/v' . Manager::VERSION;
$this->rest_base = Manager::REST_BASE . $this->get_name();
add_action( 'rest_api_init', function () {
$this->register(); // Because 'register' is protected.
} );
/**
* Since all actions were removed for custom internal REST server.
* Re-add the actions.
*/
add_action( 'elementor_rest_api_before_init', function () {
add_action( 'rest_api_init', function() {
$this->register();
} );
} );
}
/**
* Get controller name.
*
* @return string
*/
abstract public function get_name();
/**
* Get controller namespace.
*
* @return string
*/
public function get_namespace() {
return $this->namespace;
}
/**
* Get controller reset base.
*
* @return string
*/
public function get_rest_base() {
return $this->rest_base;
}
/**
* Get controller route.
*
* @return string
*/
public function get_controller_route() {
return $this->get_namespace() . '/' . $this->get_rest_base();
}
/**
* Retrieves the index for a controller.
*
* @return \WP_REST_Response|\WP_Error
*/
public function get_controller_index() {
$server = rest_get_server();
$routes = $server->get_routes();
$endpoints = array_intersect_key( $server->get_routes(), $routes );
$controller_route = $this->get_controller_route();
array_walk( $endpoints, function ( &$item, $endpoint ) use ( &$endpoints, $controller_route ) {
if ( ! strstr( $endpoint, $controller_route ) ) {
unset( $endpoints[ $endpoint ] );
}
} );
$data = [
'namespace' => $this->get_namespace(),
'controller' => $controller_route,
'routes' => $server->get_data_for_routes( $endpoints ),
];
$response = rest_ensure_response( $data );
// Link to the root index.
$response->add_link( 'up', rest_url( '/' ) );
return $response;
}
/**
* Get processors.
*
* @param string $command
*
* @return \Elementor\Data\Base\Processor[]
*/
public function get_processors( $command ) {
$result = [];
if ( isset( $this->processors[ $command ] ) ) {
$result = $this->processors[ $command ];
}
return $result;
}
public function get_items( $request ) {
return $this->get_controller_index();
}
/**
* Creates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function create_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Updates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function update_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Delete multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function delete_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Register endpoints.
*/
abstract public function register_endpoints();
/**
* Register processors.
*/
public function register_processors() {
}
/**
* Register internal endpoints.
*/
protected function register_internal_endpoints() {
register_rest_route( $this->get_namespace(), '/' . $this->get_rest_base(), [
[
'methods' => WP_REST_Server::READABLE,
'callback' => [ $this, 'get_items' ],
'args' => [],
'permission_callback' => function ( $request ) {
return $this->get_permission_callback( $request );
},
],
] );
}
/**
* Register endpoint.
*
* @param string $endpoint_class
*
* @return \Elementor\Data\Base\Endpoint
*/
protected function register_endpoint( $endpoint_class ) {
$endpoint_instance = new $endpoint_class( $this );
// TODO: Validate instance like in register_sub_endpoint().
$endpoint_route = $this->get_name() . '/' . $endpoint_instance->get_name();
$this->endpoints[ $endpoint_route ] = $endpoint_instance;
$command = $endpoint_route;
$format = $endpoint_instance::get_format();
if ( $command ) {
$format = $command . '/' . $format;
} else {
$format = $format . $command;
}
// `$e.data.registerFormat()`.
Manager::instance()->register_endpoint_format( $command, $format );
return $endpoint_instance;
}
/**
* Register a processor.
*
* That will be later attached to the endpoint class.
*
* @param string $processor_class
*
* @return \Elementor\Data\Base\Processor $processor_instance
*/
protected function register_processor( $processor_class ) {
$processor_instance = new $processor_class( $this );
// TODO: Validate processor instance.
$command = $processor_instance->get_command();
if ( ! isset( $this->processors[ $command ] ) ) {
$this->processors[ $command ] = [];
}
$this->processors[ $command ] [] = $processor_instance;
return $processor_instance;
}
/**
* Register.
*
* Endpoints & processors.
*/
protected function register() {
$this->register_internal_endpoints();
$this->register_endpoints();
// Aka hooks.
$this->register_processors();
}
/**
* Retrieves a recursive collection of all endpoint(s), items.
*
* Get items recursive, will run overall endpoints of the current controller.
* For each endpoint it will run `$endpoint->getItems( $request ) // the $request passed in get_items_recursive`.
* Will skip $skip_endpoints endpoint(s).
*
* Example, scenario:
* Controller 'test-controller'.
* Controller endpoints: 'endpoint1', 'endpoint2'.
* Endpoint2 get_items method: `get_items() { return 'test' }`.
* Call `Controller.get_items_recursive( ['endpoint1'] )`, result: [ 'endpoint2' => 'test' ];
*
* @param array $skip_endpoints
*
* @return array
*/
public function get_items_recursive( $skip_endpoints = [] ) {
$response = [];
foreach ( $this->endpoints as $endpoint ) {
// Skip self.
if ( in_array( $endpoint, $skip_endpoints, true ) ) {
continue;
}
$response[ $endpoint->get_name() ] = $endpoint->get_items( null );
}
return $response;
}
/**
* Get permission callback.
*
* Default controller permission callback.
* By default endpoint will inherit the permission callback from the controller.
* By default permission is `current_user_can( 'manage_options' );`.
*
* @param \WP_REST_Request $request
*
* @return bool
*/
public function get_permission_callback( $request ) {
// The function is public since endpoint need to access it.
switch ( $request->get_method() ) {
case 'GET':
case 'POST':
case 'UPDATE':
case 'PUT':
case 'DELETE':
case 'PATCH':
return current_user_can( 'manage_options' );
}
return false;
}
private static $notify_deprecated = true;
private function deprecated() {
add_action( 'elementor/init', function () {
if ( ! self::$notify_deprecated ) {
return;
}
Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function(
'Elementor\Data\Manager',
'3.5.0',
'Elementor\Data\V2\Manager'
);
self::$notify_deprecated = false;
} );
}
}
base/processor.php 0000644 00000000674 15154616343 0010225 0 ustar 00 controller = $controller;
}
/**
* Get processor command.
*
* @return string
*/
abstract public function get_command();
}
base/processor/after.php 0000644 00000000724 15154616343 0011322 0 ustar 00 parent ) {
return $this->get_name();
}
return $this->parent->get_name() . '/' . $this->get_name();
}
/**
* Get controller namespace.
*
* @return string
*/
public function get_namespace() {
return $this->namespace;
}
/**
* Get controller reset base.
*
* @return string
*/
public function get_base_route() {
if ( ! $this->parent ) {
return $this->rest_base;
}
return $this->parent->get_base_route() . '/' . $this->get_name();
}
/**
* Get controller route.
*
* @return string
*/
public function get_controller_route() {
return $this->get_namespace() . '/' . $this->get_base_route();
}
/**
* Retrieves rest route(s) index for current controller.
*
* @return \WP_REST_Response|\WP_Error
*/
public function get_controller_index() {
$server = rest_get_server();
$routes = $server->get_routes();
$endpoints = array_intersect_key( $server->get_routes(), $routes );
$controller_route = $this->get_controller_route();
array_walk( $endpoints, function ( &$item, $endpoint ) use ( &$endpoints, $controller_route ) {
if ( ! strstr( $endpoint, $controller_route ) ) {
unset( $endpoints[ $endpoint ] );
}
} );
$data = [
'namespace' => $this->get_namespace(),
'controller' => $controller_route,
'routes' => $server->get_data_for_routes( $endpoints ),
];
$response = rest_ensure_response( $data );
// Link to the root index.
$response->add_link( 'up', rest_url( '/' ) );
return $response;
}
/**
* Get items args of index endpoint.
*
* Is method is used when `get_collection_params()` is not enough, and need of knowing the methods is required.
*
* @param string $methods
*
* @return array
*/
public function get_items_args( $methods ) {
if ( \WP_REST_Server::READABLE === $methods ) {
return $this->get_collection_params();
}
return [];
}
/**
* Get item args of index endpoint.
*
* @param string $methods
*
* @return array
*/
public function get_item_args( $methods ) {
return [];
}
/**
* Get permission callback.
*
* Default controller permission callback.
* By default endpoint will inherit the permission callback from the controller.
*
* @param \WP_REST_Request $request
*
* @return bool
*/
public function get_permission_callback( $request ) {
$is_multi = (bool) $request->get_param( 'is_multi' );
$result = false;
// The function is public since endpoint need to access it.
// Utilize 'WP_REST_Controller' get_permission_check methods.
switch ( $request->get_method() ) {
case 'GET':
$result = $is_multi ? $this->get_items_permissions_check( $request ) : $this->get_item_permissions_check( $request );
break;
case 'POST':
$result = $is_multi ? $this->create_items_permissions_check( $request ) : $this->create_item_permissions_check( $request );
break;
case 'UPDATE':
case 'PUT':
case 'PATCH':
$result = $is_multi ? $this->update_items_permissions_check( $request ) : $this->update_item_permissions_check( $request );
break;
case 'DELETE':
$result = $is_multi ? $this->delete_items_permissions_check( $request ) : $this->delete_item_permissions_check( $request );
break;
}
if ( $result instanceof \WP_Error ) {
throw new WP_Error_Exception( esc_html( $result ) );
}
return $result;
}
/**
* Checks if a given request has access to create items.
*
* @param \WP_REST_Request $request Full details about the request.
*
* @return true|\WP_Error True if the request has access to create items, WP_Error object otherwise.
*/
public function create_items_permissions_check( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Checks if a given request has access to update items.
*
* @param \WP_REST_Request $request Full details about the request.
*
* @return true|\WP_Error True if the request has access to update the item, WP_Error object otherwise.
*/
public function update_items_permissions_check( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Checks if a given request has access to delete items.
*
* @param \WP_REST_Request $request Full details about the request.
*
* @return true|\WP_Error True if the request has access to delete the item, WP_Error object otherwise.
*/
public function delete_items_permissions_check( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
public function get_items( $request ) {
return $this->get_controller_index();
}
/**
* Creates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function create_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Updates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function update_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Delete multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
public function delete_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Get the parent controller.
*
* @return \Elementor\Data\V2\Base\Controller|null
*/
public function get_parent() {
return $this->parent;
}
/**
* Get sub controller(s).
*
* @return \Elementor\Data\V2\Base\Controller[]
*/
public function get_sub_controllers() {
return $this->sub_controllers;
}
/**
* Get processors.
*
* @param string $command
*
* @return \Elementor\Data\V2\Base\Processor[]
*/
public function get_processors( $command ) {
$result = [];
if ( isset( $this->processors[ $command ] ) ) {
$result = $this->processors[ $command ];
}
return $result;
}
/**
* Register processors.
*/
public function register_processors() {
}
/**
* Register index endpoint.
*/
protected function register_index_endpoint() {
if ( ! $this->parent ) {
$this->register_endpoint( new Endpoint\Index( $this ) );
return;
}
$this->register_endpoint( new Endpoint\Index\Sub_Index_Endpoint( $this ) );
}
/**
* Register endpoint.
*
* @param \Elementor\Data\V2\Base\Endpoint $endpoint
*
* @return \Elementor\Data\V2\Base\Endpoint
*/
protected function register_endpoint( Endpoint $endpoint ) {
$command = $endpoint->get_full_command();
if ( $endpoint instanceof Endpoint\Index ) {
$this->index_endpoint = $endpoint;
} else {
$this->endpoints[ $command ] = $endpoint;
}
$format = $endpoint->get_format();
// `$e.data.registerFormat()`.
Manager::instance()->register_endpoint_format( $command, $format );
return $endpoint;
}
/**
* Register a processor.
*
* That will be later attached to the endpoint class.
*
* @param Processor $processor
*
* @return \Elementor\Data\V2\Base\Processor $processor_instance
*/
protected function register_processor( Processor $processor ) {
$command = $processor->get_command();
if ( ! isset( $this->processors[ $command ] ) ) {
$this->processors[ $command ] = [];
}
$this->processors[ $command ] [] = $processor;
return $processor;
}
/**
* Register.
*
* Endpoints & processors.
*/
protected function register() {
$this->register_index_endpoint();
$this->register_endpoints();
// Aka hooks.
$this->register_processors();
}
/**
* Get collection params by 'additionalProperties' context.
*
* @param string $context
*
* @return array
*/
protected function get_collection_params_by_additional_props_context( $context ) {
$result = [];
$collection_params = $this->get_collection_params();
foreach ( $collection_params as $collection_param_key => $collection_param ) {
if ( isset( $collection_param['additionalProperties']['context'] ) && $context === $collection_param['additionalProperties']['context'] ) {
$result[ $collection_param_key ] = $collection_param;
}
}
return $result;
}
/**
* When `$this->get_parent_name` is extended, the controller will have a parent, and will know to behave like a sub-controller.
*
* @param string $parent_name
*/
private function act_as_sub_controller( $parent_name ) {
$this->parent = Manager::instance()->get_controller( $parent_name );
if ( ! $this->parent ) {
trigger_error( "Cannot find parent controller: '$parent_name'", E_USER_ERROR ); // phpcs:ignore
}
$this->parent->sub_controllers [] = $this;
}
/**
* Controller constructor.
*
* Register endpoints on 'rest_api_init'.
*/
public function __construct() {
$this->namespace = static::get_default_namespace() . '/v' . static::get_default_version();
$this->rest_base = $this->get_name();
add_action( 'rest_api_init', function () {
$this->register(); // Because 'register' is protected.
} );
/**
* Since all actions were removed for custom internal REST server.
* Re-add the actions.
*/
add_action( 'elementor_rest_api_before_init', function () {
add_action( 'rest_api_init', function () {
$this->register();
} );
} );
$parent_name = $this->get_parent_name();
if ( $parent_name ) {
$this->act_as_sub_controller( $parent_name );
}
}
}
v2/base/processor.php 0000644 00000001550 15154616343 0010546 0 ustar 00 controller = $controller;
}
}
v2/base/exceptions/wp-error-exception.php 0000644 00000000562 15154616343 0014463 0 ustar 00 get_error_message(), $wp_error->get_error_code(), [
'status' => $wp_error->get_error_code(),
] );
}
}
v2/base/exceptions/error-500.php 0000644 00000000557 15154616343 0012351 0 ustar 00 '',
'data' => [],
];
public function get_code() {
return 'reset-http-error';
}
public function get_message() {
return '501 Not Implemented';
}
public function get_data() {
return [
'status' => $this->get_http_error_code(), // 'status' is used by WP to pass the http error code.
];
}
public function to_wp_error() {
return new \WP_Error( $this->custom_data['code'], $this->message, $this->custom_data['data'] );
}
protected function get_http_error_code() {
return 501; // 501 Not Implemented
}
protected function apply() {}
public function __construct( $message = '', $code = '', $data = [] ) {
$this->message = empty( $message ) ? $this->get_message() : $message;
$this->custom_data['code'] = empty( $code ) ? $this->get_code() : $code;
$this->custom_data['data'] = empty( $data ) ? $this->get_data() : $data;
parent::__construct( $this->message, 0, null );
$this->apply();
}
}
v2/base/exceptions/error-404.php 0000644 00000000534 15154616343 0012347 0 ustar 00 controller;
}
/**
* Get current parent.
*
* @return \Elementor\Data\V2\Base\Controller|\Elementor\Data\V2\Base\Endpoint
*/
public function get_parent() {
return $this->parent;
}
/**
* Get public name.
*
* @return string
*/
public function get_public_name() {
return $this->get_name();
}
/**
* Get full command name ( including index ).
*
* @return string
*/
public function get_full_command() {
$parent = $this->get_parent();
if ( $parent instanceof Controller ) {
return $this->controller->get_full_name() . '/' . $this->get_name();
}
return $this->get_name_ancestry();
}
/**
* Get name ancestry format, example: 'alpha/beta/delta'.
*
* @return string
*/
public function get_name_ancestry() {
$ancestors = $this->get_ancestors();
$ancestors_names = [];
foreach ( $ancestors as $ancestor ) {
$ancestors_names [] = $ancestor->get_name();
}
return implode( '/', $ancestors_names );
}
/**
* Register sub endpoint.
*
* @param \Elementor\Data\V2\Base\Endpoint $endpoint
*
* @return \Elementor\Data\V2\Base\Endpoint
*/
public function register_sub_endpoint( Endpoint $endpoint ) {
$command = $endpoint->get_full_command();
$format = $endpoint->get_format();
$this->sub_endpoints[ $command ] = $endpoint;
Manager::instance()->register_endpoint_format( $command, $format );
return $endpoint;
}
/**
* Get ancestors.
*
* @return \Elementor\Data\V2\Base\Endpoint[]
*/
private function get_ancestors() {
$ancestors = [];
$current = $this;
do {
if ( $current ) {
$ancestors [] = $current;
}
$current = $current->get_parent();
} while ( $current );
return array_reverse( $ancestors );
}
/**
* Endpoint constructor.
*
* @param \Elementor\Data\V2\Base\Controller|\Elementor\Data\V2\Base\Endpoint $parent
* @param string $route
*/
public function __construct( $parent, $route = '/' ) {
$controller = $parent;
$this->parent = $parent;
// In case, its behave like sub-endpoint.
if ( ! ( $parent instanceof Controller ) ) {
$controller = $parent->get_controller();
}
parent::__construct( $controller, $route );
}
}
v2/base/base-route.php 0000644 00000024241 15154616343 0010577 0 ustar 00 '/'
* 'abc' => '/abc/'
* '/abc' => '/abc/'
* 'abc/' => '/abc/'
* '/abc/' => '/abc/'
*
* @param string $route
*
* @return string
*/
private function ensure_slashes( $route ) {
if ( '/' !== $route[0] ) {
$route = '/' . $route;
}
return trailingslashit( $route );
}
/**
* Get base route.
* This method should always return the base route starts with '/' and ends without '/'.
*
* @return string
*/
public function get_base_route() {
$name = $this->get_public_name();
$parent = $this->get_parent();
$parent_base = $parent->get_base_route();
$route = '/';
if ( ! ( $parent instanceof Controller ) ) {
$route = $parent->item_route ? $parent->item_route['route'] . '/' : $this->route;
}
return untrailingslashit( '/' . trim( $parent_base . $route . $name, '/' ) );
}
/**
* Get permission callback.
*
* By default get permission callback from the controller.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return boolean
*/
public function get_permission_callback( $request ) {
return $this->controller->get_permission_callback( $request );
}
/**
* Retrieves a collection of items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function get_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Retrieves one item from the collection.
*
* @param string $id
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function get_item( $id, $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Creates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function create_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Creates one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function create_item( $id, $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Updates multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function update_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Updates one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function update_item( $id, $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Delete multiple items.
*
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function delete_items( $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Delete one item.
*
* @param string $id id of request item.
* @param \WP_REST_Request $request Full data about the request.
*
* @return \WP_Error|\WP_REST_Response Response object on success, or WP_Error object on failure.
*/
protected function delete_item( $id, $request ) {
return new \WP_Error( 'invalid-method', sprintf( "Method '%s' not implemented. Must be overridden in subclass.", __METHOD__ ), [ 'status' => 405 ] );
}
/**
* Register the endpoint.
*
* By default: register get items route.
*/
protected function register() {
$this->register_items_route();
}
protected function register_route( $route = '', $methods = WP_REST_Server::READABLE, $args = [] ) {
if ( ! in_array( $methods, self::AVAILABLE_METHODS, true ) ) {
trigger_error( "Invalid method: '$methods'.", E_USER_ERROR ); // phpcs:ignore
}
$route = $this->get_base_route() . $route;
$this->routes [] = [
'args' => $args,
'route' => $route,
];
/**
* Determine behaviour of `base_callback()` and `get_permission_callback()`:
* For `base_callback()` which applying the action.
* Whether it's a one item request and should call `get_item_permission_callback()` or it's mutil items request and should call `get_items_permission_callback()`.
*/
$is_multi = ! empty( $args['is_multi'] );
if ( $is_multi ) {
unset( $args['is_multi'] );
}
$callback = function ( $request ) use ( $methods, $args, $is_multi ) {
return $this->base_callback( $methods, $request, $is_multi );
};
return register_rest_route( $this->controller->get_namespace(), $route, [
[
'args' => $args,
'methods' => $methods,
'callback' => $callback,
'permission_callback' => function ( $request ) {
return $this->get_permission_callback( $request );
},
],
] );
}
/**
* Register items route.
*
* @param string $methods
* @param array $args
*/
public function register_items_route( $methods = WP_REST_Server::READABLE, $args = [] ) {
$args['is_multi'] = true;
$this->register_route( '', $methods, $args );
}
public function register_item_route( $methods = WP_REST_Server::READABLE, $args = [], $route = '/' ) {
if ( ! empty( $args['id_arg_name'] ) ) {
$this->id_arg_name = $args['id_arg_name'];
unset( $args['id_arg_name'] );
}
if ( ! empty( $args['id_arg_type_regex'] ) ) {
$this->id_arg_type_regex = $args['id_arg_type_regex'];
unset( $args['id_arg_type_regex'] );
}
$args = array_merge( [
$this->id_arg_name => [
'description' => 'Unique identifier for the object.',
'type' => 'string',
'required' => true,
],
], $args );
$route .= '(?P<' . $this->id_arg_name . '>' . $this->id_arg_type_regex . ')';
$this->item_route = [
'args' => $args,
'route' => $route,
];
$this->register_route( $route, $methods, $args );
}
/**
* Base callback.
* All reset requests from the client should pass this function.
*
* @param string $methods
* @param \WP_REST_Request $request
* @param bool $is_multi
* @param array $args
*
* @return mixed|\WP_Error|\WP_HTTP_Response|\WP_REST_Response
*/
public function base_callback( $methods, $request, $is_multi = false, $args = [] ) {
if ( $request ) {
$json_params = $request->get_json_params();
if ( $json_params ) {
$request->set_body_params( $json_params );
}
}
$args = wp_parse_args( $args, [
'is_debug' => ( defined( 'WP_DEBUG' ) && WP_DEBUG ),
] );
$result = new \WP_Error( 'invalid_methods', 'route not supported.' );
$request->set_param( 'is_multi', $is_multi );
try {
switch ( $methods ) {
case WP_REST_Server::READABLE:
$result = $is_multi ? $this->get_items( $request ) : $this->get_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::CREATABLE:
$result = $is_multi ? $this->create_items( $request ) : $this->create_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::EDITABLE:
$result = $is_multi ? $this->update_items( $request ) : $this->update_item( $request->get_param( 'id' ), $request );
break;
case WP_REST_Server::DELETABLE:
$result = $is_multi ? $this->delete_items( $request ) : $this->delete_item( $request->get_param( 'id' ), $request );
break;
}
} catch ( Data_Exception $e ) {
$result = $e->to_wp_error();
} catch ( \Exception $e ) {
if ( empty( $args['is_debug'] ) ) {
$result = ( new Error_500() )->to_wp_error();
} else {
// For frontend.
$exception_mapping = [
'trace' => $e->getTrace(),
'file' => $e->getFile(),
'line' => $e->getLine(),
];
$e->debug = $exception_mapping;
$result = ( new Data_Exception( $e->getMessage(), $e->getCode(), $e ) )->to_wp_error();
}
}
return rest_ensure_response( $result );
}
/**
* Constructor.
*
* Run `$this->register()`.
*
* @param \Elementor\Data\V2\Base\Controller $controller
* @param string $route
*/
protected function __construct( Controller $controller, $route ) {
$this->controller = $controller;
$this->route = $this->ensure_slashes( $route );
$this->register();
}
}
v2/base/endpoint/index/all-children.php 0000644 00000003601 15154616343 0014013 0 ustar 00 controller->get_name() . '/index';
}
/**
* Retrieves a result(s) of all controller endpoint(s), items.
*
* Run overall endpoints of the current controller.
*
* Example, scenario:
* 'settings' - controller
* 'settings/products' - endpoint
* 'settings/partners' - endpoint
* Result:
* [
* 'products' => [
* 0 => ...
* 1 => ...
* ],
* 'partners' => [
* 0 => ...
* 1 => ...
* ],
* ]
*/
public function get_items( $request ) {
$response = [];
foreach ( $this->controller->get_sub_controllers() as $controller ) {
$controller_route = $this->get_controller()->get_base_route() . '/' . $controller->get_name();
$result = Manager::instance()->run_request( $controller_route );
if ( ! $result->is_error() ) {
$response[ $controller->get_name() ] = $result->get_data();
}
}
foreach ( $this->controller->endpoints as $endpoint ) {
// Skip self.
if ( $endpoint === $this ) {
continue;
}
$result = Manager::instance()->run_request( $endpoint->get_base_route() );
if ( ! $result->is_error() ) {
$response[ $endpoint->get_name() ] = $result->get_data();
}
}
return $response;
}
}
v2/base/endpoint/index/sub-index-endpoint.php 0000644 00000002741 15154616343 0015175 0 ustar 00 controller->get_parent()->get_name() . '/{id}/' . $this->controller->get_name() . '/{sub_id}';
}
public function get_base_route() {
$parent_controller = $this->controller->get_parent();
$parent_index_endpoint = $parent_controller->index_endpoint;
$parent_controller_route = '';
// In case `$parent_index_endpoint` is AllChildren, it cannot support id_arg_name.
if ( ! $parent_index_endpoint instanceof AllChildren ) {
$parent_controller_route = "(?P<{$parent_index_endpoint->id_arg_name}>[\w]+)";
}
return untrailingslashit('/' . implode( '/', array_filter( [
trim( $parent_index_endpoint->get_base_route(), '/' ),
$parent_controller_route,
$this->controller->get_name(),
$this->get_public_name(),
] ) ) );
}
}
v2/base/endpoint/index.php 0000644 00000003173 15154616343 0011461 0 ustar 00 controller->get_full_name()}/{id}";
}
public function get_public_name() {
return '';
}
public function get_items( $request ) {
return $this->controller->get_items( $request );
}
public f