elementor / includes / template-library / manager.php

manager.php in Elementor Website Builder – more than just a page builder 4.2.1, at includes/template-library/manager.php

1,250 lines 32.2 KB

Raw Download Zip

1	<?php
2	namespace Elementor\TemplateLibrary;
3
4	use Elementor\Api;
5	use Elementor\Core\Common\Modules\Ajax\Module as Ajax;
6	use Elementor\Core\Settings\Manager as SettingsManager;
7	use Elementor\Includes\TemplateLibrary\Data\Controller;
8	use Elementor\TemplateLibrary\Classes\Import_Images;
9	use Elementor\Core\Utils\Template_Library_Import_Export_Utils;
10	use Elementor\Plugin;
11	use Elementor\User;
12	use Elementor\Utils;
13
14	if ( ! defined( 'ABSPATH' ) ) {
15	exit; // Exit if accessed directly.
16	}
17
18	/**
19	* Elementor template library manager.
20	*
21	* Elementor template library manager handler class is responsible for
22	* initializing the template library.
23	*
24	* @since 1.0.0
25	*/
26	class Manager {
27
28	const ERROR_TEMPLATE_SOURCE_NOT_FOUND = 'Template source not found.';
29	const ERROR_TEMPLATE_IDS_MISSING = 'Template IDs are missing.';
30	const ERROR_JSON_UPLOAD_NOT_ALLOWED = 'Uploading JSON files is not allowed for this user.';
31
32	/**
33	* Registered template sources.
34	*
35	* Holds a list of all the supported sources with their instances.
36	*
37	* @access protected
38	*
39	* @var Source_Base[]
40	*/
41	protected $_registered_sources = []; // phpcs:ignore PSR2.Classes.PropertyDeclaration.Underscore
42
43	/**
44	* Imported template images.
45	*
46	* Holds an instance of `Import_Images` class.
47	*
48	* @access private
49	*
50	* @var Import_Images
51	*/
52	private $_import_images = null; // phpcs:ignore PSR2.Classes.PropertyDeclaration.Underscore
53
54	/**
55	* Template library manager constructor.
56	*
57	* Initializing the template library manager by registering default template
58	* sources and initializing ajax calls.
59	*
60	* @since 1.0.0
61	* @access public
62	*/
63	public function __construct() {
64	Plugin::$instance->data_manager_v2->register_controller( new Controller() );
65
66	$this->register_default_sources();
67
68	$this->add_actions();
69	}
70
71	/**
72	* @since 2.3.0
73	* @access public
74	*/
75	public function add_actions() {
76	add_action( 'elementor/ajax/register_actions', [ $this, 'register_ajax_actions' ] );
77	add_action( 'wp_ajax_elementor_library_direct_actions', [ $this, 'handle_direct_actions' ] );
78	}
79
80	/**
81	* Get `Import_Images` instance.
82	*
83	* Retrieve the instance of the `Import_Images` class.
84	*
85	* @since 1.0.0
86	* @access public
87	*
88	* @return Import_Images Imported images instance.
89	*/
90	public function get_import_images_instance() {
91	if ( null === $this->_import_images ) {
92	$this->_import_images = new Import_Images();
93	}
94
95	return $this->_import_images;
96	}
97
98	/**
99	* Register template source.
100	*
101	* Used to register new template sources displayed in the template library.
102	*
103	* @since 1.0.0
104	* @access public
105	*
106	* @param string $source_class The name of source class.
107	* @param array $args Optional. Class arguments. Default is an
108	* empty array.
109	*
110	* @return \WP_Error\|true True if the source was registered, `WP_Error`
111	* otherwise.
112	*/
113	public function register_source( $source_class, $args = [] ) {
114	if ( ! class_exists( $source_class ) ) {
115	return new \WP_Error( 'source_class_name_not_exists' );
116	}
117
118	$source_instance = new $source_class( $args );
119
120	if ( ! $source_instance instanceof Source_Base ) {
121	return new \WP_Error( 'wrong_instance_source' );
122	}
123
124	$source_id = $source_instance->get_id();
125
126	if ( isset( $this->_registered_sources[ $source_id ] ) ) {
127	return new \WP_Error( 'source_exists' );
128	}
129
130	$this->_registered_sources[ $source_id ] = $source_instance;
131
132	return true;
133	}
134
135	/**
136	* Unregister template source.
137	*
138	* Remove an existing template sources from the list of registered template
139	* sources.
140	*
141	* @since 1.0.0
142	* @deprecated 2.7.0
143	* @access public
144	*
145	* @param string $id The source ID.
146	*
147	* @return bool Whether the source was unregistered.
148	*/
149	public function unregister_source( $id ) {
150	return true;
151	}
152
153	/**
154	* Get registered template sources.
155	*
156	* Retrieve registered template sources.
157	*
158	* @since 1.0.0
159	* @access public
160	*
161	* @return Source_Base[] Registered template sources.
162	*/
163	public function get_registered_sources() {
164	return $this->_registered_sources;
165	}
166
167	/**
168	* Get template source.
169	*
170	* Retrieve single template sources for a given template ID.
171	*
172	* @since 1.0.0
173	* @access public
174	*
175	* @param string $id The source ID.
176	*
177	* @return false\|Source_Base Template sources if one exist, False otherwise.
178	*/
179	public function get_source( $id ) {
180	$sources = $this->get_registered_sources();
181
182	if ( ! isset( $sources[ $id ] ) ) {
183	return false;
184	}
185
186	return $sources[ $id ];
187	}
188
189	/**
190	* Get templates.
191	*
192	* Retrieve all the templates from all the registered sources.
193	*
194	* @param array $filter_sources
195	* @param bool $force_update
196	* @return array
197	*/
198	public function get_templates( array $filter_sources = [], bool $force_update = false ): array {
199	$templates = [];
200
201	foreach ( $this->get_registered_sources() as $source ) {
202	if ( ! empty( $filter_sources ) && ! in_array( $source->get_id(), $filter_sources, true ) ) {
203	continue;
204	}
205
206	$templates = array_merge( $templates, $source->get_items( [ 'force_update' => $force_update ] ) );
207	}
208
209	return $templates;
210	}
211
212	/**
213	* Get library data.
214	*
215	* Retrieve the library data.
216	*
217	* @since 1.9.0
218	* @access public
219	*
220	* @param array $args Library arguments.
221	*
222	* @return array Library data.
223	*/
224	public function get_library_data( array $args ) {
225	$force_update = ! empty( $args['sync'] );
226
227	$library_data = Api::get_library_data( $force_update );
228
229	if ( empty( $library_data ) ) {
230	return $library_data;
231	}
232
233	// Ensure all document are registered.
234	Plugin::$instance->documents->get_document_types();
235
236	$filter_sources = ! empty( $args['filter_sources'] ) ? $args['filter_sources'] : [];
237
238	$full_library_data = [
239	'templates' => $this->get_templates( $filter_sources, $force_update ),
240	'config' => $library_data['types_data'],
241	];
242
243	/**
244	* Filter the full library data.
245	*
246	* @since 3.32.2
247	* @param-out $full_library_data - 'templates' and 'config' data ('config' holds the list of categories).
248	*/
249	return apply_filters( 'elementor/library/full-data', $full_library_data );
250	}
251
252	/**
253	* Save template.
254	*
255	* Save new or update existing template on the database.
256	*
257	* @since 1.0.0
258	* @access public
259	*
260	* @param array $args Template arguments.
261	*
262	* @return \WP_Error\|int The ID of the saved/updated template.
263	*/
264	public function save_template( array $args ) {
265	$validate_args = $this->ensure_args( [ 'post_id', 'source', 'content', 'type' ], $args );
266
267	if ( is_wp_error( $validate_args ) ) {
268	return $validate_args;
269	}
270
271	$sources = (array) $args['source']; // BC
272	$results = [];
273
274	foreach ( $sources as $source ) {
275	$args_copy = $args;
276	$args_copy['source'] = $source;
277	$results[] = $this->save_template_item( $args_copy );
278	}
279
280	return 1 === count( $results ) ? $results[0] : $results;
281	}
282
283	private function save_template_item( array $args ) {
284	$source = $this->get_source( $args['source'] );
285
286	if ( ! $source ) {
287	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
288	}
289
290	$args['content'] = json_decode( $args['content'], true );
291
292	$page = SettingsManager::get_settings_managers( 'page' )->get_model( $args['post_id'] );
293
294	$args['page_settings'] = $page->get_data( 'settings' );
295
296	$template_id = $source->save_item( $args );
297
298	if ( is_wp_error( $template_id ) ) {
299	return $template_id;
300	}
301
302	return $source->get_item( $template_id );
303	}
304
305	public function move_template( array $args ) {
306	$validate_args = $this->ensure_args( [ 'source', 'from_source', 'from_template_id' ], $args );
307
308	if ( is_wp_error( $validate_args ) ) {
309	return $validate_args;
310	}
311
312	$args['source'] = $args['source'][0];
313
314	$result = $this->move_template_item( $args );
315
316	if ( ! $this->is_action_to_same_source( $args ) ) {
317	$this->delete_template( [
318	'source' => $args['from_source'],
319	'template_id' => $args['from_template_id'],
320	] );
321	}
322
323	return $result;
324	}
325
326	private function move_template_item( array $args ) {
327	$validate_args = $this->ensure_args( [ 'source', 'from_source', 'from_template_id' ], $args );
328
329	if ( is_wp_error( $validate_args ) ) {
330	return $validate_args;
331	}
332
333	$source = $this->get_source( $args['source'] );
334
335	if ( ! $source ) {
336	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
337	}
338
339	if ( $this->is_action_to_same_source( $args ) ) {
340	return $source->move_template_to_folder( $args );
341	}
342
343	$from_source = $this->get_source( $args['from_source'] );
344
345	if ( ! $from_source ) {
346	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
347	}
348
349	$args = $from_source->format_args_for_single_action( $args );
350
351	$template_id = $source->save_item( $args );
352
353	if ( is_wp_error( $template_id ) ) {
354	return $template_id;
355	}
356
357	return $source->get_item( $template_id );
358	}
359
360	public function copy_template( array $args ) {
361	$validate_args = $this->ensure_args( [ 'source', 'from_source', 'from_template_id' ], $args );
362
363	if ( is_wp_error( $validate_args ) ) {
364	return $validate_args;
365	}
366
367	$source = $this->get_source( $args['source'][0] );
368
369	if ( ! $source ) {
370	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
371	}
372
373	$from_source = $this->get_source( $args['from_source'] );
374
375	if ( ! $from_source ) {
376	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
377	}
378
379	$args = $from_source->format_args_for_single_action( $args );
380
381	$template_id = $source->save_item( $args );
382
383	if ( is_wp_error( $template_id ) ) {
384	return $template_id;
385	}
386
387	return $source->get_item( $template_id );
388	}
389
390	private function is_action_to_same_source( $args ) {
391	return $args['source'] === $args['from_source'];
392	}
393
394	/**
395	* Update template.
396	*
397	* Update template on the database.
398	*
399	* @since 1.0.0
400	* @access public
401	*
402	* @param array $template_data New template data.
403	*
404	* @return \WP_Error\|Source_Base Template sources instance if the templates
405	* was updated, `WP_Error` otherwise.
406	*/
407	public function update_template( array $template_data ) {
408	$validate_args = $this->ensure_args( [ 'source', 'content', 'type' ], $template_data );
409
410	if ( is_wp_error( $validate_args ) ) {
411	return $validate_args;
412	}
413
414	$source = $this->get_source( $template_data['source'] );
415
416	if ( ! $source ) {
417	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
418	}
419
420	$template_data['content'] = json_decode( $template_data['content'], true );
421
422	$update = $source->update_item( $template_data );
423
424	if ( is_wp_error( $update ) ) {
425	return $update;
426	}
427
428	return $source->get_item( $template_data['id'] );
429	}
430
431	public function rename_template( array $template_data ) {
432	$validate_args = $this->ensure_args( [ 'source', 'title', 'id' ], $template_data );
433
434	if ( is_wp_error( $validate_args ) ) {
435	return $validate_args;
436	}
437
438	$source = $this->get_source( $template_data['source'] );
439
440	if ( ! $source ) {
441	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
442	}
443
444	$update = $source->update_item( $template_data );
445
446	if ( is_wp_error( $update ) ) {
447	return $update;
448	}
449
450	return $source->get_item( $template_data['id'] );
451	}
452
453	/**
454	* Update templates.
455	*
456	* Update template on the database.
457	*
458	* @since 1.0.0
459	* @access public
460	*
461	* @param array $args Template arguments.
462	*
463	* @return \WP_Error\|true True if templates updated, `WP_Error` otherwise.
464	*/
465	public function update_templates( array $args ) {
466	foreach ( $args['templates'] as $template_data ) {
467	$result = $this->update_template( $template_data );
468
469	if ( is_wp_error( $result ) ) {
470	return $result;
471	}
472	}
473
474	return true;
475	}
476
477	/**
478	* Get template data.
479	*
480	* Retrieve the template data.
481	*
482	* @since 1.5.0
483	* @access public
484	*
485	* @param array $args Template arguments.
486	*
487	* @return \WP_Error\|bool\|array ??
488	*/
489	public function get_template_data( array $args ) {
490	$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
491
492	if ( is_wp_error( $validate_args ) ) {
493	return $validate_args;
494	}
495
496	$source = $this->get_source( $args['source'] );
497
498	if ( ! $source ) {
499	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
500	}
501
502	if ( method_exists( $source, 'is_allowed_to_read_template' ) && ! $source->is_allowed_to_read_template( $args ) ) {
503	return new \WP_Error(
504	'template_error',
505	esc_html__( 'You do not have permission to access this template.', 'elementor' )
506	);
507	}
508
509	if ( isset( $args['edit_mode'] ) ) {
510	Plugin::$instance->editor->set_edit_mode( $args['edit_mode'] );
511	}
512
513	do_action( 'elementor/template-library/before_get_source_data', $args, $source );
514
515	$data = $source->get_data( $args );
516
517	do_action( 'elementor/template-library/after_get_source_data', $args, $source );
518
519	return $data;
520	}
521
522	/**
523	* Delete template.
524	*
525	* Delete template from the database.
526	*
527	* @since 1.0.0
528	* @access public
529	*
530	* @param array $args Template arguments.
531	*
532	* @return \WP_Post\|\WP_Error\|false\|null Post data on success, false or null
533	* or 'WP_Error' on failure.
534	*/
535	public function delete_template( array $args ) {
536	$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
537
538	if ( is_wp_error( $validate_args ) ) {
539	return $validate_args;
540	}
541
542	$source = $this->get_source( $args['source'] );
543
544	if ( ! $source ) {
545	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
546	}
547
548	return $source->delete_template( $args['template_id'] );
549	}
550
551	/**
552	* Export template.
553	*
554	* Export template to a file after ensuring it is a valid Elementor template
555	* and checking user permissions for private posts.
556	*
557	* @since 1.0.0
558	* @access public
559	*
560	* @param array $args Template arguments.
561	*
562	* @return mixed Whether the export succeeded or failed.
563	*/
564	public function export_template( array $args ) {
565	$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
566
567	if ( is_wp_error( $validate_args ) ) {
568	return $validate_args;
569	}
570
571	$source = $this->get_source( $args['source'] );
572
573	if ( ! $source ) {
574	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
575	}
576
577	return $source->export_template( $args['template_id'] );
578	}
579
580	/**
581	* @since 2.3.0
582	* @access public
583	*/
584	public function direct_import_template() {
585	/** @var Source_Local $source */
586	$source = $this->get_source( 'local' );
587	$file = Utils::get_super_global_value( $_FILES, 'file' ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
588	return $source->import_template( $file['name'], $file['tmp_name'] );
589	}
590
591	/**
592	* Import template.
593	*
594	* Import template from a file.
595	*
596	* @since 1.0.0
597	* @access public
598	*
599	* @param array $data
600	*
601	* @return mixed Whether the export succeeded or failed.
602	*/
603	public function import_template( array $data ) {
604	if ( ! User::is_current_user_can_upload_json() ) {
605	return new \WP_Error( 'template_error', self::ERROR_JSON_UPLOAD_NOT_ALLOWED );
606	}
607
608	// If the template is a JSON file, allow uploading it.
609	add_filter( 'elementor/files/allow-file-type/json', [ $this, 'enable_json_template_upload' ] );
610	add_filter( 'elementor/files/allow_unfiltered_upload', [ $this, 'enable_json_template_upload' ] );
611
612	// Imported templates can be either JSON files, or Zip files containing multiple JSON files
613	$upload_result = Plugin::$instance->uploads_manager->handle_elementor_upload( $data, [ 'zip', 'json' ] );
614
615	remove_filter( 'elementor/files/allow-file-type/json', [ $this, 'enable_json_template_upload' ] );
616	remove_filter( 'elementor/files/allow_unfiltered_upload', [ $this, 'enable_json_template_upload' ] );
617
618	if ( is_wp_error( $upload_result ) ) {
619	return $upload_result;
620	}
621
622	$source = $this->get_source( $data['source'] ?? 'local' );
623
624	$import_mode = $data['import_mode'] ?? 'match_site';
625	$import_result = $source->import_template( $upload_result['name'], $upload_result['tmp_name'], $import_mode );
626
627	// Remove the temporary directory generated for the stream-uploaded file.
628	Plugin::$instance->uploads_manager->remove_file_or_dir( dirname( $upload_result['tmp_name'] ) );
629
630	return $import_result;
631	}
632
633	/**
634	* Enable JSON Template Upload
635	*
636	* Runs on the 'elementor/files/allow-file-type/json' Uploads Manager filter.
637	*
638	* @since 3.5.0
639	* @access public
640	*
641	* return bool
642	*/
643	public function enable_json_template_upload() {
644	return true;
645	}
646
647	/**
648	* Mark template as favorite.
649	*
650	* Add the template to the user favorite templates.
651	*
652	* @since 1.9.0
653	* @access public
654	*
655	* @param array $args Template arguments.
656	*
657	* @return mixed Whether the template marked as favorite.
658	*/
659	public function mark_template_as_favorite( $args ) {
660	$validate_args = $this->ensure_args( [ 'source', 'template_id', 'favorite' ], $args );
661
662	if ( is_wp_error( $validate_args ) ) {
663	return $validate_args;
664	}
665
666	$source = $this->get_source( $args['source'] );
667
668	return $source->mark_as_favorite( $args['template_id'], filter_var( $args['favorite'], FILTER_VALIDATE_BOOLEAN ) );
669	}
670
671	public function import_from_json( array $args ) {
672	$validate_args = $this->ensure_args( [ 'editor_post_id', 'elements' ], $args );
673
674	if ( is_wp_error( $validate_args ) ) {
675	return $validate_args;
676	}
677
678	$elements = json_decode( $args['elements'], true );
679
680	$document = Plugin::$instance->documents->get( $args['editor_post_id'] );
681	if ( ! $document ) {
682	return new \WP_Error( 'template_error', 'Document not found.' );
683	}
684
685	$import_data = $document->get_import_data( [ 'content' => $elements ] );
686
687	$content = $document::on_import_update_dynamic_content(
688	$import_data['content'],
689	[ 'post_ids' => [] ]
690	);
691
692	return Plugin::$instance->db->iterate_data( $content, function( $element_data ) {
693	unset( $element_data['htmlCache'] );
694	return $element_data;
695	} );
696	}
697
698	public function process_global_styles( array $args ) {
699	$validate_args = $this->ensure_args( [ 'content', 'import_mode' ], $args );
700
701	if ( is_wp_error( $validate_args ) ) {
702	return $validate_args;
703	}
704
705	$import_mode = Template_Library_Import_Export_Utils::sanitize_import_mode( $args['import_mode'] );
706
707	$content = $this->get_validated_json_arg( $args, 'content' );
708	if ( is_wp_error( $content ) ) {
709	return $content;
710	}
711
712	$global_classes = $this->get_validated_json_arg( $args, 'global_classes', true );
713	if ( is_wp_error( $global_classes ) ) {
714	return $global_classes;
715	}
716
717	$global_variables = $this->get_validated_json_arg( $args, 'global_variables', true );
718	if ( is_wp_error( $global_variables ) ) {
719	return $global_variables;
720	}
721
722	$data = [
723	'global_classes' => $global_classes,
724	'global_variables' => $global_variables,
725	];
726
727	$result = apply_filters(
728	'elementor/template_library/import/process_content',
729	[ 'content' => $content ],
730	$import_mode,
731	$data,
732	null
733	);
734
735	$response = [
736	'content' => $result['content'],
737	];
738
739	if ( ! empty( $result['updated_global_classes'] ) ) {
740	$response['updated_global_classes'] = $result['updated_global_classes'];
741	}
742
743	if ( ! empty( $result['updated_global_variables'] ) ) {
744	$response['updated_global_variables'] = $result['updated_global_variables'];
745	}
746
747	$classes_to_flatten = $result['classes_to_flatten'] ?? [];
748	$variables_to_flatten = $result['variables_to_flatten'] ?? [];
749
750	if ( ! empty( $classes_to_flatten ) ) {
751	$response['flattened_classes_count'] = count( $classes_to_flatten );
752	}
753
754	if ( ! empty( $variables_to_flatten ) ) {
755	$response['flattened_variables_count'] = count( $variables_to_flatten );
756	}
757
758	return $response;
759	}
760
761	private function get_validated_json_arg( array $args, string $key, bool $is_optional = false ) {
762	if ( ! array_key_exists( $key, $args ) \|\| null === $args[ $key ] \|\| '' === $args[ $key ] ) {
763	return $is_optional ? null : new \WP_Error( "invalid_$key", "Invalid $key." );
764	}
765
766	$value = $args[ $key ];
767	if ( is_string( $value ) ) {
768	$decoded = json_decode( $value, true );
769	if ( JSON_ERROR_NONE !== json_last_error() ) {
770	return new \WP_Error( "invalid_$key", "Invalid JSON $key." );
771	}
772	return $decoded;
773	}
774
775	if ( ! is_array( $value ) ) {
776	return new \WP_Error( "invalid_$key", "Invalid $key format." );
777	}
778
779	return $value;
780	}
781
782	public function get_item_children( array $args ) {
783	$validate_args = $this->ensure_args( [ 'source', 'template_id' ], $args );
784
785	if ( is_wp_error( $validate_args ) ) {
786	return $validate_args;
787	}
788
789	$source = $this->get_source( $args['source'] );
790
791	if ( ! $source ) {
792	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
793	}
794
795	return $source->get_item_children( $args );
796	}
797
798	public function search_templates( array $args ) {
799	$validate_args = $this->ensure_args( [ 'source', 'search' ], $args );
800
801	if ( is_wp_error( $validate_args ) ) {
802	return $validate_args;
803	}
804
805	$source = $this->get_source( $args['source'] );
806
807	if ( ! $source ) {
808	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
809	}
810
811	return $source->search_templates( $args );
812	}
813
814	public function load_more_templates( array $args ) {
815	$validate_args = $this->ensure_args( [ 'source', 'offset' ], $args );
816
817	if ( is_wp_error( $validate_args ) ) {
818	return $validate_args;
819	}
820
821	$source = $this->get_source( $args['source'] );
822
823	if ( ! $source ) {
824	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
825	}
826
827	return $source->get_items( $args );
828	}
829
830	public function create_folder( array $args ) {
831	$validate_args = $this->ensure_args( [ 'source', 'title' ], $args );
832
833	if ( is_wp_error( $validate_args ) ) {
834	return $validate_args;
835	}
836
837	$source = $this->get_source( $args['source'] );
838
839	if ( ! $source ) {
840	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
841	}
842
843	return $source->save_folder( $args );
844	}
845
846	public function get_folders( array $args ) {
847	$validate_args = $this->ensure_args( [ 'source', 'offset' ], $args );
848
849	if ( is_wp_error( $validate_args ) ) {
850	return $validate_args;
851	}
852
853	$source = $this->get_source( $args['source'] );
854
855	if ( ! $source ) {
856	return new \WP_Error( 'template_error', 'Folder source not found.' );
857	}
858
859	$args['templateType'] = 'folder';
860
861	return $source->get_items( $args );
862	}
863
864	/**
865	* Register default template sources.
866	*
867	* Register the 'local' and 'remote' template sources that Elementor use by
868	* default.
869	*
870	* @since 1.0.0
871	* @access private
872	*/
873	private function register_default_sources() {
874	$sources = [
875	'local',
876	'remote',
877	'cloud',
878	];
879
880	foreach ( $sources as $source_filename ) {
881	$class_name = ucwords( $source_filename );
882	$class_name = str_replace( '-', '_', $class_name );
883
884	$this->register_source( __NAMESPACE__ . '\Source_' . $class_name );
885	}
886	}
887
888	/**
889	* Handle ajax request.
890	*
891	* Fire authenticated ajax actions for any given ajax request.
892	*
893	* @since 1.0.0
894	* @access private
895	*
896	* @param string $ajax_request Ajax request.
897	*
898	* @param array $data
899	*
900	* @return mixed
901	* @throws \Exception If current user has no permission or the post is not found.
902	*/
903	private function handle_ajax_request( $ajax_request, array $data ) {
904	if ( ! User::is_current_user_can_edit_post_type( Source_Local::CPT ) ) {
905	throw new \Exception( 'Access denied.' );
906	}
907
908	if ( 'import_template' === $ajax_request && ! User::is_current_user_can_upload_json() ) {
909	throw new \Exception( 'Access denied.' );
910	}
911
912	if ( ! empty( $data['editor_post_id'] ) ) {
913	$editor_post_id = absint( $data['editor_post_id'] );
914
915	if ( ! get_post( $editor_post_id ) ) {
916	throw new \Exception( 'Post not found.' );
917	}
918
919	Plugin::$instance->db->switch_to_post( $editor_post_id );
920	}
921
922	$result = call_user_func( [ $this, $ajax_request ], $data );
923
924	if ( is_wp_error( $result ) ) {
925	throw new \Exception( esc_html( $result->get_error_message() ) );
926	}
927
928	return $result;
929	}
930
931	/**
932	* @throws \Exception If template import fails, file validation errors occur, or processing encounters issues.
933	*/
934	public function save_template_screenshot( $data ): string {
935	$validate_args = $this->ensure_args( [ 'template_id', 'screenshot' ], $data );
936
937	if ( is_wp_error( $validate_args ) ) {
938	return $validate_args;
939	}
940
941	$raw_binary = base64_decode( substr( $data['screenshot'], strlen( 'data:image/png;base64,' ) ) );
942
943	return $this->get_source( 'cloud' )->save_item_preview( $data['template_id'], $raw_binary );
944	}
945
946	/**
947	* @throws \Exception If template processing fails or data validation errors occur.
948	*/
949	public function template_screenshot_failed( $data ): string {
950	$validate_args = $this->ensure_args( [ 'template_id' ], $data );
951
952	if ( is_wp_error( $validate_args ) ) {
953	return $validate_args;
954	}
955
956	return $this->get_source( 'cloud' )->mark_preview_as_failed( $data['template_id'], $data['error'] );
957	}
958
959	public function bulk_delete_templates( $data ) {
960	$validate_args = $this->ensure_args( [ 'template_ids', 'source' ], $data );
961
962	if ( is_wp_error( $validate_args ) ) {
963	return $validate_args;
964	}
965
966	$source = $this->get_source( $data['source'] );
967
968	if ( ! $source ) {
969	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
970	}
971
972	if ( empty( $data['template_ids'] ) \|\| ! is_array( $data['template_ids'] ) ) {
973	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_IDS_MISSING );
974	}
975
976	return $source->bulk_delete_items( $data['template_ids'] );
977	}
978
979	public function bulk_undo_delete_items( $data ) {
980	$validate_args = $this->ensure_args( [ 'template_ids', 'source' ], $data );
981
982	if ( is_wp_error( $validate_args ) ) {
983	return $validate_args;
984	}
985
986	$source = $this->get_source( $data['source'] );
987
988	if ( ! $source ) {
989	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
990	}
991
992	if ( empty( $data['template_ids'] ) \|\| ! is_array( $data['template_ids'] ) ) {
993	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_IDS_MISSING );
994	}
995
996	return $source->bulk_undo_delete_items( $data['template_ids'] );
997	}
998
999	/**
1000	* Init ajax calls.
1001	*
1002	* Initialize template library ajax calls for allowed ajax requests.
1003	*
1004	* @since 2.3.0
1005	* @access public
1006	*
1007	* @param Ajax $ajax
1008	*/
1009	public function register_ajax_actions( Ajax $ajax ) {
1010	$library_ajax_requests = [
1011	'get_library_data',
1012	'get_template_data',
1013	'save_template',
1014	'update_templates',
1015	'delete_template',
1016	'import_template',
1017	'mark_template_as_favorite',
1018	'import_from_json',
1019	'get_item_children',
1020	'search_templates',
1021	'rename_template',
1022	'load_more_templates',
1023	'create_folder',
1024	'get_folders',
1025	'save_template_screenshot',
1026	'move_template',
1027	'copy_template',
1028	'bulk_move_templates',
1029	'bulk_delete_templates',
1030	'bulk_copy_templates',
1031	'bulk_undo_delete_items',
1032	'get_templates_quota',
1033	'template_screenshot_failed',
1034	'process_global_styles',
1035	];
1036
1037	foreach ( $library_ajax_requests as $ajax_request ) {
1038	$ajax->register_ajax_action( $ajax_request, function( $data ) use ( $ajax_request ) {
1039	return $this->handle_ajax_request( $ajax_request, $data );
1040	} );
1041	}
1042	}
1043
1044	/**
1045	* @since 2.3.0
1046	* @access public
1047	*/
1048	public function handle_direct_actions() {
1049	if ( ! User::is_current_user_can_edit_post_type( Source_Local::CPT ) ) {
1050	return;
1051	}
1052
1053	/** @var Ajax $ajax */
1054	$ajax = Plugin::$instance->common->get_component( 'ajax' );
1055
1056	if ( ! $ajax->verify_request_nonce() ) {
1057	$this->handle_direct_action_error( 'Access Denied' );
1058	}
1059
1060	$action = Utils::get_super_global_value( $_REQUEST, 'library_action' ); // phpcs:ignore -- Nonce already verified.
1061
1062	$whitelist_methods = [
1063	'export_template',
1064	'direct_import_template',
1065	];
1066
1067	if ( 'direct_import_template' === $action && ! User::is_current_user_can_upload_json() ) {
1068	return;
1069	}
1070
1071	if ( in_array( $action, $whitelist_methods, true ) ) {
1072	$result = $this->$action( $_REQUEST ); // phpcs:ignore -- Nonce already verified.
1073	} else {
1074	$result = new \WP_Error( 'method_not_exists', 'Method Not exists' );
1075	}
1076
1077	if ( is_wp_error( $result ) ) {
1078	/** @var \WP_Error $result */
1079	$this->handle_direct_action_error( $result->get_error_message() . '.' );
1080	}
1081
1082	$callback = "on_{$action}_success";
1083
1084	if ( method_exists( $this, $callback ) ) {
1085	$this->$callback( $result );
1086	}
1087
1088	die;
1089	}
1090
1091	/**
1092	* On successful template import.
1093	*
1094	* Redirect the user to the template library after template import was
1095	* successful finished.
1096	*
1097	* @since 2.3.0
1098	* @access private
1099	*/
1100	private function on_direct_import_template_success() {
1101	wp_safe_redirect( admin_url( Source_Local::ADMIN_MENU_SLUG ) );
1102	}
1103
1104	/**
1105	* @since 2.3.0
1106	* @access private
1107	*/
1108	private function handle_direct_action_error( $message ) {
1109	_default_wp_die_handler( $message, 'Elementor Library' );
1110	}
1111
1112	/**
1113	* Ensure arguments exist.
1114	*
1115	* Checks whether the required arguments exist in the specified arguments.
1116	*
1117	* @since 1.0.0
1118	* @access private
1119	*
1120	* @param array $required_args Required arguments to check whether they
1121	* exist.
1122	* @param array $specified_args The list of all the specified arguments to
1123	* check against.
1124	*
1125	* @return \WP_Error\|true True on success, 'WP_Error' otherwise.
1126	*/
1127	private function ensure_args( array $required_args, array $specified_args ) {
1128	$not_specified_args = array_diff( $required_args, array_keys( $specified_args ) );
1129
1130	if ( $not_specified_args ) {
1131	return new \WP_Error( 'arguments_not_specified', sprintf( 'The required argument(s) "%s" not specified.', implode( ', ', $not_specified_args ) ) );
1132	}
1133
1134	return true;
1135	}
1136
1137	public function bulk_move_templates( array $args ) {
1138	$validate_args = $this->ensure_args( [ 'source', 'from_source', 'from_template_id' ], $args );
1139
1140	if ( is_wp_error( $validate_args ) ) {
1141	return $validate_args;
1142	}
1143
1144	$args['source'] = $args['source'][0];
1145
1146	return $this->bulk_move_template_items( $args );
1147	}
1148
1149	private function bulk_move_template_items( array $args ) {
1150	$source = $this->get_source( $args['source'] );
1151
1152	if ( ! $source ) {
1153	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
1154	}
1155
1156	if ( $this->is_action_to_same_source( $args ) ) {
1157	return $source->move_bulk_templates_to_folder( $args );
1158	}
1159
1160	$from_source = $this->get_source( $args['from_source'] );
1161
1162	if ( ! $from_source ) {
1163	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
1164	}
1165
1166	$bulk_args = $from_source->format_args_for_bulk_action( $args );
1167
1168	if ( $source->supports_quota() && ! $this->is_action_to_same_source( $args ) ) {
1169	$quota_validation = $source->validate_quota( $bulk_args );
1170
1171	if ( is_wp_error( $quota_validation ) ) {
1172	return $quota_validation;
1173	}
1174
1175	if ( false === $quota_validation ) {
1176	return new \WP_Error( 'quota_error', 'The moving failed because it will pass the maximum templates you can save.' );
1177	}
1178	}
1179
1180	$bulk_save = $source->save_bulk_items( $bulk_args );
1181
1182	if ( ! empty( $bulk_save ) ) {
1183	$this->bulk_delete_templates( [
1184	'template_ids' => $args['from_template_id'],
1185	'source' => $args['from_source'],
1186	] );
1187	}
1188
1189	return $bulk_save;
1190	}
1191
1192	public function bulk_copy_templates( array $args ) {
1193	$validate_args = $this->ensure_args( [ 'source', 'from_source', 'from_template_id' ], $args );
1194
1195	if ( is_wp_error( $validate_args ) ) {
1196	return $validate_args;
1197	}
1198
1199	$args['source'] = $args['source'][0];
1200
1201	return $this->bulk_copy_template_items( $args );
1202	}
1203
1204	private function bulk_copy_template_items( array $args ) {
1205	$source = $this->get_source( $args['source'] );
1206
1207	if ( ! $source ) {
1208	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
1209	}
1210
1211	$from_source = $this->get_source( $args['from_source'] );
1212
1213	if ( ! $from_source ) {
1214	return new \WP_Error( 'template_error', self::ERROR_TEMPLATE_SOURCE_NOT_FOUND );
1215	}
1216
1217	$bulk_args = $from_source->format_args_for_bulk_action( $args );
1218
1219	if ( $source->supports_quota() && ! $this->is_action_to_same_source( $args ) ) {
1220	$quota_validation = $source->validate_quota( $bulk_args );
1221
1222	if ( is_wp_error( $quota_validation ) ) {
1223	return $quota_validation;
1224	}
1225
1226	if ( false === $quota_validation ) {
1227	return new \WP_Error( 'quota_error', 'The copying failed because it will pass the maximum templates you can save.' );
1228	}
1229	}
1230
1231	return $source->save_bulk_items( $bulk_args );
1232	}
1233
1234	public function get_templates_quota( array $args ) {
1235	$validate_args = $this->ensure_args( [ 'source' ], $args );
1236
1237	if ( is_wp_error( $validate_args ) ) {
1238	return $validate_args;
1239	}
1240
1241	$source = $this->get_source( $args['source'] );
1242
1243	if ( ! $source ) {
1244	return new \WP_Error( 'template_error', 'Source not found.' );
1245	}
1246
1247	return $source->get_quota();
1248	}
1249	}
1250