← All changes | includes/base/element-base.php +37 -174 4.2.2 → 3.11.2 View file →

		@@ -119,12 +119,8 @@
119	119	public function get_script_depends() {
120	120	return $this->depended_scripts;
121	121	}
122	122
123		- public function get_global_scripts() {
124		- return [ 'elementor-frontend' ];
125		- }
126		-
127	123	/**
128	124	* Enqueue scripts.
129	125	*
130	126	* Registers all the scripts defined as element dependencies and enqueues
		@@ -134,9 +130,9 @@
134	130	* @access public
135	131	*/
136	132	final public function enqueue_scripts() {
137	133	$deprecated_scripts = [
138		- // Insert here when you have a deprecated script.
	134	+ //Insert here when you have a deprecated script
139	135	];
140	136
141	137	foreach ( $this->get_script_depends() as $script ) {
142	138	if ( isset( $deprecated_scripts[ $script ] ) ) {
		@@ -144,16 +140,10 @@
144	140	}
145	141
146	142	wp_enqueue_script( $script );
147	143	}
148		-
149		- foreach ( $this->get_global_scripts() as $script ) {
150		- wp_enqueue_script( $script );
151		- }
152	144	}
153	145
154		- public function register_frontend_handlers() {}
155		-
156	146	/**
157	147	* Get style dependencies.
158	148	*
159	149	* Retrieve the list of style dependencies the element requires.
		@@ -295,22 +285,8 @@
295	285	return true;
296	286	}
297	287
298	288	/**
299		- * Whether the element returns dynamic content.
300		- *
301		- * Set to determine whether to cache the element output or not.
302		- *
303		- * @since 3.22.0
304		- * @access protected
305		- *
306		- * @return bool Whether to cache the element output.
307		- */
308		- protected function is_dynamic_content(): bool {
309		- return true;
310		- }
311		-
312		- /**
313	289	* Get child elements.
314	290	*
315	291	* Retrieve all the child elements of this element.
316	292	*
		@@ -326,28 +302,8 @@
326	302
327	303	return $this->children;
328	304	}
329	305
330		- public function render_markdown(): string {
331		- $children = $this->get_children();
332		-
333		- if ( empty( $children ) ) {
334		- return '';
335		- }
336		-
337		- $parts = [];
338		-
339		- foreach ( $children as $child ) {
340		- $md = $child->render_markdown();
341		-
342		- if ( ! empty( trim( $md ) ) ) {
343		- $parts[] = $md;
344		- }
345		- }
346		-
347		- return implode( "\n\n", $parts );
348		- }
349		-
350	306	/**
351	307	* Get default arguments.
352	308	*
353	309	* Retrieve the element default arguments. Used to return all the default
		@@ -364,23 +320,8 @@
364	320	return self::get_items( $this->default_args, $item );
365	321	}
366	322
367	323	/**
368		- * Get panel presets.
369		- *
370		- * Used for displaying the widget in the panel multiple times, but with different defaults values,
371		- * icon, title etc.
372		- *
373		- * @since 3.16.0
374		- * @access public
375		- *
376		- * @return array
377		- */
378		- public function get_panel_presets() {
379		- return [];
380		- }
381		-
382		- /**
383	324	* Add new child element.
384	325	*
385	326	* Register new child element to allow hierarchy.
386	327	*
		@@ -426,14 +367,15 @@
426	367	* @since 2.8.0
427	368	* @access public
428	369	*
429	370	* @param array|string $element The HTML element.
430		- * @param array $url_control Array of link settings.
431		- * @param bool $overwrite Optional. Whether to overwrite existing
432		- * attribute. Default is false, not to overwrite.
	371	+ * @param array $url_control Array of link settings.
	372	+ * @param bool $overwrite Optional. Whether to overwrite existing
	373	+ * attribute. Default is false, not to overwrite.
433	374	*
434	375	* @return Element_Base Current instance of the element.
435	376	*/
	377	+
