elementor / includes / autoloader.php

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

315 lines 8.9 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( str_replace( '-', '_', $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 name,
158	* a ucwords polyfill for php versions not supporting delimiter parameter
159	* reference : https://github.com/elementor/elementor/issues/7310#issuecomment-469593385
160	*
161	* @param $string
162	* @param string $delimiter
163	*
164	* @todo Remove once we bump minimum php version to 5.6
165	* @return mixed
166	*/
167	private static function normalize_class_name( $string, $delimiter = ' ' ) {
168	return str_replace( ' ', $delimiter, ucwords( str_replace( $delimiter, ' ', $string ) ) );
169	}
170
171	private static function init_classes_aliases() {
172	self::$classes_aliases = [
173	'Core\Ajax' => [
174	'replacement' => 'Core\Common\Modules\Ajax\Module',
175	'version' => '2.3.0',
176	],
177	'Editor' => [
178	'replacement' => 'Core\Editor\Editor',
179	'version' => '2.6.0',
180	],
181	'Scheme_Base' => [
182	'replacement' => 'Core\Schemes\Base',
183	'version' => '2.8.0',
184	],
185	'Scheme_Color' => [
186	'replacement' => 'Core\Schemes\Color',
187	'version' => '2.8.0',
188	],
189	'Scheme_Color_Picker' => [
190	'replacement' => 'Core\Schemes\Color_Picker',
191	'version' => '2.8.0',
192	],
193	'Schemes_Manager' => [
194	'replacement' => 'Core\Schemes\Manager',
195	'version' => '2.8.0',
196	],
197	'Scheme_Typography' => [
198	'replacement' => 'Core\Schemes\Typography',
199	'version' => '2.8.0',
200	],
201	'System_Info\Main' => [
202	'replacement' => 'Modules\System_Info\Module',
203	'version' => '2.9.0',
204	],
205	'System_Info\Classes\Abstracts\Base_Reporter' => [
206	'replacement' => 'Modules\System_Info\Reporters\Base',
207	'version' => '2.9.0',
208	],
209	'System_Info\Classes\Server_Reporter' => [
210	'replacement' => 'Modules\System_Info\Reporters\Server',
211	'version' => '2.9.0',
212	],
213	'System_Info\Classes\MU_Plugins_Reporter' => [
214	'replacement' => 'Modules\System_Info\Reporters\MU_Plugins',
215	'version' => '2.9.0',
216	],
217	'System_Info\Classes\Network_Plugins_Reporter' => [
218	'replacement' => 'Modules\System_Info\Reporters\Network_Plugins',
219	'version' => '2.9.0',
220	],
221	'System_Info\Classes\Plugins_Reporter' => [
222	'replacement' => 'Modules\System_Info\Reporters\Plugins',
223	'version' => '2.9.0',
224	],
225	'System_Info\Classes\Theme_Reporter' => [
226	'replacement' => 'Modules\System_Info\Reporters\Theme',
227	'version' => '2.9.0',
228	],
229	'System_Info\Classes\User_Reporter' => [
230	'replacement' => 'Modules\System_Info\Reporters\User',
231	'version' => '2.9.0',
232	],
233	'System_Info\Helpers\Model_Helper' => [
234	'replacement' => 'Modules\System_Info\Helpers\Model_Helper',
235	'version' => '2.9.0',
236	],
237	];
238	}
239
240	/**
241	* Load class.
242	*
243	* For a given class name, require the class file.
244	*
245	* @since 1.6.0
246	* @access private
247	* @static
248	*
249	* @param string $relative_class_name Class name.
250	*/
251	private static function load_class( $relative_class_name ) {
252	$classes_map = self::get_classes_map();
253
254	if ( isset( $classes_map[ $relative_class_name ] ) ) {
255	$filename = ELEMENTOR_PATH . '/' . $classes_map[ $relative_class_name ];
256	} else {
257	$filename = strtolower(
258	preg_replace(
259	[ '/([a-z])([A-Z])/', '/_/', '/\\\/' ],
260	[ '$1-$2', '-', DIRECTORY_SEPARATOR ],
261	$relative_class_name
262	)
263	);
264
265	$filename = ELEMENTOR_PATH . $filename . '.php';
266	}
267
268	if ( is_readable( $filename ) ) {
269	require $filename;
270	}
271	}
272
273	/**
274	* Autoload.
275	*
276	* For a given class, check if it exist and load it.
277	*
278	* @since 1.6.0
279	* @access private
280	* @static
281	*
282	* @param string $class Class name.
283	*/
284	private static function autoload( $class ) {
285	if ( 0 !== strpos( $class, __NAMESPACE__ . '\\' ) ) {
286	return;
287	}
288
289	$relative_class_name = preg_replace( '/^' . __NAMESPACE__ . '\\\/', '', $class );
290
291	$classes_aliases = self::get_classes_aliases();
292
293	$has_class_alias = isset( $classes_aliases[ $relative_class_name ] );
294
295	// Backward Compatibility: Save old class name for set an alias after the new class is loaded
296	if ( $has_class_alias ) {
297	$alias_data = $classes_aliases[ $relative_class_name ];
298
299	$relative_class_name = $alias_data['replacement'];
300	}
301
302	$final_class_name = __NAMESPACE__ . '\\' . $relative_class_name;
303
304	if ( ! class_exists( $final_class_name ) ) {
305	self::load_class( $relative_class_name );
306	}
307
308	if ( $has_class_alias ) {
309	class_alias( $final_class_name, $class );
310
311	Utils::handle_deprecation( $class, $alias_data['version'], $final_class_name );
312	}
313	}
314	}
315