PluginProbe
Elementor Website Builder – more than just a page builder / 3.13.3
Elementor Website Builder – more than just a page builder v3.13.3
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/element-base.php +34 -143 4.0.93.13.3 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 *
@@ -344,23 +320,8 @@
344 320 return self::get_items( $this->default_args, $item );
345 321 }
346 322
347 323 /**
348 - * Get panel presets.
349 - *
350 - * Used for displaying the widget in the panel multiple times, but with different defaults values,
351 - * icon, title etc.
352 - *
353 - * @since 3.16.0
354 - * @access public
355 - *
356 - * @return array
357 - */
358 - public function get_panel_presets() {
359 - return [];
360 - }
361 -
362 - /**
363 324 * Add new child element.
364 325 *
365 326 * Register new child element to allow hierarchy.
366 327 *
@@ -406,14 +367,15 @@
406 367 * @since 2.8.0
407 368 * @access public
408 369 *
409 370 * @param array|string $element The HTML element.
410 - * @param array $url_control Array of link settings.
411 - * @param bool $overwrite Optional. Whether to overwrite existing
412 - * 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.
413 374 *
414 375 * @return Element_Base Current instance of the element.
415 376 */
377 +
416 378 public function add_link_attributes( $element, array $url_control, $overwrite = false ) {
417 379 $attributes = [];
418 380
419 381 if ( ! empty( $url_control['url'] ) ) {
@@ -430,9 +392,9 @@
430 392 $attributes['rel'] = 'nofollow';
431 393 }
432 394
433 395 if ( ! empty( $url_control['custom_attributes'] ) ) {
434 - // 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
435 397 $attributes = array_merge( $attributes, Utils::parse_custom_attributes( $url_control['custom_attributes'] ) );
436 398 }
437 399
438 400 if ( $attributes ) {
@@ -452,15 +414,8 @@
452 414 */
453 415 public function print_element() {
454 416 $element_type = $this->get_type();
455 417
456 - if ( $this->should_render_shortcode() ) {
457 - $unique_id = apply_filters( 'elementor/element_cache/unique_id', '' );
458 -
459 - echo '[elementor-element k="' . esc_attr( $unique_id ) . '" data="' . esc_attr( base64_encode( wp_json_encode( $this->get_raw_data() ) ) ) . '"]';
460 - return;
461 - }
462 -
463 418 /**
464 419 * Before frontend element render.
465 420 *
466 421 * Fires before Elementor element is rendered in the frontend.
@@ -523,10 +478,8 @@
523 478 // PHPCS - The content has already been escaped by the `render` method.
524 479 echo $content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
525 480 $this->after_render();
526 481
527 - // TODO: Remove this in the future
528 - // Since version 3.24.0 page scripts/styles are handled by `page_assets`.
529 482 $this->enqueue_scripts();
530 483 $this->enqueue_styles();
531 484 }
532 485
@@ -554,54 +507,8 @@
554 507 */
555 508 do_action( 'elementor/frontend/after_render', $this );
556 509 }
557 510
558 - protected function should_render_shortcode() {
559 - $should_render_shortcode = apply_filters( 'elementor/element/should_render_shortcode', false );
560 -
561 - if ( ! $should_render_shortcode ) {
562 - return false;
563 - }
564 -
565 - $raw_data = $this->get_raw_data();
566 -
567 - if ( ! empty( $raw_data['settings']['_element_cache'] ) ) {
568 - return 'yes' === $raw_data['settings']['_element_cache'];
569 - }
570 -
571 - if ( $this->is_dynamic_content() ) {
572 - return true;
573 - }
574 -
575 - $is_dynamic_content = apply_filters( 'elementor/element/is_dynamic_content', false, $raw_data, $this );
576 -
577 - $has_dynamic_tag = $this->has_element_dynamic_tag( $raw_data['settings'] );
578 -
579 - if ( $is_dynamic_content || $has_dynamic_tag ) {
580 - return true;
581 - }
582 -
583 - return false;
584 - }
585 -
586 - private function has_element_dynamic_tag( $element_settings ): bool {
587 - if ( is_array( $element_settings ) ) {
588 - if ( ! empty( $element_settings['__dynamic__'] ) ) {
589 - return true;
590 - }
591 -
592 - foreach ( $element_settings as $value ) {
593 - $has_dynamic = $this->has_element_dynamic_tag( $value );
594 -
595 - if ( $has_dynamic ) {
596 - return true;
597 - }
598 - }
599 - }
600 -
601 - return false;
602 - }
603 -
604 511 /**
605 512 * Get the element raw data.
606 513 *
607 514 * Retrieve the raw element data, including the id, type, settings, child
@@ -704,9 +611,9 @@
704 611 * @param array|null $controls The available controls.
705 612 *
706 613 * @return array Element data.
707 614 */
708 - 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 {
709 616 $tags_manager = Plugin::$instance->dynamic_tags;
710 617
711 618 if ( empty( $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ] ) ) {
712 619 return $config;
@@ -739,12 +646,12 @@
739 646 * Used to add attributes to the current element wrapper HTML tag.
740 647 *
741 648 * @since 1.3.0
742 649 * @access protected
743 - * @deprecated 3.1.0 Use `add_render_attribute()` method instead.
650 + * @deprecated 3.1.0
744 651 */
745 652 protected function _add_render_attributes() {
746 - 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()' );
747 654
748 655 return $this->add_render_attributes();
749 656 }
750 657
@@ -769,9 +676,8 @@
769 676 'elementor-element-' . $id,
770 677 ],
771 678 'data-id' => $id,
772 679 'data-element_type' => $this->get_type(),
773 - 'data-e-type' => $this->get_type(),
774 680 ] );
775 681
776 682 $class_settings = [];
777 683
@@ -776,15 +682,9 @@
776 682 $class_settings = [];
777 683
778 684 foreach ( $settings as $setting_key => $setting ) {
779 685 if ( isset( $controls[ $setting_key ]['prefix_class'] ) ) {
780 - if ( isset( $controls[ $setting_key ]['classes_dictionary'][ $setting ] ) ) {
781 - $value = $controls[ $setting_key ]['classes_dictionary'][ $setting ];
782 - } else {
783 - $value = $setting;
784 - }
785 -
786 - $class_settings[ $setting_key ] = $value;
686 + $class_settings[ $setting_key ] = $setting;
787 687 }
788 688 }
789 689
790 690 foreach ( $class_settings as $setting_key => $setting ) {
@@ -796,15 +696,15 @@
796 696 }
797 697
798 698 $_animation = ! empty( $settings['_animation'] );
799 699 $animation = ! empty( $settings['animation'] );
800 - $has_animation = ( $_animation && 'none' !== $settings['_animation'] ) || ( $animation && 'none' !== $settings['animation'] );
700 + $has_animation = $_animation && 'none' !== $settings['_animation'] || $animation && 'none' !== $settings['animation'];
801 701
802 702 if ( $has_animation ) {
803 703 $is_static_render_mode = Plugin::$instance->frontend->is_static_render_mode();
804 704
805 705 if ( ! $is_static_render_mode ) {
806 - // Hide the element until the animation begins.
706 + // Hide the element until the animation begins
807 707 $this->add_render_attribute( '_wrapper', 'class', 'elementor-invisible' );
808 708 }
809 709 }
810 710
@@ -832,15 +732,13 @@
832 732 * Register the Transform controls in the advanced tab of the element.
833 733 *
834 734 * Previously registered under the Widget_Common class, but registered a more fundamental level now to enable access from other widgets.
835 735 *
836 - * @param string $element_selector
837 - * @param string $transform_selector_class
838 - * @return void
839 736 * @since 3.9.0
840 737 * @access protected
738 + * @return void
841 739 */
842 - protected function register_transform_section( $element_selector = '', $transform_selector_class = ' > .elementor-widget-container' ) {
740 + protected function register_transform_section( $element_selector = '' ) {
843 741 $default_unit_values_deg = [];
844 742 $default_unit_values_ms = [];
845 743
846 744 // Set the default unit sizes for all active breakpoints.
@@ -869,8 +767,9 @@
869 767 $this->start_controls_tabs( '_tabs_positioning' );
870 768
871 769 $transform_prefix_class = 'e-';
872 770 $transform_return_value = 'transform';
771 + $transform_selector_class = ' > .elementor-widget-container';
873 772 $transform_css_modifier = '';
874 773
875 774 if ( 'con' === $element_selector ) {
876 775 $transform_selector_class = '.e-' . $element_selector;
@@ -901,9 +800,9 @@
901 800
902 801 $this->add_responsive_control(
903 802 "_transform_rotateZ_effect{$tab}",
904 803 [
905 - 'label' => esc_html__( 'Rotate', 'elementor' ) . ' (deg)',
804 + 'label' => esc_html__( 'Rotate', 'elementor' ),
906 805 'type' => Controls_Manager::SLIDER,
907 806 'device_args' => $default_unit_values_deg,
908 807 'range' => [
909 808 'px' => [
@@ -933,9 +832,8 @@
933 832 ],
934 833 'condition' => [
935 834 "_transform_rotate_popover{$tab}!" => '',
936 835 ],
937 - 'frontend_available' => true,
938 836 ]
939 837 );
940 838
941 839 $this->add_responsive_control(
@@ -940,9 +838,9 @@
940 838
941 839 $this->add_responsive_control(
942 840 "_transform_rotateX_effect{$tab}",
943 841 [
944 - 'label' => esc_html__( 'Rotate X', 'elementor' ) . ' (deg)',
842 + 'label' => esc_html__( 'Rotate X', 'elementor' ),
945 843 'type' => Controls_Manager::SLIDER,
946 844 'device_args' => $default_unit_values_deg,
947 845 'range' => [
948 846 'px' => [
@@ -963,9 +861,9 @@
963 861
964 862 $this->add_responsive_control(
965 863 "_transform_rotateY_effect{$tab}",
966 864 [
967 - 'label' => esc_html__( 'Rotate Y', 'elementor' ) . ' (deg)',
865 + 'label' => esc_html__( 'Rotate Y', 'elementor' ),
968 866 'type' => Controls_Manager::SLIDER,
969 867 'device_args' => $default_unit_values_deg,
970 868 'range' => [
971 869 'px' => [
@@ -986,12 +884,13 @@
986 884
987 885 $this->add_responsive_control(
988 886 "_transform_perspective_effect{$tab}",
989 887 [
990 - 'label' => esc_html__( 'Perspective', 'elementor' ) . ' (px)',
888 + 'label' => esc_html__( 'Perspective', 'elementor' ),
991 889 'type' => Controls_Manager::SLIDER,
992 890 'range' => [
993 891 'px' => [
892 + 'min' => 0,
994 893 'max' => 1000,
995 894 ],
996 895 ],
997 896 'condition' => [
@@ -1102,8 +1001,9 @@
1102 1001 'label' => esc_html__( 'Scale', 'elementor' ),
1103 1002 'type' => Controls_Manager::SLIDER,
1104 1003 'range' => [
1105 1004 'px' => [
1005 + 'min' => 0,
1106 1006 'max' => 2,
1107 1007 'step' => 0.1,
1108 1008 ],
1109 1009 ],
@@ -1124,8 +1024,9 @@
1124 1024 'label' => esc_html__( 'Scale X', 'elementor' ),
1125 1025 'type' => Controls_Manager::SLIDER,
1126 1026 'range' => [
1127 1027 'px' => [
1028 + 'min' => 0,
1128 1029 'max' => 2,
1129 1030 'step' => 0.1,
1130 1031 ],
1131 1032 ],
@@ -1146,8 +1047,9 @@
1146 1047 'label' => esc_html__( 'Scale Y', 'elementor' ),
1147 1048 'type' => Controls_Manager::SLIDER,
1148 1049 'range' => [
1149 1050 'px' => [
1051 + 'min' => 0,
1150 1052 'max' => 2,
1151 1053 'step' => 0.1,
1152 1054 ],
1153 1055 ],
@@ -1178,9 +1080,9 @@
1178 1080
1179 1081 $this->add_responsive_control(
1180 1082 "_transform_skewX_effect{$tab}",
1181 1083 [
1182 - 'label' => esc_html__( 'Skew X', 'elementor' ) . ' (deg)',
1084 + 'label' => esc_html__( 'Skew X', 'elementor' ),
1183 1085 'type' => Controls_Manager::SLIDER,
1184 1086 'device_args' => $default_unit_values_deg,
1185 1087 'range' => [
1186 1088 'px' => [
@@ -1200,9 +1102,9 @@
1200 1102
1201 1103 $this->add_responsive_control(
1202 1104 "_transform_skewY_effect{$tab}",
1203 1105 [
1204 - 'label' => esc_html__( 'Skew Y', 'elementor' ) . ' (deg)',
1106 + 'label' => esc_html__( 'Skew Y', 'elementor' ),
1205 1107 'type' => Controls_Manager::SLIDER,
1206 1108 'device_args' => $default_unit_values_deg,
1207 1109 'range' => [
1208 1110 'px' => [
@@ -1268,11 +1170,10 @@
1268 1170 'type' => Controls_Manager::SLIDER,
1269 1171 'device_args' => $default_unit_values_ms,
1270 1172 'range' => [
1271 1173 'px' => [
1272 - 'min' => 0,
1174 + 'min' => 100,
1273 1175 'max' => 10000,
1274 - 'step' => 100,
1275 1176 ],
1276 1177 ],
1277 1178 'selectors' => [
1278 1179 '{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-transition-duration: {{SIZE}}ms',
@@ -1313,9 +1214,9 @@
1313 1214 'relation' => 'or',
1314 1215 'terms' => array_merge( $transform_origin_conditions, $transform_origin_conditions_hover ),
1315 1216 ];
1316 1217
1317 - // Will override motion effect transform-origin.
1218 + // Will override motion effect transform-origin
1318 1219 $this->add_responsive_control(
1319 1220 'motion_fx_transform_x_anchor_point',
1320 1221 [
1321 1222 'label' => esc_html__( 'X Anchor Point', 'elementor' ),
@@ -1341,9 +1242,9 @@
1341 1242 ],
1342 1243 ]
1343 1244 );
1344 1245
1345 - // Will override motion effect transform-origin.
1246 + // Will override motion effect transform-origin
1346 1247 $this->add_responsive_control(
1347 1248 'motion_fx_transform_y_anchor_point',
1348 1249 [
1349 1250 'label' => esc_html__( 'Y Anchor Point', 'elementor' ),
@@ -1390,13 +1291,10 @@
1390 1291
1391 1292 $this->add_control(
1392 1293 'hide_' . $breakpoint_key,
1393 1294 [
1394 - 'label' => sprintf(
1395 - /* translators: %s: Device name. */
1396 - esc_html__( 'Hide On %s', 'elementor' ),
1397 - $label
1398 - ),
1295 + /* translators: %s: Device name. */
1296 + 'label' => sprintf( __( 'Hide On %s', 'elementor' ), $label ),
1399 1297 'type' => Controls_Manager::SWITCHER,
1400 1298 'default' => '',
1401 1299 'prefix_class' => 'elementor-',
1402 1300 'label_on' => esc_html__( 'Hide', 'elementor' ),
@@ -1434,12 +1332,12 @@
1434 1332 * Output the element final HTML on the frontend.
1435 1333 *
1436 1334 * @since 1.0.0
1437 1335 * @access protected
1438 - * @deprecated 3.1.0 Use `print_content()` method instead.
1336 + * @deprecated 3.1.0
1439 1337 */
1440 1338 protected function _print_content() {
1441 - 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()' );
1442 1340
1443 1341 $this->print_content();
1444 1342 }
1445 1343
@@ -1494,11 +1392,8 @@
1494 1392
1495 1393 /**
1496 1394 * A Base method for sanitizing the settings before save.
1497 1395 * This method is meant to be overridden by the element.
1498 - *
1499 - * @param array $settings
1500 - * @return array
1501 1396 */
1502 1397 protected function on_save( array $settings ) {
1503 1398 return $settings;
1504 1399 }
@@ -1517,9 +1412,9 @@
1517 1412 */
1518 1413 private function get_child_type( $element_data ) {
1519 1414 $child_type = $this->_get_default_child_type( $element_data );
1520 1415
1521 - // If it's not a valid widget ( like a deactivated plugin ).
1416 + // If it's not a valid widget ( like a deactivated plugin )
1522 1417 if ( ! $child_type ) {
1523 1418 return false;
1524 1419 }
1525 1420
@@ -1564,12 +1459,8 @@
1564 1459 $this->add_child( $child_data );
1565 1460 }
1566 1461 }
1567 1462
1568 - public function has_widget_inner_wrapper(): bool {
1569 - return true;
1570 - }
1571 -
1572 1463 /**
1573 1464 * Element base constructor.
1574 1465 *
1575 1466 * Initializing the element base class using `$data` and `$args`.
@@ -1582,9 +1473,9 @@
1582 1473 *
1583 1474 * @param array $data Optional. Element data. Default is an empty array.
1584 1475 * @param array|null $args Optional. Element default arguments. Default is null.
1585 1476 **/
1586 - public function __construct( array $data = [], ?array $args = null ) {
1477 + public function __construct( array $data = [], array $args = null ) {
1587 1478 if ( $data ) {
1588 1479 $this->is_type_instance = false;
1589 1480 } elseif ( $args ) {
1590 1481 $this->default_args = $args;