436	378	public function add_link_attributes( $element, array $url_control, $overwrite = false ) {
437	379	$attributes = [];
438	380
439	381	if ( ! empty( $url_control['url'] ) ) {
		@@ -450,9 +392,9 @@
450	392	$attributes['rel'] = 'nofollow';
451	393	}
452	394
453	395	if ( ! empty( $url_control['custom_attributes'] ) ) {
454		- // Custom URL attributes should come as a string of comma-delimited key|value pairs.
	396	+ // Custom URL attributes should come as a string of comma-delimited key|value pairs
455	397	$attributes = array_merge( $attributes, Utils::parse_custom_attributes( $url_control['custom_attributes'] ) );
456	398	}
457	399
458	400	if ( $attributes ) {
		@@ -461,16 +403,8 @@
461	403
462	404	return $this;
463	405	}
464	406
465		- public function reset_descendant_render_state(): void {
466		- $this->reset_render_state();
467		-
468		- foreach ( $this->get_children() as $child ) {
469		- $child->reset_descendant_render_state();
470		- }
471		- }
472		-
473	407	/**
474	408	* Print element.
475	409	*
476	410	* Used to generate the element final HTML on the frontend and the editor.
		@@ -480,15 +414,8 @@
480	414	*/
481	415	public function print_element() {
482	416	$element_type = $this->get_type();
483	417
484		- if ( $this->should_render_shortcode() ) {
485		- $unique_id = apply_filters( 'elementor/element_cache/unique_id', '' );
486		-
487		- echo '[elementor-element k="' . esc_attr( $unique_id ) . '" data="' . esc_attr( base64_encode( wp_json_encode( $this->get_raw_data() ) ) ) . '"]';
488		- return;
489		- }
490		-
491	418	/**
492	419	* Before frontend element render.
493	420	*
494	421	* Fires before Elementor element is rendered in the frontend.
		@@ -551,10 +478,8 @@
551	478	// PHPCS - The content has already been escaped by the `render` method.
552	479	echo $content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
553	480	$this->after_render();
554	481
555		- // TODO: Remove this in the future
556		- // Since version 3.24.0 page scripts/styles are handled by `page_assets`.
557	482	$this->enqueue_scripts();
558	483	$this->enqueue_styles();
559	484	}
560	485
		@@ -582,54 +507,8 @@
582	507	*/
583	508	do_action( 'elementor/frontend/after_render', $this );
584	509	}
585	510
586		- protected function should_render_shortcode() {
587		- $should_render_shortcode = apply_filters( 'elementor/element/should_render_shortcode', false );
588		-
589		- if ( ! $should_render_shortcode ) {
590		- return false;
591		- }
592		-
593		- $raw_data = $this->get_raw_data();
594		-
595		- if ( ! empty( $raw_data['settings']['_element_cache'] ) ) {
596		- return 'yes' === $raw_data['settings']['_element_cache'];
597		- }
598		-
599		- if ( $this->is_dynamic_content() ) {
600		- return true;
601		- }
602		-
603		- $is_dynamic_content = apply_filters( 'elementor/element/is_dynamic_content', false, $raw_data, $this );
604		-
605		- $has_dynamic_tag = $this->has_element_dynamic_tag( $raw_data['settings'] );
606		-
607		- if ( $is_dynamic_content || $has_dynamic_tag ) {
608		- return true;
609		- }
610		-
611		- return false;
612		- }
613		-
614		- private function has_element_dynamic_tag( $element_settings ): bool {
615		- if ( is_array( $element_settings ) ) {
616		- if ( ! empty( $element_settings['__dynamic__'] ) ) {
617		- return true;
618		- }
619		-
620		- foreach ( $element_settings as $value ) {
621		- $has_dynamic = $this->has_element_dynamic_tag( $value );
622		-
623		- if ( $has_dynamic ) {
624		- return true;
625		- }
626		- }
627		- }
628		-
629		- return false;
630		- }
631		-
632	511	/**
633	512	* Get the element raw data.
634	513	*
635	514	* Retrieve the raw element data, including the id, type, settings, child
		@@ -732,9 +611,9 @@
732	611	* @param array|null $controls The available controls.
733	612	*
734	613	* @return array Element data.
735	614	*/
736		- public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ): array {
	615	+ public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ) : array {
737	616	$tags_manager = Plugin::$instance->dynamic_tags;
738	617
739	618	if ( empty( $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ] ) ) {
740	619	return $config;
		@@ -767,12 +646,12 @@
767	646	* Used to add attributes to the current element wrapper HTML tag.
768	647	*
769	648	* @since 1.3.0
770	649	* @access protected
771		- * @deprecated 3.1.0 Use `add_render_attribute()` method instead.
	650	+ * @deprecated 3.1.0
772	651	*/
773	652	protected function _add_render_attributes() {
774		- Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'add_render_attributes()' );
	653	+ Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::add_render_attributes()' );
775	654
776	655	return $this->add_render_attributes();
777	656	}
778	657
		@@ -797,9 +676,8 @@
797	676	'elementor-element-' . $id,
798	677	],
799	678	'data-id' => $id,
800	679	'data-element_type' => $this->get_type(),
801		- 'data-e-type' => $this->get_type(),
802	680	] );
803	681
804	682	$class_settings = [];
805	683
		@@ -804,15 +682,9 @@
