← All changes | includes/base/controls-stack.php +33 -89 4.2.2 → 3.24.8 View file →

		@@ -4,9 +4,8 @@
4	4	use Elementor\Core\Base\Base_Object;
5	5	use Elementor\Core\DynamicTags\Manager;
6	6	use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
7	7	use Elementor\Core\Frontend\Performance;
8		-use Elementor\Utils;
9	8
10	9	if ( ! defined( 'ABSPATH' ) ) {
11	10	exit; // Exit if accessed directly.
12	11	}
		@@ -226,9 +225,9 @@
226	225	public function get_id_int() {
227	226	/** We ignore possible notices, in order to support elements created prior to v1.8.0 and might include
228	227	* non-base 16 characters as part of their ID.
229	228	*/
230		- return @hexdec( (string) $this->id );
	229	+ return @hexdec( $this->id );
231	230	}
232	231
233	232	/**
234	233	* Get widget number.
		@@ -349,9 +348,9 @@
349	348	* @param array $settings Optional. Controls settings. Default is null.
350	349	*
351	350	* @return array Active controls.
352	351	*/
353		- public function get_active_controls( ?array $controls = null, ?array $settings = null ) {
	352	+ public function get_active_controls( array $controls = null, array $settings = null ) {
354	353	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.0.0' );
355	354
356	355	if ( ! $controls ) {
357	356	$controls = $this->get_controls();
		@@ -612,10 +611,10 @@
612	611
613	612	$position = array_merge( $default_position, $position );
614	613
615	614	if (
616		- ( 'control' === $position['type'] && in_array( $position['at'], [ 'start', 'end' ], true ) ) ||
617		- ( 'section' === $position['type'] && in_array( $position['at'], [ 'before', 'after' ], true ) )
	615	+ 'control' === $position['type'] && in_array( $position['at'], [ 'start', 'end' ], true ) ||
	616	+ 'section' === $position['type'] && in_array( $position['at'], [ 'before', 'after' ], true )
618	617	) {
619	618	_doing_it_wrong( sprintf( '%s::%s', get_called_class(), __FUNCTION__ ), 'Invalid position arguments. Use `before` / `after` for control or `start` / `end` for section.', '1.7.0' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
620	619
621	620	return false;
		@@ -637,13 +636,13 @@
637	636
638	637	$controls_keys = array_keys( $registered_controls );
639	638
640	639	while ( Controls_Manager::SECTION !== $registered_controls[ $controls_keys[ $target_section_index ] ]['type'] ) {
641		- --$target_section_index;
	640	+ $target_section_index--;
642	641	}
643	642
644	643	if ( 'section' === $position['type'] ) {
645		- ++$target_control_index;
	644	+ $target_control_index++;
646	645
647	646	if ( 'end' === $position['at'] ) {
648	647	while ( Controls_Manager::SECTION !== $registered_controls[ $controls_keys[ $target_control_index ] ]['type'] ) {
649	648	if ( ++$target_control_index >= count( $registered_controls ) ) {
		@@ -655,9 +654,9 @@
655	654
656	655	$target_control = $registered_controls[ $controls_keys[ $target_control_index ] ];
657	656
658	657	if ( 'after' === $position['at'] ) {
659		- ++$target_control_index;
	658	+ $target_control_index++;
660	659	}
661	660
662	661	$section_id = $registered_controls[ $controls_keys[ $target_section_index ] ]['name'];
663	662
		@@ -737,9 +736,9 @@
737	736
738	737	$controls_keys = array_keys( $registered_controls );
739	738
740	739	while ( true ) {
741		- ++$section_index;
	740	+ $section_index++;
742	741
743	742	if ( ! isset( $controls_keys[ $section_index ] ) ) {
744	743	break;
745	744	}
		@@ -750,9 +749,9 @@
750	749	break;
751	750	}
752	751
753	752	$section_controls[ $control_key ] = $registered_controls[ $control_key ];
754		- }
	753	+ };
755	754
756	755	return $section_controls;
757	756	}
758	757
		@@ -796,9 +795,9 @@
796	795	* @param array $settings Optional. Controls settings. Default is null.
797	796	*
798	797	* @return array Style controls.
799	798	*/
800		- final public function get_style_controls( ?array $controls = null, ?array $settings = null ) {
	799	+ final public function get_style_controls( array $controls = null, array $settings = null ) {
801	800	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.0.0' );
802	801
803	802	$controls = $this->get_active_controls( $controls, $settings );
804	803
		@@ -931,9 +930,9 @@
931	930	$control_args = $args;
932	931
933	932	// Set parent using the name from previous iteration.
934	933	if ( isset( $control_name ) ) {
935		- // If $control_name end with _widescreen use desktop name instead.
	934	+ // If $control_name end with _widescreen use desktop name instead
936	935	$control_args['parent'] = '_widescreen' === substr( $control_name, -strlen( '_widescreen' ) ) ? $id : $control_name;
937	936	} else {
938	937	$control_args['parent'] = null;
939	938	}
		@@ -1060,10 +1059,10 @@
1060	1059	* @return array|null The config.
1061	1060	*/
1062	1061	final public function get_config() {
1063	1062	if ( null === $this->config ) {
1064		- // TODO: This is for backwards compatibility starting from 2.9.0.
1065		- // This if statement should be removed when the method is hard-deprecated.
	1063	+ // TODO: This is for backwards compatibility starting from 2.9.0
	1064	+ // This if statement should be removed when the method is hard-deprecated
1066	1065	if ( $this->has_own_method( '_get_initial_config', self::class ) ) {
1067	1066	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_get_initial_config', '2.9.0', __CLASS__ . '::get_initial_config()' );
1068	1067
1069	1068	$this->config = $this->_get_initial_config();
		@@ -1087,10 +1086,8 @@
1087	1086	* Set a config property.
1088	1087	*
1089	1088	* Set a specific property of the config list for this controls-stack.
1090	1089	*
1091		- * @param string $key
1092		- * @param string $value
1093	1090	* @since 3.5.0
1094	1091	* @access public
1095	1092	*/
1096	1093	public function set_config( $key, $value ) {
		@@ -1166,11 +1163,8 @@
1166	1163	return self::get_items( $this->data, $item );
1167	1164	}
1168	1165
1169	1166	/**
1170		- * @param null $setting
1171		- * @param null $settings
1172		- * @return array|mixed|null
1173	1167	* @since 2.0.14
1174	1168	* @access public
1175	1169	*/
1176	1170	public function get_parsed_dynamic_settings( $setting = null, $settings = null ) {
		@@ -1184,28 +1178,21 @@
1184	1178
1185	1179	return self::get_items( $this->parsed_dynamic_settings, $setting );
1186	1180	}
1187	1181
1188		- public function reset_render_state(): void {
1189		- $this->active_settings = null;
1190		- $this->parsed_active_settings = null;
1191		- $this->parsed_dynamic_settings = null;
1192		- $this->render_attributes = [];
1193		- }
1194		-
1195	1182	/**
1196	1183	* Get active settings.
1197	1184	*
1198	1185	* Retrieve the settings from all the active controls.
1199	1186	*
1200		- * @param array|null $settings Optional. Controls settings. Default is null.
1201		- * @param array|null $controls Optional. An array of controls. Default is null.
1202		- *
1203		- * @return array Active settings.
	1187	+ * @since 1.4.0
1204	1188	* @since 2.1.0 Added the `controls` and the `settings` parameters.
1205	1189	* @access public
1206	1190	*
1207		- * @since 1.4.0
	1191	+ * @param array $controls Optional. An array of controls. Default is null.
	1192	+ * @param array $settings Optional. Controls settings. Default is null.
	1193	+ *
	1194	+ * @return array Active settings.
1208	1195	*/
1209	1196	public function get_active_settings( $settings = null, $controls = null ) {
1210	1197	$is_first_request = ! $settings && ! $this->active_settings;
1211	1198
		@@ -1434,14 +1421,15 @@
1434	1421	* Whether the control is visible or not.
1435	1422	*
1436	1423	* Used to determine whether the control is visible or not.
1437	1424	*
	1425	+ * @since 1.4.0
	1426	+ * @access public
	1427	+ *
1438	1428	* @param array $control The control.
1439		- * @param null $values Optional. Condition values. Default is null.
1440		- * @param null $controls
	1429	+ * @param array $values Optional. Condition values. Default is null.
	1430	+ *
1441	1431	* @return bool Whether the control is visible.
1442		- * @since 1.4.0
1443		- * @access public
1444	1432	*/
1445	1433	public function is_control_visible( $control, $values = null, $controls = null ) {
1446	1434	if ( null === $values ) {
1447	1435	$values = $this->get_settings();
		@@ -1463,9 +1451,9 @@
1463	1451	preg_match( '/([a-z_\-0-9]+)(?:\[([a-z_]+)])?(!?)$/i', $condition_key, $condition_key_parts );
1464	1452
1465	1453	$pure_condition_key = $condition_key_parts[1];
1466	1454	$condition_sub_key = $condition_key_parts[2];
1467		- $is_negative_condition = (bool) $condition_key_parts[3];
	1455	+ $is_negative_condition = ! ! $condition_key_parts[3];
1468	1456
1469	1457	if ( ! isset( $values[ $pure_condition_key ] ) || null === $values[ $pure_condition_key ] ) {
1470	1458	return false;
1471	1459	}
		@@ -1528,12 +1516,9 @@
1528	1516	} else {
1529	1517	$is_contains = $instance_value === $condition_value;
1530	1518	}
1531	1519
1532		- if (
1533		- ( $is_negative_condition && $is_contains ) ||
1534		- ( ! $is_negative_condition && ! $is_contains )
1535		- ) {
	1520	+ if ( $is_negative_condition && $is_contains || ! $is_negative_condition && ! $is_contains ) {
1536	1521	return false;
1537	1522	}
1538	1523	}
1539	1524
		@@ -1584,12 +1569,8 @@
1584	1569	* @param array $args Section arguments.
1585	1570	*/
1586	1571	do_action( "elementor/element/{$stack_name}/{$section_id}/before_section_start", $this, $args );
1587	1572
1588		- if ( $this->should_manually_trigger_common_action( $stack_name ) ) {
1589		- do_action( "elementor/element/common/{$section_id}/before_section_start", $this, $args );
1590		- }
1591		-
1592	1573	$args['type'] = Controls_Manager::SECTION;
1593	1574
1594	1575	$this->add_control( $section_id, $args );
1595	1576
		@@ -1628,12 +1609,8 @@
1628	1609	* @param Controls_Stack $this The control.
1629	1610	* @param array $args Section arguments.
1630	1611	*/
1631	1612	do_action( "elementor/element/{$stack_name}/{$section_id}/after_section_start", $this, $args );
1632		-
1633		- if ( $this->should_manually_trigger_common_action( $stack_name ) ) {
1634		- do_action( "elementor/element/common/{$section_id}/after_section_start", $this, $args );
1635		- }
1636	1613	}
1637	1614
1638	1615	/**
1639	1616	* End controls section.
		@@ -1682,12 +1659,8 @@
1682	1659	* @param array $args Section arguments.
1683	1660	*/
1684	1661	do_action( "elementor/element/{$stack_name}/{$section_id}/before_section_end", $this, $args );
1685	1662
1686		- if ( $this->should_manually_trigger_common_action( $stack_name ) ) {
1687		- do_action( "elementor/element/common/{$section_id}/before_section_end", $this, $args );
1688		- }
1689		-
1690	1663	$this->current_section = null;
1691	1664
1692	1665	/**
1693	1666	* After section end.
		@@ -1714,40 +1687,11 @@
1714	1687	* @param Controls_Stack $this The control.
1715	1688	* @param array $args Section arguments.
1716	1689	*/
1717	1690	do_action( "elementor/element/{$stack_name}/{$section_id}/after_section_end", $this, $args );
1718		-
1719		- if ( $this->should_manually_trigger_common_action( $stack_name ) ) {
1720		- do_action( "elementor/element/common/{$section_id}/after_section_end", $this, $args );
1721		- }
1722	1691	}
1723	1692
1724	1693	/**
1725		- * Should manually trigger common action.
1726		- *
1727		- * With the Optimized Markup experiment, the Advanced Tab has been split to maintain backward compatibility:
1728		- * - 'common' refers to the existing Advanced Tab.
1729		- * - 'common-optimized' refers to the new Advanced Tab for optimized widgets.
1730		- *
1731		- * Third-party developers may have used hooks like 'elementor/element/common/_section_background/before_section_end'
1732		- * to add controls to the Advanced Tab. However, this hook will now only work on widgets that are not optimized.
1733		- *
1734		- * This method checks whether the 'elementor/element/common/...' hooks should be manually executed
1735		- * to prevent third parties from needing to add equivalent hooks for 'elementor/element/common-optimized/...'.
1736		- *
1737		- * @todo Remove this method and the manual execution of 'common' hooks when the feature is merged.
1738		- *
1739		- * @access private
1740		- *
1741		- * @param string $stack_name Stack name.
1742		- *
1743		- * @return bool
1744		- */
1745		- private function should_manually_trigger_common_action( $stack_name ): bool {
1746		- return 'common-optimized' === $stack_name && Plugin::$instance->experiments->is_feature_active( 'e_optimized_markup' );
1747		- }
1748		-
1749		- /**
1750	1694	* Start controls tabs.
1751	1695	*
1752	1696	* Used to add a new set of tabs inside a section. You should use this
1753	1697	* method before adding new individual tabs using `start_controls_tab()`.
		@@ -2020,10 +1964,10 @@
2020	1964	*
2021	1965	* @since 2.7.0
2022	1966	* @access public
2023	1967	*
2024		- * @param string $element The HTML element.
2025		- * @param string $key Optional. Attribute key. Default is null.
	1968	+ * @param string $element The HTML element.
	1969	+ * @param string $key Optional. Attribute key. Default is null.
2026	1970	* @param array|string $values Optional. Attribute value/s. Default is null.
2027	1971	*/
2028	1972	public function remove_render_attribute( $element, $key = null, $values = null ) {
2029	1973	if ( $key && ! isset( $this->render_attributes[ $element ][ $key ] ) ) {
		@@ -2080,9 +2024,9 @@
2080	2024	*
2081	2025	* @param array|string $element The element.
2082	2026	*/
2083	2027	public function print_render_attribute_string( $element ) {
2084		- Utils::print_unescaped_internal_string( $this->get_render_attribute_string( $element ) );
	2028	+ echo $this->get_render_attribute_string( $element ); // XSS ok.
2085	2029	}
2086	2030
2087	2031	/**
2088	2032	* Print element template.
		@@ -2095,9 +2039,9 @@
2095	2039	public function print_template() {
2096	2040	ob_start();
2097	2041
2098	2042	// TODO: This is for backwards compatibility starting from 2.9.0
2099		- // This `if` statement should be removed when the method is removed.
	2043	+ // This `if` statement should be removed when the method is removed
2100	2044	if ( $this->has_own_method( '_content_template', self::class ) ) {
2101	2045	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_content_template', '2.9.0', __CLASS__ . '::content_template()' );
2102	2046
2103	2047	$this->_content_template();
		@@ -2143,9 +2087,9 @@
2143	2087	* @param array|null $controls The available controls.
2144	2088	*
2145	2089	* @return array Element data.
2146	2090	*/
2147		- public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ): array {
	2091	+ public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ) : array {
2148	2092	return $config;
2149	2093	}
2150	2094
2151	2095	/**
		@@ -2392,9 +2336,9 @@
2392	2336	*
2393	2337	* @param string $template_content Template content.
2394	2338	*/
2395	2339	protected function print_template_content( $template_content ) {
2396		- Utils::print_unescaped_internal_string( $template_content );
	2340	+ echo $template_content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
2397	2341	}
2398	2342
2399	2343	/**
2400	2344	* Render element output in the editor.
		@@ -2432,9 +2376,9 @@
2432	2376	protected function init_controls() {
2433	2377	Plugin::$instance->controls_manager->open_stack( $this );
2434	2378
2435	2379	// TODO: This is for backwards compatibility starting from 2.9.0
2436		- // This `if` statement should be removed when the method is removed.
	2380	+ // This `if` statement should be removed when the method is removed
2437	2381	if ( $this->has_own_method( '_register_controls', self::class ) ) {
2438	2382	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_register_controls', '3.1.0', __CLASS__ . '::register_controls()' );
2439	2383
2440	2384	$this->_register_controls();
		@@ -2579,9 +2523,9 @@
2579	2523	*/
2580	2524	public function __construct( array $data = [] ) {
2581	2525	if ( $data ) {
2582	2526	// TODO: This is for backwards compatibility starting from 2.9.0
2583		- // This if statement should be removed when the method is hard-deprecated.
	2527	+ // This if statement should be removed when the method is hard-deprecated
2584	2528	if ( $this->has_own_method( '_init', self::class ) ) {
2585	2529	Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_init', '2.9.0', __CLASS__ . '::init()' );
2586	2530
2587	2531	$this->_init( $data );