admin-templates
1 year ago
base
1 year ago
container
1 year ago
controls
1 year ago
editor-templates
1 year ago
elements
1 year ago
interfaces
1 year ago
libraries
1 year ago
managers
1 year ago
settings
1 year ago
template-library
1 year ago
widgets
1 year ago
api.php
2 years ago
autoloader.php
1 year ago
beta-testers.php
3 years ago
compatibility.php
1 year ago
conditions.php
3 years ago
db.php
2 years ago
editor-assets-api.php
1 year ago
embed.php
1 year ago
fonts.php
1 year ago
frontend.php
1 year ago
heartbeat.php
3 years ago
maintenance-mode.php
2 years ago
maintenance.php
3 years ago
plugin.php
1 year ago
preview.php
1 year ago
rollback.php
3 years ago
shapes.php
1 year ago
stylesheet.php
1 year ago
tracker.php
2 years ago
user.php
2 years ago
utils.php
1 year ago
autoloader.php
342 lines
| 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 | 'Has_Validation' => 'includes/interfaces/has-validation.php', |
| 132 | 'Heartbeat' => 'includes/heartbeat.php', |
| 133 | 'Images_Manager' => 'includes/managers/image.php', |
| 134 | 'Maintenance' => 'includes/maintenance.php', |
| 135 | 'Maintenance_Mode' => 'includes/maintenance-mode.php', |
| 136 | 'Preview' => 'includes/preview.php', |
| 137 | 'Rollback' => 'includes/rollback.php', |
| 138 | 'Settings' => 'includes/settings/settings.php', |
| 139 | 'Settings_Controls' => 'includes/settings/controls.php', |
| 140 | 'Settings_Validations' => 'includes/settings/validations.php', |
| 141 | 'Settings_Page' => 'includes/settings/settings-page.php', |
| 142 | 'Shapes' => 'includes/shapes.php', |
| 143 | 'Skins_Manager' => 'includes/managers/skins.php', |
| 144 | 'Icons_Manager' => 'includes/managers/icons.php', |
| 145 | 'Stylesheet' => 'includes/stylesheet.php', |
| 146 | 'System_Info\Main' => 'includes/settings/system-info/main.php', |
| 147 | 'TemplateLibrary\Classes\Import_Images' => 'includes/template-library/classes/class-import-images.php', |
| 148 | 'TemplateLibrary\Forms\New_Template_Form' => 'includes/template-library/forms/new-template-form.php', |
| 149 | 'TemplateLibrary\Manager' => 'includes/template-library/manager.php', |
| 150 | 'TemplateLibrary\Source_Base' => 'includes/template-library/sources/base.php', |
| 151 | 'TemplateLibrary\Source_Local' => 'includes/template-library/sources/local.php', |
| 152 | 'TemplateLibrary\Source_Remote' => 'includes/template-library/sources/remote.php', |
| 153 | 'Tools' => 'includes/settings/tools.php', |
| 154 | 'Container\Container' => 'includes/container/container.php', |
| 155 | 'Tracker' => 'includes/tracker.php', |
| 156 | 'User' => 'includes/user.php', |
| 157 | 'Utils' => 'includes/utils.php', |
| 158 | 'Widget_WordPress' => 'includes/widgets/wordpress.php', |
| 159 | 'Widgets_Manager' => 'includes/managers/widgets.php', |
| 160 | 'WordPress_Widgets_Manager' => 'includes/managers/wordpress-widgets.php', |
| 161 | ]; |
| 162 | |
| 163 | $controls_names = Controls_Manager::get_controls_names(); |
| 164 | |
| 165 | $controls_names = array_merge( $controls_names, [ |
| 166 | 'base_multiple', |
| 167 | 'base_units', |
| 168 | ] ); |
| 169 | |
| 170 | foreach ( $controls_names as $control_name ) { |
| 171 | $class_name = 'Control_' . self::normalize_class_name( $control_name, '_' ); |
| 172 | |
| 173 | self::$classes_map[ $class_name ] = 'includes/controls/' . str_replace( '_', '-', $control_name ) . '.php'; |
| 174 | } |
| 175 | |
| 176 | $controls_groups_names = Controls_Manager::get_groups_names(); |
| 177 | |
| 178 | foreach ( $controls_groups_names as $group_name ) { |
| 179 | $class_name = 'Group_Control_' . self::normalize_class_name( $group_name, '_' ); |
| 180 | |
| 181 | self::$classes_map[ $class_name ] = 'includes/controls/groups/' . $group_name . '.php'; |
| 182 | } |
| 183 | } |
| 184 | |
| 185 | /** |
| 186 | * Normalize Class Name |
| 187 | * |
| 188 | * Used to convert control names to class names. |
| 189 | * |
| 190 | * @param $string |
| 191 | * @param string $delimiter |
| 192 | * |
| 193 | * @return mixed |
| 194 | */ |
| 195 | private static function normalize_class_name( $string, $delimiter = ' ' ) { |
| 196 | return ucwords( str_replace( '-', '_', $string ), $delimiter ); |
| 197 | } |
| 198 | |
| 199 | /** |
| 200 | * Init classes aliases. |
| 201 | * |
| 202 | * When Elementor classes renamed or moved to different folders, developers |
| 203 | * can still use the old names by setting an alias. |
| 204 | * |
| 205 | * While in deprecation period both classes will work. When the deprecation |
| 206 | * period ends, the alies should be removed from the list of aliases. |
| 207 | * |
| 208 | * Usage: |
| 209 | * |
| 210 | * self::$classes_aliases = [ |
| 211 | * 'Namespace\OldClassName' => [ |
| 212 | * 'replacement' => 'Namespace\NewClassName', |
| 213 | * 'version' => '3.0.0', |
| 214 | * ], |
| 215 | * 'Namespace\OldModule\ClassName' => [ |
| 216 | * 'replacement' => 'Namespace\NewModule\ClassName', |
| 217 | * 'version' => '3.5.0', |
| 218 | * ], |
| 219 | * ]; |
| 220 | * |
| 221 | * @access private |
| 222 | * @static |
| 223 | * |
| 224 | * @return void |
| 225 | */ |
| 226 | private static function init_classes_aliases() { |
| 227 | self::$classes_aliases = [ |
| 228 | 'System_Info\Main' => [ |
| 229 | 'replacement' => 'Modules\System_Info\Module', |
| 230 | 'version' => '2.9.0', |
| 231 | ], |
| 232 | 'System_Info\Classes\Abstracts\Base_Reporter' => [ |
| 233 | 'replacement' => 'Modules\System_Info\Reporters\Base', |
| 234 | 'version' => '2.9.0', |
| 235 | ], |
| 236 | 'System_Info\Classes\Server_Reporter' => [ |
| 237 | 'replacement' => 'Modules\System_Info\Reporters\Server', |
| 238 | 'version' => '2.9.0', |
| 239 | ], |
| 240 | 'System_Info\Classes\MU_Plugins_Reporter' => [ |
| 241 | 'replacement' => 'Modules\System_Info\Reporters\MU_Plugins', |
| 242 | 'version' => '2.9.0', |
| 243 | ], |
| 244 | 'System_Info\Classes\Network_Plugins_Reporter' => [ |
| 245 | 'replacement' => 'Modules\System_Info\Reporters\Network_Plugins', |
| 246 | 'version' => '2.9.0', |
| 247 | ], |
| 248 | 'System_Info\Classes\Plugins_Reporter' => [ |
| 249 | 'replacement' => 'Modules\System_Info\Reporters\Plugins', |
| 250 | 'version' => '2.9.0', |
| 251 | ], |
| 252 | 'System_Info\Classes\Theme_Reporter' => [ |
| 253 | 'replacement' => 'Modules\System_Info\Reporters\Theme', |
| 254 | 'version' => '2.9.0', |
| 255 | ], |
| 256 | 'System_Info\Classes\User_Reporter' => [ |
| 257 | 'replacement' => 'Modules\System_Info\Reporters\User', |
| 258 | 'version' => '2.9.0', |
| 259 | ], |
| 260 | 'System_Info\Helpers\Model_Helper' => [ |
| 261 | 'replacement' => 'Modules\System_Info\Helpers\Model_Helper', |
| 262 | 'version' => '2.9.0', |
| 263 | ], |
| 264 | ]; |
| 265 | } |
| 266 | |
| 267 | /** |
| 268 | * Load class. |
| 269 | * |
| 270 | * For a given class name, require the class file. |
| 271 | * |
| 272 | * @since 1.6.0 |
| 273 | * @access private |
| 274 | * @static |
| 275 | * |
| 276 | * @param string $relative_class_name Class name. |
| 277 | */ |
| 278 | private static function load_class( $relative_class_name ) { |
| 279 | $classes_map = self::get_classes_map(); |
| 280 | |
| 281 | if ( isset( $classes_map[ $relative_class_name ] ) ) { |
| 282 | $filename = self::$default_path . '/' . $classes_map[ $relative_class_name ]; |
| 283 | } else { |
| 284 | $filename = strtolower( |
| 285 | preg_replace( |
| 286 | [ '/([a-z])([A-Z])/', '/_/', '/\\\/' ], |
| 287 | [ '$1-$2', '-', DIRECTORY_SEPARATOR ], |
| 288 | $relative_class_name |
| 289 | ) |
| 290 | ); |
| 291 | |
| 292 | $filename = self::$default_path . $filename . '.php'; |
| 293 | } |
| 294 | |
| 295 | if ( is_readable( $filename ) ) { |
| 296 | require $filename; |
| 297 | } |
| 298 | } |
| 299 | |
| 300 | /** |
| 301 | * Autoload. |
| 302 | * |
| 303 | * For a given class, check if it exist and load it. |
| 304 | * |
| 305 | * @since 1.6.0 |
| 306 | * @access private |
| 307 | * @static |
| 308 | * |
| 309 | * @param string $class Class name. |
| 310 | */ |
| 311 | private static function autoload( $class ) { |
| 312 | if ( 0 !== strpos( $class, self::$default_namespace . '\\' ) ) { |
| 313 | return; |
| 314 | } |
| 315 | |
| 316 | $relative_class_name = preg_replace( '/^' . self::$default_namespace . '\\\/', '', $class ); |
| 317 | |
| 318 | $classes_aliases = self::get_classes_aliases(); |
| 319 | |
| 320 | $has_class_alias = isset( $classes_aliases[ $relative_class_name ] ); |
| 321 | |
| 322 | // Backward Compatibility: Save old class name for set an alias after the new class is loaded |
| 323 | if ( $has_class_alias ) { |
| 324 | $alias_data = $classes_aliases[ $relative_class_name ]; |
| 325 | |
| 326 | $relative_class_name = $alias_data['replacement']; |
| 327 | } |
| 328 | |
| 329 | $final_class_name = self::$default_namespace . '\\' . $relative_class_name; |
| 330 | |
| 331 | if ( ! class_exists( $final_class_name ) ) { |
| 332 | self::load_class( $relative_class_name ); |
| 333 | } |
| 334 | |
| 335 | if ( $has_class_alias ) { |
| 336 | class_alias( $final_class_name, $class ); |
| 337 | |
| 338 | Utils::handle_deprecation( $class, $alias_data['version'], $final_class_name ); |
| 339 | } |
| 340 | } |
| 341 | } |
| 342 |