804	682	$class_settings = [];
805	683
806	684	foreach ( $settings as $setting_key => $setting ) {
807	685	if ( isset( $controls[ $setting_key ]['prefix_class'] ) ) {
808		- if ( isset( $controls[ $setting_key ]['classes_dictionary'][ $setting ] ) ) {
809		- $value = $controls[ $setting_key ]['classes_dictionary'][ $setting ];
810		- } else {
811		- $value = $setting;
812		- }
813		-
814		- $class_settings[ $setting_key ] = $value;
	686	+ $class_settings[ $setting_key ] = $setting;
815	687	}
816	688	}
817	689
818	690	foreach ( $class_settings as $setting_key => $setting ) {
		@@ -824,15 +696,15 @@
824	696	}
825	697
826	698	$_animation = ! empty( $settings['_animation'] );
827	699	$animation = ! empty( $settings['animation'] );
828		- $has_animation = ( $_animation && 'none' !== $settings['_animation'] ) || ( $animation && 'none' !== $settings['animation'] );
	700	+ $has_animation = $_animation && 'none' !== $settings['_animation'] || $animation && 'none' !== $settings['animation'];
829	701
830	702	if ( $has_animation ) {
831	703	$is_static_render_mode = Plugin::$instance->frontend->is_static_render_mode();
832	704
833	705	if ( ! $is_static_render_mode ) {
834		- // Hide the element until the animation begins.
	706	+ // Hide the element until the animation begins
835	707	$this->add_render_attribute( '_wrapper', 'class', 'elementor-invisible' );
836	708	}
837	709	}
838	710
		@@ -860,15 +732,13 @@
860	732	* Register the Transform controls in the advanced tab of the element.
861	733	*
862	734	* Previously registered under the Widget_Common class, but registered a more fundamental level now to enable access from other widgets.
863	735	*
864		- * @param string $element_selector
865		- * @param string $transform_selector_class
866		- * @return void
867	736	* @since 3.9.0
868	737	* @access protected
	738	+ * @return void
