elementor / includes / autoloader.php

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

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