first commit
This commit is contained in:
@@ -0,0 +1,229 @@
|
||||
<?php
|
||||
namespace Elementor\TemplateLibrary\Classes;
|
||||
|
||||
use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
|
||||
use Elementor\Core\Files\Uploads_Manager;
|
||||
use Elementor\Plugin;
|
||||
use Elementor\Utils;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
/**
|
||||
* Elementor template library import images.
|
||||
*
|
||||
* Elementor template library import images handler class is responsible for
|
||||
* importing remote images used by the template library.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
class Import_Images {
|
||||
|
||||
/**
|
||||
* Replaced images IDs.
|
||||
*
|
||||
* The IDs of all the new imported images. An array containing the old
|
||||
* attachment ID and the new attachment ID generated after the import.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access private
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $_replace_image_ids = [];
|
||||
|
||||
/**
|
||||
* Get image hash.
|
||||
*
|
||||
* Retrieve the sha1 hash of the image URL.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @access private
|
||||
*
|
||||
* @param string $attachment_url The attachment URL.
|
||||
*
|
||||
* @return string Image hash.
|
||||
*/
|
||||
private function get_hash_image( $attachment_url ) {
|
||||
return sha1( $attachment_url );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get saved image.
|
||||
*
|
||||
* Retrieve new image ID, if the image has a new ID after the import.
|
||||
*
|
||||
* @since 2.0.0
|
||||
* @access private
|
||||
*
|
||||
* @param array $attachment The attachment.
|
||||
*
|
||||
* @return false|array New image ID or false.
|
||||
*/
|
||||
private function get_saved_image( $attachment ) {
|
||||
global $wpdb;
|
||||
|
||||
if ( isset( $this->_replace_image_ids[ $attachment['id'] ] ) ) {
|
||||
return $this->_replace_image_ids[ $attachment['id'] ];
|
||||
}
|
||||
|
||||
$post_id = $wpdb->get_var(
|
||||
$wpdb->prepare(
|
||||
'SELECT `post_id` FROM `' . $wpdb->postmeta . '`
|
||||
WHERE `meta_key` = \'_elementor_source_image_hash\'
|
||||
AND `meta_value` = %s
|
||||
;',
|
||||
$this->get_hash_image( $attachment['url'] )
|
||||
)
|
||||
);
|
||||
|
||||
if ( $post_id ) {
|
||||
$new_attachment = [
|
||||
'id' => $post_id,
|
||||
'url' => wp_get_attachment_url( $post_id ),
|
||||
];
|
||||
$this->_replace_image_ids[ $attachment['id'] ] = $new_attachment;
|
||||
|
||||
return $new_attachment;
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Import image.
|
||||
*
|
||||
* Import a single image from a remote server, upload the image WordPress
|
||||
* uploads folder, create a new attachment in the database and updates the
|
||||
* attachment metadata.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @since 3.2.0 New `$parent_post_id` option added
|
||||
* @access public
|
||||
*
|
||||
* @param array $attachment The attachment.
|
||||
* @param int $parent_post_id Optional
|
||||
*
|
||||
* @return false|array Imported image data, or false.
|
||||
*/
|
||||
public function import( $attachment, $parent_post_id = null ) {
|
||||
if ( isset( $attachment['tmp_name'] ) ) {
|
||||
// Used when called to import a directly-uploaded file.
|
||||
$filename = $attachment['name'];
|
||||
|
||||
$file_content = Utils::file_get_contents( $attachment['tmp_name'] );
|
||||
} else {
|
||||
// Used when attachment information is passed to this method.
|
||||
if ( ! empty( $attachment['id'] ) ) {
|
||||
$saved_image = $this->get_saved_image( $attachment );
|
||||
|
||||
if ( $saved_image ) {
|
||||
return $saved_image;
|
||||
}
|
||||
}
|
||||
|
||||
// Extract the file name and extension from the url.
|
||||
$filename = basename( $attachment['url'] );
|
||||
|
||||
$request = wp_safe_remote_get( $attachment['url'] );
|
||||
|
||||
// Make sure the request returns a valid result.
|
||||
if ( is_wp_error( $request ) || ( ! empty( $request['response']['code'] ) && 200 !== (int) $request['response']['code'] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$file_content = wp_remote_retrieve_body( $request );
|
||||
}
|
||||
|
||||
if ( empty( $file_content ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$filetype = wp_check_filetype( $filename );
|
||||
|
||||
// If the file type is not recognized by WordPress, exit here to avoid creation of an empty attachment document.
|
||||
if ( ! $filetype['ext'] ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if ( 'svg' === $filetype['ext'] ) {
|
||||
// In case that unfiltered-files upload is not enabled, SVG images should not be imported.
|
||||
if ( ! Uploads_Manager::are_unfiltered_uploads_enabled() ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$svg_handler = Plugin::$instance->uploads_manager->get_file_type_handlers( 'svg' );
|
||||
|
||||
$file_content = $svg_handler->sanitizer( $file_content );
|
||||
};
|
||||
|
||||
$upload = wp_upload_bits(
|
||||
$filename,
|
||||
null,
|
||||
$file_content
|
||||
);
|
||||
|
||||
$post = [
|
||||
'post_title' => $filename,
|
||||
'guid' => $upload['url'],
|
||||
];
|
||||
|
||||
$info = wp_check_filetype( $upload['file'] );
|
||||
|
||||
if ( $info ) {
|
||||
$post['post_mime_type'] = $info['type'];
|
||||
} else {
|
||||
// For now just return the origin attachment
|
||||
return $attachment;
|
||||
// return new \WP_Error( 'attachment_processing_error', esc_html__( 'Invalid file type.', 'elementor' ) );
|
||||
}
|
||||
|
||||
$post_id = wp_insert_attachment( $post, $upload['file'], $parent_post_id );
|
||||
|
||||
apply_filters( 'elementor/template_library/import_images/new_attachment', $post_id );
|
||||
|
||||
// On REST requests.
|
||||
if ( ! function_exists( 'wp_generate_attachment_metadata' ) ) {
|
||||
require_once ABSPATH . '/wp-admin/includes/image.php';
|
||||
}
|
||||
|
||||
if ( ! function_exists( 'wp_read_video_metadata' ) ) {
|
||||
require_once ABSPATH . '/wp-admin/includes/media.php';
|
||||
}
|
||||
|
||||
wp_update_attachment_metadata(
|
||||
$post_id,
|
||||
wp_generate_attachment_metadata( $post_id, $upload['file'] )
|
||||
);
|
||||
update_post_meta( $post_id, '_elementor_source_image_hash', $this->get_hash_image( $attachment['url'] ) );
|
||||
|
||||
$new_attachment = [
|
||||
'id' => $post_id,
|
||||
'url' => $upload['url'],
|
||||
];
|
||||
|
||||
if ( ! empty( $attachment['id'] ) ) {
|
||||
$this->_replace_image_ids[ $attachment['id'] ] = $new_attachment;
|
||||
}
|
||||
|
||||
return $new_attachment;
|
||||
}
|
||||
|
||||
/**
|
||||
* Template library import images constructor.
|
||||
*
|
||||
* Initializing the images import class used by the template library through
|
||||
* the WordPress Filesystem API.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function __construct() {
|
||||
if ( ! function_exists( 'WP_Filesystem' ) ) {
|
||||
require_once ABSPATH . 'wp-admin/includes/file.php';
|
||||
}
|
||||
|
||||
WP_Filesystem();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
namespace Elementor\Includes\TemplateLibrary\Data;
|
||||
|
||||
use Elementor\User;
|
||||
use Elementor\TemplateLibrary\Source_Local;
|
||||
use Elementor\Data\V2\Base\Controller as Controller_Base;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
class Controller extends Controller_Base {
|
||||
|
||||
public function get_name() {
|
||||
return 'template-library';
|
||||
}
|
||||
|
||||
public function register_endpoints() {
|
||||
$this->register_endpoint( new Endpoints\Templates( $this ) );
|
||||
}
|
||||
|
||||
protected function register_index_endpoint() {
|
||||
// Bypass, currently does not required.
|
||||
}
|
||||
|
||||
public function get_permission_callback( $request ) {
|
||||
return User::is_current_user_can_edit_post_type( Source_Local::CPT );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
<?php
|
||||
namespace Elementor\Includes\TemplateLibrary\Data\Endpoints;
|
||||
|
||||
use Elementor\Data\V2\Base\Endpoint;
|
||||
use Elementor\Plugin;
|
||||
use Elementor\TemplateLibrary\Source_Local;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
class Templates extends Endpoint {
|
||||
|
||||
protected function register() {
|
||||
parent::register();
|
||||
|
||||
$document_types = Plugin::$instance->documents->get_document_types( [
|
||||
'show_in_library' => true,
|
||||
] );
|
||||
|
||||
$this->register_route( '', \WP_REST_Server::CREATABLE, [
|
||||
'is_multi' => true,
|
||||
'title' => [
|
||||
'required' => false,
|
||||
'type' => 'string',
|
||||
'description' => 'The title of the document',
|
||||
],
|
||||
'type' => [
|
||||
'required' => true,
|
||||
'description' => 'The document type.',
|
||||
'type' => 'string',
|
||||
'enum' => array_keys( $document_types ),
|
||||
],
|
||||
'content' => [
|
||||
'required' => false,
|
||||
'description' => 'Elementor data object',
|
||||
'type' => 'object',
|
||||
],
|
||||
] );
|
||||
}
|
||||
|
||||
public function get_name() {
|
||||
return 'templates';
|
||||
}
|
||||
|
||||
public function get_format() {
|
||||
return 'template-library/templates';
|
||||
}
|
||||
|
||||
public function get_items( $request ) {
|
||||
return $this->reorder_categories( Plugin::$instance->templates_manager->get_library_data( [ 'filter_sources' => [ $request->get_param( 'source' ) ] ] ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Move the '404 page' category to the end of the list
|
||||
*
|
||||
* @param array $library_data
|
||||
* @return array
|
||||
*/
|
||||
private function reorder_categories( array $library_data ): array {
|
||||
$not_found_category = '404 page';
|
||||
|
||||
$key = array_search( $not_found_category, $library_data['config']['block']['categories'] );
|
||||
if ( false === $key ) {
|
||||
return $library_data;
|
||||
}
|
||||
|
||||
array_splice( $library_data['config']['block']['categories'], $key, 1 );
|
||||
$library_data['config']['block']['categories'][] = $not_found_category;
|
||||
|
||||
return $library_data;
|
||||
}
|
||||
|
||||
public function create_items( $request ) {
|
||||
/** @var Source_Local $source */
|
||||
$source = Plugin::$instance->templates_manager->get_source( 'local' );
|
||||
|
||||
$result = $source->save_item( [
|
||||
'title' => $request->get_param( 'title' ),
|
||||
'type' => $request->get_param( 'type' ),
|
||||
'content' => $request->get_param( 'content' ),
|
||||
'page_settings' => $request->get_param( 'page_settings' ),
|
||||
] );
|
||||
|
||||
if ( is_wp_error( $result ) ) {
|
||||
return $result;
|
||||
}
|
||||
|
||||
return $source->get_item( $result );
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,52 @@
|
||||
<?php
|
||||
namespace Elementor\TemplateLibrary\Forms;
|
||||
|
||||
use Elementor\Controls_Manager;
|
||||
use Elementor\Controls_Stack;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly
|
||||
}
|
||||
|
||||
class New_Template_Form extends Controls_Stack {
|
||||
|
||||
public function get_name() {
|
||||
return 'add-template-form';
|
||||
}
|
||||
|
||||
/**
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function render() {
|
||||
foreach ( $this->get_controls() as $control ) {
|
||||
switch ( $control['type'] ) {
|
||||
case Controls_Manager::SELECT:
|
||||
$this->render_select( $control );
|
||||
break;
|
||||
default:
|
||||
throw new \Exception( "'{$control['type']}' control type is not supported." );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private function render_select( $control_settings ) {
|
||||
$control_id = "elementor-new-template__form__{$control_settings['name']}";
|
||||
$wrapper_class = isset( $control_settings['wrapper_class'] ) ? $control_settings['wrapper_class'] : '';
|
||||
?>
|
||||
<div id="<?php echo esc_attr( $control_id ); ?>__wrapper" class="elementor-form-field <?php echo esc_attr( $wrapper_class ); ?>">
|
||||
<label for="<?php echo esc_attr( $control_id ); ?>" class="elementor-form-field__label">
|
||||
<?php echo esc_html( $control_settings['label'] ); ?>
|
||||
</label>
|
||||
<div class="elementor-form-field__select__wrapper">
|
||||
<select id="<?php echo esc_attr( $control_id ); ?>" class="elementor-form-field__select" name="meta[<?php echo esc_html( $control_settings['name'] ); ?>]">
|
||||
<?php
|
||||
foreach ( $control_settings['options'] as $key => $value ) {
|
||||
echo sprintf( '<option value="%1$s">%2$s</option>', esc_html( $key ), esc_html( $value ) );
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
</div>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,737 @@
|
||||
<?php
|
||||
namespace Elementor\TemplateLibrary;
|
||||
|
||||
use Elementor\Api;
|
||||
use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
|
||||
use Elementor\Core\Settings\Manager as SettingsManager;
|
||||
use Elementor\Includes\TemplateLibrary\Data\Controller;
|
||||
use Elementor\TemplateLibrary\Classes\Import_Images;
|
||||
use Elementor\Plugin;
|
||||
use Elementor\User;
|
||||
use Elementor\Utils;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
/**
|
||||
* Elementor template library manager.
|
||||
*
|
||||
* Elementor template library manager handler class is responsible for
|
||||
* initializing the template library.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
class Manager {
|
||||
|
||||
/**
|
||||
* Registered template sources.
|
||||
*
|
||||
* Holds a list of all the supported sources with their instances.
|
||||
*
|
||||
* @access protected
|
||||
*
|
||||
* @var Source_Base[]
|
||||
*/
|
||||
protected $_registered_sources = []; // phpcs:ignore PSR2.Classes.PropertyDeclaration.Underscore
|
||||
|
||||
/**
|
||||
* Imported template images.
|
||||
*
|
||||
* Holds an instance of `Import_Images` class.
|
||||
*
|
||||
* @access private
|
||||
*
|
||||
* @var Import_Images
|
||||
*/
|
||||
private $_import_images = null; // phpcs:ignore PSR2.Classes.PropertyDeclaration.Underscore
|
||||
|
||||
/**
|
||||
* Template library manager constructor.
|
||||
*
|
||||
* Initializing the template library manager by registering default template
|
||||
* sources and initializing ajax calls.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function __construct() {
|
||||
Plugin::$instance->data_manager_v2->register_controller( new Controller() );
|
||||
|
||||
$this->register_default_sources();
|
||||
|
||||
$this->add_actions();
|
||||
}
|
||||
|
||||
/**
|
||||
* @since 2.3.0
|
||||
* @access public
|
||||
*/
|
||||
public function add_actions() {
|
||||
add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_actions' ] );
|
||||
add_action( 'wp_ajax_elementor_library_direct_actions', [ $this, 'handle_direct_actions' ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get `Import_Images` instance.
|
||||
*
|
||||
* Retrieve the instance of the `Import_Images` class.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return Import_Images Imported images instance.
|
||||
*/
|
||||
public function get_import_images_instance() {
|
||||
if ( null === $this->_import_images ) {
|
||||
$this->_import_images = new Import_Images();
|
||||
}
|
||||
|
||||
return $this->_import_images;
|
||||
}
|
||||
|
||||
/**
|
||||
* Register template source.
|
||||
*
|
||||
* Used to register new template sources displayed in the template library.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $source_class The name of source class.
|
||||
* @param array $args Optional. Class arguments. Default is an
|
||||
* empty array.
|
||||
*
|
||||
* @return \WP_Error|true True if the source was registered, `WP_Error`
|
||||
* otherwise.
|
||||
*/
|
||||
public function register_source( $source_class, $args = [] ) {
|
||||
if ( ! class_exists( $source_class ) ) {
|
||||
return new \WP_Error( 'source_class_name_not_exists' );
|
||||
}
|
||||
|
||||
$source_instance = new $source_class( $args );
|
||||
|
||||
if ( ! $source_instance instanceof Source_Base ) {
|
||||
return new \WP_Error( 'wrong_instance_source' );
|
||||
}
|
||||
|
||||
$source_id = $source_instance->get_id();
|
||||
|
||||
if ( isset( $this->_registered_sources[ $source_id ] ) ) {
|
||||
return new \WP_Error( 'source_exists' );
|
||||
}
|
||||
|
||||
$this->_registered_sources[ $source_id ] = $source_instance;
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregister template source.
|
||||
*
|
||||
* Remove an existing template sources from the list of registered template
|
||||
* sources.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @deprecated 2.7.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $id The source ID.
|
||||
*
|
||||
* @return bool Whether the source was unregistered.
|
||||
*/
|
||||
public function unregister_source( $id ) {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get registered template sources.
|
||||
*
|
||||
* Retrieve registered template sources.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return Source_Base[] Registered template sources.
|
||||
*/
|
||||
public function get_registered_sources() {
|
||||
return $this->_registered_sources;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get template source.
|
||||
*
|
||||
* Retrieve single template sources for a given template ID.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $id The source ID.
|
||||
*
|
||||
* @return false|Source_Base Template sources if one exist, False otherwise.
|
||||
*/
|
||||
public function get_source( $id ) {
|
||||
$sources = $this->get_registered_sources();
|
||||
|
||||
if ( ! isset( $sources[ $id ] ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
return $sources[ $id ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get templates.
|
||||
*
|
||||
* Retrieve all the templates from all the registered sources.
|
||||
*
|
||||
* @param array $filter_sources
|
||||
* @param bool $force_update
|
||||
* @return array
|
||||
*/
|
||||
public function get_templates( array $filter_sources = [], bool $force_update = false ): array {
|
||||
$templates = [];
|
||||
|
||||
foreach ( $this->get_registered_sources() as $source ) {
|
||||
if ( ! empty( $filter_sources ) && ! in_array( $source->get_id(), $filter_sources, true ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$templates = array_merge( $templates, $source->get_items( [ 'force_update' => $force_update ] ) );
|
||||
}
|
||||
|
||||
return $templates;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get library data.
|
||||
*
|
||||
* Retrieve the library data.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Library arguments.
|
||||
*
|
||||
* @return array Library data.
|
||||
*/
|
||||
public function get_library_data( array $args ) {
|
||||
$library_data = Api::get_library_data( ! empty( $args['sync'] ) );
|
||||
|
||||
if ( empty( $library_data ) ) {
|
||||
return $library_data;
|
||||
}
|
||||
|
||||
// Ensure all document are registered.
|
||||
Plugin::$instance->documents->get_document_types();
|
||||
|
||||
$filter_sources = ! empty( $args['filter_sources'] ) ? $args['filter_sources'] : [];
|
||||
$force_update = ! empty( $args['sync'] );
|
||||
|
||||
return [
|
||||
'templates' => $this->get_templates( $filter_sources, $force_update ),
|
||||
'config' => $library_data['types_data'],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Save template.
|
||||
*
|
||||
* Save new or update existing template on the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return \WP_Error|int The ID of the saved/updated template.
|
||||
*/
|
||||
public function save_template( array $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'post_id', 'source', 'content', 'type' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$source = $this->get_source( $args['source'] );
|
||||
|
||||
if ( ! $source ) {
|
||||
return new \WP_Error( 'template_error', 'Template source not found.' );
|
||||
}
|
||||
|
||||
$args['content'] = json_decode( $args['content'], true );
|
||||
|
||||
$page = SettingsManager::get_settings_managers( 'page' )->get_model( $args['post_id'] );
|
||||
|
||||
$args['page_settings'] = $page->get_data( 'settings' );
|
||||
|
||||
$template_id = $source->save_item( $args );
|
||||
|
||||
if ( is_wp_error( $template_id ) ) {
|
||||
return $template_id;
|
||||
}
|
||||
|
||||
return $source->get_item( $template_id );
|
||||
}
|
||||
|
||||
/**
|
||||
* Update template.
|
||||
*
|
||||
* Update template on the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $template_data New template data.
|
||||
*
|
||||
* @return \WP_Error|Source_Base Template sources instance if the templates
|
||||
* was updated, `WP_Error` otherwise.
|
||||
*/
|
||||
public function update_template( array $template_data ) {
|
||||
$validate_args = $this->ensure_args( [ 'source', 'content', 'type' ], $template_data );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$source = $this->get_source( $template_data['source'] );
|
||||
|
||||
if ( ! $source ) {
|
||||
return new \WP_Error( 'template_error', 'Template source not found.' );
|
||||
}
|
||||
|
||||
$template_data['content'] = json_decode( $template_data['content'], true );
|
||||
|
||||
$update = $source->update_item( $template_data );
|
||||
|
||||
if ( is_wp_error( $update ) ) {
|
||||
return $update;
|
||||
}
|
||||
|
||||
return $source->get_item( $template_data['id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Update templates.
|
||||
*
|
||||
* Update template on the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return \WP_Error|true True if templates updated, `WP_Error` otherwise.
|
||||
*/
|
||||
public function update_templates( array $args ) {
|
||||
foreach ( $args['templates'] as $template_data ) {
|
||||
$result = $this->update_template( $template_data );
|
||||
|
||||
if ( is_wp_error( $result ) ) {
|
||||
return $result;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get template data.
|
||||
*
|
||||
* Retrieve the template data.
|
||||
*
|
||||
* @since 1.5.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return \WP_Error|bool|array ??
|
||||
*/
|
||||
public function get_template_data( array $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
if ( isset( $args['edit_mode'] ) ) {
|
||||
Plugin::$instance->editor->set_edit_mode( $args['edit_mode'] );
|
||||
}
|
||||
|
||||
$source = $this->get_source( $args['source'] );
|
||||
|
||||
if ( ! $source ) {
|
||||
return new \WP_Error( 'template_error', 'Template source not found.' );
|
||||
}
|
||||
|
||||
do_action( 'elementor/template-library/before_get_source_data', $args, $source );
|
||||
|
||||
$data = $source->get_data( $args );
|
||||
|
||||
do_action( 'elementor/template-library/after_get_source_data', $args, $source );
|
||||
|
||||
return $data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete template.
|
||||
*
|
||||
* Delete template from the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return \WP_Post|\WP_Error|false|null Post data on success, false or null
|
||||
* or 'WP_Error' on failure.
|
||||
*/
|
||||
public function delete_template( array $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$source = $this->get_source( $args['source'] );
|
||||
|
||||
if ( ! $source ) {
|
||||
return new \WP_Error( 'template_error', 'Template source not found.' );
|
||||
}
|
||||
|
||||
return $source->delete_template( $args['template_id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Export template.
|
||||
*
|
||||
* Export template to a file after ensuring it is a valid Elementor template
|
||||
* and checking user permissions for private posts.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return mixed Whether the export succeeded or failed.
|
||||
*/
|
||||
public function export_template( array $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$post_id = intval( $args['template_id'] );
|
||||
$post_status = get_post_status( $post_id );
|
||||
|
||||
if ( get_post_type( $post_id ) !== Source_Local::CPT ) {
|
||||
return new \WP_Error( 'template_error', esc_html__( 'Invalid template type or template does not exist.', 'elementor' ) );
|
||||
}
|
||||
|
||||
if ( 'private' === $post_status && ! current_user_can( 'read_private_posts', $post_id ) ) {
|
||||
return new \WP_Error( 'template_error', esc_html__( 'You do not have permission to access this template.', 'elementor' ) );
|
||||
}
|
||||
|
||||
if ( 'publish' !== $post_status && ! current_user_can( 'edit_post', $post_id ) ) {
|
||||
return new \WP_Error( 'template_error', esc_html__( 'You do not have permission to export this template.', 'elementor' ) );
|
||||
}
|
||||
|
||||
$source = $this->get_source( $args['source'] );
|
||||
|
||||
if ( ! $source ) {
|
||||
return new \WP_Error( 'template_error', 'Template source not found' );
|
||||
}
|
||||
|
||||
return $source->export_template( $args['template_id'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* @since 2.3.0
|
||||
* @access public
|
||||
*/
|
||||
public function direct_import_template() {
|
||||
/** @var Source_Local $source */
|
||||
$source = $this->get_source( 'local' );
|
||||
$file = Utils::get_super_global_value( $_FILES, 'file' );
|
||||
return $source->import_template( $file['name'], $file['tmp_name'] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Import template.
|
||||
*
|
||||
* Import template from a file.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $data
|
||||
*
|
||||
* @return mixed Whether the export succeeded or failed.
|
||||
*/
|
||||
public function import_template( array $data ) {
|
||||
// If the template is a JSON file, allow uploading it.
|
||||
add_filter( 'elementor/files/allow-file-type/json', [ $this, 'enable_json_template_upload' ] );
|
||||
add_filter( 'elementor/files/allow_unfiltered_upload', [ $this, 'enable_json_template_upload' ] );
|
||||
|
||||
// Imported templates can be either JSON files, or Zip files containing multiple JSON files
|
||||
$upload_result = Plugin::$instance->uploads_manager->handle_elementor_upload( $data, [ 'zip', 'json' ] );
|
||||
|
||||
remove_filter( 'elementor/files/allow-file-type/json', [ $this, 'enable_json_template_upload' ] );
|
||||
remove_filter( 'elementor/files/allow_unfiltered_upload', [ $this, 'enable_json_template_upload' ] );
|
||||
|
||||
if ( is_wp_error( $upload_result ) ) {
|
||||
Plugin::$instance->uploads_manager->remove_file_or_dir( dirname( $upload_result['tmp_name'] ) );
|
||||
|
||||
return $upload_result;
|
||||
}
|
||||
|
||||
/** @var Source_Local $source_local */
|
||||
$source_local = $this->get_source( 'local' );
|
||||
|
||||
$import_result = $source_local->import_template( $upload_result['name'], $upload_result['tmp_name'] );
|
||||
|
||||
// Remove the temporary directory generated for the stream-uploaded file.
|
||||
Plugin::$instance->uploads_manager->remove_file_or_dir( dirname( $upload_result['tmp_name'] ) );
|
||||
|
||||
return $import_result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Enable JSON Template Upload
|
||||
*
|
||||
* Runs on the 'elementor/files/allow-file-type/json' Uploads Manager filter.
|
||||
*
|
||||
* @since 3.5.0
|
||||
* @access public
|
||||
*
|
||||
* return bool
|
||||
*/
|
||||
public function enable_json_template_upload() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Mark template as favorite.
|
||||
*
|
||||
* Add the template to the user favorite templates.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Template arguments.
|
||||
*
|
||||
* @return mixed Whether the template marked as favorite.
|
||||
*/
|
||||
public function mark_template_as_favorite( $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'source', 'template_id', 'favorite' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$source = $this->get_source( $args['source'] );
|
||||
|
||||
return $source->mark_as_favorite( $args['template_id'], filter_var( $args['favorite'], FILTER_VALIDATE_BOOLEAN ) );
|
||||
}
|
||||
|
||||
public function import_from_json( array $args ) {
|
||||
$validate_args = $this->ensure_args( [ 'editor_post_id', 'elements' ], $args );
|
||||
|
||||
if ( is_wp_error( $validate_args ) ) {
|
||||
return $validate_args;
|
||||
}
|
||||
|
||||
$elements = json_decode( $args['elements'], true );
|
||||
|
||||
$document = Plugin::$instance->documents->get( $args['editor_post_id'] );
|
||||
if ( ! $document ) {
|
||||
return new \WP_Error( 'template_error', 'Document not found.' );
|
||||
}
|
||||
|
||||
$import_data = $document->get_import_data( [ 'content' => $elements ] );
|
||||
|
||||
return $import_data['content'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Register default template sources.
|
||||
*
|
||||
* Register the 'local' and 'remote' template sources that Elementor use by
|
||||
* default.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access private
|
||||
*/
|
||||
private function register_default_sources() {
|
||||
$sources = [
|
||||
'local',
|
||||
'remote',
|
||||
];
|
||||
|
||||
foreach ( $sources as $source_filename ) {
|
||||
$class_name = ucwords( $source_filename );
|
||||
$class_name = str_replace( '-', '_', $class_name );
|
||||
|
||||
$this->register_source( __NAMESPACE__ . '\Source_' . $class_name );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Handle ajax request.
|
||||
*
|
||||
* Fire authenticated ajax actions for any given ajax request.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access private
|
||||
*
|
||||
* @param string $ajax_request Ajax request.
|
||||
*
|
||||
* @param array $data
|
||||
*
|
||||
* @return mixed
|
||||
* @throws \Exception
|
||||
*/
|
||||
private function handle_ajax_request( $ajax_request, array $data ) {
|
||||
if ( ! User::is_current_user_can_edit_post_type( Source_Local::CPT ) ) {
|
||||
throw new \Exception( 'Access denied.' );
|
||||
}
|
||||
|
||||
if ( ! empty( $data['editor_post_id'] ) ) {
|
||||
$editor_post_id = absint( $data['editor_post_id'] );
|
||||
|
||||
if ( ! get_post( $editor_post_id ) ) {
|
||||
throw new \Exception( 'Post not found.' );
|
||||
}
|
||||
|
||||
Plugin::$instance->db->switch_to_post( $editor_post_id );
|
||||
}
|
||||
|
||||
$result = call_user_func( [ $this, $ajax_request ], $data );
|
||||
|
||||
if ( is_wp_error( $result ) ) {
|
||||
throw new \Exception( $result->get_error_message() );
|
||||
}
|
||||
|
||||
return $result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Init ajax calls.
|
||||
*
|
||||
* Initialize template library ajax calls for allowed ajax requests.
|
||||
*
|
||||
* @since 2.3.0
|
||||
* @access public
|
||||
*
|
||||
* @param Ajax $ajax
|
||||
*/
|
||||
public function register_ajax_actions( Ajax $ajax ) {
|
||||
$library_ajax_requests = [
|
||||
'get_library_data',
|
||||
'get_template_data',
|
||||
'save_template',
|
||||
'update_templates',
|
||||
'delete_template',
|
||||
'import_template',
|
||||
'mark_template_as_favorite',
|
||||
'import_from_json',
|
||||
];
|
||||
|
||||
foreach ( $library_ajax_requests as $ajax_request ) {
|
||||
$ajax->register_ajax_action( $ajax_request, function( $data ) use ( $ajax_request ) {
|
||||
return $this->handle_ajax_request( $ajax_request, $data );
|
||||
} );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @since 2.3.0
|
||||
* @access public
|
||||
*/
|
||||
public function handle_direct_actions() {
|
||||
if ( ! User::is_current_user_can_edit_post_type( Source_Local::CPT ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
/** @var Ajax $ajax */
|
||||
$ajax = Plugin::$instance->common->get_component( 'ajax' );
|
||||
|
||||
if ( ! $ajax->verify_request_nonce() ) {
|
||||
$this->handle_direct_action_error( 'Access Denied' );
|
||||
}
|
||||
|
||||
$action = Utils::get_super_global_value( $_REQUEST, 'library_action' ); // phpcs:ignore -- Nonce already verified.
|
||||
|
||||
$whitelist_methods = [
|
||||
'export_template',
|
||||
'direct_import_template',
|
||||
];
|
||||
|
||||
if ( in_array( $action, $whitelist_methods, true ) ) {
|
||||
$result = $this->$action( $_REQUEST ); // phpcs:ignore -- Nonce already verified.
|
||||
} else {
|
||||
$result = new \WP_Error( 'method_not_exists', 'Method Not exists' );
|
||||
}
|
||||
|
||||
if ( is_wp_error( $result ) ) {
|
||||
/** @var \WP_Error $result */
|
||||
$this->handle_direct_action_error( $result->get_error_message() . '.' );
|
||||
}
|
||||
|
||||
$callback = "on_{$action}_success";
|
||||
|
||||
if ( method_exists( $this, $callback ) ) {
|
||||
$this->$callback( $result );
|
||||
}
|
||||
|
||||
die;
|
||||
}
|
||||
|
||||
/**
|
||||
* On successful template import.
|
||||
*
|
||||
* Redirect the user to the template library after template import was
|
||||
* successful finished.
|
||||
*
|
||||
* @since 2.3.0
|
||||
* @access private
|
||||
*/
|
||||
private function on_direct_import_template_success() {
|
||||
wp_safe_redirect( admin_url( Source_Local::ADMIN_MENU_SLUG ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* @since 2.3.0
|
||||
* @access private
|
||||
*/
|
||||
private function handle_direct_action_error( $message ) {
|
||||
_default_wp_die_handler( $message, 'Elementor Library' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Ensure arguments exist.
|
||||
*
|
||||
* Checks whether the required arguments exist in the specified arguments.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access private
|
||||
*
|
||||
* @param array $required_args Required arguments to check whether they
|
||||
* exist.
|
||||
* @param array $specified_args The list of all the specified arguments to
|
||||
* check against.
|
||||
*
|
||||
* @return \WP_Error|true True on success, 'WP_Error' otherwise.
|
||||
*/
|
||||
private function ensure_args( array $required_args, array $specified_args ) {
|
||||
$not_specified_args = array_diff( $required_args, array_keys( $specified_args ) );
|
||||
|
||||
if ( $not_specified_args ) {
|
||||
return new \WP_Error( 'arguments_not_specified', sprintf( 'The required argument(s) "%s" not specified.', implode( ', ', $not_specified_args ) ) );
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
namespace Elementor\Includes\TemplateLibrary\Sources\AdminMenuItems;
|
||||
|
||||
use Elementor\Core\Admin\Menu\Interfaces\Admin_Menu_Item;
|
||||
use Elementor\Core\Editor\Editor;
|
||||
use Elementor\TemplateLibrary\Source_Local;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
class Add_New_Template_Menu_Item implements Admin_Menu_Item {
|
||||
|
||||
public function is_visible() {
|
||||
return true;
|
||||
}
|
||||
|
||||
public function get_parent_slug() {
|
||||
return Source_Local::ADMIN_MENU_SLUG;
|
||||
}
|
||||
|
||||
public function get_label() {
|
||||
return esc_html__( 'Add New', 'elementor' );
|
||||
}
|
||||
|
||||
public function get_capability() {
|
||||
return Editor::EDITING_CAPABILITY;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
namespace Elementor\Includes\TemplateLibrary\Sources\AdminMenuItems;
|
||||
|
||||
use Elementor\Core\Admin\Menu\Interfaces\Admin_Menu_Item;
|
||||
use Elementor\Core\Editor\Editor;
|
||||
use Elementor\TemplateLibrary\Source_Local;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
class Saved_Templates_Menu_Item implements Admin_Menu_Item {
|
||||
|
||||
public function is_visible() {
|
||||
return true;
|
||||
}
|
||||
|
||||
public function get_parent_slug() {
|
||||
return Source_Local::ADMIN_MENU_SLUG;
|
||||
}
|
||||
|
||||
public function get_label() {
|
||||
return esc_html__( 'Saved Templates', 'elementor' );
|
||||
}
|
||||
|
||||
public function get_capability() {
|
||||
return Editor::EDITING_CAPABILITY;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
namespace Elementor\Includes\TemplateLibrary\Sources\AdminMenuItems;
|
||||
|
||||
use Elementor\Core\Admin\Menu\Interfaces\Admin_Menu_Item;
|
||||
use Elementor\Core\Editor\Editor;
|
||||
use Elementor\TemplateLibrary\Source_Local;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
class Templates_Categories_Menu_Item implements Admin_Menu_Item {
|
||||
|
||||
public function is_visible() {
|
||||
return true;
|
||||
}
|
||||
|
||||
public function get_parent_slug() {
|
||||
return Source_Local::ADMIN_MENU_SLUG;
|
||||
}
|
||||
|
||||
public function get_label() {
|
||||
return esc_html__( 'Categories', 'elementor' );
|
||||
}
|
||||
|
||||
public function get_capability() {
|
||||
return 'manage_categories';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,368 @@
|
||||
<?php
|
||||
namespace Elementor\TemplateLibrary;
|
||||
|
||||
use Elementor\Controls_Stack;
|
||||
use Elementor\Plugin;
|
||||
use Elementor\Utils;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
/**
|
||||
* Elementor template library source base.
|
||||
*
|
||||
* Elementor template library source base handler class is responsible for
|
||||
* initializing all the methods controlling the source of Elementor templates.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @abstract
|
||||
*/
|
||||
abstract class Source_Base {
|
||||
|
||||
/**
|
||||
* User meta.
|
||||
*
|
||||
* Holds the current user meta data.
|
||||
*
|
||||
* @access private
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
private $user_meta;
|
||||
|
||||
/**
|
||||
* Get template ID.
|
||||
*
|
||||
* Retrieve the template ID.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*/
|
||||
abstract public function get_id();
|
||||
|
||||
/**
|
||||
* Get template title.
|
||||
*
|
||||
* Retrieve the template title.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*/
|
||||
abstract public function get_title();
|
||||
|
||||
/**
|
||||
* Register template data.
|
||||
*
|
||||
* Used to register custom template data like a post type, a taxonomy or any
|
||||
* other data.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*/
|
||||
abstract public function register_data();
|
||||
|
||||
/**
|
||||
* Get templates.
|
||||
*
|
||||
* Retrieve templates from the template library.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param array $args Optional. Filter templates list based on a set of
|
||||
* arguments. Default is an empty array.
|
||||
*/
|
||||
abstract public function get_items( $args = [] );
|
||||
|
||||
/**
|
||||
* Get template.
|
||||
*
|
||||
* Retrieve a single template from the template library.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*/
|
||||
abstract public function get_item( $template_id );
|
||||
|
||||
/**
|
||||
* Get template data.
|
||||
*
|
||||
* Retrieve a single template data from the template library.
|
||||
*
|
||||
* @since 1.5.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param array $args Custom template arguments.
|
||||
*/
|
||||
abstract public function get_data( array $args );
|
||||
|
||||
/**
|
||||
* Delete template.
|
||||
*
|
||||
* Delete template from the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*/
|
||||
abstract public function delete_template( $template_id );
|
||||
|
||||
/**
|
||||
* Save template.
|
||||
*
|
||||
* Save new or update existing template on the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param array $template_data The template data.
|
||||
*/
|
||||
abstract public function save_item( $template_data );
|
||||
|
||||
/**
|
||||
* Update template.
|
||||
*
|
||||
* Update template on the database.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param array $new_data New template data.
|
||||
*/
|
||||
abstract public function update_item( $new_data );
|
||||
|
||||
/**
|
||||
* Export template.
|
||||
*
|
||||
* Export template to a file.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
* @abstract
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*/
|
||||
abstract public function export_template( $template_id );
|
||||
|
||||
/**
|
||||
* Template library source base constructor.
|
||||
*
|
||||
* Initializing the template library source base by registering custom
|
||||
* template data.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->register_data();
|
||||
}
|
||||
|
||||
/**
|
||||
* Mark template as favorite.
|
||||
*
|
||||
* Update user meta containing his favorite templates. For a given template
|
||||
* ID, add the template to the favorite templates or remove it from the
|
||||
* favorites, based on the `favorite` parameter.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access public
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
* @param bool $favorite Optional. Whether the template is marked as
|
||||
* favorite, or not. Default is true.
|
||||
*
|
||||
* @return int|bool User meta ID if the key didn't exist, true on successful
|
||||
* update, false on failure.
|
||||
*/
|
||||
public function mark_as_favorite( $template_id, $favorite = true ) {
|
||||
$favorites_templates = $this->get_user_meta( 'favorites' );
|
||||
|
||||
if ( ! $favorites_templates ) {
|
||||
$favorites_templates = [];
|
||||
}
|
||||
|
||||
if ( $favorite ) {
|
||||
$favorites_templates[ $template_id ] = $favorite;
|
||||
} elseif ( isset( $favorites_templates[ $template_id ] ) ) {
|
||||
unset( $favorites_templates[ $template_id ] );
|
||||
}
|
||||
|
||||
return $this->update_user_meta( 'favorites', $favorites_templates );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get current user meta.
|
||||
*
|
||||
* Retrieve Elementor meta data for the current user.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $item Optional. User meta key. Default is null.
|
||||
*
|
||||
* @return null|array An array of user meta data, or null otherwise.
|
||||
*/
|
||||
public function get_user_meta( $item = null ) {
|
||||
if ( null === $this->user_meta ) {
|
||||
$this->user_meta = get_user_meta( get_current_user_id(), $this->get_user_meta_prefix(), true );
|
||||
}
|
||||
|
||||
if ( ! $this->user_meta ) {
|
||||
$this->user_meta = [];
|
||||
}
|
||||
|
||||
if ( $item ) {
|
||||
if ( isset( $this->user_meta[ $item ] ) ) {
|
||||
return $this->user_meta[ $item ];
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
return $this->user_meta;
|
||||
}
|
||||
|
||||
/**
|
||||
* Update current user meta.
|
||||
*
|
||||
* Update user meta data based on meta key an value.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access public
|
||||
*
|
||||
* @param string $key Optional. User meta key.
|
||||
* @param mixed $value Optional. User meta value.
|
||||
*
|
||||
* @return int|bool User meta ID if the key didn't exist, true on successful
|
||||
* update, false on failure.
|
||||
*/
|
||||
public function update_user_meta( $key, $value ) {
|
||||
$meta = $this->get_user_meta();
|
||||
|
||||
$meta[ $key ] = $value;
|
||||
|
||||
$this->user_meta = $meta;
|
||||
|
||||
return update_user_meta( get_current_user_id(), $this->get_user_meta_prefix(), $meta );
|
||||
}
|
||||
|
||||
/**
|
||||
* Replace elements IDs.
|
||||
*
|
||||
* For any given Elementor content/data, replace the IDs with new randomly
|
||||
* generated IDs.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access protected
|
||||
*
|
||||
* @param array $content Any type of Elementor data.
|
||||
*
|
||||
* @return mixed Iterated data.
|
||||
*/
|
||||
protected function replace_elements_ids( $content ) {
|
||||
return Plugin::$instance->db->iterate_data( $content, function( $element ) {
|
||||
$element['id'] = Utils::generate_random_string();
|
||||
|
||||
return $element;
|
||||
} );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get Elementor library user meta prefix.
|
||||
*
|
||||
* Retrieve user meta prefix used to save Elementor data.
|
||||
*
|
||||
* @since 1.9.0
|
||||
* @access protected
|
||||
*
|
||||
* @return string User meta prefix.
|
||||
*/
|
||||
protected function get_user_meta_prefix() {
|
||||
return 'elementor_library_' . $this->get_id();
|
||||
}
|
||||
|
||||
/**
|
||||
* Process content for export/import.
|
||||
*
|
||||
* Process the content and all the inner elements, and prepare all the
|
||||
* elements data for export/import.
|
||||
*
|
||||
* @since 1.5.0
|
||||
* @access protected
|
||||
*
|
||||
* @param array $content A set of elements.
|
||||
* @param string $method Accepts either `on_export` to export data or
|
||||
* `on_import` to import data.
|
||||
*
|
||||
* @return mixed Processed content data.
|
||||
*/
|
||||
protected function process_export_import_content( $content, $method ) {
|
||||
return Plugin::$instance->db->iterate_data(
|
||||
$content, function( $element_data ) use ( $method ) {
|
||||
$element = Plugin::$instance->elements_manager->create_element_instance( $element_data );
|
||||
|
||||
// If the widget/element isn't exist, like a plugin that creates a widget but deactivated
|
||||
if ( ! $element ) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return $this->process_element_export_import_content( $element, $method );
|
||||
}
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Process single element content for export/import.
|
||||
*
|
||||
* Process any given element and prepare the element data for export/import.
|
||||
*
|
||||
* @since 1.5.0
|
||||
* @access protected
|
||||
*
|
||||
* @param Controls_Stack $element
|
||||
* @param string $method
|
||||
*
|
||||
* @return array Processed element data.
|
||||
*/
|
||||
protected function process_element_export_import_content( Controls_Stack $element, $method ) {
|
||||
$element_data = $element->get_data();
|
||||
|
||||
if ( method_exists( $element, $method ) ) {
|
||||
// TODO: Use the internal element data without parameters.
|
||||
$element_data = $element->{$method}( $element_data );
|
||||
}
|
||||
|
||||
foreach ( $element->get_controls() as $control ) {
|
||||
$control_class = Plugin::$instance->controls_manager->get_control( $control['type'] );
|
||||
|
||||
// If the control isn't exist, like a plugin that creates the control but deactivated.
|
||||
if ( ! $control_class ) {
|
||||
return $element_data;
|
||||
}
|
||||
|
||||
if ( method_exists( $control_class, $method ) ) {
|
||||
$element_data['settings'][ $control['name'] ] = $control_class->{$method}( $element->get_settings( $control['name'] ), $control );
|
||||
}
|
||||
|
||||
// On Export, check if the control has an argument 'export' => false.
|
||||
if ( 'on_export' === $method && isset( $control['export'] ) && false === $control['export'] ) {
|
||||
unset( $element_data['settings'][ $control['name'] ] );
|
||||
}
|
||||
}
|
||||
|
||||
return $element_data;
|
||||
}
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,343 @@
|
||||
<?php
|
||||
namespace Elementor\TemplateLibrary;
|
||||
|
||||
use Elementor\Api;
|
||||
use Elementor\Core\Common\Modules\Connect\Module as ConnectModule;
|
||||
use Elementor\Plugin;
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit; // Exit if accessed directly.
|
||||
}
|
||||
|
||||
/**
|
||||
* Elementor template library remote source.
|
||||
*
|
||||
* Elementor template library remote source handler class is responsible for
|
||||
* handling remote templates from Elementor.com servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
class Source_Remote extends Source_Base {
|
||||
|
||||
const API_TEMPLATES_URL = 'https://my.elementor.com/api/connect/v1/library/templates';
|
||||
|
||||
const TEMPLATES_DATA_TRANSIENT_KEY_PREFIX = 'elementor_remote_templates_data_';
|
||||
|
||||
public function __construct() {
|
||||
parent::__construct();
|
||||
|
||||
$this->add_actions();
|
||||
}
|
||||
|
||||
public function add_actions() {
|
||||
add_action( 'elementor/experiments/feature-state-change/container', [ $this, 'clear_cache' ], 10, 0 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get remote template ID.
|
||||
*
|
||||
* Retrieve the remote template ID.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return string The remote template ID.
|
||||
*/
|
||||
public function get_id() {
|
||||
return 'remote';
|
||||
}
|
||||
|
||||
/**
|
||||
* Get remote template title.
|
||||
*
|
||||
* Retrieve the remote template title.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @return string The remote template title.
|
||||
*/
|
||||
public function get_title() {
|
||||
return esc_html__( 'Remote', 'elementor' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Register remote template data.
|
||||
*
|
||||
* Used to register custom template data like a post type, a taxonomy or any
|
||||
* other data.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*/
|
||||
public function register_data() {}
|
||||
|
||||
/**
|
||||
* Get remote templates.
|
||||
*
|
||||
* Retrieve remote templates from Elementor.com servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Optional. Not used in remote source.
|
||||
*
|
||||
* @return array Remote templates.
|
||||
*/
|
||||
public function get_items( $args = [] ) {
|
||||
$force_update = ! empty( $args['force_update'] ) && is_bool( $args['force_update'] );
|
||||
|
||||
$templates_data = $this->get_templates_data( $force_update );
|
||||
|
||||
$templates = [];
|
||||
|
||||
foreach ( $templates_data as $template_data ) {
|
||||
$templates[] = $this->prepare_template( $template_data );
|
||||
}
|
||||
|
||||
return $templates;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get remote template.
|
||||
*
|
||||
* Retrieve a single remote template from Elementor.com servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*
|
||||
* @return array Remote template.
|
||||
*/
|
||||
public function get_item( $template_id ) {
|
||||
$templates = $this->get_items();
|
||||
|
||||
return $templates[ $template_id ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Save remote template.
|
||||
*
|
||||
* Remote template from Elementor.com servers cannot be saved on the
|
||||
* database as they are retrieved from remote servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $template_data Remote template data.
|
||||
*
|
||||
* @return \WP_Error
|
||||
*/
|
||||
public function save_item( $template_data ) {
|
||||
return new \WP_Error( 'invalid_request', 'Cannot save template to a remote source' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Update remote template.
|
||||
*
|
||||
* Remote template from Elementor.com servers cannot be updated on the
|
||||
* database as they are retrieved from remote servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $new_data New template data.
|
||||
*
|
||||
* @return \WP_Error
|
||||
*/
|
||||
public function update_item( $new_data ) {
|
||||
return new \WP_Error( 'invalid_request', 'Cannot update template to a remote source' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Delete remote template.
|
||||
*
|
||||
* Remote template from Elementor.com servers cannot be deleted from the
|
||||
* database as they are retrieved from remote servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*
|
||||
* @return \WP_Error
|
||||
*/
|
||||
public function delete_template( $template_id ) {
|
||||
return new \WP_Error( 'invalid_request', 'Cannot delete template from a remote source' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Export remote template.
|
||||
*
|
||||
* Remote template from Elementor.com servers cannot be exported from the
|
||||
* database as they are retrieved from remote servers.
|
||||
*
|
||||
* @since 1.0.0
|
||||
* @access public
|
||||
*
|
||||
* @param int $template_id The template ID.
|
||||
*
|
||||
* @return \WP_Error
|
||||
*/
|
||||
public function export_template( $template_id ) {
|
||||
return new \WP_Error( 'invalid_request', 'Cannot export template from a remote source' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get remote template data.
|
||||
*
|
||||
* Retrieve the data of a single remote template from Elementor.com servers.
|
||||
*
|
||||
* @since 1.5.0
|
||||
* @access public
|
||||
*
|
||||
* @param array $args Custom template arguments.
|
||||
* @param string $context Optional. The context. Default is `display`.
|
||||
*
|
||||
* @return array|\WP_Error Remote Template data.
|
||||
*/
|
||||
public function get_data( array $args, $context = 'display' ) {
|
||||
$data = Api::get_template_content( $args['template_id'] );
|
||||
|
||||
if ( is_wp_error( $data ) ) {
|
||||
return $data;
|
||||
}
|
||||
|
||||
// Set the Request's state as an Elementor upload request, in order to support unfiltered file uploads.
|
||||
Plugin::$instance->uploads_manager->set_elementor_upload_state( true );
|
||||
|
||||
// BC.
|
||||
$data = (array) $data;
|
||||
|
||||
$data['content'] = $this->replace_elements_ids( $data['content'] );
|
||||
$data['content'] = $this->process_export_import_content( $data['content'], 'on_import' );
|
||||
|
||||
$post_id = $args['editor_post_id'];
|
||||
$document = Plugin::$instance->documents->get( $post_id );
|
||||
if ( $document ) {
|
||||
$data['content'] = $document->get_elements_raw_data( $data['content'], true );
|
||||
}
|
||||
|
||||
// After the upload complete, set the elementor upload state back to false
|
||||
Plugin::$instance->uploads_manager->set_elementor_upload_state( false );
|
||||
|
||||
return $data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get templates data from a transient or from a remote request.
|
||||
* In any of the following 2 conditions, the remote request will be triggered:
|
||||
* 1. Force update - "$force_update = true" parameter was passed.
|
||||
* 2. The data saved in the transient is empty or not exist.
|
||||
*
|
||||
* @param bool $force_update
|
||||
* @return array
|
||||
*/
|
||||
private function get_templates_data( bool $force_update ) : array {
|
||||
$templates_data_cache_key = static::TEMPLATES_DATA_TRANSIENT_KEY_PREFIX . ELEMENTOR_VERSION;
|
||||
|
||||
$experiments_manager = Plugin::$instance->experiments;
|
||||
$editor_layout_type = $experiments_manager->is_feature_active( 'container' ) ? 'container_flexbox' : '';
|
||||
|
||||
if ( $force_update ) {
|
||||
return $this->get_templates( $editor_layout_type );
|
||||
}
|
||||
|
||||
$templates_data = get_transient( $templates_data_cache_key );
|
||||
|
||||
if ( empty( $templates_data ) ) {
|
||||
return $this->get_templates( $editor_layout_type );
|
||||
}
|
||||
|
||||
return $templates_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the templates from a remote server and set a transient.
|
||||
*
|
||||
* @param string $editor_layout_type
|
||||
* @return array
|
||||
*/
|
||||
private function get_templates( string $editor_layout_type ): array {
|
||||
$templates_data_cache_key = static::TEMPLATES_DATA_TRANSIENT_KEY_PREFIX . ELEMENTOR_VERSION;
|
||||
|
||||
$templates_data = $this->get_templates_remotely( $editor_layout_type );
|
||||
|
||||
if ( empty( $templates_data ) ) {
|
||||
return [];
|
||||
}
|
||||
|
||||
set_transient( $templates_data_cache_key, $templates_data, 12 * HOUR_IN_SECONDS );
|
||||
|
||||
return $templates_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Fetch templates from the remote server.
|
||||
*
|
||||
* @param string $editor_layout_type
|
||||
* @return array|false
|
||||
*/
|
||||
private function get_templates_remotely( string $editor_layout_type ) {
|
||||
$response = wp_remote_get( static::API_TEMPLATES_URL, [
|
||||
'body' => [
|
||||
'plugin_version' => ELEMENTOR_VERSION,
|
||||
'editor_layout_type' => $editor_layout_type,
|
||||
],
|
||||
] );
|
||||
|
||||
if ( is_wp_error( $response ) || 200 !== (int) wp_remote_retrieve_response_code( $response ) ) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$templates_data = json_decode( wp_remote_retrieve_body( $response ), true );
|
||||
|
||||
if ( empty( $templates_data ) || ! is_array( $templates_data ) ) {
|
||||
return [];
|
||||
}
|
||||
|
||||
return $templates_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* @since 2.2.0
|
||||
* @access private
|
||||
*/
|
||||
private function prepare_template( array $template_data ) {
|
||||
$favorite_templates = $this->get_user_meta( 'favorites' );
|
||||
|
||||
// BC: Support legacy APIs that don't have access tiers.
|
||||
if ( isset( $template_data['access_tier'] ) ) {
|
||||
$access_tier = $template_data['access_tier'];
|
||||
} else {
|
||||
$access_tier = 0 === $template_data['access_level']
|
||||
? ConnectModule::ACCESS_TIER_FREE
|
||||
: ConnectModule::ACCESS_TIER_ESSENTIAL;
|
||||
}
|
||||
|
||||
return [
|
||||
'template_id' => $template_data['id'],
|
||||
'source' => $this->get_id(),
|
||||
'type' => $template_data['type'],
|
||||
'subtype' => $template_data['subtype'],
|
||||
'title' => $template_data['title'],
|
||||
'thumbnail' => $template_data['thumbnail'],
|
||||
'date' => $template_data['tmpl_created'],
|
||||
'author' => $template_data['author'],
|
||||
'tags' => json_decode( $template_data['tags'] ),
|
||||
'isPro' => ( '1' === $template_data['is_pro'] ),
|
||||
'accessLevel' => $template_data['access_level'],
|
||||
'accessTier' => $access_tier,
|
||||
'popularityIndex' => (int) $template_data['popularity_index'],
|
||||
'trendIndex' => (int) $template_data['trend_index'],
|
||||
'hasPageSettings' => ( '1' === $template_data['has_page_settings'] ),
|
||||
'url' => $template_data['url'],
|
||||
'favorite' => ! empty( $favorite_templates[ $template_data['id'] ] ),
|
||||
];
|
||||
}
|
||||
|
||||
public function clear_cache() {
|
||||
delete_transient( static::TEMPLATES_DATA_TRANSIENT_KEY_PREFIX . ELEMENTOR_VERSION );
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user