PluginProbe
Elementor Website Builder – more than just a page builder / 3.9.0
Elementor Website Builder – more than just a page builder v3.9.0
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 +38 -173 4.1.43.9.0 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 ) {
@@ -472,15 +414,8 @@
472 414 */
473 415 public function print_element() {
474 416 $element_type = $this->get_type();
475 417
476 - if ( $this->should_render_shortcode() ) {
477 - $unique_id = apply_filters( 'elementor/element_cache/unique_id', '' );
478 -
479 - echo '[elementor-element k="' . esc_attr( $unique_id ) . '" data="' . esc_attr( base64_encode( wp_json_encode( $this->get_raw_data() ) ) ) . '"]';
480 - return;
481 - }
482 -
483 418 /**
484 419 * Before frontend element render.
485 420 *
486 421 * Fires before Elementor element is rendered in the frontend.
@@ -543,10 +478,8 @@
543 478 // PHPCS - The content has already been escaped by the `render` method.
544 479 echo $content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
545 480 $this->after_render();
546 481
547 - // TODO: Remove this in the future
548 - // Since version 3.24.0 page scripts/styles are handled by `page_assets`.
549 482 $this->enqueue_scripts();
550 483 $this->enqueue_styles();
551 484 }
552 485
@@ -574,54 +507,8 @@
574 507 */
575 508 do_action( 'elementor/frontend/after_render', $this );
576 509 }
577 510
578 - protected function should_render_shortcode() {
579 - $should_render_shortcode = apply_filters( 'elementor/element/should_render_shortcode', false );
580 -
581 - if ( ! $should_render_shortcode ) {
582 - return false;
583 - }
584 -
585 - $raw_data = $this->get_raw_data();
586 -
587 - if ( ! empty( $raw_data['settings']['_element_cache'] ) ) {
588 - return 'yes' === $raw_data['settings']['_element_cache'];
589 - }
590 -
591 - if ( $this->is_dynamic_content() ) {
592 - return true;
593 - }
594 -
595 - $is_dynamic_content = apply_filters( 'elementor/element/is_dynamic_content', false, $raw_data, $this );
596 -
597 - $has_dynamic_tag = $this->has_element_dynamic_tag( $raw_data['settings'] );
598 -
599 - if ( $is_dynamic_content || $has_dynamic_tag ) {
600 - return true;
601 - }
602 -
603 - return false;
604 - }
605 -
606 - private function has_element_dynamic_tag( $element_settings ): bool {
607 - if ( is_array( $element_settings ) ) {
608 - if ( ! empty( $element_settings['__dynamic__'] ) ) {
609 - return true;
610 - }
611 -
612 - foreach ( $element_settings as $value ) {
613 - $has_dynamic = $this->has_element_dynamic_tag( $value );
614 -
615 - if ( $has_dynamic ) {
616 - return true;
617 - }
618 - }
619 - }
620 -
621 - return false;
622 - }
623 -
624 511 /**
625 512 * Get the element raw data.
626 513 *
627 514 * Retrieve the raw element data, including the id, type, settings, child
@@ -648,9 +535,9 @@
648 535 foreach ( $this->get_children() as $child ) {
649 536 $elements[] = $child->get_raw_data( $with_html_content );
650 537 }
651 538
652 - $raw_data = [
539 + return [
653 540 'id' => $this->get_id(),
654 541 'elType' => $data['elType'],
655 542 'settings' => $data['settings'],
656 543 'elements' => $elements,
@@ -655,14 +542,8 @@
655 542 'settings' => $data['settings'],
656 543 'elements' => $elements,
657 544 'isInner' => $data['isInner'],
658 545 ];
659 -
660 - if ( ! empty( $data['isLocked'] ) ) {
661 - $raw_data['isLocked'] = $data['isLocked'];
662 - }
663 -
664 - return $raw_data;
665 546 }
666 547
667 548 public function get_data_for_save() {
668 549 $data = $this->get_raw_data();
@@ -724,9 +605,9 @@
724 605 * @param array|null $controls The available controls.
725 606 *
726 607 * @return array Element data.
727 608 */
728 - public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ): array {
609 + public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ) : array {
729 610 $tags_manager = Plugin::$instance->dynamic_tags;
730 611
731 612 if ( empty( $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ] ) ) {
732 613 return $config;
@@ -759,12 +640,12 @@
759 640 * Used to add attributes to the current element wrapper HTML tag.
760 641 *
761 642 * @since 1.3.0
762 643 * @access protected
763 - * @deprecated 3.1.0 Use `add_render_attribute()` method instead.
644 + * @deprecated 3.1.0
764 645 */
765 646 protected function _add_render_attributes() {
766 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'add_render_attributes()' );
647 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::add_render_attributes()' );
767 648
768 649 return $this->add_render_attributes();
769 650 }
770 651
@@ -789,9 +670,8 @@
789 670 'elementor-element-' . $id,
790 671 ],
791 672 'data-id' => $id,
792 673 'data-element_type' => $this->get_type(),
793 - 'data-e-type' => $this->get_type(),
794 674 ] );
795 675
796 676 $class_settings = [];
797 677
@@ -796,15 +676,9 @@
796 676 $class_settings = [];
797 677
798 678 foreach ( $settings as $setting_key => $setting ) {
799 679 if ( isset( $controls[ $setting_key ]['prefix_class'] ) ) {
800 - if ( isset( $controls[ $setting_key ]['classes_dictionary'][ $setting ] ) ) {
801 - $value = $controls[ $setting_key ]['classes_dictionary'][ $setting ];
802 - } else {
803 - $value = $setting;
804 - }
805 -
806 - $class_settings[ $setting_key ] = $value;
680 + $class_settings[ $setting_key ] = $setting;
807 681 }
808 682 }
809 683
810 684 foreach ( $class_settings as $setting_key => $setting ) {
@@ -816,15 +690,15 @@
816 690 }
817 691
818 692 $_animation = ! empty( $settings['_animation'] );
819 693 $animation = ! empty( $settings['animation'] );
820 - $has_animation = ( $_animation && 'none' !== $settings['_animation'] ) || ( $animation && 'none' !== $settings['animation'] );
694 + $has_animation = $_animation && 'none' !== $settings['_animation'] || $animation && 'none' !== $settings['animation'];
821 695
822 696 if ( $has_animation ) {
823 697 $is_static_render_mode = Plugin::$instance->frontend->is_static_render_mode();
824 698
825 699 if ( ! $is_static_render_mode ) {
826 - // Hide the element until the animation begins.
700 + // Hide the element until the animation begins
827 701 $this->add_render_attribute( '_wrapper', 'class', 'elementor-invisible' );
828 702 }
829 703 }
830 704
@@ -852,15 +726,13 @@
852 726 * Register the Transform controls in the advanced tab of the element.
853 727 *
854 728 * Previously registered under the Widget_Common class, but registered a more fundamental level now to enable access from other widgets.
855 729 *
856 - * @param string $element_selector
857 - * @param string $transform_selector_class
858 - * @return void
859 730 * @since 3.9.0
860 731 * @access protected
732 + * @return void
861 733 */
862 - protected function register_transform_section( $element_selector = '', $transform_selector_class = ' > .elementor-widget-container' ) {
734 + protected function register_transform_section( $element_selector = '' ) {
863 735 $default_unit_values_deg = [];
864 736 $default_unit_values_ms = [];
865 737
866 738 // Set the default unit sizes for all active breakpoints.
@@ -889,8 +761,9 @@
889 761 $this->start_controls_tabs( '_tabs_positioning' );
890 762
891 763 $transform_prefix_class = 'e-';
892 764 $transform_return_value = 'transform';
765 + $transform_selector_class = ' > .elementor-widget-container';
893 766 $transform_css_modifier = '';
894 767
895 768 if ( 'con' === $element_selector ) {
896 769 $transform_selector_class = '.e-' . $element_selector;
@@ -921,9 +794,9 @@
921 794
922 795 $this->add_responsive_control(
923 796 "_transform_rotateZ_effect{$tab}",
924 797 [
925 - 'label' => esc_html__( 'Rotate', 'elementor' ) . ' (deg)',
798 + 'label' => esc_html__( 'Rotate', 'elementor' ),
926 799 'type' => Controls_Manager::SLIDER,
927 800 'device_args' => $default_unit_values_deg,
928 801 'range' => [
929 802 'px' => [
@@ -953,9 +826,8 @@
953 826 ],
954 827 'condition' => [
955 828 "_transform_rotate_popover{$tab}!" => '',
956 829 ],
957 - 'frontend_available' => true,
958 830 ]
959 831 );
960 832
961 833 $this->add_responsive_control(
@@ -960,9 +832,9 @@
960 832
961 833 $this->add_responsive_control(
962 834 "_transform_rotateX_effect{$tab}",
963 835 [
964 - 'label' => esc_html__( 'Rotate X', 'elementor' ) . ' (deg)',
836 + 'label' => esc_html__( 'Rotate X', 'elementor' ),
965 837 'type' => Controls_Manager::SLIDER,
966 838 'device_args' => $default_unit_values_deg,
967 839 'range' => [
968 840 'px' => [
@@ -983,9 +855,9 @@
983 855
984 856 $this->add_responsive_control(
985 857 "_transform_rotateY_effect{$tab}",
986 858 [
987 - 'label' => esc_html__( 'Rotate Y', 'elementor' ) . ' (deg)',
859 + 'label' => esc_html__( 'Rotate Y', 'elementor' ),
988 860 'type' => Controls_Manager::SLIDER,
989 861 'device_args' => $default_unit_values_deg,
990 862 'range' => [
991 863 'px' => [
@@ -1006,12 +878,13 @@
1006 878
1007 879 $this->add_responsive_control(
1008 880 "_transform_perspective_effect{$tab}",
1009 881 [
1010 - 'label' => esc_html__( 'Perspective', 'elementor' ) . ' (px)',
882 + 'label' => esc_html__( 'Perspective', 'elementor' ),
1011 883 'type' => Controls_Manager::SLIDER,
1012 884 'range' => [
1013 885 'px' => [
886 + 'min' => 0,
1014 887 'max' => 1000,
1015 888 ],
1016 889 ],
1017 890 'condition' => [
@@ -1043,9 +916,9 @@
1043 916 "_transform_translateX_effect{$tab}",
1044 917 [
1045 918 'label' => esc_html__( 'Offset X', 'elementor' ),
1046 919 'type' => Controls_Manager::SLIDER,
1047 - 'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
920 + 'size_units' => [ '%', 'px' ],
1048 921 'range' => [
1049 922 '%' => [
1050 923 'min' => -100,
1051 924 'max' => 100,
@@ -1069,9 +942,9 @@
1069 942 "_transform_translateY_effect{$tab}",
1070 943 [
1071 944 'label' => esc_html__( 'Offset Y', 'elementor' ),
1072 945 'type' => Controls_Manager::SLIDER,
1073 - 'size_units' => [ 'px', '%', 'em', 'rem', 'vh', 'custom' ],
946 + 'size_units' => [ '%', 'px' ],
1074 947 'range' => [
1075 948 '%' => [
1076 949 'min' => -100,
1077 950 'max' => 100,
@@ -1122,8 +995,9 @@
1122 995 'label' => esc_html__( 'Scale', 'elementor' ),
1123 996 'type' => Controls_Manager::SLIDER,
1124 997 'range' => [
1125 998 'px' => [
999 + 'min' => 0,
1126 1000 'max' => 2,
1127 1001 'step' => 0.1,
1128 1002 ],
1129 1003 ],
@@ -1144,8 +1018,9 @@
1144 1018 'label' => esc_html__( 'Scale X', 'elementor' ),
1145 1019 'type' => Controls_Manager::SLIDER,
1146 1020 'range' => [
1147 1021 'px' => [
1022 + 'min' => 0,
1148 1023 'max' => 2,
1149 1024 'step' => 0.1,
1150 1025 ],
1151 1026 ],
@@ -1166,8 +1041,9 @@
1166 1041 'label' => esc_html__( 'Scale Y', 'elementor' ),
1167 1042 'type' => Controls_Manager::SLIDER,
1168 1043 'range' => [
1169 1044 'px' => [
1045 + 'min' => 0,
1170 1046 'max' => 2,
1171 1047 'step' => 0.1,
1172 1048 ],
1173 1049 ],
@@ -1198,9 +1074,9 @@
1198 1074
1199 1075 $this->add_responsive_control(
1200 1076 "_transform_skewX_effect{$tab}",
1201 1077 [
1202 - 'label' => esc_html__( 'Skew X', 'elementor' ) . ' (deg)',
1078 + 'label' => esc_html__( 'Skew X', 'elementor' ),
1203 1079 'type' => Controls_Manager::SLIDER,
1204 1080 'device_args' => $default_unit_values_deg,
1205 1081 'range' => [
1206 1082 'px' => [
@@ -1220,9 +1096,9 @@
1220 1096
1221 1097 $this->add_responsive_control(
1222 1098 "_transform_skewY_effect{$tab}",
1223 1099 [
1224 - 'label' => esc_html__( 'Skew Y', 'elementor' ) . ' (deg)',
1100 + 'label' => esc_html__( 'Skew Y', 'elementor' ),
1225 1101 'type' => Controls_Manager::SLIDER,
1226 1102 'device_args' => $default_unit_values_deg,
1227 1103 'range' => [
1228 1104 'px' => [
@@ -1283,16 +1159,15 @@
1283 1159 if ( '_hover' === $tab ) {
1284 1160 $this->add_control(
1285 1161 '_transform_transition_hover',
1286 1162 [
1287 - 'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (ms)',
1163 + 'label' => esc_html__( 'Transition Duration (ms)', 'elementor' ),
1288 1164 'type' => Controls_Manager::SLIDER,
1289 1165 'device_args' => $default_unit_values_ms,
1290 1166 'range' => [
1291 1167 'px' => [
1292 - 'min' => 0,
1168 + 'min' => 100,
1293 1169 'max' => 10000,
1294 - 'step' => 100,
1295 1170 ],
1296 1171 ],
1297 1172 'selectors' => [
1298 1173 '{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-transition-duration: {{SIZE}}ms',
@@ -1333,9 +1208,9 @@
1333 1208 'relation' => 'or',
1334 1209 'terms' => array_merge( $transform_origin_conditions, $transform_origin_conditions_hover ),
1335 1210 ];
1336 1211
1337 - // Will override motion effect transform-origin.
1212 + // Will override motion effect transform-origin
1338 1213 $this->add_responsive_control(
1339 1214 'motion_fx_transform_x_anchor_point',
1340 1215 [
1341 1216 'label' => esc_html__( 'X Anchor Point', 'elementor' ),
@@ -1361,9 +1236,9 @@
1361 1236 ],
1362 1237 ]
1363 1238 );
1364 1239
1365 - // Will override motion effect transform-origin.
1240 + // Will override motion effect transform-origin
1366 1241 $this->add_responsive_control(
1367 1242 'motion_fx_transform_y_anchor_point',
1368 1243 [
1369 1244 'label' => esc_html__( 'Y Anchor Point', 'elementor' ),
@@ -1410,13 +1285,10 @@
1410 1285
1411 1286 $this->add_control(
1412 1287 'hide_' . $breakpoint_key,
1413 1288 [
1414 - 'label' => sprintf(
1415 - /* translators: %s: Device name. */
1416 - esc_html__( 'Hide On %s', 'elementor' ),
1417 - $label
1418 - ),
1289 + /* translators: %s: Device name. */
1290 + 'label' => sprintf( __( 'Hide On %s', 'elementor' ), $label ),
1419 1291 'type' => Controls_Manager::SWITCHER,
1420 1292 'default' => '',
1421 1293 'prefix_class' => 'elementor-',
1422 1294 'label_on' => esc_html__( 'Hide', 'elementor' ),
@@ -1454,12 +1326,12 @@
1454 1326 * Output the element final HTML on the frontend.
1455 1327 *
1456 1328 * @since 1.0.0
1457 1329 * @access protected
1458 - * @deprecated 3.1.0 Use `print_content()` method instead.
1330 + * @deprecated 3.1.0
1459 1331 */
1460 1332 protected function _print_content() {
1461 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'print_content()' );
1333 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::print_content()' );
1462 1334
1463 1335 $this->print_content();
1464 1336 }
1465 1337
@@ -1514,11 +1386,8 @@
1514 1386
1515 1387 /**
1516 1388 * A Base method for sanitizing the settings before save.
1517 1389 * This method is meant to be overridden by the element.
1518 - *
1519 - * @param array $settings
1520 - * @return array
1521 1390 */
1522 1391 protected function on_save( array $settings ) {
1523 1392 return $settings;
1524 1393 }
@@ -1537,9 +1406,9 @@
1537 1406 */
1538 1407 private function get_child_type( $element_data ) {
1539 1408 $child_type = $this->_get_default_child_type( $element_data );
1540 1409
1541 - // If it's not a valid widget ( like a deactivated plugin ).
1410 + // If it's not a valid widget ( like a deactivated plugin )
1542 1411 if ( ! $child_type ) {
1543 1412 return false;
1544 1413 }
1545 1414
@@ -1584,12 +1453,8 @@
1584 1453 $this->add_child( $child_data );
1585 1454 }
1586 1455 }
1587 1456
1588 - public function has_widget_inner_wrapper(): bool {
1589 - return true;
1590 - }
1591 -
1592 1457 /**
1593 1458 * Element base constructor.
1594 1459 *
1595 1460 * Initializing the element base class using `$data` and `$args`.
@@ -1602,9 +1467,9 @@
1602 1467 *
1603 1468 * @param array $data Optional. Element data. Default is an empty array.
1604 1469 * @param array|null $args Optional. Element default arguments. Default is null.
1605 1470 **/
1606 - public function __construct( array $data = [], ?array $args = null ) {
1471 + public function __construct( array $data = [], array $args = null ) {
1607 1472 if ( $data ) {
1608 1473 $this->is_type_instance = false;
1609 1474 } elseif ( $args ) {
1610 1475 $this->default_args = $args;