1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

<?php
namespace Elementor;

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly.
}

/**
 * Elementor Deprecated Notice control.
 *
 * A base control specific for creating Deprecation Notices control.
 * Displays a warning notice in the panel.
 *
 * @since 2.6.0
 */
class Control_Deprecated_Notice extends Base_UI_Control {

    /**
     * Get deprecated-notice control type.
     *
     * Retrieve the control type, in this case `deprecated_notice`.
     *
     * @since 2.6.0
     * @access public
     *
     * @return string Control type.
     */
    public function get_type() {
        return 'deprecated_notice';
    }

    /**
     * Render deprecated notice control output in the editor.
     *
     * Used to generate the control HTML in the editor using Underscore JS
     * template. The variables for the class are available using `data` JS
     * object.
     *
     * @since 2.6.0
     * @access public
     */
    public function content_template() {
        ?>
        <# if ( data.label ) { #>
        <span class="elementor-control-title">{{{ data.label }}}</span>
        <#
        }
        let notice = wp.i18n.sprintf( wp.i18n.__( 'The <strong>%1$s</strong> widget has been deprecated since %2$s %3$s.', 'elementor' ), data.widget, data.plugin, data.since );
        if ( data.replacement ) {
            notice += '<br>' + wp.i18n.sprintf( wp.i18n.__( 'It has been replaced by <strong>%1$s</strong>.', 'elementor' ), data.replacement );
        }
        if ( data.last ) {
            notice += '<br>' + wp.i18n.sprintf( wp.i18n.__( 'Note that %1$s will be completely removed once %2$s %3$s is released.', 'elementor' ), data.widget, data.plugin, data.last );
        }
        #>
        <div class="elementor-control-deprecated-notice elementor-panel-alert elementor-panel-alert-warning">{{{ notice }}}</div>
        <?php
    }

    /**
     * Get deprecated-notice control default settings.
     *
     * Retrieve the default settings of the deprecated notice control. Used to return the
     * default settings while initializing the deprecated notice control.
     *
     * @since 2.6.0
     * @access protected
     *
     * @return array Control default settings.
     */
    protected function get_default_settings() {
        return [
            'widget' => '', // Widgets name
            'since' => '', // Plugin version widget was deprecated
            'last' => '', // Plugin version in which the widget will be removed
            'plugin' => '', // Plugin's title
            'replacement' => '', // Widget replacement
        ];
    }
}