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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
<?php
namespace Elementor\Modules\NestedElements\Base;
use Elementor\Plugin;
use Elementor\Widget_Base;
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly.
}
/**
* Used to create a new widget that can be nested inside other widgets.
*/
abstract class Widget_Nested_Base extends Widget_Base {
/**
* Get default children elements structure.
*
* @return array
*/
abstract protected function get_default_children_elements();
/**
* Get repeater title setting key name.
*
* @return string
*/
abstract protected function get_default_repeater_title_setting_key();
/**
* Get default children title for the navigator, using `%d` as index in the format.
*
* @note The title in this method is used to set the default title for each created child in nested element.
* for handling the children title for new created widget(s), use `get_default_children_elements()` method,
* eg:
* [
* 'elType' => 'container',
* 'settings' => [
* '_title' => __( 'Tab #1', 'elementor' ),
* ],
* ],
* @return string
*/
protected function get_default_children_title() {
return esc_html__( 'Item #%d', 'elementor' );
}
/**
* Get default children placeholder selector, Empty string, means will be added at the end view.
*
* @return string
*/
protected function get_default_children_placeholder_selector() {
return '';
}
protected function get_default_children_container_placeholder_selector() {
return '';
}
protected function is_dynamic_content(): bool {
return false;
}
/**
* @inheritDoc
*
* To support nesting.
*/
protected function _get_default_child_type( array $element_data ) {
return Plugin::$instance->elements_manager->get_element_types( $element_data['elType'] );
}
/**
* @inheritDoc
*
* Adding new 'defaults' config for handling children elements.
*/
protected function get_initial_config() {
return array_merge( parent::get_initial_config(), [
'defaults' => [
'elements' => $this->get_default_children_elements(),
'elements_title' => $this->get_default_children_title(),
'elements_placeholder_selector' => $this->get_default_children_placeholder_selector(),
'child_container_placeholder_selector' => $this->get_default_children_container_placeholder_selector(),
'repeater_title_setting' => $this->get_default_repeater_title_setting_key(),
],
'support_nesting' => true,
] );
}
/**
* @inheritDoc
*
* Each element including its children elements.
*/
public function get_raw_data( $with_html_content = false ) {
$elements = [];
$data = $this->get_data();
$children = $this->get_children();
foreach ( $children as $child ) {
$child_raw_data = $child->get_raw_data( $with_html_content );
$elements[] = $child_raw_data;
}
return [
'id' => $this->get_id(),
'elType' => $data['elType'],
'widgetType' => $data['widgetType'],
'settings' => $data['settings'],
'elements' => $elements,
];
}
/**
* Print child, helper method to print the child element.
*
* @param int $index
*/
public function print_child( $index ) {
$children = $this->get_children();
if ( ! empty( $children[ $index ] ) ) {
$children[ $index ]->print_element();
}
}
protected function content_template_single_repeater_item() {}
public function print_template() {
parent::print_template();
if ( $this->get_initial_config()['support_improved_repeaters'] ?? false ) {
?>
<script type="text/html" id="tmpl-elementor-<?php echo esc_attr( $this->get_name() ); ?>-content-single">
<?php $this->content_template_single_repeater_item(); ?>
</script>
<?php
}
}
}
|