PluginProbe
Elementor Website Builder – more than just a page builder / 3.3.0
Elementor Website Builder – more than just a page builder v3.3.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 +220 -800 4.1.0-dev33.3.0 View file →
@@ -1,9 +1,7 @@
1 1 <?php
2 2 namespace Elementor;
3 3
4 -use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
5 -
6 4 if ( ! defined( 'ABSPATH' ) ) {
7 5 exit; // Exit if accessed directly.
8 6 }
9 7
@@ -31,8 +29,20 @@
31 29 */
32 30 private $children;
33 31
34 32 /**
33 + * Element render attributes.
34 + *
35 + * Holds all the render attributes of the element. Used to store data like
36 + * the HTML class name and the class value, or HTML element ID name and value.
37 + *
38 + * @access private
39 + *
40 + * @var array
41 + */
42 + private $render_attributes = [];
43 +
44 + /**
35 45 * Element default arguments.
36 46 *
37 47 * Holds all the default arguments of the element. Used to store additional
38 48 * data. For example WordPress widgets use this to store widget names.
@@ -119,12 +129,8 @@
119 129 public function get_script_depends() {
120 130 return $this->depended_scripts;
121 131 }
122 132
123 - public function get_global_scripts() {
124 - return [ 'elementor-frontend' ];
125 - }
126 -
127 133 /**
128 134 * Enqueue scripts.
129 135 *
130 136 * Registers all the scripts defined as element dependencies and enqueues
@@ -134,9 +140,12 @@
134 140 * @access public
135 141 */
136 142 final public function enqueue_scripts() {
137 143 $deprecated_scripts = [
138 - // Insert here when you have a deprecated script.
144 + 'jquery-slick' => [
145 + 'version' => '2.7.0',
146 + 'replacement' => 'Swiper',
147 + ],
139 148 ];
140 149
141 150 foreach ( $this->get_script_depends() as $script ) {
142 151 if ( isset( $deprecated_scripts[ $script ] ) ) {
@@ -144,16 +153,10 @@
144 153 }
145 154
146 155 wp_enqueue_script( $script );
147 156 }
148 -
149 - foreach ( $this->get_global_scripts() as $script ) {
150 - wp_enqueue_script( $script );
151 - }
152 157 }
153 158
154 - public function register_frontend_handlers() {}
155 -
156 159 /**
157 160 * Get style dependencies.
158 161 *
159 162 * Retrieve the list of style dependencies the element requires.
@@ -295,22 +298,8 @@
295 298 return true;
296 299 }
297 300
298 301 /**
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 302 * Get child elements.
314 303 *
315 304 * Retrieve all the child elements of this element.
316 305 *
@@ -326,28 +315,8 @@
326 315
327 316 return $this->children;
328 317 }
329 318
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 319 /**
351 320 * Get default arguments.
352 321 *
353 322 * Retrieve the element default arguments. Used to return all the default
@@ -364,23 +333,8 @@
364 333 return self::get_items( $this->default_args, $item );
365 334 }
366 335
367 336 /**
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 337 * Add new child element.
384 338 *
385 339 * Register new child element to allow hierarchy.
386 340 *
@@ -411,8 +365,66 @@
411 365 return $child;
412 366 }
413 367
414 368 /**
369 + * Add render attribute.
370 + *
371 + * Used to add attributes to a specific HTML element.
372 + *
373 + * The HTML tag is represented by the element parameter, then you need to
374 + * define the attribute key and the attribute key. The final result will be:
375 + * `<element attribute_key="attribute_value">`.
376 + *
377 + * Example usage:
378 + *
379 + * `$this->add_render_attribute( 'wrapper', 'class', 'custom-widget-wrapper-class' );`
380 + * `$this->add_render_attribute( 'widget', 'id', 'custom-widget-id' );`
381 + * `$this->add_render_attribute( 'button', [ 'class' => 'custom-button-class', 'id' => 'custom-button-id' ] );`
382 + *
383 + * @since 1.0.0
384 + * @access public
385 + *
386 + * @param array|string $element The HTML element.
387 + * @param array|string $key Optional. Attribute key. Default is null.
388 + * @param array|string $value Optional. Attribute value. Default is null.
389 + * @param bool $overwrite Optional. Whether to overwrite existing
390 + * attribute. Default is false, not to overwrite.
391 + *
392 + * @return Element_Base Current instance of the element.
393 + */
394 + public function add_render_attribute( $element, $key = null, $value = null, $overwrite = false ) {
395 + if ( is_array( $element ) ) {
396 + foreach ( $element as $element_key => $attributes ) {
397 + $this->add_render_attribute( $element_key, $attributes, null, $overwrite );
398 + }
399 +
400 + return $this;
401 + }
402 +
403 + if ( is_array( $key ) ) {
404 + foreach ( $key as $attribute_key => $attributes ) {
405 + $this->add_render_attribute( $element, $attribute_key, $attributes, $overwrite );
406 + }
407 +
408 + return $this;
409 + }
410 +
411 + if ( empty( $this->render_attributes[ $element ][ $key ] ) ) {
412 + $this->render_attributes[ $element ][ $key ] = [];
413 + }
414 +
415 + settype( $value, 'array' );
416 +
417 + if ( $overwrite ) {
418 + $this->render_attributes[ $element ][ $key ] = $value;
419 + } else {
420 + $this->render_attributes[ $element ][ $key ] = array_merge( $this->render_attributes[ $element ][ $key ], $value );
421 + }
422 +
423 + return $this;
424 + }
425 +
426 + /**
415 427 * Add link render attributes.
416 428 *
417 429 * Used to add link tag attributes to a specific HTML element.
418 430 *
@@ -426,14 +438,15 @@
426 438 * @since 2.8.0
427 439 * @access public
428 440 *
429 441 * @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.
442 + * @param array $url_control Array of link settings.
443 + * @param bool $overwrite Optional. Whether to overwrite existing
444 + * attribute. Default is false, not to overwrite.
433 445 *
434 446 * @return Element_Base Current instance of the element.
435 447 */
448 +
436 449 public function add_link_attributes( $element, array $url_control, $overwrite = false ) {
437 450 $attributes = [];
438 451
439 452 if ( ! empty( $url_control['url'] ) ) {
@@ -450,14 +463,14 @@
450 463 $attributes['rel'] = 'nofollow';
451 464 }
452 465
453 466 if ( ! empty( $url_control['custom_attributes'] ) ) {
454 - // Custom URL attributes should come as a string of comma-delimited key|value pairs.
467 + // Custom URL attributes should come as a string of comma-delimited key|value pairs
455 468 $attributes = array_merge( $attributes, Utils::parse_custom_attributes( $url_control['custom_attributes'] ) );
456 469 }
457 470
458 471 if ( $attributes ) {
459 - $this->add_render_attribute( $element, $attributes, null, $overwrite );
472 + $this->add_render_attribute( $element, $attributes, $overwrite );
460 473 }
461 474
462 475 return $this;
463 476 }
@@ -462,8 +475,138 @@
462 475 return $this;
463 476 }
464 477
465 478 /**
479 + * Get Render Attributes
480 + *
481 + * Used to retrieve render attribute.
482 + *
483 + * The returned array is either all elements and their attributes if no `$element` is specified, an array of all
484 + * attributes of a specific element or a specific attribute properties if `$key` is specified.
485 + *
486 + * Returns null if one of the requested parameters isn't set.
487 + *
488 + * @since 2.2.6
489 + * @access public
490 + * @param string $element
491 + * @param string $key
492 + *
493 + * @return array
494 + */
495 + public function get_render_attributes( $element = '', $key = '' ) {
496 + $attributes = $this->render_attributes;
497 +
498 + if ( $element ) {
499 + if ( ! isset( $attributes[ $element ] ) ) {
500 + return null;
501 + }
502 +
503 + $attributes = $attributes[ $element ];
504 +
505 + if ( $key ) {
506 + if ( ! isset( $attributes[ $key ] ) ) {
507 + return null;
508 + }
509 +
510 + $attributes = $attributes[ $key ];
511 + }
512 + }
513 +
514 + return $attributes;
515 + }
516 +
517 + /**
518 + * Set render attribute.
519 + *
520 + * Used to set the value of the HTML element render attribute or to update
521 + * an existing render attribute.
522 + *
523 + * @since 1.0.0
524 + * @access public
525 + *
526 + * @param array|string $element The HTML element.
527 + * @param array|string $key Optional. Attribute key. Default is null.
528 + * @param array|string $value Optional. Attribute value. Default is null.
529 + *
530 + * @return Element_Base Current instance of the element.
531 + */
532 + public function set_render_attribute( $element, $key = null, $value = null ) {
533 + return $this->add_render_attribute( $element, $key, $value, true );
534 + }
535 +
536 + /**
537 + * Remove render attribute.
538 + *
539 + * Used to remove an element (with its keys and their values), key (with its values),
540 + * or value/s from an HTML element's render attribute.
541 + *
542 + * @since 2.7.0
543 + * @access public
544 + *
545 + * @param string $element The HTML element.
546 + * @param string $key Optional. Attribute key. Default is null.
547 + * @param array|string $values Optional. Attribute value/s. Default is null.
548 + */
549 + public function remove_render_attribute( $element, $key = null, $values = null ) {
550 + if ( $key && ! isset( $this->render_attributes[ $element ][ $key ] ) ) {
551 + return;
552 + }
553 +
554 + if ( $values ) {
555 + $values = (array) $values;
556 +
557 + $this->render_attributes[ $element ][ $key ] = array_diff( $this->render_attributes[ $element ][ $key ], $values );
558 +
559 + return;
560 + }
561 +
562 + if ( $key ) {
563 + unset( $this->render_attributes[ $element ][ $key ] );
564 +
565 + return;
566 + }
567 +
568 + if ( isset( $this->render_attributes[ $element ] ) ) {
569 + unset( $this->render_attributes[ $element ] );
570 + }
571 + }
572 +
573 + /**
574 + * Get render attribute string.
575 + *
576 + * Used to retrieve the value of the render attribute.
577 + *
578 + * @since 1.0.0
579 + * @access public
580 + *
581 + * @param string $element The element.
582 + *
583 + * @return string Render attribute string, or an empty string if the attribute
584 + * is empty or not exist.
585 + */
586 + public function get_render_attribute_string( $element ) {
587 + if ( empty( $this->render_attributes[ $element ] ) ) {
588 + return '';
589 + }
590 +
591 + return Utils::render_html_attributes( $this->render_attributes[ $element ] );
592 + }
593 +
594 + /**
595 + * Print render attribute string.
596 + *
597 + * Used to output the rendered attribute.
598 + *
599 + * @since 2.0.0
600 + * @access public
601 + *
602 + * @param array|string $element The element.
603 + */
604 + public function print_render_attribute_string( $element ) {
605 + echo $this->get_render_attribute_string( $element ); // XSS ok.
606 + }
607 +
608 + /**
466 609 * Print element.
467 610 *
468 611 * Used to generate the element final HTML on the frontend and the editor.
469 612 *
@@ -472,15 +615,8 @@
472 615 */
473 616 public function print_element() {
474 617 $element_type = $this->get_type();
475 618
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 619 /**
484 620 * Before frontend element render.
485 621 *
486 622 * Fires before Elementor element is rendered in the frontend.
@@ -539,14 +675,11 @@
539 675 $this->add_render_attributes();
540 676 }
541 677
542 678 $this->before_render();
543 - // PHPCS - The content has already been escaped by the `render` method.
544 - echo $content; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
679 + echo $content;
545 680 $this->after_render();
546 681
547 - // TODO: Remove this in the future
548 - // Since version 3.24.0 page scripts/styles are handled by `page_assets`.
549 682 $this->enqueue_scripts();
550 683 $this->enqueue_styles();
551 684 }
552 685
@@ -574,54 +707,8 @@
574 707 */
575 708 do_action( 'elementor/frontend/after_render', $this );
576 709 }
577 710
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 711 /**
625 712 * Get the element raw data.
626 713 *
627 714 * Retrieve the raw element data, including the id, type, settings, child
@@ -648,9 +735,9 @@
648 735 foreach ( $this->get_children() as $child ) {
649 736 $elements[] = $child->get_raw_data( $with_html_content );
650 737 }
651 738
652 - $raw_data = [
739 + return [
653 740 'id' => $this->get_id(),
654 741 'elType' => $data['elType'],
655 742 'settings' => $data['settings'],
656 743 'elements' => $elements,
@@ -655,36 +742,10 @@
655 742 'settings' => $data['settings'],
656 743 'elements' => $elements,
657 744 'isInner' => $data['isInner'],
658 745 ];
659 -
660 - if ( ! empty( $data['isLocked'] ) ) {
661 - $raw_data['isLocked'] = $data['isLocked'];
662 - }
663 -
664 - return $raw_data;
665 746 }
666 747
667 - public function get_data_for_save() {
668 - $data = $this->get_raw_data();
669 -
670 - $elements = [];
671 -
672 - foreach ( $this->get_children() as $child ) {
673 - $elements[] = $child->get_data_for_save();
674 - }
675 -
676 - if ( ! empty( $elements ) ) {
677 - $data['elements'] = $elements;
678 - }
679 -
680 - if ( ! empty( $data['settings'] ) ) {
681 - $data['settings'] = $this->on_save( $data['settings'] );
682 - }
683 -
684 - return $data;
685 - }
686 -
687 748 /**
688 749 * Get unique selector.
689 750 *
690 751 * Retrieve the unique selector of the element. Used to set a unique HTML
@@ -714,47 +775,8 @@
714 775 return $this->is_type_instance;
715 776 }
716 777
717 778 /**
718 - * On import update dynamic content (e.g. post and term IDs).
719 - *
720 - * @since 3.8.0
721 - *
722 - * @param array $config The config of the passed element.
723 - * @param array $data The data that requires updating/replacement when imported.
724 - * @param array|null $controls The available controls.
725 - *
726 - * @return array Element data.
727 - */
728 - public static function on_import_update_dynamic_content( array $config, array $data, $controls = null ): array {
729 - $tags_manager = Plugin::$instance->dynamic_tags;
730 -
731 - if ( empty( $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ] ) ) {
732 - return $config;
733 - }
734 -
735 - foreach ( $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ] as $dynamic_name => $dynamic_value ) {
736 - $tag_config = $tags_manager->tag_text_to_tag_data( $dynamic_value );
737 - $tag_instance = $tags_manager->create_tag( $tag_config['id'], $tag_config['name'], $tag_config['settings'] );
738 -
739 - if ( is_null( $tag_instance ) ) {
740 - continue;
741 - }
742 -
743 - if ( $tag_instance->has_own_method( 'on_import_replace_dynamic_content' ) ) {
744 - // TODO: Remove this check in the future.
745 - $tag_config = $tag_instance->on_import_replace_dynamic_content( $tag_config, $data['post_ids'] );
746 - } else {
747 - $tag_config = $tag_instance->on_import_update_dynamic_content( $tag_config, $data, $tag_instance->get_controls() );
748 - }
749 -
750 - $config['settings'][ $tags_manager::DYNAMIC_SETTING_KEY ][ $dynamic_name ] = $tags_manager->tag_data_to_tag_text( $tag_config['id'], $tag_config['name'], $tag_config['settings'] );
751 - }
752 -
753 - return $config;
754 - }
755 -
756 - /**
757 779 * Add render attributes.
758 780 *
759 781 * Used to add attributes to the current element wrapper HTML tag.
760 782 *
@@ -759,12 +781,12 @@
759 781 * Used to add attributes to the current element wrapper HTML tag.
760 782 *
761 783 * @since 1.3.0
762 784 * @access protected
763 - * @deprecated 3.1.0 Use `add_render_attribute()` method instead.
785 + * @deprecated 3.1.0
764 786 */
765 787 protected function _add_render_attributes() {
766 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'add_render_attributes()' );
788 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::add_render_attributes()' );
767 789
768 790 return $this->add_render_attributes();
769 791 }
770 792
@@ -789,9 +811,8 @@
789 811 'elementor-element-' . $id,
790 812 ],
791 813 'data-id' => $id,
792 814 'data-element_type' => $this->get_type(),
793 - 'data-e-type' => $this->get_type(),
794 815 ] );
795 816
796 817 $class_settings = [];
797 818
@@ -796,15 +817,9 @@
796 817 $class_settings = [];
797 818
798 819 foreach ( $settings as $setting_key => $setting ) {
799 820 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;
821 + $class_settings[ $setting_key ] = $setting;
807 822 }
808 823 }
809 824
810 825 foreach ( $class_settings as $setting_key => $setting ) {
@@ -816,15 +831,15 @@
816 831 }
817 832
818 833 $_animation = ! empty( $settings['_animation'] );
819 834 $animation = ! empty( $settings['animation'] );
820 - $has_animation = ( $_animation && 'none' !== $settings['_animation'] ) || ( $animation && 'none' !== $settings['animation'] );
835 + $has_animation = $_animation && 'none' !== $settings['_animation'] || $animation && 'none' !== $settings['animation'];
821 836
822 837 if ( $has_animation ) {
823 838 $is_static_render_mode = Plugin::$instance->frontend->is_static_render_mode();
824 839
825 840 if ( ! $is_static_render_mode ) {
826 - // Hide the element until the animation begins.
841 + // Hide the element until the animation begins
827 842 $this->add_render_attribute( '_wrapper', 'class', 'elementor-invisible' );
828 843 }
829 844 }
830 845
@@ -848,587 +863,8 @@
848 863 do_action( 'elementor/element/after_add_attributes', $this );
849 864 }
850 865
851 866 /**
852 - * Register the Transform controls in the advanced tab of the element.
853 - *
854 - * Previously registered under the Widget_Common class, but registered a more fundamental level now to enable access from other widgets.
855 - *
856 - * @param string $element_selector
857 - * @param string $transform_selector_class
858 - * @return void
859 - * @since 3.9.0
860 - * @access protected
861 - */
862 - protected function register_transform_section( $element_selector = '', $transform_selector_class = ' > .elementor-widget-container' ) {
863 - $default_unit_values_deg = [];
864 - $default_unit_values_ms = [];
865 -
866 - // Set the default unit sizes for all active breakpoints.
867 - foreach ( Breakpoints_Manager::get_default_config() as $breakpoint_name => $breakpoint_config ) {
868 - $default_unit_values_deg[ $breakpoint_name ] = [
869 - 'default' => [
870 - 'unit' => 'deg',
871 - ],
872 - ];
873 -
874 - $default_unit_values_ms[ $breakpoint_name ] = [
875 - 'default' => [
876 - 'unit' => 'ms',
877 - ],
878 - ];
879 - }
880 -
881 - $this->start_controls_section(
882 - '_section_transform',
883 - [
884 - 'label' => esc_html__( 'Transform', 'elementor' ),
885 - 'tab' => Controls_Manager::TAB_ADVANCED,
886 - ]
887 - );
888 -
889 - $this->start_controls_tabs( '_tabs_positioning' );
890 -
891 - $transform_prefix_class = 'e-';
892 - $transform_return_value = 'transform';
893 - $transform_css_modifier = '';
894 -
895 - if ( 'con' === $element_selector ) {
896 - $transform_selector_class = '.e-' . $element_selector;
897 - $transform_css_modifier = $element_selector . '-';
898 - }
899 -
900 - foreach ( [ '', '_hover' ] as $tab ) {
901 - $state = '_hover' === $tab ? ':hover' : '';
902 -
903 - $this->start_controls_tab(
904 - "_tab_positioning{$tab}",
905 - [
906 - 'label' => '' === $tab ? esc_html__( 'Normal', 'elementor' ) : esc_html__( 'Hover', 'elementor' ),
907 - ]
908 - );
909 -
910 - $this->add_control(
911 - "_transform_rotate_popover{$tab}",
912 - [
913 - 'label' => esc_html__( 'Rotate', 'elementor' ),
914 - 'type' => Controls_Manager::POPOVER_TOGGLE,
915 - 'prefix_class' => $transform_prefix_class,
916 - 'return_value' => $transform_return_value,
917 - ]
918 - );
919 -
920 - $this->start_popover();
921 -
922 - $this->add_responsive_control(
923 - "_transform_rotateZ_effect{$tab}",
924 - [
925 - 'label' => esc_html__( 'Rotate', 'elementor' ) . ' (deg)',
926 - 'type' => Controls_Manager::SLIDER,
927 - 'device_args' => $default_unit_values_deg,
928 - 'range' => [
929 - 'px' => [
930 - 'min' => -360,
931 - 'max' => 360,
932 - ],
933 - ],
934 - 'selectors' => [
935 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-rotateZ: {{SIZE}}deg',
936 - ],
937 - 'condition' => [
938 - "_transform_rotate_popover{$tab}!" => '',
939 - ],
940 - 'frontend_available' => true,
941 - ]
942 - );
943 -
944 - $this->add_control(
945 - "_transform_rotate_3d{$tab}",
946 - [
947 - 'label' => esc_html__( '3D Rotate', 'elementor' ),
948 - 'type' => Controls_Manager::SWITCHER,
949 - 'label_on' => esc_html__( 'On', 'elementor' ),
950 - 'label_off' => esc_html__( 'Off', 'elementor' ),
951 - 'selectors' => [
952 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-rotateX: 1{{UNIT}}; --e-' . $transform_css_modifier . 'transform-perspective: 20px;',
953 - ],
954 - 'condition' => [
955 - "_transform_rotate_popover{$tab}!" => '',
956 - ],
957 - 'frontend_available' => true,
958 - ]
959 - );
960 -
961 - $this->add_responsive_control(
962 - "_transform_rotateX_effect{$tab}",
963 - [
964 - 'label' => esc_html__( 'Rotate X', 'elementor' ) . ' (deg)',
965 - 'type' => Controls_Manager::SLIDER,
966 - 'device_args' => $default_unit_values_deg,
967 - 'range' => [
968 - 'px' => [
969 - 'min' => -360,
970 - 'max' => 360,
971 - ],
972 - ],
973 - 'condition' => [
974 - "_transform_rotate_3d{$tab}!" => '',
975 - "_transform_rotate_popover{$tab}!" => '',
976 - ],
977 - 'selectors' => [
978 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-rotateX: {{SIZE}}deg;',
979 - ],
980 - 'frontend_available' => true,
981 - ]
982 - );
983 -
984 - $this->add_responsive_control(
985 - "_transform_rotateY_effect{$tab}",
986 - [
987 - 'label' => esc_html__( 'Rotate Y', 'elementor' ) . ' (deg)',
988 - 'type' => Controls_Manager::SLIDER,
989 - 'device_args' => $default_unit_values_deg,
990 - 'range' => [
991 - 'px' => [
992 - 'min' => -360,
993 - 'max' => 360,
994 - ],
995 - ],
996 - 'condition' => [
997 - "_transform_rotate_3d{$tab}!" => '',
998 - "_transform_rotate_popover{$tab}!" => '',
999 - ],
1000 - 'selectors' => [
1001 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-rotateY: {{SIZE}}deg;',
1002 - ],
1003 - 'frontend_available' => true,
1004 - ]
1005 - );
1006 -
1007 - $this->add_responsive_control(
1008 - "_transform_perspective_effect{$tab}",
1009 - [
1010 - 'label' => esc_html__( 'Perspective', 'elementor' ) . ' (px)',
1011 - 'type' => Controls_Manager::SLIDER,
1012 - 'range' => [
1013 - 'px' => [
1014 - 'max' => 1000,
1015 - ],
1016 - ],
1017 - 'condition' => [
1018 - "_transform_rotate_popover{$tab}!" => '',
1019 - "_transform_rotate_3d{$tab}!" => '',
1020 - ],
1021 - 'selectors' => [
1022 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-perspective: {{SIZE}}px',
1023 - ],
1024 - 'frontend_available' => true,
1025 - ]
1026 - );
1027 -
1028 - $this->end_popover();
1029 -
1030 - $this->add_control(
1031 - "_transform_translate_popover{$tab}",
1032 - [
1033 - 'label' => esc_html__( 'Offset', 'elementor' ),
1034 - 'type' => Controls_Manager::POPOVER_TOGGLE,
1035 - 'prefix_class' => $transform_prefix_class,
1036 - 'return_value' => $transform_return_value,
1037 - ]
1038 - );
1039 -
1040 - $this->start_popover();
1041 -
1042 - $this->add_responsive_control(
1043 - "_transform_translateX_effect{$tab}",
1044 - [
1045 - 'label' => esc_html__( 'Offset X', 'elementor' ),
1046 - 'type' => Controls_Manager::SLIDER,
1047 - 'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
1048 - 'range' => [
1049 - '%' => [
1050 - 'min' => -100,
1051 - 'max' => 100,
1052 - ],
1053 - 'px' => [
1054 - 'min' => -1000,
1055 - 'max' => 1000,
1056 - ],
1057 - ],
1058 - 'condition' => [
1059 - "_transform_translate_popover{$tab}!" => '',
1060 - ],
1061 - 'selectors' => [
1062 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-translateX: {{SIZE}}{{UNIT}};',
1063 - ],
1064 - 'frontend_available' => true,
1065 - ]
1066 - );
1067 -
1068 - $this->add_responsive_control(
1069 - "_transform_translateY_effect{$tab}",
1070 - [
1071 - 'label' => esc_html__( 'Offset Y', 'elementor' ),
1072 - 'type' => Controls_Manager::SLIDER,
1073 - 'size_units' => [ 'px', '%', 'em', 'rem', 'vh', 'custom' ],
1074 - 'range' => [
1075 - '%' => [
1076 - 'min' => -100,
1077 - 'max' => 100,
1078 - ],
1079 - 'px' => [
1080 - 'min' => -1000,
1081 - 'max' => 1000,
1082 - ],
1083 - ],
1084 - 'condition' => [
1085 - "_transform_translate_popover{$tab}!" => '',
1086 - ],
1087 - 'selectors' => [
1088 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-translateY: {{SIZE}}{{UNIT}};',
1089 - ],
1090 - 'frontend_available' => true,
1091 - ]
1092 - );
1093 -
1094 - $this->end_popover();
1095 -
1096 - $this->add_control(
1097 - "_transform_scale_popover{$tab}",
1098 - [
1099 - 'label' => esc_html__( 'Scale', 'elementor' ),
1100 - 'type' => Controls_Manager::POPOVER_TOGGLE,
1101 - 'prefix_class' => $transform_prefix_class,
1102 - 'return_value' => $transform_return_value,
1103 - ]
1104 - );
1105 -
1106 - $this->start_popover();
1107 -
1108 - $this->add_control(
1109 - "_transform_keep_proportions{$tab}",
1110 - [
1111 - 'label' => esc_html__( 'Keep Proportions', 'elementor' ),
1112 - 'type' => Controls_Manager::SWITCHER,
1113 - 'label_on' => esc_html__( 'On', 'elementor' ),
1114 - 'label_off' => esc_html__( 'Off', 'elementor' ),
1115 - 'default' => 'yes',
1116 - ]
1117 - );
1118 -
1119 - $this->add_responsive_control(
1120 - "_transform_scale_effect{$tab}",
1121 - [
1122 - 'label' => esc_html__( 'Scale', 'elementor' ),
1123 - 'type' => Controls_Manager::SLIDER,
1124 - 'range' => [
1125 - 'px' => [
1126 - 'max' => 2,
1127 - 'step' => 0.1,
1128 - ],
1129 - ],
1130 - 'condition' => [
1131 - "_transform_scale_popover{$tab}!" => '',
1132 - "_transform_keep_proportions{$tab}!" => '',
1133 - ],
1134 - 'selectors' => [
1135 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-scale: {{SIZE}};',
1136 - ],
1137 - 'frontend_available' => true,
1138 - ]
1139 - );
1140 -
1141 - $this->add_responsive_control(
1142 - "_transform_scaleX_effect{$tab}",
1143 - [
1144 - 'label' => esc_html__( 'Scale X', 'elementor' ),
1145 - 'type' => Controls_Manager::SLIDER,
1146 - 'range' => [
1147 - 'px' => [
1148 - 'max' => 2,
1149 - 'step' => 0.1,
1150 - ],
1151 - ],
1152 - 'condition' => [
1153 - "_transform_scale_popover{$tab}!" => '',
1154 - "_transform_keep_proportions{$tab}" => '',
1155 - ],
1156 - 'selectors' => [
1157 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-scaleX: {{SIZE}};',
1158 - ],
1159 - 'frontend_available' => true,
1160 - ]
1161 - );
1162 -
1163 - $this->add_responsive_control(
1164 - "_transform_scaleY_effect{$tab}",
1165 - [
1166 - 'label' => esc_html__( 'Scale Y', 'elementor' ),
1167 - 'type' => Controls_Manager::SLIDER,
1168 - 'range' => [
1169 - 'px' => [
1170 - 'max' => 2,
1171 - 'step' => 0.1,
1172 - ],
1173 - ],
1174 - 'condition' => [
1175 - "_transform_scale_popover{$tab}!" => '',
1176 - "_transform_keep_proportions{$tab}" => '',
1177 - ],
1178 - 'selectors' => [
1179 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-scaleY: {{SIZE}};',
1180 - ],
1181 - 'frontend_available' => true,
1182 - ]
1183 - );
1184 -
1185 - $this->end_popover();
1186 -
1187 - $this->add_control(
1188 - "_transform_skew_popover{$tab}",
1189 - [
1190 - 'label' => esc_html__( 'Skew', 'elementor' ),
1191 - 'type' => Controls_Manager::POPOVER_TOGGLE,
1192 - 'prefix_class' => $transform_prefix_class,
1193 - 'return_value' => $transform_return_value,
1194 - ]
1195 - );
1196 -
1197 - $this->start_popover();
1198 -
1199 - $this->add_responsive_control(
1200 - "_transform_skewX_effect{$tab}",
1201 - [
1202 - 'label' => esc_html__( 'Skew X', 'elementor' ) . ' (deg)',
1203 - 'type' => Controls_Manager::SLIDER,
1204 - 'device_args' => $default_unit_values_deg,
1205 - 'range' => [
1206 - 'px' => [
1207 - 'min' => -360,
1208 - 'max' => 360,
1209 - ],
1210 - ],
1211 - 'condition' => [
1212 - "_transform_skew_popover{$tab}!" => '',
1213 - ],
1214 - 'selectors' => [
1215 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-skewX: {{SIZE}}deg;',
1216 - ],
1217 - 'frontend_available' => true,
1218 - ]
1219 - );
1220 -
1221 - $this->add_responsive_control(
1222 - "_transform_skewY_effect{$tab}",
1223 - [
1224 - 'label' => esc_html__( 'Skew Y', 'elementor' ) . ' (deg)',
1225 - 'type' => Controls_Manager::SLIDER,
1226 - 'device_args' => $default_unit_values_deg,
1227 - 'range' => [
1228 - 'px' => [
1229 - 'min' => -360,
1230 - 'max' => 360,
1231 - ],
1232 - ],
1233 - 'condition' => [
1234 - "_transform_skew_popover{$tab}!" => '',
1235 - ],
1236 - 'selectors' => [
1237 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-skewY: {{SIZE}}deg;',
1238 - ],
1239 - 'frontend_available' => true,
1240 - ]
1241 - );
1242 -
1243 - $this->end_popover();
1244 -
1245 - $this->add_control(
1246 - "_transform_flipX_effect{$tab}",
1247 - [
1248 - 'label' => esc_html__( 'Flip Horizontal', 'elementor' ),
1249 - 'type' => Controls_Manager::CHOOSE,
1250 - 'options' => [
1251 - 'transform' => [
1252 - 'title' => esc_html__( 'Flip Horizontal', 'elementor' ),
1253 - 'icon' => 'eicon-flip eicon-tilted',
1254 - ],
1255 - ],
1256 - 'prefix_class' => $transform_prefix_class,
1257 - 'selectors' => [
1258 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-flipX: -1',
1259 - ],
1260 - 'frontend_available' => true,
1261 - ]
1262 - );
1263 -
1264 - $this->add_control(
1265 - "_transform_flipY_effect{$tab}",
1266 - [
1267 - 'label' => esc_html__( 'Flip Vertical', 'elementor' ),
1268 - 'type' => Controls_Manager::CHOOSE,
1269 - 'options' => [
1270 - 'transform' => [
1271 - 'title' => esc_html__( 'Flip Vertical', 'elementor' ),
1272 - 'icon' => 'eicon-flip',
1273 - ],
1274 - ],
1275 - 'prefix_class' => $transform_prefix_class,
1276 - 'selectors' => [
1277 - "{{WRAPPER}}{$transform_selector_class}{$state}" => '--e-' . $transform_css_modifier . 'transform-flipY: -1',
1278 - ],
1279 - 'frontend_available' => true,
1280 - ]
1281 - );
1282 -
1283 - if ( '_hover' === $tab ) {
1284 - $this->add_control(
1285 - '_transform_transition_hover',
1286 - [
1287 - 'label' => esc_html__( 'Transition Duration', 'elementor' ) . ' (ms)',
1288 - 'type' => Controls_Manager::SLIDER,
1289 - 'device_args' => $default_unit_values_ms,
1290 - 'range' => [
1291 - 'px' => [
1292 - 'min' => 0,
1293 - 'max' => 10000,
1294 - 'step' => 100,
1295 - ],
1296 - ],
1297 - 'selectors' => [
1298 - '{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-transition-duration: {{SIZE}}ms',
1299 - ],
1300 - ]
1301 - );
1302 - }
1303 -
1304 - ${"transform_origin_conditions{$tab}"} = [
1305 - [
1306 - 'name' => "_transform_scale_popover{$tab}",
1307 - 'operator' => '!=',
1308 - 'value' => '',
1309 - ],
1310 - [
1311 - 'name' => "_transform_rotate_popover{$tab}",
1312 - 'operator' => '!=',
1313 - 'value' => '',
1314 - ],
1315 - [
1316 - 'name' => "_transform_flipX_effect{$tab}",
1317 - 'operator' => '!=',
1318 - 'value' => '',
1319 - ],
1320 - [
1321 - 'name' => "_transform_flipY_effect{$tab}",
1322 - 'operator' => '!=',
1323 - 'value' => '',
1324 - ],
1325 - ];
1326 -
1327 - $this->end_controls_tab();
1328 - }
1329 -
1330 - $this->end_controls_tabs();
1331 -
1332 - $transform_origin_conditions = [
1333 - 'relation' => 'or',
1334 - 'terms' => array_merge( $transform_origin_conditions, $transform_origin_conditions_hover ),
1335 - ];
1336 -
1337 - // Will override motion effect transform-origin.
1338 - $this->add_responsive_control(
1339 - 'motion_fx_transform_x_anchor_point',
1340 - [
1341 - 'label' => esc_html__( 'X Anchor Point', 'elementor' ),
1342 - 'type' => Controls_Manager::CHOOSE,
1343 - 'options' => [
1344 - 'left' => [
1345 - 'title' => esc_html__( 'Left', 'elementor' ),
1346 - 'icon' => 'eicon-h-align-left',
1347 - ],
1348 - 'center' => [
1349 - 'title' => esc_html__( 'Center', 'elementor' ),
1350 - 'icon' => 'eicon-h-align-center',
1351 - ],
1352 - 'right' => [
1353 - 'title' => esc_html__( 'Right', 'elementor' ),
1354 - 'icon' => 'eicon-h-align-right',
1355 - ],
1356 - ],
1357 - 'conditions' => $transform_origin_conditions,
1358 - 'separator' => 'before',
1359 - 'selectors' => [
1360 - '{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-origin-x: {{VALUE}}',
1361 - ],
1362 - ]
1363 - );
1364 -
1365 - // Will override motion effect transform-origin.
1366 - $this->add_responsive_control(
1367 - 'motion_fx_transform_y_anchor_point',
1368 - [
1369 - 'label' => esc_html__( 'Y Anchor Point', 'elementor' ),
1370 - 'type' => Controls_Manager::CHOOSE,
1371 - 'options' => [
1372 - 'top' => [
1373 - 'title' => esc_html__( 'Top', 'elementor' ),
1374 - 'icon' => 'eicon-v-align-top',
1375 - ],
1376 - 'center' => [
1377 - 'title' => esc_html__( 'Center', 'elementor' ),
1378 - 'icon' => 'eicon-v-align-middle',
1379 - ],
1380 - 'bottom' => [
1381 - 'title' => esc_html__( 'Bottom', 'elementor' ),
1382 - 'icon' => 'eicon-v-align-bottom',
1383 - ],
1384 - ],
1385 - 'conditions' => $transform_origin_conditions,
1386 - 'selectors' => [
1387 - '{{WRAPPER}}' => '--e-' . $transform_css_modifier . 'transform-origin-y: {{VALUE}}',
1388 - ],
1389 - ]
1390 - );
1391 -
1392 - $this->end_controls_section();
1393 - }
1394 -
1395 - /**
1396 - * Add Hidden Device Controls
1397 - *
1398 - * Adds controls for hiding elements within certain devices' viewport widths. Adds a control for each active device.
1399 - *
1400 - * @since 3.4.0
1401 - * @access protected
1402 - */
1403 - protected function add_hidden_device_controls() {
1404 - // The 'Hide On X' controls are displayed from largest to smallest, while the method returns smallest to largest.
1405 - $active_devices = Plugin::$instance->breakpoints->get_active_devices_list( [ 'reverse' => true ] );
1406 - $active_breakpoints = Plugin::$instance->breakpoints->get_active_breakpoints();
1407 -
1408 - foreach ( $active_devices as $breakpoint_key ) {
1409 - $label = 'desktop' === $breakpoint_key ? esc_html__( 'Desktop', 'elementor' ) : $active_breakpoints[ $breakpoint_key ]->get_label();
1410 -
1411 - $this->add_control(
1412 - 'hide_' . $breakpoint_key,
1413 - [
1414 - 'label' => sprintf(
1415 - /* translators: %s: Device name. */
1416 - esc_html__( 'Hide On %s', 'elementor' ),
1417 - $label
1418 - ),
1419 - 'type' => Controls_Manager::SWITCHER,
1420 - 'default' => '',
1421 - 'prefix_class' => 'elementor-',
1422 - 'label_on' => esc_html__( 'Hide', 'elementor' ),
1423 - 'label_off' => esc_html__( 'Show', 'elementor' ),
1424 - 'return_value' => 'hidden-' . $breakpoint_key,
1425 - ]
1426 - );
1427 - }
1428 - }
1429 -
1430 - /**
1431 867 * Get default data.
1432 868 *
1433 869 * Retrieve the default element data. Used to reset the data on initialization.
1434 870 *
@@ -1454,12 +890,11 @@
1454 890 * Output the element final HTML on the frontend.
1455 891 *
1456 892 * @since 1.0.0
1457 893 * @access protected
1458 - * @deprecated 3.1.0 Use `print_content()` method instead.
1459 894 */
1460 895 protected function _print_content() {
1461 - Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', 'print_content()' );
896 + Plugin::$instance->modules_manager->get_modules( 'dev-tools' )->deprecation->deprecated_function( __METHOD__, '3.1.0', __CLASS__ . '::print_content()' );
1462 897
1463 898 $this->print_content();
1464 899 }
1465 900
@@ -1512,19 +947,8 @@
1512 947 return $config;
1513 948 }
1514 949
1515 950 /**
1516 - * A Base method for sanitizing the settings before save.
1517 - * This method is meant to be overridden by the element.
1518 - *
1519 - * @param array $settings
1520 - * @return array
1521 - */
1522 - protected function on_save( array $settings ) {
1523 - return $settings;
1524 - }
1525 -
1526 - /**
1527 951 * Get child type.
1528 952 *
1529 953 * Retrieve the element child type based on element data.
1530 954 *
@@ -1537,9 +961,9 @@
1537 961 */
1538 962 private function get_child_type( $element_data ) {
1539 963 $child_type = $this->_get_default_child_type( $element_data );
1540 964
1541 - // If it's not a valid widget ( like a deactivated plugin ).
965 + // If it's not a valid widget ( like a deactivated plugin )
1542 966 if ( ! $child_type ) {
1543 967 return false;
1544 968 }
1545 969
@@ -1584,12 +1008,8 @@
1584 1008 $this->add_child( $child_data );
1585 1009 }
1586 1010 }
1587 1011
1588 - public function has_widget_inner_wrapper(): bool {
1589 - return true;
1590 - }
1591 -
1592 1012 /**
1593 1013 * Element base constructor.
1594 1014 *
1595 1015 * Initializing the element base class using `$data` and `$args`.
@@ -1602,9 +1022,9 @@
1602 1022 *
1603 1023 * @param array $data Optional. Element data. Default is an empty array.
1604 1024 * @param array|null $args Optional. Element default arguments. Default is null.
1605 1025 **/
1606 - public function __construct( array $data = [], ?array $args = null ) {
1026 + public function __construct( array $data = [], array $args = null ) {
1607 1027 if ( $data ) {
1608 1028 $this->is_type_instance = false;
1609 1029 } elseif ( $args ) {
1610 1030 $this->default_args = $args;