elementor / modules / components / module.php

module.php in Elementor Website Builder – more than just a page builder 4.0.0-dev4, at modules/components/module.php

148 lines 5.5 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Modules\Components;
3
4	use Elementor\Core\Base\Module as BaseModule;
5	use Elementor\Core\Experiments\Manager as Experiments_Manager;
6	use Elementor\Modules\AtomicWidgets\Module as AtomicWidgetsModule;
7	use Elementor\Plugin;
8	use Elementor\Modules\AtomicWidgets\PropsResolver\Transformers_Registry;
9	use Elementor\Modules\Components\Styles\Component_Styles;
10	use Elementor\Modules\Components\Documents\Component as Component_Document;
11	use Elementor\Modules\Components\Component_Lock_Manager;
12	use Elementor\Modules\Components\PropTypes\Component_Instance_Prop_Type;
13	use Elementor\Modules\Components\Transformers\Component_Instance_Transformer;
14	use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
15	use Elementor\Modules\Components\Transformers\Overridable_Transformer;
16	use Elementor\Core\Base\Document;
17	use Elementor\Modules\Components\PropTypes\Override_Prop_Type;
18	use Elementor\Modules\Components\Transformers\Override_Transformer;
19
20	if ( ! defined( 'ABSPATH' ) ) {
21	exit; // Exit if accessed directly.
22	}
23
24	class Module extends BaseModule {
25	const EXPERIMENT_NAME = 'e_components';
26	const PACKAGES = [ 'editor-components' ];
27
28	public function get_name() {
29	return 'components';
30	}
31
32	public function __construct() {
33	parent::__construct();
34
35	if ( ! $this->is_experiment_active() ) {
36	return;
37	}
38
39	$this->register_component_post_type();
40
41	add_filter( 'elementor/editor/v2/packages', fn ( $packages ) => $this->add_packages( $packages ) );
42	add_filter( 'elementor/atomic-widgets/props-schema', fn ( $schema ) => $this->modify_props_schema( $schema ) );
43	add_action( 'elementor/documents/register', fn ( $documents_manager ) => $this->register_document_type( $documents_manager ) );
44	add_action( 'elementor/document/before_save', fn( Document $document, array $data ) => $this->validate_circular_dependencies( $document, $data ), 10, 2 );
45	add_action( 'elementor/document/after_save', fn( Document $document, array $data ) => $this->set_component_overridable_props( $document, $data ), 10, 2 );
46	add_filter( 'elementor/global_classes/additional_post_types', fn( $post_types ) => array_merge( $post_types, [ Component_Document::TYPE ] ) );
47
48	add_action( 'elementor/atomic-widgets/settings/transformers/register', fn ( $transformers ) => $this->register_settings_transformers( $transformers ) );
49
50	( Component_Lock_Manager::get_instance()->register_hooks() );
51	( new Component_Styles() )->register_hooks();
52	( new Components_REST_API() )->register_hooks();
53	}
54
55	public function is_experiment_active() {
56	return Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_NAME )
57	&& Plugin::$instance->experiments->is_feature_active( AtomicWidgetsModule::EXPERIMENT_NAME );
58	}
59
60	public static function get_experimental_data() {
61	return [
62	'name' => self::EXPERIMENT_NAME,
63	'title' => esc_html__( 'Components', 'elementor' ),
64	'description' => esc_html__( 'Enable components.', 'elementor' ),
65	'hidden' => true,
66	'default' => Experiments_Manager::STATE_ACTIVE,
67	'release_status' => Experiments_Manager::RELEASE_STATUS_BETA,
68	];
69	}
70
71	public function get_widgets() {
72	return [
73	'Component_Instance',
74	];
75	}
76
77	private function add_packages( $packages ) {
78	return array_merge( $packages, self::PACKAGES );
79	}
80
81	private function modify_props_schema( array $schema ) {
82	return Overridable_Schema_Extender::make()->get_extended_schema( $schema );
83	}
84
85	private function register_component_post_type() {
86	register_post_type( Component_Document::TYPE, [
87	'label' => Component_Document::get_title(),
88	'labels' => Component_Document::get_labels(),
89	'public' => false,
90	'supports' => Component_Document::get_supported_features(),
91	] );
92	}
93
94	private function register_document_type( $documents_manager ) {
95	$documents_manager->register_document_type(
96	Component_Document::TYPE,
97	Component_Document::get_class_full_name()
98	);
99	}
100
101	private function validate_circular_dependencies( Document $document, array $data ) {
102	if ( ! $document instanceof Component_Document ) {
103	return;
104	}
105
106	if ( ! isset( $data['elements'] ) ) {
107	return;
108	}
109
110	$component_id = $document->get_main_id();
111	$elements = $data['elements'];
112
113	$result = Circular_Dependency_Validator::make()->validate( $component_id, $elements );
114
115	if ( ! $result['success'] ) {
116	throw new \Exception( esc_html__( "Can't add this component - components that contain each other can't be nested.", 'elementor' ) );
117	}
118	}
119
120	private function set_component_overridable_props( Document $document, array $data ) {
121	if ( ! isset( $data['settings'] ) ) {
122	return;
123	}
124	if ( ( ! $document instanceof Component_Document ) \|\|
125	( ! isset( $data['settings']['overridable_props'] ) )
126	) {
127	return;
128	}
129
130	if ( ! Components_Access_Controller::can_edit() ) {
131	throw new \Exception( esc_html__( 'You do not have permission to edit component source.', 'elementor' ) );
132	}
133
134	/* @var Component_Document $document */
135	$result = $document->update_overridable_props( $data['settings']['overridable_props'] );
136
137	if ( ! $result->is_valid() ) {
138	throw new \Exception( esc_html( 'Settings validation failed for component overridable props: ' . $result->errors()->to_string() ) );
139	}
140	}
141
142	private function register_settings_transformers( Transformers_Registry $transformers ) {
143	$transformers->register( Component_Instance_Prop_Type::get_key(), new Component_Instance_Transformer() );
144	$transformers->register( Overridable_Prop_Type::get_key(), new Overridable_Transformer() );
145	$transformers->register( Override_Prop_Type::get_key(), new Override_Transformer() );
146	}
147	}
148