autoloader.php 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258
  1. <?php
  2. namespace Elementor;
  3. if ( ! defined( 'ABSPATH' ) ) {
  4. exit; // Exit if accessed directly.
  5. }
  6. /**
  7. * Elementor autoloader.
  8. *
  9. * Elementor autoloader handler class is responsible for loading the different
  10. * classes needed to run the plugin.
  11. *
  12. * @since 1.6.0
  13. */
  14. class Autoloader {
  15. const ALIASES_DEPRECATION_RANGE = 0.2;
  16. /**
  17. * Classes map.
  18. *
  19. * Maps Elementor classes to file names.
  20. *
  21. * @since 1.6.0
  22. * @access private
  23. * @static
  24. *
  25. * @var array Classes used by elementor.
  26. */
  27. private static $classes_map = [
  28. 'Admin' => 'includes/admin.php',
  29. 'Api' => 'includes/api.php',
  30. 'Base_Control' => 'includes/controls/base.php',
  31. 'Base_Data_Control' => 'includes/controls/base-data.php',
  32. 'Base_UI_Control' => 'includes/controls/base-ui.php',
  33. 'Beta_Testers' => 'includes/beta-testers.php',
  34. 'Compatibility' => 'includes/compatibility.php',
  35. 'Conditions' => 'includes/conditions.php',
  36. 'Control_Base_Multiple' => 'includes/controls/base-multiple.php',
  37. 'Control_Base_Units' => 'includes/controls/base-units.php',
  38. 'Controls_Manager' => 'includes/managers/controls.php',
  39. 'Controls_Stack' => 'includes/base/controls-stack.php',
  40. 'DB' => 'includes/db.php',
  41. 'Debug\Debug' => 'includes/debug/debug.php',
  42. 'Editor' => 'includes/editor.php',
  43. 'Elements_Manager' => 'includes/managers/elements.php',
  44. 'Embed' => 'includes/embed.php',
  45. 'Fonts' => 'includes/fonts.php',
  46. 'Frontend' => 'includes/frontend.php',
  47. 'Group_Control_Background' => 'includes/controls/groups/background.php',
  48. 'Group_Control_Base' => 'includes/controls/groups/base.php',
  49. 'Group_Control_Border' => 'includes/controls/groups/border.php',
  50. 'Group_Control_Box_Shadow' => 'includes/controls/groups/box-shadow.php',
  51. 'Group_Control_Css_Filter' => 'includes/controls/groups/css-filter.php',
  52. 'Group_Control_Image_Size' => 'includes/controls/groups/image-size.php',
  53. 'Group_Control_Interface' => 'includes/interfaces/group-control.php',
  54. 'Group_Control_Text_Shadow' => 'includes/controls/groups/text-shadow.php',
  55. 'Group_Control_Typography' => 'includes/controls/groups/typography.php',
  56. 'Heartbeat' => 'includes/heartbeat.php',
  57. 'Images_Manager' => 'includes/managers/image.php',
  58. 'Maintenance' => 'includes/maintenance.php',
  59. 'Maintenance_Mode' => 'includes/maintenance-mode.php',
  60. 'Posts_CSS_Manager' => 'includes/managers/css-files.php',
  61. 'Preview' => 'includes/preview.php',
  62. 'Rollback' => 'includes/rollback.php',
  63. 'Scheme_Base' => 'includes/schemes/base.php',
  64. 'Scheme_Color' => 'includes/schemes/color.php',
  65. 'Scheme_Color_Picker' => 'includes/schemes/color-picker.php',
  66. 'Scheme_Typography' => 'includes/schemes/typography.php',
  67. 'Scheme_Interface' => 'includes/interfaces/scheme.php',
  68. 'Schemes_Manager' => 'includes/managers/schemes.php',
  69. 'Settings' => 'includes/settings/settings.php',
  70. 'Settings_Controls' => 'includes/settings/controls.php',
  71. 'Settings_Validations' => 'includes/settings/validations.php',
  72. 'Settings_Page' => 'includes/settings/settings-page.php',
  73. 'Shapes' => 'includes/shapes.php',
  74. 'Skins_Manager' => 'includes/managers/skins.php',
  75. 'Stylesheet' => 'includes/stylesheet.php',
  76. 'System_Info\Main' => 'includes/settings/system-info/main.php',
  77. 'TemplateLibrary\Classes\Import_Images' => 'includes/template-library/classes/class-import-images.php',
  78. 'TemplateLibrary\Manager' => 'includes/template-library/manager.php',
  79. 'TemplateLibrary\Source_Base' => 'includes/template-library/sources/base.php',
  80. 'TemplateLibrary\Source_Local' => 'includes/template-library/sources/local.php',
  81. 'TemplateLibrary\Source_Remote' => 'includes/template-library/sources/remote.php',
  82. 'Tools' => 'includes/settings/tools.php',
  83. 'Tracker' => 'includes/tracker.php',
  84. 'Upgrades' => 'includes/upgrades.php',
  85. 'User' => 'includes/user.php',
  86. 'Utils' => 'includes/utils.php',
  87. 'Widget_WordPress' => 'includes/widgets/wordpress.php',
  88. 'Widgets_Manager' => 'includes/managers/widgets.php',
  89. 'WordPress_Widgets_Manager' => 'includes/managers/wordpress-widgets.php',
  90. ];
  91. /**
  92. * Classes aliases.
  93. *
  94. * Maps Elementor classes to aliases.
  95. *
  96. * @since 1.6.0
  97. * @access private
  98. * @static
  99. *
  100. * @var array Classes aliases.
  101. */
  102. private static $classes_aliases = [
  103. 'Control_Base' => [
  104. 'replacement' => 'Base_Data_Control',
  105. 'version' => '1.6.0',
  106. ],
  107. 'PageSettings\Manager' => [
  108. 'replacement' => 'Core\Settings\Page\Manager',
  109. 'version' => '1.6.0',
  110. ],
  111. 'Revisions_Manager' => [
  112. 'replacement' => 'Modules\History\Revisions_Manager',
  113. 'version' => '1.7.0',
  114. ],
  115. 'CSS_File' => [
  116. 'replacement' => 'Core\Files\CSS\Base',
  117. 'version' => '2.1.0',
  118. ],
  119. 'Global_CSS_File' => [
  120. 'replacement' => 'Core\Files\CSS\Global_CSS',
  121. 'version' => '2.1.0',
  122. ],
  123. 'Post_CSS_File' => [
  124. 'replacement' => 'Core\Files\CSS\Post',
  125. 'version' => '2.1.0',
  126. ],
  127. 'Posts_CSS_Manager' => [
  128. 'replacement' => 'Core\Files\Manager',
  129. 'version' => '2.1.0',
  130. ],
  131. 'Post_Preview_CSS' => [
  132. 'replacement' => 'Core\Files\CSS\Post_Preview',
  133. 'version' => '2.1.0',
  134. ],
  135. 'Responsive' => [
  136. 'replacement' => 'Core\Responsive\Responsive',
  137. 'version' => '2.1.0',
  138. ],
  139. 'Admin' => [
  140. 'replacement' => 'Core\Admin\Admin',
  141. 'version' => '2.2.0',
  142. ],
  143. ];
  144. /**
  145. * Run autoloader.
  146. *
  147. * Register a function as `__autoload()` implementation.
  148. *
  149. * @since 1.6.0
  150. * @access public
  151. * @static
  152. */
  153. public static function run() {
  154. spl_autoload_register( [ __CLASS__, 'autoload' ] );
  155. }
  156. /**
  157. * Get classes aliases.
  158. *
  159. * Retrieve the classes aliases names.
  160. *
  161. * @since 1.6.0
  162. * @access public
  163. * @static
  164. *
  165. * @return array Classes aliases.
  166. */
  167. public static function get_classes_aliases() {
  168. return self::$classes_aliases;
  169. }
  170. /**
  171. * Load class.
  172. *
  173. * For a given class name, require the class file.
  174. *
  175. * @since 1.6.0
  176. * @access private
  177. * @static
  178. *
  179. * @param string $relative_class_name Class name.
  180. */
  181. private static function load_class( $relative_class_name ) {
  182. if ( isset( self::$classes_map[ $relative_class_name ] ) ) {
  183. $filename = ELEMENTOR_PATH . '/' . self::$classes_map[ $relative_class_name ];
  184. } else {
  185. $filename = strtolower(
  186. preg_replace(
  187. [ '/([a-z])([A-Z])/', '/_/', '/\\\/' ],
  188. [ '$1-$2', '-', DIRECTORY_SEPARATOR ],
  189. $relative_class_name
  190. )
  191. );
  192. $filename = ELEMENTOR_PATH . $filename . '.php';
  193. }
  194. if ( is_readable( $filename ) ) {
  195. require $filename;
  196. }
  197. }
  198. /**
  199. * Autoload.
  200. *
  201. * For a given class, check if it exist and load it.
  202. *
  203. * @since 1.6.0
  204. * @access private
  205. * @static
  206. *
  207. * @param string $class Class name.
  208. */
  209. private static function autoload( $class ) {
  210. if ( 0 !== strpos( $class, __NAMESPACE__ . '\\' ) ) {
  211. return;
  212. }
  213. $relative_class_name = preg_replace( '/^' . __NAMESPACE__ . '\\\/', '', $class );
  214. $has_class_alias = isset( self::$classes_aliases[ $relative_class_name ] );
  215. // Backward Compatibility: Save old class name for set an alias after the new class is loaded
  216. if ( $has_class_alias ) {
  217. $alias_data = self::$classes_aliases[ $relative_class_name ];
  218. $relative_class_name = $alias_data['replacement'];
  219. }
  220. $final_class_name = __NAMESPACE__ . '\\' . $relative_class_name;
  221. if ( ! class_exists( $final_class_name ) ) {
  222. self::load_class( $relative_class_name );
  223. }
  224. if ( $has_class_alias ) {
  225. class_alias( $final_class_name, $class );
  226. preg_match( '/^[0-9]+\.[0-9]+/', ELEMENTOR_VERSION, $current_version_as_float );
  227. $current_version_as_float = (float) $current_version_as_float[0];
  228. preg_match( '/^[0-9]+\.[0-9]+/', $alias_data['version'], $alias_version_as_float );
  229. $alias_version_as_float = (float) $alias_version_as_float[0];
  230. if ( $current_version_as_float - $alias_version_as_float >= self::ALIASES_DEPRECATION_RANGE ) {
  231. _deprecated_file( $class, $alias_data['version'], $final_class_name );
  232. }
  233. }
  234. }
  235. }