elementor / modules / element-cache / module.php

module.php in Elementor Website Builder – more than just a page builder 3.22.3, at modules/element-cache/module.php

156 lines 4.6 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Modules\ElementCache;
3
4	use Elementor\Controls_Manager;
5	use Elementor\Core\Base\Module as BaseModule;
6	use Elementor\Core\Experiments\Manager as ExperimentsManager;
7	use Elementor\Element_Base;
8	use Elementor\Plugin;
9	use Elementor\Settings;
10
11	if ( ! defined( 'ABSPATH' ) ) {
12	exit; // Exit if accessed directly.
13	}
14
15	class Module extends BaseModule {
16
17	public function get_name() {
18	return 'element-cache';
19	}
20
21	public function __construct() {
22	parent::__construct();
23
24	$this->register_experiments();
25	$this->register_shortcode();
26
27	if ( ! Plugin::$instance->experiments->is_feature_active( 'e_element_cache' ) ) {
28	return;
29	}
30
31	$this->add_advanced_tab_actions();
32
33	if ( is_admin() ) {
34	add_action( 'elementor/admin/after_create_settings/' . Settings::PAGE_ID, [ $this, 'register_admin_fields' ], 100 );
35	}
36
37	$this->clear_cache_on_site_changed();
38	}
39
40	private function register_experiments() {
41	Plugin::$instance->experiments->add_feature( [
42	'name' => 'e_element_cache',
43	'title' => esc_html__( 'Element Caching', 'elementor' ),
44	'tag' => esc_html__( 'Performance', 'elementor' ),
45	'description' => esc_html__( 'Elements caching reduces loading times by serving up a copy of an element instead of rendering it fresh every time the page is loaded. When active, Elementor will determine which elements can benefit from static loading - but you can override this.', 'elementor' ),
46	'release_status' => ExperimentsManager::RELEASE_STATUS_DEV,
47	'default' => ExperimentsManager::STATE_INACTIVE,
48	'generator_tag' => true,
49	] );
50	}
51
52	private function register_shortcode() {
53	add_shortcode( 'elementor-element', function ( $atts ) {
54	if ( empty( $atts['data'] ) ) {
55	return '';
56	}
57
58	$widget_data = json_decode( base64_decode( $atts['data'] ), true );
59
60	if ( empty( $widget_data ) \|\| ! is_array( $widget_data ) ) {
61	return '';
62	}
63
64	ob_start();
65
66	$element = Plugin::$instance->elements_manager->create_element_instance( $widget_data );
67
68	if ( $element ) {
69	$element->print_element();
70	}
71
72	return ob_get_clean();
73	} );
74	}
75
76	private function add_advanced_tab_actions() {
77	$hooks = array(
78	'elementor/element/common/_section_style/after_section_end' => '_css_classes', // Widgets
79	);
80
81	foreach ( $hooks as $hook => $injection_position ) {
82	add_action(
83	$hook,
84	function( $element, $args ) use ( $injection_position ) {
85	$this->add_control_to_advanced_tab( $element, $args, $injection_position );
86	},
87	10,
88	2
89	);
90	}
91	}
92
93	private function add_control_to_advanced_tab( Element_Base $element, $args, $injection_position ) {
94	$element->start_injection(
95	[
96	'of' => $injection_position,
97	]
98	);
99
100	$control_data = [
101	'label' => esc_html__( 'Cache Settings', 'elementor' ),
102	'type' => Controls_Manager::SELECT,
103	'default' => '',
104	'options' => [
105	'' => esc_html__( 'Default', 'elementor' ),
106	'yes' => esc_html__( 'Inactive', 'elementor' ),
107	'no' => esc_html__( 'Active', 'elementor' ),
108	],
109	];
110
111	$element->add_control( '_element_cache', $control_data );
112
113	$element->end_injection();
114	}
115
116	public function register_admin_fields( Settings $settings ) {
117	$settings->add_field(
118	Settings::TAB_PERFORMANCE,
119	Settings::TAB_PERFORMANCE,
120	'element_cache_ttl',
121	[
122	'label' => esc_html__( 'Element Cache Expiration', 'elementor' ),
123	'field_args' => [
124	'class' => 'elementor-element-cache-ttl',
125	'type' => 'select',
126	'std' => '24',
127	'options' => [
128	'1' => esc_html__( '1 Hour', 'elementor' ),
129	'6' => esc_html__( '6 Hours', 'elementor' ),
130	'12' => esc_html__( '12 Hours', 'elementor' ),
131	'24' => esc_html__( '1 Day', 'elementor' ),
132	'72' => esc_html__( '3 Days', 'elementor' ),
133	'168' => esc_html__( '1 Week', 'elementor' ),
134	'336' => esc_html__( '2 Weeks', 'elementor' ),
135	'720' => esc_html__( '1 Month', 'elementor' ),
136	'8760' => esc_html__( '1 Year', 'elementor' ),
137	],
138	'desc' => esc_html__( 'Specify the duration for which data is stored in the cache. Elements caching speeds up loading by serving pre-rendered copies of elements, rather than rendering them fresh each time. This control ensures efficient performance and up-to-date content.', 'elementor' ),
139	],
140	]
141	);
142	}
143
144	private function clear_cache_on_site_changed() {
145	add_action( 'activated_plugin', [ $this, 'clear_cache' ] );
146	add_action( 'deactivated_plugin', [ $this, 'clear_cache' ] );
147	add_action( 'switch_theme', [ $this, 'clear_cache' ] );
148	add_action( 'upgrader_process_complete', [ $this, 'clear_cache' ] );
149	}
150
151	public function clear_cache() {
152	Plugin::$instance->files_manager->clear_cache();
153
154	}
155	}
156