869	739	*/
870		- protected function register_transform_section( $element_selector = '', $transform_selector_class = ' > .elementor-widget-container' ) {
	740	+ protected function register_transform_section( $element_selector = '' ) {
871	741	$default_unit_values_deg = [];
872	742	$default_unit_values_ms = [];
873	743
874	744	// Set the default unit sizes for all active breakpoints.
		@@ -897,8 +767,9 @@
897	767	$this->start_controls_tabs( '_tabs_positioning' );
898	768
899	769	$transform_prefix_class = 'e-';
900	770	$transform_return_value = 'transform';
	771	+ $transform_selector_class = ' > .elementor-widget-container';
901	772	$transform_css_modifier = '';
902	773
903	774	if ( 'con' === $element_selector ) {
904	775	$transform_selector_class = '.e-' . $element_selector;
		@@ -929,9 +800,9 @@
929	800
930	801	$this->add_responsive_control(
931	802	"_transform_rotateZ_effect{$tab}",
932	803	[
933		- 'label' => esc_html__( 'Rotate', 'elementor' ) . ' (deg)',
	804	+ 'label' => esc_html__( 'Rotate', 'elementor' ),
934	805	'type' => Controls_Manager::SLIDER,
935	806	'device_args' => $default_unit_values_deg,
936	807	'range' => [
937	808	'px' => [
		@@ -961,9 +832,8 @@
961	832	],
962	833	'condition' => [
963	834	"_transform_rotate_popover{$tab}!" => '',
964	835	],
965		- 'frontend_available' => true,
966	836	]
967	837	);
968	838
969	839	$this->add_responsive_control(
		@@ -968,9 +838,9 @@
968	838
969	839	$this->add_responsive_control(
970	840	"_transform_rotateX_effect{$tab}",
971	841	[
972		- 'label' => esc_html__( 'Rotate X', 'elementor' ) . ' (deg)',
	842	+ 'label' => esc_html__( 'Rotate X', 'elementor' ),
973	843	'type' => Controls_Manager::SLIDER,
974	844	'device_args' => $default_unit_values_deg,
975	845	'range' => [
976	846	'px' => [
		@@ -991,9 +861,9 @@
991	861
992	862	$this->add_responsive_control(
993	863	"_transform_rotateY_effect{$tab}",
994	864	[
995		- 'label' => esc_html__( 'Rotate Y', 'elementor' ) . ' (deg)',
	865	+ 'label' => esc_html__( 'Rotate Y', 'elementor' ),
996	866	'type' => Controls_Manager::SLIDER,
997	867	'device_args' => $default_unit_values_deg,
998	868	'range' => [
999	869	'px' => [
		@@ -1014,12 +884,13 @@
1014	884
1015	885	$this->add_responsive_control(
1016	886	"_transform_perspective_effect{$tab}",
1017	887	[
1018		- 'label' => esc_html__( 'Perspective', 'elementor' ) . ' (px)',
	888	+ 'label' => esc_html__( 'Perspective', 'elementor' ),
1019	889	'type' => Controls_Manager::SLIDER,
1020	890	'range' => [
1021	891	'px' => [
	892	+ 'min' => 0,
1022	893	'max' => 1000,
1023	894	],
1024	895	],
1025	896	'condition' => [
		@@ -1051,9 +922,9 @@
1051	922	"_transform_translateX_effect{$tab}",
1052	923	[
1053	924	'label' => esc_html__( 'Offset X', 'elementor' ),
1054	925	'type' => Controls_Manager::SLIDER,
1055		- 'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
	926	+ 'size_units' => [ '%', 'px' ],
1056	927	'range' => [
1057	928	'%' => [
1058	929	'min' => -100,
1059	930	'max' => 100,
		@@ -1077,9 +948,9 @@
1077	948	"_transform_translateY_effect{$tab}",
1078	949	[
1079	950	'label' => esc_html__( 'Offset Y', 'elementor' ),
1080	951	'type' => Controls_Manager::SLIDER,
1081		- 'size_units' => [ 'px', '%', 'em', 'rem', 'vh', 'custom' ],
	952	+ 'size_units' => [ '%', 'px' ],
1082	953	'range' => [
1083	954	'%' => [
1084	955	'min' => -100,
1085	956	'max' => 100,
		@@ -1130,8 +1001,9 @@
1130	1001	'label' => esc_html__( 'Scale', 'elementor' ),
1131	1002	'type' => Controls_Manager::SLIDER,
1132	1003	'range' => [
1133	1004	'px' => [
	1005	+ 'min' => 0,
1134	1006	'max' => 2,
1135	1007	'step' => 0.1,
1136	1008	],
1137	1009	],
		@@ -1152,8 +1024,9 @@
1152	1024	'label' => esc_html__( 'Scale X', 'elementor' ),
1153	1025	'type' => Controls_Manager::SLIDER,
1154	1026	'range' => [
1155	1027	'px' => [
	1028	+ 'min' => 0,
1156	1029	'max' => 2,
1157	1030	'step' => 0.1,
1158	1031	],
1159	1032	],
		@@ -1174,8 +1047,9 @@
1174	1047	'label' => esc_html__( 'Scale Y', 'elementor' ),
1175	1048	'type' => Controls_Manager::SLIDER,
1176	1049	'range' => [
1177	1050	'px' => [
	1051	+ 'min' => 0,
1178	1052	'max' => 2,
1179	1053	'step' => 0.1,
1180	1054	],
1181	1055	],
		@@ -1206,9 +1080,9 @@
1206	1080
1207	1081	$this->add_responsive_control(
1208	1082	"_transform_skewX_effect{$tab}",
1209	1083	[
1210		- 'label' => esc_html__( 'Skew X', 'elementor' ) . ' (deg)',
	1084	+ 'label' => esc_html__( 'Skew X', 'elementor' ),
1211	1085	'type' => Controls_Manager::SLIDER,
1212	1086	'device_args' => $default_unit_values_deg,
1213	1087	'range' => [
1214	1088	'px' => [
		@@ -1228,9 +1102,9 @@
1228	1102
1229	1103	$this->add_responsive_control(
1230	1104	"_transform_skewY_effect{$tab}",
1231	1105	[
1232		- 'label' => esc_html__( 'Skew Y', 'elementor' ) . ' (deg)',
	1106	+ 'label' => esc_html__( 'Skew Y', 'elementor' ),
1233	1107	'type' => Controls_Manager::SLIDER,
1234	1108	'device_args' => $default_unit_values_deg,
1235	1109	'range' => [
1236	1110	'px' => [
		@@ -1291,16 +1165,15 @@
1291	1165	if ( '_hover' === $tab ) {
1292	1166	$this->add_control(
1293	1167	'_transform_transition_hover',
1294	1168	[
1295		- 'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (ms)',
	1169	+ 'label' => esc_html__( 'Transition Duration (ms)', 'elementor' ),
1296	1170	'type' => Controls_Manager::SLIDER,
1297	1171	'device_args' => $default_unit_values_ms,
1298	1172	'range' => [
1299	1173	'px' => [
1300		- 'min' => 0,
	1174	+ 'min' => 100,
1301	1175	'max' => 10000,
1302		- 'step' => 100,
1303	1176	],
1304	1177	],
1305	1178	'selectors' => [
1306	1179	'{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-transition-duration: {{SIZE}}ms',
		@@ -1341,9 +1214,9 @@
1341	1214	'relation' => 'or',
1342	1215	'terms' => array_merge( $transform_origin_conditions, $transform_origin_conditions_hover ),
1343	1216	];
1344	1217
1345		- // Will override motion effect transform-origin.
	1218	+ // Will override motion effect transform-origin
1346	1219	$this->add_responsive_control(
1347	1220	'motion_fx_transform_x_anchor_point',
1348	1221	[
1349	1222	'label' => esc_html__( 'X Anchor Point', 'elementor' ),
		@@ -1369,9 +1242,9 @@
1369	1242	],
1370	1243	]
1371	1244	);
1372	1245
1373		- // Will override motion effect transform-origin.
	1246	+ // Will override motion effect transform-origin
1374	1247	$this->add_responsive_control(
1375	1248	'motion_fx_transform_y_anchor_point',
1376	1249	[
1377	1250	'label' => esc_html__( 'Y Anchor Point', 'elementor' ),
		@@ -1418,13 +1291,10 @@
1418	1291
1419	1292	$this->add_control(
1420	1293	'hide_' . $breakpoint_key,
1421	1294	[
1422		- 'label' => sprintf(
1423		- /* translators: %s: Device name. */
1424		- esc_html__( 'Hide On %s', 'elementor' ),
1425		- $label
1426		- ),
	1295	+ /* translators: %s: Device name. */
	1296	+ 'label' => sprintf( __( 'Hide On %s', 'elementor' ), $label ),
1427	1297	'type' => Controls_Manager::SWITCHER,
1428	1298	'default' => '',
1429	1299	'prefix_class' => 'elementor-',
1430	1300	'label_on' => esc_html__( 'Hide', 'elementor' ),
		@@ -1462,12 +1332,12 @@
1462	1332	* Output the element final HTML on the frontend.
1463	1333	*
1464	1334	* @since 1.0.0
1465	1335	* @access protected
1466		- * @deprecated 3.1.0 Use `print_content()` method instead.
	1336	+ * @deprecated 3.1.0
1467	1337	*/
1468	1338	protected function _print_content() {
1469		- Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'print_content()' );
	1339	+ Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::print_content()' );
1470	1340
1471	1341	$this->print_content();
1472	1342	}
1473	1343
		@@ -1522,11 +1392,8 @@
1522	1392
1523	1393	/**
1524	1394	* A Base method for sanitizing the settings before save.
1525	1395	* This method is meant to be overridden by the element.
1526		- *
1527		- * @param array $settings
1528		- * @return array
1529	1396	*/
1530	1397	protected function on_save( array $settings ) {
1531	1398	return $settings;
1532	1399	}
		@@ -1545,9 +1412,9 @@
1545	1412	*/
1546	1413	private function get_child_type( $element_data ) {
1547	1414	$child_type = $this->_get_default_child_type( $element_data );
1548	1415
1549		- // If it's not a valid widget ( like a deactivated plugin ).
	1416	+ // If it's not a valid widget ( like a deactivated plugin )
1550	1417	if ( ! $child_type ) {
1551	1418	return false;
1552	1419	}
1553	1420
		@@ -1592,12 +1459,8 @@
1592	1459	$this->add_child( $child_data );
1593	1460	}
1594	1461	}
1595	1462
1596		- public function has_widget_inner_wrapper(): bool {
1597		- return true;
1598		- }
1599		-
1600	1463	/**
1601	1464	* Element base constructor.
1602	1465	*
1603	1466	* Initializing the element base class using `$data` and `$args`.
		@@ -1610,9 +1473,9 @@
1610	1473	*
1611	1474	* @param array $data Optional. Element data. Default is an empty array.
1612	1475	* @param array|null $args Optional. Element default arguments. Default is null.
1613	1476	**/
1614		- public function __construct( array $data = [], ?array $args = null ) {
	1477	+ public function __construct( array $data = [], array $args = null ) {
1615	1478	if ( $data ) {
1616	1479	$this->is_type_instance = false;
1617	1480	} elseif ( $args ) {
1618	1481	$this->default_args = $args;