plugin.php — Elementor Website Builder – more than just a page builder 3.27.1

elementor / includes / plugin.php

elementor / includes Last commit date

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 1 year 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 1 year 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 1 year ago user.php 2 years ago utils.php 1 year ago

plugin.php

890 lines

1	<?php
2	namespace Elementor;
3
4	use Elementor\Container\Container;
5	use ElementorDeps\DI\Container as DIContainer;
6	use Elementor\Core\Admin\Menu\Admin_Menu_Manager;
7	use Elementor\Core\Wp_Api;
8	use Elementor\Core\Admin\Admin;
9	use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
10	use Elementor\Core\Common\App as CommonApp;
11	use Elementor\Core\Debug\Inspector;
12	use Elementor\Core\Documents_Manager;
13	use Elementor\Core\Experiments\Manager as Experiments_Manager;
14	use Elementor\Core\Kits\Manager as Kits_Manager;
15	use Elementor\Core\Editor\Editor;
16	use Elementor\Core\Files\Manager as Files_Manager;
17	use Elementor\Core\Files\Assets\Manager as Assets_Manager;
18	use Elementor\Core\Modules_Manager;
19	use Elementor\Core\Settings\Manager as Settings_Manager;
20	use Elementor\Core\Settings\Page\Manager as Page_Settings_Manager;
21	use Elementor\Modules\History\Revisions_Manager;
22	use Elementor\Core\DynamicTags\Manager as Dynamic_Tags_Manager;
23	use Elementor\Core\Logger\Manager as Log_Manager;
24	use Elementor\Core\Page_Assets\Loader as Assets_Loader;
25	use Elementor\Modules\System_Info\Module as System_Info_Module;
26	use Elementor\Data\Manager as Data_Manager;
27	use Elementor\Data\V2\Manager as Data_Manager_V2;
28	use Elementor\Core\Common\Modules\DevTools\Module as Dev_Tools;
29	use Elementor\Core\Files\Uploads_Manager as Uploads_Manager;
30
31	if ( ! defined( 'ABSPATH' ) ) {
32	exit;
33	}
34
35	/**
36	* Elementor plugin.
37	*
38	* The main plugin handler class is responsible for initializing Elementor. The
39	* class registers and all the components required to run the plugin.
40	*
41	* @since 1.0.0
42	*/
43	class Plugin {
44	const ELEMENTOR_DEFAULT_POST_TYPES = [ 'page', 'post' ];
45
46	/**
47	* Instance.
48	*
49	* Holds the plugin instance.
50	*
51	* @since 1.0.0
52	* @access public
53	* @static
54	*
55	* @var Plugin
56	*/
57	public static $instance = null;
58
59	/**
60	* Database.
61	*
62	* Holds the plugin database handler which is responsible for communicating
63	* with the database.
64	*
65	* @since 1.0.0
66	* @access public
67	*
68	* @var DB
69	*/
70	public $db;
71
72	/**
73	* Controls manager.
74	*
75	* Holds the plugin controls manager handler is responsible for registering
76	* and initializing controls.
77	*
78	* @since 1.0.0
79	* @access public
80	*
81	* @var Controls_Manager
82	*/
83	public $controls_manager;
84
85	/**
86	* Documents manager.
87	*
88	* Holds the documents manager.
89	*
90	* @since 2.0.0
91	* @access public
92	*
93	* @var Documents_Manager
94	*/
95	public $documents;
96
97	/**
98	* Schemes manager.
99	*
100	* Holds the plugin schemes manager.
101	*
102	* @since 1.0.0
103	* @access public
104	* @deprecated 3.0.0
105	*
106	* @var Schemes_Manager
107	*/
108	public $schemes_manager;
109
110	/**
111	* Elements manager.
112	*
113	* Holds the plugin elements manager.
114	*
115	* @since 1.0.0
116	* @access public
117	*
118	* @var Elements_Manager
119	*/
120	public $elements_manager;
121
122	/**
123	* Widgets manager.
124	*
125	* Holds the plugin widgets manager which is responsible for registering and
126	* initializing widgets.
127	*
128	* @since 1.0.0
129	* @access public
130	*
131	* @var Widgets_Manager
132	*/
133	public $widgets_manager;
134
135	/**
136	* Revisions manager.
137	*
138	* Holds the plugin revisions manager which handles history and revisions
139	* functionality.
140	*
141	* @since 1.0.0
142	* @access public
143	*
144	* @var Revisions_Manager
145	*/
146	public $revisions_manager;
147
148	/**
149	* Images manager.
150	*
151	* Holds the plugin images manager which is responsible for retrieving image
152	* details.
153	*
154	* @since 2.9.0
155	* @access public
156	*
157	* @var Images_Manager
158	*/
159	public $images_manager;
160
161	/**
162	* Maintenance mode.
163	*
164	* Holds the maintenance mode manager responsible for the "Maintenance Mode"
165	* and the "Coming Soon" features.
166	*
167	* @since 1.0.0
168	* @access public
169	*
170	* @var Maintenance_Mode
171	*/
172	public $maintenance_mode;
173
174	/**
175	* Page settings manager.
176	*
177	* Holds the page settings manager.
178	*
179	* @since 1.0.0
180	* @access public
181	*
182	* @var Page_Settings_Manager
183	*/
184	public $page_settings_manager;
185
186	/**
187	* Dynamic tags manager.
188	*
189	* Holds the dynamic tags manager.
190	*
191	* @since 1.0.0
192	* @access public
193	*
194	* @var Dynamic_Tags_Manager
195	*/
196	public $dynamic_tags;
197
198	/**
199	* Settings.
200	*
201	* Holds the plugin settings.
202	*
203	* @since 1.0.0
204	* @access public
205	*
206	* @var Settings
207	*/
208	public $settings;
209
210	/**
211	* Role Manager.
212	*
213	* Holds the plugin role manager.
214	*
215	* @since 2.0.0
216	* @access public
217	*
218	* @var Core\RoleManager\Role_Manager
219	*/
220	public $role_manager;
221
222	/**
223	* Admin.
224	*
225	* Holds the plugin admin.
226	*
227	* @since 1.0.0
228	* @access public
229	*
230	* @var Admin
231	*/
232	public $admin;
233
234	/**
235	* Tools.
236	*
237	* Holds the plugin tools.
238	*
239	* @since 1.0.0
240	* @access public
241	*
242	* @var Tools
243	*/
244	public $tools;
245
246	/**
247	* Preview.
248	*
249	* Holds the plugin preview.
250	*
251	* @since 1.0.0
252	* @access public
253	*
254	* @var Preview
255	*/
256	public $preview;
257
258	/**
259	* Editor.
260	*
261	* Holds the plugin editor.
262	*
263	* @since 1.0.0
264	* @access public
265	*
266	* @var Editor
267	*/
268	public $editor;
269
270	/**
271	* Frontend.
272	*
273	* Holds the plugin frontend.
274	*
275	* @since 1.0.0
276	* @access public
277	*
278	* @var Frontend
279	*/
280	public $frontend;
281
282	/**
283	* Heartbeat.
284	*
285	* Holds the plugin heartbeat.
286	*
287	* @since 1.0.0
288	* @access public
289	*
290	* @var Heartbeat
291	*/
292	public $heartbeat;
293
294	/**
295	* System info.
296	*
297	* Holds the system info data.
298	*
299	* @since 1.0.0
300	* @access public
301	*
302	* @var System_Info_Module
303	*/
304	public $system_info;
305
306	/**
307	* Template library manager.
308	*
309	* Holds the template library manager.
310	*
311	* @since 1.0.0
312	* @access public
313	*
314	* @var TemplateLibrary\Manager
315	*/
316	public $templates_manager;
317
318	/**
319	* Skins manager.
320	*
321	* Holds the skins manager.
322	*
323	* @since 1.0.0
324	* @access public
325	*
326	* @var Skins_Manager
327	*/
328	public $skins_manager;
329
330	/**
331	* Files manager.
332	*
333	* Holds the plugin files manager.
334	*
335	* @since 2.1.0
336	* @access public
337	*
338	* @var Files_Manager
339	*/
340	public $files_manager;
341
342	/**
343	* Assets manager.
344	*
345	* Holds the plugin assets manager.
346	*
347	* @since 2.6.0
348	* @access public
349	*
350	* @var Assets_Manager
351	*/
352	public $assets_manager;
353
354	/**
355	* Icons Manager.
356	*
357	* Holds the plugin icons manager.
358	*
359	* @access public
360	*
361	* @var Icons_Manager
362	*/
363	public $icons_manager;
364
365	/**
366	* WordPress widgets manager.
367	*
368	* Holds the WordPress widgets manager.
369	*
370	* @since 1.0.0
371	* @access public
372	*
373	* @var WordPress_Widgets_Manager
374	*/
375	public $wordpress_widgets_manager;
376
377	/**
378	* Modules manager.
379	*
380	* Holds the plugin modules manager.
381	*
382	* @since 1.0.0
383	* @access public
384	*
385	* @var Modules_Manager
386	*/
387	public $modules_manager;
388
389	/**
390	* Beta testers.
391	*
392	* Holds the plugin beta testers.
393	*
394	* @since 1.0.0
395	* @access public
396	*
397	* @var Beta_Testers
398	*/
399	public $beta_testers;
400
401	/**
402	* Inspector.
403	*
404	* Holds the plugin inspector data.
405	*
406	* @since 2.1.2
407	* @access public
408	*
409	* @var Inspector
410	*/
411	public $inspector;
412
413	/**
414	* @var Admin_Menu_Manager
415	*/
416	public $admin_menu_manager;
417
418	/**
419	* Common functionality.
420	*
421	* Holds the plugin common functionality.
422	*
423	* @since 2.3.0
424	* @access public
425	*
426	* @var CommonApp
427	*/
428	public $common;
429
430	/**
431	* Log manager.
432	*
433	* Holds the plugin log manager.
434	*
435	* @access public
436	*
437	* @var Log_Manager
438	*/
439	public $logger;
440
441	/**
442	* Dev tools.
443	*
444	* Holds the plugin dev tools.
445	*
446	* @access private
447	*
448	* @var Dev_Tools
449	*/
450	private $dev_tools;
451
452	/**
453	* Upgrade manager.
454	*
455	* Holds the plugin upgrade manager.
456	*
457	* @access public
458	*
459	* @var Core\Upgrade\Manager
460	*/
461	public $upgrade;
462
463	/**
464	* Tasks manager.
465	*
466	* Holds the plugin tasks manager.
467	*
468	* @var Core\Upgrade\Custom_Tasks_Manager
469	*/
470	public $custom_tasks;
471
472	/**
473	* Kits manager.
474	*
475	* Holds the plugin kits manager.
476	*
477	* @access public
478	*
479	* @var Core\Kits\Manager
480	*/
481	public $kits_manager;
482
483	/**
484	* @var \Elementor\Data\V2\Manager
485	*/
486	public $data_manager_v2;
487
488	/**
489	* Legacy mode.
490	*
491	* Holds the plugin legacy mode data.
492	*
493	* @access public
494	*
495	* @var array
496	*/
497	public $legacy_mode;
498
499	/**
500	* App.
501	*
502	* Holds the plugin app data.
503	*
504	* @since 3.0.0
505	* @access public
506	*
507	* @var App\App
508	*/
509	public $app;
510
511	/**
512	* WordPress API.
513	*
514	* Holds the methods that interact with WordPress Core API.
515	*
516	* @since 3.0.0
517	* @access public
518	*
519	* @var Wp_Api
520	*/
521	public $wp;
522
523	/**
524	* Experiments manager.
525	*
526	* Holds the plugin experiments manager.
527	*
528	* @since 3.1.0
529	* @access public
530	*
531	* @var Experiments_Manager
532	*/
533	public $experiments;
534
535	/**
536	* Uploads manager.
537	*
538	* Holds the plugin uploads manager responsible for handling file uploads
539	* that are not done with WordPress Media.
540	*
541	* @since 3.3.0
542	* @access public
543	*
544	* @var Uploads_Manager
545	*/
546	public $uploads_manager;
547
548	/**
549	* Breakpoints manager.
550	*
551	* Holds the plugin breakpoints manager.
552	*
553	* @since 3.2.0
554	* @access public
555	*
556	* @var Breakpoints_Manager
557	*/
558	public $breakpoints;
559
560	/**
561	* Assets loader.
562	*
563	* Holds the plugin assets loader responsible for conditionally enqueuing
564	* styles and script assets that were pre-enabled.
565	*
566	* @since 3.3.0
567	* @access public
568	*
569	* @var Assets_Loader
570	*/
571	public $assets_loader;
572
573	/**
574	* Container instance for managing dependencies.
575	*
576	* @since 3.24.0
577	* @var DIContainer
578	*/
579	private $container;
580
581	/**
582	* Clone.
583	*
584	* Disable class cloning and throw an error on object clone.
585	*
586	* The whole idea of the singleton design pattern is that there is a single
587	* object. Therefore, we don't want the object to be cloned.
588	*
589	* @access public
590	* @since 1.0.0
591	*/
592	public function __clone() {
593	_doing_it_wrong(
594	__FUNCTION__,
595	sprintf( 'Cloning instances of the singleton "%s" class is forbidden.', get_class( $this ) ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
596	'1.0.0'
597	);
598	}
599
600	/**
601	* Wakeup.
602	*
603	* Disable unserializing of the class.
604	*
605	* @access public
606	* @since 1.0.0
607	*/
608	public function __wakeup() {
609	_doing_it_wrong(
610	__FUNCTION__,
611	sprintf( 'Unserializing instances of the singleton "%s" class is forbidden.', get_class( $this ) ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
612	'1.0.0'
613	);
614	}
615
616	/**
617	* Instance.
618	*
619	* Ensures only one instance of the plugin class is loaded or can be loaded.
620	*
621	* @since 1.0.0
622	* @access public
623	* @static
624	*
625	* @return Plugin An instance of the class.
626	*/
627	public static function instance() {
628	if ( is_null( self::$instance ) ) {
629	self::$instance = new self();
630
631	/**
632	* Elementor loaded.
633	*
634	* Fires when Elementor was fully loaded and instantiated.
635	*
636	* @since 1.0.0
637	*/
638	do_action( 'elementor/loaded' );
639	}
640
641	return self::$instance;
642	}
643
644	public function initialize_container() {
645	Container::initialize_instance();
646
647	$this->container = Container::get_instance();
648	}
649
650	/**
651	* Get the Elementor container or resolve a dependency.
652	*/
653	public function elementor_container( $abstract = null ) {
654	if ( is_null( $abstract ) ) {
655	return $this->container;
656	}
657
658	return $this->container->make( $abstract );
659	}
660
661	/**
662	* Init.
663	*
664	* Initialize Elementor Plugin. Register Elementor support for all the
665	* supported post types and initialize Elementor components.
666	*
667	* @since 1.0.0
668	* @access public
669	*/
670	public function init() {
671	$this->add_cpt_support();
672
673	$this->init_components();
674
675	/**
676	* Elementor init.
677	*
678	* Fires when Elementor components are initialized.
679	*
680	* After Elementor finished loading but before any headers are sent.
681	*
682	* @since 1.0.0
683	*/
684	do_action( 'elementor/init' );
685	}
686
687	/**
688	* Get install time.
689	*
690	* Retrieve the time when Elementor was installed.
691	*
692	* @since 2.6.0
693	* @access public
694	* @static
695	*
696	* @return int Unix timestamp when Elementor was installed.
697	*/
698	public function get_install_time() {
699	$installed_time = get_option( '_elementor_installed_time' );
700
701	if ( ! $installed_time ) {
702	$installed_time = time();
703
704	update_option( '_elementor_installed_time', $installed_time );
705	}
706
707	return $installed_time;
708	}
709
710	/**
711	* @since 2.3.0
712	* @access public
713	*/
714	public function on_rest_api_init() {
715	// On admin/frontend sometimes the rest API is initialized after the common is initialized.
716	if ( ! $this->common ) {
717	$this->init_common();
718	}
719	}
720
721	/**
722	* Init components.
723	*
724	* Initialize Elementor components. Register actions, run setting manager,
725	* initialize all the components that run elementor, and if in admin page
726	* initialize admin components.
727	*
728	* @since 1.0.0
729	* @access private
730	*/
731	private function init_components() {
732	$this->experiments = new Experiments_Manager();
733	$this->breakpoints = new Breakpoints_Manager();
734	$this->inspector = new Inspector();
735
736	Settings_Manager::run();
737
738	$this->db = new DB();
739	$this->controls_manager = new Controls_Manager();
740	$this->documents = new Documents_Manager();
741	$this->kits_manager = new Kits_Manager();
742	$this->elements_manager = new Elements_Manager();
743	$this->widgets_manager = new Widgets_Manager();
744	$this->skins_manager = new Skins_Manager();
745	$this->files_manager = new Files_Manager();
746	$this->assets_manager = new Assets_Manager();
747	$this->icons_manager = new Icons_Manager();
748	$this->settings = new Settings();
749	$this->tools = new Tools();
750	$this->editor = new Editor();
751	$this->preview = new Preview();
752	$this->frontend = new Frontend();
753	$this->maintenance_mode = new Maintenance_Mode();
754	$this->dynamic_tags = new Dynamic_Tags_Manager();
755	$this->modules_manager = new Modules_Manager();
756	$this->templates_manager = new TemplateLibrary\Manager();
757	$this->role_manager = new Core\RoleManager\Role_Manager();
758	$this->system_info = new System_Info_Module();
759	$this->revisions_manager = new Revisions_Manager();
760	$this->images_manager = new Images_Manager();
761	$this->wp = new Wp_Api();
762	$this->assets_loader = new Assets_Loader();
763	$this->uploads_manager = new Uploads_Manager();
764
765	$this->admin_menu_manager = new Admin_Menu_Manager();
766	$this->admin_menu_manager->register_actions();
767
768	User::init();
769	Api::init();
770	Tracker::init();
771
772	$this->upgrade = new Core\Upgrade\Manager();
773	$this->custom_tasks = new Core\Upgrade\Custom_Tasks_Manager();
774
775	$this->app = new App\App();
776
777	if ( is_admin() ) {
778	$this->heartbeat = new Heartbeat();
779	$this->wordpress_widgets_manager = new WordPress_Widgets_Manager();
780	$this->admin = new Admin();
781	$this->beta_testers = new Beta_Testers();
782	}
783	}
784
785	/**
786	* @since 2.3.0
787	* @access public
788	*/
789	public function init_common() {
790	$this->common = new CommonApp();
791
792	$this->common->init_components();
793	}
794
795	/**
796	* Add custom post type support.
797	*
798	* Register Elementor support for all the supported post types defined by
799	* the user in the admin screen and saved as `elementor_cpt_support` option
800	* in WordPress `$wpdb->options` table.
801	*
802	* If no custom post type selected, usually in new installs, this method
803	* will return the two default post types: `page` and `post`.
804	*
805	* @since 1.0.0
806	* @access private
807	*/
808	private function add_cpt_support() {
809	$cpt_support = get_option( 'elementor_cpt_support', self::ELEMENTOR_DEFAULT_POST_TYPES );
810
811	foreach ( $cpt_support as $cpt_slug ) {
812	add_post_type_support( $cpt_slug, 'elementor' );
813	}
814	}
815
816	/**
817	* Register autoloader.
818	*
819	* Elementor autoloader loads all the classes needed to run the plugin.
820	*
821	* @since 1.6.0
822	* @access private
823	*/
824	private function register_autoloader() {
825	require_once ELEMENTOR_PATH . '/includes/autoloader.php';
826
827	Autoloader::run();
828	}
829
830	/**
831	* Plugin Magic Getter
832	*
833	* @since 3.1.0
834	* @access public
835	*
836	* @param $property
837	* @return mixed
838	* @throws \Exception
839	*/
840	public function __get( $property ) {
841	if ( 'posts_css_manager' === $property ) {
842	self::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_argument( 'Plugin::$instance->posts_css_manager', '2.7.0', 'Plugin::$instance->files_manager' );
843
844	return $this->files_manager;
845	}
846
847	if ( 'data_manager' === $property ) {
848	return Data_Manager::instance();
849	}
850
851	if ( property_exists( $this, $property ) ) {
852	throw new \Exception( 'Cannot access private property.' );
853	}
854
855	return null;
856	}
857
858	/**
859	* Plugin constructor.
860	*
861	* Initializing Elementor plugin.
862	*
863	* @since 1.0.0
864	* @access private
865	*/
866	private function __construct() {
867	$this->register_autoloader();
868
869	$this->logger = Log_Manager::instance();
870	$this->data_manager_v2 = Data_Manager_V2::instance();
871
872	Maintenance::init();
873	Compatibility::register_actions();
874
875	add_action( 'init', [ $this, 'init' ], 0 );
876	add_action( 'rest_api_init', [ $this, 'on_rest_api_init' ], 9 );
877	}
878
879	final public static function get_title() {
880	return esc_html__( 'Elementor', 'elementor' );
881	}
882	}
883
884	if ( ! defined( 'ELEMENTOR_TESTS' ) ) {
885	// In tests we run the instance manually.
886	$plugin_instance = Plugin::instance();
887
888	$plugin_instance->initialize_container();
889	}
890