elementor / includes / autoloader.php

autoloader.php in Elementor Website Builder – more than just a page builder 3.1.0-beta1, at includes/autoloader.php

312 lines 8.6 KB

Raw Download Zip

1	<?php
2	namespace Elementor;
3
4	if ( ! defined( 'ABSPATH' ) ) {
5	exit; // Exit if accessed directly.
6	}
7
8	/**
9	* Elementor autoloader.
10	*
11	* Elementor autoloader handler class is responsible for loading the different
12	* classes needed to run the plugin.
13	*
14	* @since 1.6.0
15	*/
16	class Autoloader {
17
18	/**
19	* Classes map.
20	*
21	* Maps Elementor classes to file names.
22	*
23	* @since 1.6.0
24	* @access private
25	* @static
26	*
27	* @var array Classes used by elementor.
28	*/
29	private static $classes_map;
30
31	/**
32	* Classes aliases.
33	*
34	* Maps Elementor classes to aliases.
35	*
36	* @since 1.6.0
37	* @access private
38	* @static
39	*
40	* @var array Classes aliases.
41	*/
42	private static $classes_aliases;
43
44	/**
45	* Run autoloader.
46	*
47	* Register a function as `__autoload()` implementation.
48	*
49	* @since 1.6.0
50	* @access public
51	* @static
52	*/
53	public static function run() {
54	spl_autoload_register( [ __CLASS__, 'autoload' ] );
55	}
56
57	/**
58	* Get classes aliases.
59	*
60	* Retrieve the classes aliases names.
61	*
62	* @since 1.6.0
63	* @access public
64	* @static
65	*
66	* @return array Classes aliases.
67	*/
68	public static function get_classes_aliases() {
69	if ( ! self::$classes_aliases ) {
70	self::init_classes_aliases();
71	}
72
73	return self::$classes_aliases;
74	}
75
76	public static function get_classes_map() {
77	if ( ! self::$classes_map ) {
78	self::init_classes_map();
79	}
80
81	return self::$classes_map;
82	}
83
84	private static function init_classes_map() {
85	self::$classes_map = [
86	'Api' => 'includes/api.php',
87	'Base_Control' => 'includes/controls/base.php',
88	'Base_Data_Control' => 'includes/controls/base-data.php',
89	'Base_UI_Control' => 'includes/controls/base-ui.php',
90	'Beta_Testers' => 'includes/beta-testers.php',
91	'Compatibility' => 'includes/compatibility.php',
92	'Conditions' => 'includes/conditions.php',
93	'Controls_Manager' => 'includes/managers/controls.php',
94	'Controls_Stack' => 'includes/base/controls-stack.php',
95	'Sub_Controls_Stack' => 'includes/base/sub-controls-stack.php',
96	'DB' => 'includes/db.php',
97	'Elements_Manager' => 'includes/managers/elements.php',
98	'Embed' => 'includes/embed.php',
99	'Fonts' => 'includes/fonts.php',
100	'Frontend' => 'includes/frontend.php',
101	'Group_Control_Base' => 'includes/controls/groups/base.php',
102	'Group_Control_Interface' => 'includes/interfaces/group-control.php',
103	'Heartbeat' => 'includes/heartbeat.php',
104	'Images_Manager' => 'includes/managers/image.php',
105	'Maintenance' => 'includes/maintenance.php',
106	'Maintenance_Mode' => 'includes/maintenance-mode.php',
107	'Preview' => 'includes/preview.php',
108	'Rollback' => 'includes/rollback.php',
109	'Settings' => 'includes/settings/settings.php',
110	'Settings_Controls' => 'includes/settings/controls.php',
111	'Settings_Validations' => 'includes/settings/validations.php',
112	'Settings_Page' => 'includes/settings/settings-page.php',
113	'Shapes' => 'includes/shapes.php',
114	'Skins_Manager' => 'includes/managers/skins.php',
115	'Icons_Manager' => 'includes/managers/icons.php',
116	'Stylesheet' => 'includes/stylesheet.php',
117	'System_Info\Main' => 'includes/settings/system-info/main.php',
118	'TemplateLibrary\Classes\Import_Images' => 'includes/template-library/classes/class-import-images.php',
119	'TemplateLibrary\Manager' => 'includes/template-library/manager.php',
120	'TemplateLibrary\Source_Base' => 'includes/template-library/sources/base.php',
121	'TemplateLibrary\Source_Local' => 'includes/template-library/sources/local.php',
122	'TemplateLibrary\Source_Remote' => 'includes/template-library/sources/remote.php',
123	'Tools' => 'includes/settings/tools.php',
124	'Tracker' => 'includes/tracker.php',
125	'User' => 'includes/user.php',
126	'Utils' => 'includes/utils.php',
127	'Widget_WordPress' => 'includes/widgets/wordpress.php',
128	'Widgets_Manager' => 'includes/managers/widgets.php',
129	'WordPress_Widgets_Manager' => 'includes/managers/wordpress-widgets.php',
130	];
131
132	$controls_names = Controls_Manager::get_controls_names();
133
134	$controls_names = array_merge( $controls_names, [
135	'base_multiple',
136	'base_units',
137	] );
138
139	foreach ( $controls_names as $control_name ) {
140	$class_name = 'Control_' . self::normalize_class_name( $control_name, '_' );
141
142	self::$classes_map[ $class_name ] = 'includes/controls/' . str_replace( '_', '-', $control_name ) . '.php';
143	}
144
145	$controls_groups_names = Controls_Manager::get_groups_names();
146
147	foreach ( $controls_groups_names as $group_name ) {
148	$class_name = 'Group_Control_' . self::normalize_class_name( $group_name, '_' );
149
150	self::$classes_map[ $class_name ] = 'includes/controls/groups/' . $group_name . '.php';
151	}
152	}
153
154	/**
155	* Normalize Class Name
156	*
157	* Used to convert control names to class names.
158	*
159	* @param $string
160	* @param string $delimiter
161	*
162	* @return mixed
163	*/
164	private static function normalize_class_name( $string, $delimiter = ' ' ) {
165	return ucwords( str_replace( '-', '_', $string ), $delimiter );
166	}
167
168	private static function init_classes_aliases() {
169	self::$classes_aliases = [
170	'Core\Ajax' => [
171	'replacement' => 'Core\Common\Modules\Ajax\Module',
172	'version' => '2.3.0',
173	],
174	'Editor' => [
175	'replacement' => 'Core\Editor\Editor',
176	'version' => '2.6.0',
177	],
178	'Scheme_Base' => [
179	'replacement' => 'Core\Schemes\Base',
180	'version' => '2.8.0',
181	],
182	'Scheme_Color' => [
183	'replacement' => 'Core\Schemes\Color',
184	'version' => '2.8.0',
185	],
186	'Scheme_Color_Picker' => [
187	'replacement' => 'Core\Schemes\Color_Picker',
188	'version' => '2.8.0',
189	],
190	'Schemes_Manager' => [
191	'replacement' => 'Core\Schemes\Manager',
192	'version' => '2.8.0',
193	],
194	'Scheme_Typography' => [
195	'replacement' => 'Core\Schemes\Typography',
196	'version' => '2.8.0',
197	],
198	'System_Info\Main' => [
199	'replacement' => 'Modules\System_Info\Module',
200	'version' => '2.9.0',
201	],
202	'System_Info\Classes\Abstracts\Base_Reporter' => [
203	'replacement' => 'Modules\System_Info\Reporters\Base',
204	'version' => '2.9.0',
205	],
206	'System_Info\Classes\Server_Reporter' => [
207	'replacement' => 'Modules\System_Info\Reporters\Server',
208	'version' => '2.9.0',
209	],
210	'System_Info\Classes\MU_Plugins_Reporter' => [
211	'replacement' => 'Modules\System_Info\Reporters\MU_Plugins',
212	'version' => '2.9.0',
213	],
214	'System_Info\Classes\Network_Plugins_Reporter' => [
215	'replacement' => 'Modules\System_Info\Reporters\Network_Plugins',
216	'version' => '2.9.0',
217	],
218	'System_Info\Classes\Plugins_Reporter' => [
219	'replacement' => 'Modules\System_Info\Reporters\Plugins',
220	'version' => '2.9.0',
221	],
222	'System_Info\Classes\Theme_Reporter' => [
223	'replacement' => 'Modules\System_Info\Reporters\Theme',
224	'version' => '2.9.0',
225	],
226	'System_Info\Classes\User_Reporter' => [
227	'replacement' => 'Modules\System_Info\Reporters\User',
228	'version' => '2.9.0',
229	],
230	'System_Info\Helpers\Model_Helper' => [
231	'replacement' => 'Modules\System_Info\Helpers\Model_Helper',
232	'version' => '2.9.0',
233	],
234	];
235	}
236
237	/**
238	* Load class.
239	*
240	* For a given class name, require the class file.
241	*
242	* @since 1.6.0
243	* @access private
244	* @static
245	*
246	* @param string $relative_class_name Class name.
247	*/
248	private static function load_class( $relative_class_name ) {
249	$classes_map = self::get_classes_map();
250
251	if ( isset( $classes_map[ $relative_class_name ] ) ) {
252	$filename = ELEMENTOR_PATH . '/' . $classes_map[ $relative_class_name ];
253	} else {
254	$filename = strtolower(
255	preg_replace(
256	[ '/([a-z])([A-Z])/', '/_/', '/\\\/' ],
257	[ '$1-$2', '-', DIRECTORY_SEPARATOR ],
258	$relative_class_name
259	)
260	);
261
262	$filename = ELEMENTOR_PATH . $filename . '.php';
263	}
264
265	if ( is_readable( $filename ) ) {
266	require $filename;
267	}
268	}
269
270	/**
271	* Autoload.
272	*
273	* For a given class, check if it exist and load it.
274	*
275	* @since 1.6.0
276	* @access private
277	* @static
278	*
279	* @param string $class Class name.
280	*/
281	private static function autoload( $class ) {
282	if ( 0 !== strpos( $class, __NAMESPACE__ . '\\' ) ) {
283	return;
284	}
285
286	$relative_class_name = preg_replace( '/^' . __NAMESPACE__ . '\\\/', '', $class );
287
288	$classes_aliases = self::get_classes_aliases();
289
290	$has_class_alias = isset( $classes_aliases[ $relative_class_name ] );
291
292	// Backward Compatibility: Save old class name for set an alias after the new class is loaded
293	if ( $has_class_alias ) {
294	$alias_data = $classes_aliases[ $relative_class_name ];
295
296	$relative_class_name = $alias_data['replacement'];
297	}
298
299	$final_class_name = __NAMESPACE__ . '\\' . $relative_class_name;
300
301	if ( ! class_exists( $final_class_name ) ) {
302	self::load_class( $relative_class_name );
303	}
304
305	if ( $has_class_alias ) {
306	class_alias( $final_class_name, $class );
307
308	Utils::handle_deprecation( $class, $alias_data['version'], $final_class_name );
309	}
310	}
311	}
312