PluginProbe
Elementor Website Builder – more than just a page builder / 3.7.5
Elementor Website Builder – more than just a page builder v3.7.5
4.3.0-beta2 4.3.0-beta1 4.2.4 4.2.3 4.2.2 4.2.1 4.2.0 4.1.5 4.2.0-beta2 4.2.0-dev2 4.2.0-beta1 4.1.4 4.1.3 4.1.2 4.1.1 4.1.0 4.1.0-beta3 4.1.0-dev3 4.0.9 4.1.0-beta2 4.1.0-dev2 4.0.8 4.1.0-beta1 4.1.0-dev1 4.0.7 All 451 releases
← All changes | includes/base/controls-stack.php +98 -227 4.2.0-dev23.7.5 View file →
@@ -2,11 +2,10 @@
2 2 namespace Elementor;
3 3
4 4 use Elementor\Core\Base\Base_Object;
5 5 use Elementor\Core\DynamicTags\Manager;
6 +use Elementor\Core\Schemes\Manager as Schemes_Manager;
6 7 use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
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,26 +225,12 @@
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 - * Get widget number.
235 - *
236 - * Get the first three numbers of the element converted ID.
237 - *
238 - * @since 3.16
239 - * @access public
240 - *
241 - * @return string The widget number.
242 - */
243 - public function get_widget_number(): string {
244 - return substr( $this->get_id_int(), 0, 3 );
245 - }
246 -
247 - /**
248 233 * Get the type.
249 234 *
250 235 * Retrieve the type, e.g. 'stack', 'section', 'widget' etc.
251 236 *
@@ -311,26 +296,9 @@
311 296 *
312 297 * @return mixed Controls list.
313 298 */
314 299 public function get_controls( $control_id = null ) {
315 - $stack = $this->get_stack();
316 -
317 - if ( null !== $control_id ) {
318 - $control_data = self::get_items( $stack['controls'], $control_id );
319 - if ( null === $control_data && ! empty( $stack['style_controls'] ) ) {
320 - $control_data = self::get_items( $stack['style_controls'], $control_id );
321 - }
322 -
323 - return $control_data;
324 - }
325 -
326 - $controls = $stack['controls'];
327 -
328 - if ( Performance::is_use_style_controls() && ! empty( $stack['style_controls'] ) ) {
329 - $controls += $stack['style_controls'];
330 - }
331 -
332 - return self::get_items( $controls, $control_id );
300 + return self::get_items( $this->get_stack()['controls'], $control_id );
333 301 }
334 302
335 303 /**
336 304 * Get active controls.
@@ -349,9 +317,9 @@
349 317 * @param array $settings Optional. Controls settings. Default is null.
350 318 *
351 319 * @return array Active controls.
352 320 */
353 - public function get_active_controls( ?array $controls = null, ?array $settings = null ) {
321 + public function get_active_controls( array $controls = null, array $settings = null ) {
354 322 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.0.0' );
355 323
356 324 if ( ! $controls ) {
357 325 $controls = $this->get_controls();
@@ -364,9 +332,9 @@
364 332 $active_controls = array_reduce(
365 333 array_keys( $controls ), function( $active_controls, $control_key ) use ( $controls, $settings ) {
366 334 $control = $controls[ $control_key ];
367 335
368 - if ( $this->is_control_visible( $control, $settings, $controls ) ) {
336 + if ( $this->is_control_visible( $control, $settings ) ) {
369 337 $active_controls[ $control_key ] = $control;
370 338 }
371 339
372 340 return $active_controls;
@@ -449,50 +417,8 @@
449 417 $this->current_popover['initialized'] = true;
450 418 }
451 419 }
452 420
453 - if ( Performance::should_optimize_controls() ) {
454 - $ui_controls = [
455 - Controls_Manager::RAW_HTML,
456 - Controls_Manager::DIVIDER,
457 - Controls_Manager::HEADING,
458 - Controls_Manager::BUTTON,
459 - Controls_Manager::ALERT,
460 - Controls_Manager::NOTICE,
461 - Controls_Manager::DEPRECATED_NOTICE,
462 - ];
463 -
464 - if ( ! empty( $args['type'] ) && ! empty( $args['section'] ) && in_array( $args['type'], $ui_controls ) ) {
465 - $args = [
466 - 'type' => $args['type'],
467 - 'section' => $args['section'],
468 - ];
469 - }
470 -
471 - unset(
472 - $args['label_block'],
473 - $args['label'],
474 - $args['title'],
475 - $args['tab'],
476 - $args['options'],
477 - $args['placeholder'],
478 - $args['separator'],
479 - $args['size_units'],
480 - $args['range'],
481 - $args['toggle'],
482 - $args['ai'],
483 - $args['classes'],
484 - $args['style_transfer'],
485 - $args['show_label'],
486 - $args['description'],
487 - $args['label_on'],
488 - $args['label_off'],
489 - $args['labels'],
490 - $args['handles'],
491 - $args['editor_available'],
492 - );
493 - }
494 -
495 421 return Plugin::$instance->controls_manager->add_control_to_stack( $this, $id, $args, $options );
496 422 }
497 423
498 424 /**
@@ -612,10 +538,10 @@
612 538
613 539 $position = array_merge( $default_position, $position );
614 540
615 541 if (
616 - ( 'control' === $position['type'] && in_array( $position['at'], [ 'start', 'end' ], true ) ) ||
617 - ( 'section' === $position['type'] && in_array( $position['at'], [ 'before', 'after' ], true ) )
542 + 'control' === $position['type'] && in_array( $position['at'], [ 'start', 'end' ], true ) ||
543 + 'section' === $position['type'] && in_array( $position['at'], [ 'before', 'after' ], true )
618 544 ) {
619 545 _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 546
621 547 return false;
@@ -637,13 +563,13 @@
637 563
638 564 $controls_keys = array_keys( $registered_controls );
639 565
640 566 while ( Controls_Manager::SECTION !== $registered_controls[ $controls_keys[ $target_section_index ] ]['type'] ) {
641 - --$target_section_index;
567 + $target_section_index--;
642 568 }
643 569
644 570 if ( 'section' === $position['type'] ) {
645 - ++$target_control_index;
571 + $target_control_index++;
646 572
647 573 if ( 'end' === $position['at'] ) {
648 574 while ( Controls_Manager::SECTION !== $registered_controls[ $controls_keys[ $target_control_index ] ]['type'] ) {
649 575 if ( ++$target_control_index >= count( $registered_controls ) ) {
@@ -655,9 +581,9 @@
655 581
656 582 $target_control = $registered_controls[ $controls_keys[ $target_control_index ] ];
657 583
658 584 if ( 'after' === $position['at'] ) {
659 - ++$target_control_index;
585 + $target_control_index++;
660 586 }
661 587
662 588 $section_id = $registered_controls[ $controls_keys[ $target_section_index ] ]['name'];
663 589
@@ -737,9 +663,9 @@
737 663
738 664 $controls_keys = array_keys( $registered_controls );
739 665
740 666 while ( true ) {
741 - ++$section_index;
667 + $section_index++;
742 668
743 669 if ( ! isset( $controls_keys[ $section_index ] ) ) {
744 670 break;
745 671 }
@@ -750,9 +676,9 @@
750 676 break;
751 677 }
752 678
753 679 $section_controls[ $control_key ] = $registered_controls[ $control_key ];
754 - }
680 + };
755 681
756 682 return $section_controls;
757 683 }
758 684
@@ -781,8 +707,32 @@
781 707 $group->add_controls( $this, $args, $options );
782 708 }
783 709
784 710 /**
711 + * Get scheme controls.
712 + *
713 + * Retrieve all the controls that use schemes.
714 + *
715 + * @since 1.4.0
716 + * @access public
717 + * @deprecated 3.0.0
718 + *
719 + * @return array Scheme controls.
720 + */
721 + final public function get_scheme_controls() {
722 +
723 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.0.0' );
724 +
725 + $enabled_schemes = Schemes_Manager::get_enabled_schemes();
726 +
727 + return array_filter(
728 + $this->get_controls(), function ( $control ) use ( $enabled_schemes ) {
729 + return ( ! empty( $control['scheme'] ) && in_array( $control['scheme']['type'], $enabled_schemes ) );
730 + }
731 + );
732 + }
733 +
734 + /**
785 735 * Get style controls.
786 736 *
787 737 * Retrieve style controls for all active controls or, when requested, from
788 738 * a specific set of controls.
@@ -796,9 +746,9 @@
796 746 * @param array $settings Optional. Controls settings. Default is null.
797 747 *
798 748 * @return array Style controls.
799 749 */
800 - final public function get_style_controls( ?array $controls = null, ?array $settings = null ) {
750 + final public function get_style_controls( array $controls = null, array $settings = null ) {
801 751 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.0.0' );
802 752
803 753 $controls = $this->get_active_controls( $controls, $settings );
804 754
@@ -931,9 +881,9 @@
931 881 $control_args = $args;
932 882
933 883 // Set parent using the name from previous iteration.
934 884 if ( isset( $control_name ) ) {
935 - // If $control_name end with _widescreen use desktop name instead.
885 + // If $control_name end with _widescreen use desktop name instead
936 886 $control_args['parent'] = '_widescreen' === substr( $control_name, -strlen( '_widescreen' ) ) ? $id : $control_name;
937 887 } else {
938 888 $control_args['parent'] = null;
939 889 }
@@ -979,11 +929,9 @@
979 929 $id_suffix = Breakpoints_Manager::BREAKPOINT_KEY_DESKTOP === $device_name ? '' : '_' . $device_name;
980 930 $control_name = $id . $id_suffix;
981 931
982 932 // Set this control as child of previous iteration control.
983 - if ( ! empty( $control_args['parent'] ) ) {
984 - $this->update_control( $control_args['parent'], [ 'inheritors' => [ $control_name ] ] );
985 - }
933 + $this->update_control( $control_args['parent'], [ 'inheritors' => [ $control_name ] ] );
986 934
987 935 if ( ! empty( $options['overwrite'] ) ) {
988 936 $this->update_control( $control_name, $control_args, [
989 937 'recursive' => ! empty( $options['recursive'] ),
@@ -1060,10 +1008,10 @@
1060 1008 * @return array|null The config.
1061 1009 */
1062 1010 final public function get_config() {
1063 1011 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.
1012 + // TODO: This is for backwards compatibility starting from 2.9.0
1013 + // This if statement should be removed when the method is hard-deprecated
1066 1014 if ( $this->has_own_method( '_get_initial_config', self::class ) ) {
1067 1015 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_get_initial_config', '2.9.0', __CLASS__ . '::get_initial_config()' );
1068 1016
1069 1017 $this->config = $this->_get_initial_config();
@@ -1087,10 +1035,8 @@
1087 1035 * Set a config property.
1088 1036 *
1089 1037 * Set a specific property of the config list for this controls-stack.
1090 1038 *
1091 - * @param string $key
1092 - * @param string $value
1093 1039 * @since 3.5.0
1094 1040 * @access public
1095 1041 */
1096 1042 public function set_config( $key, $value ) {
@@ -1166,11 +1112,8 @@
1166 1112 return self::get_items( $this->data, $item );
1167 1113 }
1168 1114
1169 1115 /**
1170 - * @param null $setting
1171 - * @param null $settings
1172 - * @return array|mixed|null
1173 1116 * @since 2.0.14
1174 1117 * @access public
1175 1118 */
1176 1119 public function get_parsed_dynamic_settings( $setting = null, $settings = null ) {
@@ -1184,28 +1127,21 @@
1184 1127
1185 1128 return self::get_items( $this->parsed_dynamic_settings, $setting );
1186 1129 }
1187 1130
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 1131 /**
1196 1132 * Get active settings.
1197 1133 *
1198 1134 * Retrieve the settings from all the active controls.
1199 1135 *
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.
1136 + * @since 1.4.0
1204 1137 * @since 2.1.0 Added the `controls` and the `settings` parameters.
1205 1138 * @access public
1206 1139 *
1207 - * @since 1.4.0
1140 + * @param array $controls Optional. An array of controls. Default is null.
1141 + * @param array $settings Optional. Controls settings. Default is null.
1142 + *
1143 + * @return array Active settings.
1208 1144 */
1209 1145 public function get_active_settings( $settings = null, $controls = null ) {
1210 1146 $is_first_request = ! $settings && ! $this->active_settings;
1211 1147
@@ -1220,10 +1156,8 @@
1220 1156 }
1221 1157
1222 1158 $active_settings = [];
1223 1159
1224 - $controls_objs = Plugin::$instance->controls_manager->get_controls();
1225 -
1226 1160 foreach ( $settings as $setting_key => $setting ) {
1227 1161 if ( ! isset( $controls[ $setting_key ] ) ) {
1228 1162 $active_settings[ $setting_key ] = $setting;
1229 1163
@@ -1231,10 +1165,10 @@
1231 1165 }
1232 1166
1233 1167 $control = $controls[ $setting_key ];
1234 1168
1235 - if ( $this->is_control_visible( $control, $settings, $controls ) ) {
1236 - $control_obj = $controls_objs[ $control['type'] ] ?? null;
1169 + if ( $this->is_control_visible( $control, $settings ) ) {
1170 + $control_obj = Plugin::$instance->controls_manager->get_control( $control['type'] );
1237 1171
1238 1172 if ( $control_obj instanceof Control_Repeater ) {
1239 1173 foreach ( $setting as & $item ) {
1240 1174 $item = $this->get_active_settings( $item, $control['fields'] );
@@ -1301,13 +1235,11 @@
1301 1235 if ( null === $controls ) {
1302 1236 $controls = $this->get_controls();
1303 1237 }
1304 1238
1305 - $controls_objs = Plugin::$instance->controls_manager->get_controls();
1306 -
1307 1239 foreach ( $controls as $control ) {
1308 1240 $control_name = $control['name'];
1309 - $control_obj = $controls_objs[ $control['type'] ] ?? null;
1241 + $control_obj = Plugin::$instance->controls_manager->get_control( $control['type'] );
1310 1242
1311 1243 if ( ! $control_obj instanceof Base_Data_Control ) {
1312 1244 continue;
1313 1245 }
@@ -1419,16 +1351,21 @@
1419 1351
1420 1352 /**
1421 1353 * Get Responsive Control Device Suffix
1422 1354 *
1423 - * @deprecated 3.7.6 Use `Elementor\Controls_Manager::get_responsive_control_device_suffix()` instead.
1424 1355 * @param array $control
1425 1356 * @return string $device suffix
1426 1357 */
1427 1358 protected function get_responsive_control_device_suffix( $control ) {
1428 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.7.6', 'Elementor\Controls_Manager::get_responsive_control_device_suffix()' );
1359 + if ( ! empty( $control['responsive']['max'] ) ) {
1360 + $query_device = $control['responsive']['max'];
1361 + } elseif ( ! empty( $control['responsive']['min'] ) ) {
1362 + $query_device = $control['responsive']['min'];
1363 + } else {
1364 + return '';
1365 + }
1429 1366
1430 - return Controls_Manager::get_responsive_control_device_suffix( $control );
1367 + return 'desktop' === $query_device ? '' : '_' . $query_device;
1431 1368 }
1432 1369
1433 1370 /**
1434 1371 * Whether the control is visible or not.
@@ -1434,16 +1371,17 @@
1434 1371 * Whether the control is visible or not.
1435 1372 *
1436 1373 * Used to determine whether the control is visible or not.
1437 1374 *
1375 + * @since 1.4.0
1376 + * @access public
1377 + *
1438 1378 * @param array $control The control.
1439 - * @param null $values Optional. Condition values. Default is null.
1440 - * @param null $controls
1379 + * @param array $values Optional. Condition values. Default is null.
1380 + *
1441 1381 * @return bool Whether the control is visible.
1442 - * @since 1.4.0
1443 - * @access public
1444 1382 */
1445 - public function is_control_visible( $control, $values = null, $controls = null ) {
1383 + public function is_control_visible( $control, $values = null ) {
1446 1384 if ( null === $values ) {
1447 1385 $values = $this->get_settings();
1448 1386 }
1449 1387
@@ -1454,11 +1392,9 @@
1454 1392 if ( empty( $control['condition'] ) ) {
1455 1393 return true;
1456 1394 }
1457 1395
1458 - if ( ! $controls ) {
1459 - $controls = $this->get_controls();
1460 - }
1396 + $controls = $this->get_controls();
1461 1397
1462 1398 foreach ( $control['condition'] as $condition_key => $condition_value ) {
1463 1399 preg_match( '/([a-z_\-0-9]+)(?:\[([a-z_]+)])?(!?)$/i', $condition_key, $condition_key_parts );
1464 1400
@@ -1463,9 +1399,9 @@
1463 1399 preg_match( '/([a-z_\-0-9]+)(?:\[([a-z_]+)])?(!?)$/i', $condition_key, $condition_key_parts );
1464 1400
1465 1401 $pure_condition_key = $condition_key_parts[1];
1466 1402 $condition_sub_key = $condition_key_parts[2];
1467 - $is_negative_condition = (bool) $condition_key_parts[3];
1403 + $is_negative_condition = ! ! $condition_key_parts[3];
1468 1404
1469 1405 if ( ! isset( $values[ $pure_condition_key ] ) || null === $values[ $pure_condition_key ] ) {
1470 1406 return false;
1471 1407 }
@@ -1473,26 +1409,18 @@
1473 1409 $are_control_and_condition_responsive = isset( $control['responsive'] ) && ! empty( $controls[ $pure_condition_key ]['responsive'] );
1474 1410 $condition_name_to_check = $pure_condition_key;
1475 1411
1476 1412 if ( $are_control_and_condition_responsive ) {
1477 - $device_suffix = Controls_Manager::get_responsive_control_device_suffix( $control );
1413 + $device_suffix = $this->get_responsive_control_device_suffix( $control );
1478 1414
1479 1415 $condition_name_to_check = $pure_condition_key . $device_suffix;
1480 1416
1481 - // If the control is not desktop, and a conditioning control for the corresponding device exists, use it.
1482 - $instance_value = $values[ $pure_condition_key . $device_suffix ] ?? $values[ $pure_condition_key ];
1417 + // If the control is not desktop, take the value of the conditioning control of the corresponding device.
1418 + $instance_value = $values[ $pure_condition_key . $device_suffix ];
1483 1419 } else {
1484 1420 $instance_value = $values[ $pure_condition_key ];
1485 1421 }
1486 1422
1487 - if ( $condition_sub_key && is_array( $instance_value ) ) {
1488 - if ( ! isset( $instance_value[ $condition_sub_key ] ) ) {
1489 - return false;
1490 - }
1491 -
1492 - $instance_value = $instance_value[ $condition_sub_key ];
1493 - }
1494 -
1495 1423 if ( ! $instance_value ) {
1496 1424 $parent = isset( $controls[ $condition_name_to_check ]['parent'] ) ? $controls[ $condition_name_to_check ]['parent'] : false;
1497 1425
1498 1426 while ( $parent ) {
@@ -1498,23 +1426,20 @@
1498 1426 while ( $parent ) {
1499 1427 $instance_value = $values[ $parent ];
1500 1428
1501 1429 if ( $instance_value ) {
1502 - if ( ! is_array( $instance_value ) ) {
1503 - break;
1504 - }
1505 -
1506 - if ( $condition_sub_key && isset( $instance_value[ $condition_sub_key ] ) ) {
1507 - $instance_value = $instance_value[ $condition_sub_key ];
1508 -
1509 - if ( '' !== $instance_value ) {
1510 - break;
1511 - }
1512 - }
1430 + break;
1513 1431 }
1432 + $parent = isset( $controls[ $parent ]['parent'] ) ? $controls[ $parent ]['parent'] : false;
1433 + }
1434 + }
1514 1435
1515 - $parent = isset( $controls[ $parent ]['parent'] ) ? $controls[ $parent ]['parent'] : false;
1436 + if ( $condition_sub_key && is_array( $instance_value ) ) {
1437 + if ( ! isset( $instance_value[ $condition_sub_key ] ) ) {
1438 + return false;
1516 1439 }
1440 +
1441 + $instance_value = $instance_value[ $condition_sub_key ];
1517 1442 }
1518 1443
1519 1444 /**
1520 1445 * If the $condition_value is a non empty array - check if the $condition_value contains the $instance_value,
@@ -1528,12 +1453,9 @@
1528 1453 } else {
1529 1454 $is_contains = $instance_value === $condition_value;
1530 1455 }
1531 1456
1532 - if (
1533 - ( $is_negative_condition && $is_contains ) ||
1534 - ( ! $is_negative_condition && ! $is_contains )
1535 - ) {
1457 + if ( $is_negative_condition && $is_contains || ! $is_negative_condition && ! $is_contains ) {
1536 1458 return false;
1537 1459 }
1538 1460 }
1539 1461
@@ -1584,12 +1506,8 @@
1584 1506 * @param array $args Section arguments.
1585 1507 */
1586 1508 do_action( "elementor/element/{$stack_name}/{$section_id}/before_section_start", $this, $args );
1587 1509
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 1510 $args['type'] = Controls_Manager::SECTION;
1593 1511
1594 1512 $this->add_control( $section_id, $args );
1595 1513
@@ -1628,12 +1546,8 @@
1628 1546 * @param Controls_Stack $this The control.
1629 1547 * @param array $args Section arguments.
1630 1548 */
1631 1549 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 1550 }
1637 1551
1638 1552 /**
1639 1553 * End controls section.
@@ -1682,12 +1596,8 @@
1682 1596 * @param array $args Section arguments.
1683 1597 */
1684 1598 do_action( "elementor/element/{$stack_name}/{$section_id}/before_section_end", $this, $args );
1685 1599
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 1600 $this->current_section = null;
1691 1601
1692 1602 /**
1693 1603 * After section end.
@@ -1714,40 +1624,11 @@
1714 1624 * @param Controls_Stack $this The control.
1715 1625 * @param array $args Section arguments.
1716 1626 */
1717 1627 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 1628 }
1723 1629
1724 1630 /**
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 1631 * Start controls tabs.
1751 1632 *
1752 1633 * Used to add a new set of tabs inside a section. You should use this
1753 1634 * method before adding new individual tabs using `start_controls_tab()`.
@@ -2020,10 +1901,10 @@
2020 1901 *
2021 1902 * @since 2.7.0
2022 1903 * @access public
2023 1904 *
2024 - * @param string $element The HTML element.
2025 - * @param string $key Optional. Attribute key. Default is null.
1905 + * @param string $element The HTML element.
1906 + * @param string $key Optional. Attribute key. Default is null.
2026 1907 * @param array|string $values Optional. Attribute value/s. Default is null.
2027 1908 */
2028 1909 public function remove_render_attribute( $element, $key = null, $values = null ) {
2029 1910 if ( $key && ! isset( $this->render_attributes[ $element ][ $key ] ) ) {
@@ -2080,9 +1961,9 @@
2080 1961 *
2081 1962 * @param array|string $element The element.
2082 1963 */
2083 1964 public function print_render_attribute_string( $element ) {
2084 - Utils::print_unescaped_internal_string( $this->get_render_attribute_string( $element ) );
1965 + echo $this->get_render_attribute_string( $element ); // XSS ok.
2085 1966 }
2086 1967
2087 1968 /**
2088 1969 * Print element template.
@@ -2095,9 +1976,9 @@
2095 1976 public function print_template() {
2096 1977 ob_start();
2097 1978
2098 1979 // TODO: This is for backwards compatibility starting from 2.9.0
2099 - // This `if` statement should be removed when the method is removed.
1980 + // This `if` statement should be removed when the method is removed
2100 1981 if ( $this->has_own_method( '_content_template', self::class ) ) {
2101 1982 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_content_template', '2.9.0', __CLASS__ . '::content_template()' );
2102 1983
2103 1984 $this->_content_template();
@@ -2133,19 +2014,13 @@
2133 2014 <?php
2134 2015 }
2135 2016
2136 2017 /**
2137 - * On import update dynamic content (e.g. post and term IDs).
2138 2018 *
2139 - * @since 3.8.0
2140 - *
2141 - * @param array $config The config of the passed element.
2142 - * @param array $data The data that requires updating/replacement when imported.
2143 - * @param array|null $controls The available controls.
2144 - *
2145 - * @return array Element data.
2019 + * @since 3.6.0
2020 + * @access public
2146 2021 */
2147 - public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ): array {
2022 + public static function on_import_replace_dynamic_content( $config, $map_old_new_post_ids ) {
2148 2023 return $config;
2149 2024 }
2150 2025
2151 2026 /**
@@ -2224,12 +2099,12 @@
2224 2099 * `start_controls_tab()`.
2225 2100 *
2226 2101 * @since 1.4.0
2227 2102 * @access protected
2228 - * @deprecated 3.1.0 Use `register_controls()` method instead.
2103 + * @deprecated 3.1.0 Use `Controls_Stack::register_controls()` instead
2229 2104 */
2230 2105 protected function _register_controls() {
2231 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'register_controls()' );
2106 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::register_controls()' );
2232 2107
2233 2108 $this->register_controls();
2234 2109 }
2235 2110
@@ -2272,12 +2147,10 @@
2272 2147 */
2273 2148 protected function get_init_settings() {
2274 2149 $settings = $this->get_data( 'settings' );
2275 2150
2276 - $controls_objs = Plugin::$instance->controls_manager->get_controls();
2277 -
2278 2151 foreach ( $this->get_controls() as $control ) {
2279 - $control_obj = $controls_objs[ $control['type'] ] ?? null;
2152 + $control_obj = Plugin::$instance->controls_manager->get_control( $control['type'] );
2280 2153
2281 2154 if ( ! $control_obj instanceof Base_Data_Control ) {
2282 2155 continue;
2283 2156 }
@@ -2313,15 +2186,15 @@
2313 2186 * Retrieve the current element initial configuration - controls list and
2314 2187 * the tabs assigned to the control.
2315 2188 *
2316 2189 * @since 1.4.0
2317 - * @deprecated 2.9.0 Use `get_initial_config()` method instead.
2190 + * @deprecated 2.9.0 use `get_initial_config()` instead
2318 2191 * @access protected
2319 2192 *
2320 2193 * @return array The initial config.
2321 2194 */
2322 2195 protected function _get_initial_config() {
2323 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', 'get_initial_config()' );
2196 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', __CLASS__ . '::get_initial_config()' );
2324 2197
2325 2198 return $this->get_initial_config();
2326 2199 }
2327 2200
@@ -2392,9 +2265,9 @@
2392 2265 *
2393 2266 * @param string $template_content Template content.
2394 2267 */
2395 2268 protected function print_template_content( $template_content ) {
2396 - Utils::print_unescaped_internal_string( $template_content );
2269 + echo $template_content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
2397 2270 }
2398 2271
2399 2272 /**
2400 2273 * Render element output in the editor.
@@ -2411,13 +2284,13 @@
2411 2284 *
2412 2285 * Used to generate the live preview, using a Backbone JavaScript template.
2413 2286 *
2414 2287 * @since 2.0.0
2415 - * @deprecated 2.9.0 Use `content_template()` method instead.
2288 + * @deprecated 2.9.0 use `content_template()` instead
2416 2289 * @access protected
2417 2290 */
2418 2291 protected function _content_template() {
2419 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', 'content_template()' );
2292 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', __CLASS__ . '::content_template()' );
2420 2293
2421 2294 $this->content_template();
2422 2295 }
2423 2296
@@ -2432,9 +2305,9 @@
2432 2305 protected function init_controls() {
2433 2306 Plugin::$instance->controls_manager->open_stack( $this );
2434 2307
2435 2308 // TODO: This is for backwards compatibility starting from 2.9.0
2436 - // This `if` statement should be removed when the method is removed.
2309 + // This `if` statement should be removed when the method is removed
2437 2310 if ( $this->has_own_method( '_register_controls', self::class ) ) {
2438 2311 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_register_controls', '3.1.0', __CLASS__ . '::register_controls()' );
2439 2312
2440 2313 $this->_register_controls();
@@ -2470,11 +2343,9 @@
2470 2343 if ( null !== $target_tab ) {
2471 2344 $args = array_replace_recursive( $target_tab, $args );
2472 2345 }
2473 2346 } elseif ( empty( $args['section'] ) && ( ! $overwrite || is_wp_error( Plugin::$instance->controls_manager->get_control_from_stack( $this->get_unique_name(), $control_id ) ) ) ) {
2474 - if ( ! Performance::should_optimize_controls() ) {
2475 - wp_die( sprintf( '%s::%s: Cannot add a control outside of a section (use `start_controls_section`).', get_called_class(), __FUNCTION__ ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
2476 - }
2347 + wp_die( sprintf( '%s::%s: Cannot add a control outside of a section (use `start_controls_section`).', get_called_class(), __FUNCTION__ ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
2477 2348 }
2478 2349
2479 2350 return $args;
2480 2351 }
@@ -2500,15 +2371,15 @@
2500 2371 *
2501 2372 * Set the raw data, the ID and the parsed settings.
2502 2373 *
2503 2374 * @since 1.4.0
2504 - * @deprecated 2.9.0 Use `init()` method instead.
2375 + * @deprecated 2.9.0 use `init()` instead
2505 2376 * @access protected
2506 2377 *
2507 2378 * @param array $data Initial data.
2508 2379 */
2509 2380 protected function _init( $data ) {
2510 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', 'init()' );
2381 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '2.9.0', __CLASS__ . '::init()' );
2511 2382
2512 2383 $this->init( $data );
2513 2384 }
2514 2385
@@ -2579,9 +2450,9 @@
2579 2450 */
2580 2451 public function __construct( array $data = [] ) {
2581 2452 if ( $data ) {
2582 2453 // TODO: This is for backwards compatibility starting from 2.9.0
2583 - // This if statement should be removed when the method is hard-deprecated.
2454 + // This if statement should be removed when the method is hard-deprecated
2584 2455 if ( $this->has_own_method( '_init', self::class ) ) {
2585 2456 Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( '_init', '2.9.0', __CLASS__ . '::init()' );
2586 2457
2587 2458 $this->_init( $data );