elementor / includes / widgets / divider.php

divider.php in Elementor Website Builder – more than just a page builder 3.25.8, at includes/widgets/divider.php

1,138 lines 33.2 KB

Raw Download Zip

1	<?php
2	namespace Elementor;
3
4	if ( ! defined( 'ABSPATH' ) ) {
5	exit; // Exit if accessed directly.
6	}
7
8	use Elementor\Core\Kits\Documents\Tabs\Global_Colors;
9	use Elementor\Core\Kits\Documents\Tabs\Global_Typography;
10
11	/**
12	* Elementor divider widget.
13	*
14	* Elementor widget that displays a line that divides different elements in the
15	* page.
16	*
17	* @since 1.0.0
18	*/
19	class Widget_Divider extends Widget_Base {
20
21	/**
22	* Get widget name.
23	*
24	* Retrieve divider widget name.
25	*
26	* @since 1.0.0
27	* @access public
28	*
29	* @return string Widget name.
30	*/
31	public function get_name() {
32	return 'divider';
33	}
34
35	/**
36	* Get widget title.
37	*
38	* Retrieve divider widget title.
39	*
40	* @since 1.0.0
41	* @access public
42	*
43	* @return string Widget title.
44	*/
45	public function get_title() {
46	return esc_html__( 'Divider', 'elementor' );
47	}
48
49	/**
50	* Get widget icon.
51	*
52	* Retrieve divider widget icon.
53	*
54	* @since 1.0.0
55	* @access public
56	*
57	* @return string Widget icon.
58	*/
59	public function get_icon() {
60	return 'eicon-divider';
61	}
62
63	/**
64	* Get widget categories.
65	*
66	* Retrieve the list of categories the divider widget belongs to.
67	*
68	* Used to determine where to display the widget in the editor.
69	*
70	* @since 2.0.0
71	* @access public
72	*
73	* @return array Widget categories.
74	*/
75	public function get_categories() {
76	return [ 'basic' ];
77	}
78
79	/**
80	* Get widget keywords.
81	*
82	* Retrieve the list of keywords the widget belongs to.
83	*
84	* @since 2.1.0
85	* @access public
86	*
87	* @return array Widget keywords.
88	*/
89	public function get_keywords() {
90	return [ 'divider', 'hr', 'line', 'border' ];
91	}
92
93	protected function is_dynamic_content(): bool {
94	return false;
95	}
96
97	/**
98	* Get style dependencies.
99	*
100	* Retrieve the list of style dependencies the widget requires.
101	*
102	* @since 3.24.0
103	* @access public
104	*
105	* @return array Widget style dependencies.
106	*/
107	public function get_style_depends(): array {
108	return [ 'widget-divider' ];
109	}
110
111	private static function get_additional_styles() {
112	static $additional_styles = null;
113
114	if ( null !== $additional_styles ) {
115	return $additional_styles;
116	}
117	$additional_styles = [];
118	/**
119	* Additional Styles.
120	*
121	* Filters the styles used by Elementor to add additional divider styles.
122	*
123	* @since 2.7.0
124	*
125	* @param array $additional_styles Additional Elementor divider styles.
126	*/
127	$additional_styles = apply_filters( 'elementor/divider/styles/additional_styles', $additional_styles );
128	return $additional_styles;
129	}
130
131	private function get_separator_styles() {
132	return array_merge(
133	self::get_additional_styles(),
134	[
135	'curly' => [
136	'label' => esc_html_x( 'Curly', 'Shapes', 'elementor' ),
137	'shape' => '<path d="M0,21c3.3,0,8.3-0.9,15.7-7.1c6.6-5.4,4.4-9.3,2.4-10.3c-3.4-1.8-7.7,1.3-7.3,8.8C11.2,20,17.1,21,24,21"/>',
138	'preserve_aspect_ratio' => false,
139	'supports_amount' => true,
140	'round' => false,
141	'group' => 'line',
142	],
143	'curved' => [
144	'label' => esc_html_x( 'Curved', 'Shapes', 'elementor' ),
145	'shape' => '<path d="M0,6c6,0,6,13,12,13S18,6,24,6"/>',
146	'preserve_aspect_ratio' => false,
147	'supports_amount' => true,
148	'round' => false,
149	'group' => 'line',
150	],
151	'multiple' => [
152	'label' => esc_html_x( 'Multiple', 'Shapes', 'elementor' ),
153	'shape' => '<path d="M24,8v12H0V8H24z M24,4v1H0V4H24z"/>',
154	'preserve_aspect_ratio' => false,
155	'supports_amount' => false,
156	'round' => false,
157	'group' => 'pattern',
158	],
159	'slashes' => [
160	'label' => esc_html_x( 'Slashes', 'Shapes', 'elementor' ),
161	'shape' => '<g transform="translate(-12.000000, 0)"><path d="M28,0L10,18"/><path d="M18,0L0,18"/><path d="M48,0L30,18"/><path d="M38,0L20,18"/></g>',
162	'preserve_aspect_ratio' => false,
163	'supports_amount' => true,
164	'round' => false,
165	'view_box' => '0 0 20 16',
166	'group' => 'line',
167	],
168	'squared' => [
169	'label' => esc_html_x( 'Squared', 'Shapes', 'elementor' ),
170	'shape' => '<polyline points="0,6 6,6 6,18 18,18 18,6 24,6 "/>',
171	'preserve_aspect_ratio' => false,
172	'supports_amount' => true,
173	'round' => false,
174	'group' => 'line',
175	],
176	'wavy' => [
177	'label' => esc_html_x( 'Wavy', 'Shapes', 'elementor' ),
178	'shape' => '<path d="M0,6c6,0,0.9,11.1,6.9,11.1S18,6,24,6"/>',
179	'preserve_aspect_ratio' => false,
180	'supports_amount' => true,
181	'round' => false,
182	'group' => 'line',
183	],
184	'zigzag' => [
185	'label' => esc_html_x( 'Zigzag', 'Shapes', 'elementor' ),
186	'shape' => '<polyline points="0,18 12,6 24,18 "/>',
187	'preserve_aspect_ratio' => false,
188	'supports_amount' => true,
189	'round' => false,
190	'group' => 'line',
191	],
192	'arrows' => [
193	'label' => esc_html_x( 'Arrows', 'Shapes', 'elementor' ),
194	'shape' => '<path d="M14.2,4c0.3,0,0.5,0.1,0.7,0.3l7.9,7.2c0.2,0.2,0.3,0.4,0.3,0.7s-0.1,0.5-0.3,0.7l-7.9,7.2c-0.2,0.2-0.4,0.3-0.7,0.3s-0.5-0.1-0.7-0.3s-0.3-0.4-0.3-0.7l0-2.9l-11.5,0c-0.4,0-0.7-0.3-0.7-0.7V9.4C1,9,1.3,8.7,1.7,8.7l11.5,0l0-3.6c0-0.3,0.1-0.5,0.3-0.7S13.9,4,14.2,4z"/>',
195	'preserve_aspect_ratio' => true,
196	'supports_amount' => true,
197	'round' => true,
198	'group' => 'pattern',
199	],
200	'pluses' => [
201	'label' => esc_html_x( 'Pluses', 'Shapes', 'elementor' ),
202	'shape' => '<path d="M21.4,9.6h-7.1V2.6c0-0.9-0.7-1.6-1.6-1.6h-1.6c-0.9,0-1.6,0.7-1.6,1.6v7.1H2.6C1.7,9.6,1,10.3,1,11.2v1.6c0,0.9,0.7,1.6,1.6,1.6h7.1v7.1c0,0.9,0.7,1.6,1.6,1.6h1.6c0.9,0,1.6-0.7,1.6-1.6v-7.1h7.1c0.9,0,1.6-0.7,1.6-1.6v-1.6C23,10.3,22.3,9.6,21.4,9.6z"/>',
203	'preserve_aspect_ratio' => true,
204	'supports_amount' => true,
205	'round' => false,
206	'group' => 'pattern',
207	],
208	'rhombus' => [
209	'label' => esc_html_x( 'Rhombus', 'Shapes', 'elementor' ),
210	'shape' => '<path d="M12.7,2.3c-0.4-0.4-1.1-0.4-1.5,0l-8,9.1c-0.3,0.4-0.3,0.9,0,1.2l8,9.1c0.4,0.4,1.1,0.4,1.5,0l8-9.1c0.3-0.4,0.3-0.9,0-1.2L12.7,2.3z"/>',
211	'preserve_aspect_ratio' => false,
212	'supports_amount' => true,
213	'round' => false,
214	'group' => 'pattern',
215	],
216	'parallelogram' => [
217	'label' => esc_html_x( 'Parallelogram', 'Shapes', 'elementor' ),
218	'shape' => '<polygon points="9.4,2 24,2 14.6,21.6 0,21.6"/>',
219	'preserve_aspect_ratio' => false,
220	'supports_amount' => true,
221	'round' => false,
222	'group' => 'pattern',
223	],
224	'rectangles' => [
225	'label' => esc_html_x( 'Rectangles', 'Shapes', 'elementor' ),
226	'shape' => '<rect x="15" y="0" width="30" height="30"/>',
227	'preserve_aspect_ratio' => false,
228	'supports_amount' => true,
229	'round' => true,
230	'group' => 'pattern',
231	'view_box' => '0 0 60 30',
232	],
233	'dots_tribal' => [
234	'label' => esc_html_x( 'Dots', 'Shapes', 'elementor' ),
235	'shape' => '<path d="M3,10.2c2.6,0,2.6,2,2.6,3.2S4.4,16.5,3,16.5s-3-1.4-3-3.2S0.4,10.2,3,10.2z M18.8,10.2c1.7,0,3.2,1.4,3.2,3.2s-1.4,3.2-3.2,3.2c-1.7,0-3.2-1.4-3.2-3.2S17,10.2,18.8,10.2z M34.6,10.2c1.5,0,2.6,1.4,2.6,3.2s-0.5,3.2-1.9,3.2c-1.5,0-3.4-1.4-3.4-3.2S33.1,10.2,34.6,10.2z M50.5,10.2c1.7,0,3.2,1.4,3.2,3.2s-1.4,3.2-3.2,3.2c-1.7,0-3.3-0.9-3.3-2.6S48.7,10.2,50.5,10.2z M66.2,10.2c1.5,0,3.4,1.4,3.4,3.2s-1.9,3.2-3.4,3.2c-1.5,0-2.6-0.4-2.6-2.1S64.8,10.2,66.2,10.2z M82.2,10.2c1.7,0.8,2.6,1.4,2.6,3.2s-0.1,3.2-1.6,3.2c-1.5,0-3.7-1.4-3.7-3.2S80.5,9.4,82.2,10.2zM98.6,10.2c1.5,0,2.6,0.4,2.6,2.1s-1.2,4.2-2.6,4.2c-1.5,0-3.7-0.4-3.7-2.1S97.1,10.2,98.6,10.2z M113.4,10.2c1.2,0,2.2,0.9,2.2,3.2s-0.1,3.2-1.3,3.2s-3.1-1.4-3.1-3.2S112.2,10.2,113.4,10.2z"/>',
236	'preserve_aspect_ratio' => true,
237	'supports_amount' => false,
238	'round' => false,
239	'group' => 'tribal',
240	'view_box' => '0 0 126 26',
241	],
242	'trees_2_tribal' => [
243	'label' => esc_html_x( 'Fir Tree', 'Shapes', 'elementor' ),
244	'shape' => '<path d="M111.9,18.3v3.4H109v-3.4H111.9z M90.8,18.3v3.4H88v-3.4H90.8z M69.8,18.3v3.4h-2.9v-3.4H69.8z M48.8,18.3v3.4h-2.9v-3.4H48.8z M27.7,18.3v3.4h-2.9v-3.4H27.7z M6.7,18.3v3.4H3.8v-3.4H6.7z M46.4,4l4.3,4.8l-1.8,0l3.5,4.4l-2.2-0.1l3,3.3l-11,0.4l3.6-3.8l-2.9-0.1l3.1-4.2l-1.9,0L46.4,4z M111.4,4l2.4,4.8l-1.8,0l3.5,4.4l-2.5-0.1l3.3,3.3h-11l3.1-3.4l-2.5-0.1l3.1-4.2l-1.9,0L111.4,4z M89.9,4l2.9,4.8l-1.9,0l3.2,4.2l-2.5,0l3.5,3.5l-11-0.4l3-3.1l-2.4,0L88,8.8l-1.9,0L89.9,4z M68.6,4l3,4.4l-1.9,0.1l3.4,4.1l-2.7,0.1l3.8,3.7H63.8l2.9-3.6l-2.9,0.1L67,8.7l-2,0.1L68.6,4z M26.5,4l3,4.4l-1.9,0.1l3.7,4.7l-2.5-0.1l3.3,3.3H21l3.1-3.4l-2.5-0.1l3.2-4.3l-2,0.1L26.5,4z M4.9,4l3.7,4.8l-1.5,0l3.1,4.2L7.6,13l3.4,3.4H0l3-3.3l-2.3,0.1l3.5-4.4l-2.3,0L4.9,4z"/>',
245	'preserve_aspect_ratio' => true,
246	'supports_amount' => false,
247	'round' => false,
248	'group' => 'tribal',
249	'view_box' => '0 0 126 26',
250	],
251	'rounds_tribal' => [
252	'label' => esc_html_x( 'Half Rounds', 'Shapes', 'elementor' ),
253	'shape' => '<path d="M11.9,15.9L11.9,15.9L0,16c-0.2-3.7,1.5-5.7,4.9-6C10,9.6,12.4,14.2,11.9,15.9zM26.9,15.9L26.9,15.9L15,16c0.5-3.7,2.5-5.7,5.9-6C26,9.6,27.4,14.2,26.9,15.9z M37.1,10c3.4,0.3,5.1,2.3,4.9,6H30.1C29.5,14.4,31.9,9.6,37.1,10z M57,15.9L57,15.9L45,16c0-3.4,1.6-5.4,4.9-5.9C54.8,9.3,57.4,14.2,57,15.9z M71.9,15.9L71.9,15.9L60,16c-0.2-3.7,1.5-5.7,4.9-6C70,9.6,72.4,14.2,71.9,15.9z M82.2,10c3.4,0.3,5,2.3,4.8,6H75.3C74,13,77.1,9.6,82.2,10zM101.9,15.9L101.9,15.9L90,16c-0.2-3.7,1.5-5.7,4.9-6C100,9.6,102.4,14.2,101.9,15.9z M112.1,10.1c2.7,0.5,4.3,2.5,4.9,5.9h-11.9l0,0C104.5,14.4,108,9.3,112.1,10.1z"/>',
254	'preserve_aspect_ratio' => true,
255	'supports_amount' => false,
256	'round' => false,
257	'group' => 'tribal',
258	'view_box' => '0 0 120 26',
259	],
260	'leaves_tribal' => [
261	'label' => esc_html_x( 'Leaves', 'Shapes', 'elementor' ),
262	'shape' => '<path d="M3,1.5C5,4.9,6,8.8,6,13s-1.7,8.1-5,11.5C0.3,21.1,0,17.2,0,13S1,4.9,3,1.5z M16,1.5c2,3.4,3,7.3,3,11.5s-1,8.1-3,11.5c-2-4.1-3-8.3-3-12.5S14,4.3,16,1.5z M29,1.5c2,4.8,3,9.3,3,13.5s-1,7.4-3,9.5c-2-3.4-3-7.3-3-11.5S27,4.9,29,1.5z M41.1,1.5C43.7,4.9,45,8.8,45,13s-1,8.1-3,11.5c-2-3.4-3-7.3-3-11.5S39.7,4.9,41.1,1.5zM55,1.5c2,2.8,3,6.3,3,10.5s-1.3,8.4-4,12.5c-1.3-3.4-2-7.3-2-11.5S53,4.9,55,1.5z M68,1.5c2,3.4,3,7.3,3,11.5s-0.7,8.1-2,11.5c-2.7-4.8-4-9.3-4-13.5S66,3.6,68,1.5z M82,1.5c1.3,4.8,2,9.3,2,13.5s-1,7.4-3,9.5c-2-3.4-3-7.3-3-11.5S79.3,4.9,82,1.5z M94,1.5c2,3.4,3,7.3,3,11.5s-1.3,8.1-4,11.5c-1.3-1.4-2-4.3-2-8.5S92,6.9,94,1.5z M107,1.5c2,2.1,3,5.3,3,9.5s-0.7,8.7-2,13.5c-2.7-3.4-4-7.3-4-11.5S105,4.9,107,1.5z"/>',
263	'preserve_aspect_ratio' => true,
264	'supports_amount' => false,
265	'round' => false,
266	'group' => 'tribal',
267	'view_box' => '0 0 117 26',
268	],
269	'stripes_tribal' => [
270	'label' => esc_html_x( 'Stripes', 'Shapes', 'elementor' ),
271	'shape' => '<path d="M54,1.6V26h-9V2.5L54,1.6z M69,1.6v23.3L60,26V1.6H69z M24,1.6v23.5l-9-0.6V1.6H24z M30,0l9,0.7v24.5h-9V0z M9,2.5v22H0V3.7L9,2.5z M75,1.6l9,0.9v22h-9V1.6z M99,2.7v21.7h-9V3.8L99,2.7z M114,3.8v20.7l-9-0.5V3.8L114,3.8z"/>',
272	'preserve_aspect_ratio' => true,
273	'supports_amount' => false,
274	'round' => false,
275	'group' => 'tribal',
276	'view_box' => '0 0 120 26',
277	],
278	'squares_tribal' => [
279	'label' => esc_html_x( 'Squares', 'Shapes', 'elementor' ),
280	'shape' => '<path d="M46.8,7.8v11.5L36,18.6V7.8H46.8z M82.4,7.8L84,18.6l-12,0.7L70.4,7.8H82.4z M0,7.8l12,0.9v9.9H1.3L0,7.8z M30,7.8v10.8H19L18,7.8H30z M63.7,7.8L66,18.6H54V9.5L63.7,7.8z M89.8,7L102,7.8v10.8H91.2L89.8,7zM108,7.8l12,0.9v8.9l-12,1V7.8z"/>',
281	'preserve_aspect_ratio' => true,
282	'supports_amount' => false,
283	'round' => false,
284	'group' => 'tribal',
285	'view_box' => '0 0 126 26',
286	],
287	'trees_tribal' => [
288	'label' => esc_html_x( 'Trees', 'Shapes', 'elementor' ),
289	'shape' => '<path d="M6.4,2l4.2,5.7H7.7v2.7l3.8,5.2l-3.8,0v7.8H4.8v-7.8H0l4.8-5.2V7.7H1.1L6.4,2z M25.6,2L31,7.7h-3.7v2.7l4.8,5.2h-4.8v7.8h-2.8v-7.8l-3.8,0l3.8-5.2V7.7h-2.9L25.6,2z M47.5,2l4.2,5.7h-3.3v2.7l3.8,5.2l-3.8,0l0.4,7.8h-2.8v-7.8H41l4.8-5.2V7.7h-3.7L47.5,2z M66.2,2l5.4,5.7h-3.7v2.7l4.8,5.2h-4.8v7.8H65v-7.8l-3.8,0l3.8-5.2V7.7h-2.9L66.2,2zM87.4,2l4.8,5.7h-2.9v3.1l3.8,4.8l-3.8,0v7.8h-2.8v-7.8h-4.8l4.8-4.8V7.7h-3.7L87.4,2z M107.3,2l5.4,5.7h-3.7v2.7l4.8,5.2h-4.8v7.8H106v-7.8l-3.8,0l3.8-5.2V7.7h-2.9L107.3,2z"/>',
290	'preserve_aspect_ratio' => true,
291	'supports_amount' => false,
292	'round' => false,
293	'group' => 'tribal',
294	'view_box' => '0 0 123 26',
295	],
296	'planes_tribal' => [
297	'label' => esc_html_x( 'Tribal', 'Shapes', 'elementor' ),
298	'shape' => '<path d="M29.6,10.3l2.1,2.2l-3.6,3.3h7v2.9h-7l3.6,3.5l-2.1,1.7l-5.2-5.2h-5.8v-2.9h5.8L29.6,10.3z M70.9,9.6l2.1,1.7l-3.6,3.5h7v2.9h-7l3.6,3.3l-2.1,2.2l-5.2-5.5h-5.8v-2.9h5.8L70.9,9.6z M111.5,9.6l2.1,1.7l-3.6,3.5h7v2.9h-7l3.6,3.3l-2.1,2.2l-5.2-5.5h-5.8v-2.9h5.8L111.5,9.6z M50.2,2.7l2.1,1.7l-3.6,3.5h7v2.9h-7l3.6,3.3l-2.1,2.2L45,10.7h-5.8V7.9H45L50.2,2.7z M11,2l2.1,1.7L9.6,7.2h7V10h-7l3.6,3.3L11,15.5L5.8,10H0V7.2h5.8L11,2z M91.5,2l2.1,2.2l-3.6,3.3h7v2.9h-7l3.6,3.5l-2.1,1.7l-5.2-5.2h-5.8V7.5h5.8L91.5,2z"/>',
299	'preserve_aspect_ratio' => true,
300	'supports_amount' => false,
301	'round' => false,
302	'group' => 'tribal',
303	'view_box' => '0 0 121 26',
304	],
305	'x_tribal' => [
306	'label' => esc_html_x( 'X', 'Shapes', 'elementor' ),
307	'shape' => '<path d="M10.7,6l2.5,2.6l-4,4.3l4,5.4l-2.5,1.9l-4.5-5.2l-3.9,4.2L0.7,17L4,13.1L0,8.6l2.3-1.3l3.9,3.9L10.7,6z M23.9,6.6l4.2,4.5L32,7.2l2.3,1.3l-4,4.5l3.2,3.9L32,19.1l-3.9-3.3l-4.5,4.3l-2.5-1.9l4.4-5.1l-4.2-3.9L23.9,6.6zM73.5,6L76,8.6l-4,4.3l4,5.4l-2.5,1.9l-4.5-5.2l-3.9,4.2L63.5,17l4.1-4.7L63.5,8l2.3-1.3l4.1,3.6L73.5,6z M94,6l2.5,2.6l-4,4.3l4,5.4L94,20.1l-3.9-5l-3.9,4.2L84,17l3.2-3.9L84,8.6l2.3-1.3l3.2,3.9L94,6z M106.9,6l4.5,5.1l3.9-3.9l2.3,1.3l-4,4.5l3.2,3.9l-1.6,2.1l-3.9-4.2l-4.5,5.2l-2.5-1.9l4-5.4l-4-4.3L106.9,6z M53.1,6l2.5,2.6l-4,4.3l4,4.6l-2.5,1.9l-4.5-4.5l-3.5,4.5L43.1,17l3.2-3.9l-4-4.5l2.3-1.3l3.9,3.9L53.1,6z"/>',
308	'preserve_aspect_ratio' => true,
309	'supports_amount' => false,
310	'round' => false,
311	'group' => 'tribal',
312	'view_box' => '0 0 126 26',
313	],
314	'zigzag_tribal' => [
315	'label' => esc_html_x( 'Zigzag', 'Shapes', 'elementor' ),
316	'shape' => '<polygon points="0,14.4 0,21 11.5,12.4 21.3,20 30.4,11.1 40.3,20 51,12.4 60.6,20 69.6,11.1 79.3,20 90.1,12.4 99.6,20 109.7,11.1 120,21 120,14.4 109.7,5 99.6,13 90.1,5 79.3,14.5 71,5.7 60.6,12.4 51,5 40.3,14.5 31.1,5 21.3,13 11.5,5 "/>',
317	'preserve_aspect_ratio' => true,
318	'supports_amount' => false,
319	'round' => false,
320	'group' => 'tribal',
321	'view_box' => '0 0 120 26',
322	],
323	]
324	);
325	}
326
327	private function filter_styles_by( $array, $key, $value ) {
328	return array_filter( $array, function( $style ) use ( $key, $value ) {
329	return $value === $style[ $key ];
330	} );
331	}
332
333	private function get_options_by_groups( $styles, $group = false ) {
334	$groups = [
335	'line' => [
336	'label' => esc_html__( 'Line', 'elementor' ),
337	'options' => [
338	'solid' => esc_html__( 'Solid', 'elementor' ),
339	'double' => esc_html__( 'Double', 'elementor' ),
340	'dotted' => esc_html__( 'Dotted', 'elementor' ),
341	'dashed' => esc_html__( 'Dashed', 'elementor' ),
342	],
343	],
344	];
345	foreach ( $styles as $key => $style ) {
346	if ( ! isset( $groups[ $style['group'] ] ) ) {
347	$groups[ $style['group'] ] = [
348	'label' => ucwords( str_replace( '_', '', $style['group'] ) ),
349	'options' => [],
350	];
351	}
352	$groups[ $style['group'] ]['options'][ $key ] = $style['label'];
353	}
354
355	if ( $group && isset( $groups[ $group ] ) ) {
356	return $groups[ $group ];
357	}
358	return $groups;
359	}
360
361	/**
362	* Register divider widget controls.
363	*
364	* Adds different input fields to allow the user to change and customize the widget settings.
365	*
366	* @since 3.1.0
367	* @access protected
368	*/
369	protected function register_controls() {
370	$styles = $this->get_separator_styles();
371	$this->start_controls_section(
372	'section_divider',
373	[
374	'label' => esc_html__( 'Divider', 'elementor' ),
375	]
376	);
377
378	$this->add_control(
379	'style',
380	[
381	'label' => esc_html__( 'Style', 'elementor' ),
382	'type' => Controls_Manager::SELECT,
383	'groups' => array_values( $this->get_options_by_groups( $styles ) ),
384	'render_type' => 'template',
385	'default' => 'solid',
386	'selectors' => [
387	'{{WRAPPER}}' => '--divider-border-style: {{VALUE}}',
388	],
389	]
390	);
391
392	$this->add_control(
393	'separator_type',
394	[
395	'type' => Controls_Manager::HIDDEN,
396	'default' => 'pattern',
397	'prefix_class' => 'elementor-widget-divider--separator-type-',
398	'condition' => [
399	'style!' => [
400	'',
401	'solid',
402	'double',
403	'dotted',
404	'dashed',
405	],
406	],
407	'render_type' => 'template',
408	]
409	);
410
411	$this->add_control(
412	'pattern_spacing_flag',
413	[
414	'type' => Controls_Manager::HIDDEN,
415	'default' => 'no-spacing',
416	'prefix_class' => 'elementor-widget-divider--',
417	'condition' => [
418	'style' => array_keys( $this->filter_styles_by( $styles, 'supports_amount', false ) ),
419	],
420	'render_type' => 'template',
421	]
422	);
423
424	$this->add_control(
425	'pattern_round_flag',
426	[
427	'type' => Controls_Manager::HIDDEN,
428	'default' => 'bg-round',
429	'prefix_class' => 'elementor-widget-divider--',
430	'condition' => [
431	'style' => array_keys( $this->filter_styles_by( $styles, 'round', true ) ),
432	],
433	]
434	);
435
436	$this->add_responsive_control(
437	'width',
438	[
439	'label' => esc_html__( 'Width', 'elementor' ),
440	'type' => Controls_Manager::SLIDER,
441	'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
442	'range' => [
443	'px' => [
444	'max' => 1000,
445	],
446	],
447	'default' => [
448	'size' => 100,
449	'unit' => '%',
450	],
451	'tablet_default' => [
452	'unit' => '%',
453	],
454	'mobile_default' => [
455	'unit' => '%',
456	],
457	'selectors' => [
458	'{{WRAPPER}} .elementor-divider-separator' => 'width: {{SIZE}}{{UNIT}};',
459	],
460	]
461	);
462
463	$this->add_responsive_control(
464	'align',
465	[
466	'label' => esc_html__( 'Alignment', 'elementor' ),
467	'type' => Controls_Manager::CHOOSE,
468	'options' => [
469	'left' => [
470	'title' => esc_html__( 'Left', 'elementor' ),
471	'icon' => 'eicon-text-align-left',
472	],
473	'center' => [
474	'title' => esc_html__( 'Center', 'elementor' ),
475	'icon' => 'eicon-text-align-center',
476	],
477	'right' => [
478	'title' => esc_html__( 'Right', 'elementor' ),
479	'icon' => 'eicon-text-align-right',
480	],
481	],
482	'selectors' => [
483	'{{WRAPPER}} .elementor-divider' => 'text-align: {{VALUE}}',
484	'{{WRAPPER}} .elementor-divider-separator' => 'margin: 0 auto; margin-{{VALUE}}: 0',
485	],
486	]
487	);
488
489	$this->add_control(
490	'look',
491	[
492	'label' => esc_html__( 'Add Element', 'elementor' ),
493	'type' => Controls_Manager::CHOOSE,
494	'default' => 'line',
495	'options' => [
496	'line' => [
497	'title' => esc_html__( 'None', 'elementor' ),
498	'icon' => 'eicon-ban',
499	],
500	'line_text' => [
501	'title' => esc_html__( 'Text', 'elementor' ),
502	'icon' => 'eicon-t-letter-bold',
503	],
504	'line_icon' => [
505	'title' => esc_html__( 'Icon', 'elementor' ),
506	'icon' => 'eicon-star',
507	],
508	],
509	'separator' => 'before',
510	'prefix_class' => 'elementor-widget-divider--view-',
511	'toggle' => false,
512	'render_type' => 'template',
513	]
514	);
515
516	$this->add_control(
517	'text',
518	[
519	'label' => esc_html__( 'Text', 'elementor' ),
520	'type' => Controls_Manager::TEXT,
521	'condition' => [
522	'look' => 'line_text',
523	],
524	'default' => esc_html__( 'Divider', 'elementor' ),
525	'dynamic' => [
526	'active' => true,
527	],
528	]
529	);
530
531	$this->add_control(
532	'html_tag',
533	[
534	'label' => esc_html__( 'HTML Tag', 'elementor' ),
535	'type' => Controls_Manager::SELECT,
536	'condition' => [
537	'look' => 'line_text',
538	],
539	'options' => [
540	'h1' => 'H1',
541	'h2' => 'H2',
542	'h3' => 'H3',
543	'h4' => 'H4',
544	'h5' => 'H5',
545	'h6' => 'H6',
546	'div' => 'div',
547	'span' => 'span',
548	'p' => 'p',
549	],
550	'default' => 'span',
551	]
552	);
553
554	$this->add_control(
555	'icon',
556	[
557	'label' => esc_html__( 'Icon', 'elementor' ),
558	'type' => Controls_Manager::ICONS,
559	'default' => [
560	'value' => 'fas fa-star',
561	'library' => 'fa-solid',
562	],
563	'condition' => [
564	'look' => 'line_icon',
565	],
566	]
567	);
568
569	$this->end_controls_section();
570
571	$this->start_controls_section(
572	'section_divider_style',
573	[
574	'label' => esc_html__( 'Divider', 'elementor' ),
575	'tab' => Controls_Manager::TAB_STYLE,
576	'condition' => [
577	'style!' => 'none',
578	],
579	]
580	);
581
582	$this->add_control(
583	'color',
584	[
585	'label' => esc_html__( 'Color', 'elementor' ),
586	'type' => Controls_Manager::COLOR,
587	'global' => [
588	'default' => Global_Colors::COLOR_SECONDARY,
589	],
590	'default' => '#000',
591	'render_type' => 'template',
592	'selectors' => [
593	'{{WRAPPER}}' => '--divider-color: {{VALUE}}',
594	],
595	]
596	);
597
598	$this->add_control(
599	'weight',
600	[
601	'label' => esc_html__( 'Weight', 'elementor' ),
602	'type' => Controls_Manager::SLIDER,
603	'size_units' => [ 'px', 'em', 'rem', 'custom' ],
604	'default' => [
605	'size' => 1,
606	],
607	'range' => [
608	'px' => [
609	'min' => 1,
610	'max' => 10,
611	'step' => 0.1,
612	],
613	'em' => [
614	'min' => 0.1,
615	'max' => 1,
616	],
617	'rem' => [
618	'min' => 0.1,
619	'max' => 1,
620	],
621	],
622	'render_type' => 'template',
623	'condition' => [
624	'style' => array_keys( $this->get_options_by_groups( $styles, 'line' )['options'] ),
625	],
626	'selectors' => [
627	'{{WRAPPER}}' => '--divider-border-width: {{SIZE}}{{UNIT}}',
628	],
629	]
630	);
631
632	$this->add_control(
633	'pattern_height',
634	[
635	'label' => esc_html__( 'Size', 'elementor' ),
636	'type' => Controls_Manager::SLIDER,
637	'selectors' => [
638	'{{WRAPPER}}' => '--divider-pattern-height: {{SIZE}}{{UNIT}}',
639	],
640	'default' => [
641	'size' => 20,
642	],
643	'range' => [
644	'px' => [
645	'step' => 0.1,
646	],
647	],
648	'condition' => [
649	'style!' => [
650	'',
651	'solid',
652	'double',
653	'dotted',
654	'dashed',
655	],
656	],
657	]
658	);
659
660	$this->add_control(
661	'pattern_size',
662	[
663	'label' => esc_html__( 'Amount', 'elementor' ),
664	'type' => Controls_Manager::SLIDER,
665	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
666	'selectors' => [
667	'{{WRAPPER}}' => '--divider-pattern-size: {{SIZE}}{{UNIT}}',
668	],
669	'default' => [
670	'size' => 20,
671	],
672	'range' => [
673	'px' => [
674	'step' => 0.1,
675	],
676	'%' => [
677	'step' => 0.01,
678	],
679	],
680	'condition' => [
681	'style!' => array_merge( array_keys( $this->filter_styles_by( $styles, 'supports_amount', false ) ), [
682	'',
683	'solid',
684	'double',
685	'dotted',
686	'dashed',
687	] ),
688	],
689	]
690	);
691
692	$this->add_responsive_control(
693	'gap',
694	[
695	'label' => esc_html__( 'Gap', 'elementor' ),
696	'type' => Controls_Manager::SLIDER,
697	'default' => [
698	'size' => 15,
699	],
700	'range' => [
701	'px' => [
702	'min' => 2,
703	'max' => 50,
704	],
705	],
706	'selectors' => [
707	'{{WRAPPER}} .elementor-divider' => 'padding-block-start: {{SIZE}}{{UNIT}}; padding-block-end: {{SIZE}}{{UNIT}};',
708	],
709	'separator' => 'before',
710	]
711	);
712
713	$this->end_controls_section();
714
715	$this->start_controls_section(
716	'section_text_style',
717	[
718	'label' => esc_html__( 'Text', 'elementor' ),
719	'tab' => Controls_Manager::TAB_STYLE,
720	'condition' => [
721	'look' => 'line_text',
722	],
723	]
724	);
725
726	$this->add_control(
727	'text_color',
728	[
729	'label' => esc_html__( 'Color', 'elementor' ),
730	'type' => Controls_Manager::COLOR,
731	'global' => [
732	'default' => Global_Colors::COLOR_SECONDARY,
733	],
734	'selectors' => [
735	'{{WRAPPER}} .elementor-divider__text' => 'color: {{VALUE}}',
736	],
737	]
738	);
739
740	$this->add_group_control(
741	Group_Control_Typography::get_type(),
742	[
743	'name' => 'typography',
744	'global' => [
745	'default' => Global_Typography::TYPOGRAPHY_SECONDARY,
746	],
747	'selector' => '{{WRAPPER}} .elementor-divider__text',
748	]
749	);
750
751	$this->add_group_control(
752	Group_Control_Text_Stroke::get_type(),
753	[
754	'name' => 'text_stroke',
755	'selector' => '{{WRAPPER}} .elementor-divider__text',
756	]
757	);
758
759	$this->add_control(
760	'text_align',
761	[
762	'label' => esc_html__( 'Position', 'elementor' ),
763	'type' => Controls_Manager::CHOOSE,
764	'options' => [
765	'left' => [
766	'title' => esc_html__( 'Left', 'elementor' ),
767	'icon' => 'eicon-h-align-left',
768	],
769	'center' => [
770	'title' => esc_html__( 'Center', 'elementor' ),
771	'icon' => 'eicon-h-align-center',
772	],
773	'right' => [
774	'title' => esc_html__( 'Right', 'elementor' ),
775	'icon' => 'eicon-h-align-right',
776	],
777	],
778	'default' => 'center',
779	'prefix_class' => 'elementor-widget-divider--element-align-',
780	]
781	);
782
783	$this->add_responsive_control(
784	'text_spacing',
785	[
786	'label' => esc_html__( 'Spacing', 'elementor' ),
787	'type' => Controls_Manager::SLIDER,
788	'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
789	'range' => [
790	'px' => [
791	'max' => 50,
792	],
793	'%' => [
794	'max' => 50,
795	],
796	'em' => [
797	'max' => 5,
798	],
799	'rem' => [
800	'max' => 5,
801	],
802	'vw' => [
803	'max' => 50,
804	],
805	],
806	'selectors' => [
807	'{{WRAPPER}}' => '--divider-element-spacing: {{SIZE}}{{UNIT}};',
808	],
809	]
810	);
811
812	$this->end_controls_section();
813
814	$this->start_controls_section(
815	'section_icon_style',
816	[
817	'label' => esc_html__( 'Icon', 'elementor' ),
818	'tab' => Controls_Manager::TAB_STYLE,
819	'condition' => [
820	'look' => 'line_icon',
821	],
822	]
823	);
824
825	$this->add_control(
826	'icon_view',
827	[
828	'label' => esc_html__( 'View', 'elementor' ),
829	'type' => Controls_Manager::SELECT,
830	'options' => [
831	'default' => esc_html__( 'Default', 'elementor' ),
832	'stacked' => esc_html__( 'Stacked', 'elementor' ),
833	'framed' => esc_html__( 'Framed', 'elementor' ),
834	],
835	'default' => 'default',
836	'prefix_class' => 'elementor-view-',
837	]
838	);
839
840	$this->add_responsive_control(
841	'icon_size',
842	[
843	'label' => esc_html__( 'Size', 'elementor' ),
844	'type' => Controls_Manager::SLIDER,
845	'size_units' => [ 'px', 'em', 'rem', 'custom' ],
846	'range' => [
847	'px' => [
848	'max' => 100,
849	],
850	'em' => [
851	'max' => 10,
852	],
853	'rem' => [
854	'max' => 10,
855	],
856	],
857	'selectors' => [
858	'{{WRAPPER}}' => '--divider-icon-size: {{SIZE}}{{UNIT}};',
859	],
860	]
861	);
862
863	$this->add_control(
864	'icon_padding',
865	[
866	'label' => esc_html__( 'Padding', 'elementor' ),
867	'type' => Controls_Manager::SLIDER,
868	'size_units' => [ 'px', 'em', 'rem', 'custom' ],
869	'selectors' => [
870	'{{WRAPPER}} .elementor-icon' => 'padding: {{SIZE}}{{UNIT}};',
871	],
872	'range' => [
873	'px' => [
874	'max' => 50,
875	],
876	'em' => [
877	'min' => 0,
878	'max' => 5,
879	],
880	'rem' => [
881	'min' => 0,
882	'max' => 5,
883	],
884	],
885	'condition' => [
886	'icon_view!' => 'default',
887	],
888	]
889	);
890
891	$this->add_control(
892	'primary_color',
893	[
894	'label' => esc_html__( 'Primary Color', 'elementor' ),
895	'type' => Controls_Manager::COLOR,
896	'default' => '',
897	'selectors' => [
898	'{{WRAPPER}}.elementor-view-stacked .elementor-icon' => 'background-color: {{VALUE}};',
899	'{{WRAPPER}}.elementor-view-framed .elementor-icon, {{WRAPPER}}.elementor-view-default .elementor-icon' => 'color: {{VALUE}}; border-color: {{VALUE}};',
900	'{{WRAPPER}}.elementor-view-framed .elementor-icon, {{WRAPPER}}.elementor-view-default .elementor-icon svg' => 'fill: {{VALUE}};',
901	],
902	'global' => [
903	'default' => Global_Colors::COLOR_SECONDARY,
904	],
905	]
906	);
907
908	$this->add_control(
909	'secondary_color',
910	[
911	'label' => esc_html__( 'Secondary Color', 'elementor' ),
912	'type' => Controls_Manager::COLOR,
913	'default' => '',
914	'condition' => [
915	'icon_view!' => 'default',
916	],
917	'selectors' => [
918	'{{WRAPPER}}.elementor-view-framed .elementor-icon' => 'background-color: {{VALUE}};',
919	'{{WRAPPER}}.elementor-view-stacked .elementor-icon' => 'color: {{VALUE}};',
920	'{{WRAPPER}}.elementor-view-stacked .elementor-icon svg' => 'fill: {{VALUE}};',
921	],
922	]
923	);
924
925	$this->add_control(
926	'icon_align',
927	[
928	'label' => esc_html__( 'Position', 'elementor' ),
929	'type' => Controls_Manager::CHOOSE,
930	'options' => [
931	'left' => [
932	'title' => esc_html__( 'Left', 'elementor' ),
933	'icon' => 'eicon-h-align-left',
934	],
935	'center' => [
936	'title' => esc_html__( 'Center', 'elementor' ),
937	'icon' => 'eicon-h-align-center',
938	],
939	'right' => [
940	'title' => esc_html__( 'Right', 'elementor' ),
941	'icon' => 'eicon-h-align-right',
942	],
943	],
944	'default' => 'center',
945	'prefix_class' => 'elementor-widget-divider--element-align-',
946	'separator' => 'before',
947	]
948	);
949
950	$this->add_responsive_control(
951	'icon_spacing',
952	[
953	'label' => esc_html__( 'Spacing', 'elementor' ),
954	'type' => Controls_Manager::SLIDER,
955	'size_units' => [ 'px', 'em', 'rem', 'custom' ],
956	'range' => [
957	'px' => [
958	'max' => 50,
959	],
960	'em' => [
961	'max' => 5,
962	],
963	'rem' => [
964	'max' => 5,
965	],
966	],
967	'selectors' => [
968	'{{WRAPPER}}' => '--divider-element-spacing: {{SIZE}}{{UNIT}}',
969	],
970	'separator' => 'before',
971	]
972	);
973
974	$this->add_responsive_control(
975	'rotate',
976	[
977	'label' => esc_html__( 'Rotate', 'elementor' ),
978	'type' => Controls_Manager::SLIDER,
979	'size_units' => [ 'deg', 'grad', 'rad', 'turn', 'custom' ],
980	'default' => [
981	'unit' => 'deg',
982	],
983	'tablet_default' => [
984	'unit' => 'deg',
985	],
986	'mobile_default' => [
987	'unit' => 'deg',
988	],
989	'selectors' => [
990	'{{WRAPPER}} .elementor-icon i, {{WRAPPER}} .elementor-icon svg' => 'transform: rotate({{SIZE}}{{UNIT}})',
991	],
992	]
993	);
994
995	$this->add_control(
996	'icon_border_width',
997	[
998	'label' => esc_html__( 'Border Width', 'elementor' ),
999	'type' => Controls_Manager::SLIDER,
1000	'size_units' => [ 'px', '%', 'em', 'rem', 'vw', 'custom' ],
1001	'range' => [
1002	'px' => [
1003	'max' => 20,
1004	],
1005	'em' => [
1006	'max' => 2,
1007	],
1008	],
1009	'selectors' => [
1010	'{{WRAPPER}} .elementor-icon' => 'border-width: {{SIZE}}{{UNIT}}',
1011	],
1012	'condition' => [
1013	'icon_view' => 'framed',
1014	],
1015	]
1016	);
1017
1018	$this->add_control(
1019	'border_radius',
1020	[
1021	'label' => esc_html__( 'Border Radius', 'elementor' ),
1022	'type' => Controls_Manager::SLIDER,
1023	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
1024	'selectors' => [
1025	'{{WRAPPER}} .elementor-icon' => 'border-radius: {{SIZE}}{{UNIT}}',
1026	],
1027	'condition' => [
1028	'icon_view!' => 'default',
1029	],
1030	]
1031	);
1032
1033	$this->end_controls_section();
1034	}
1035
1036	/**
1037	* Build SVG
1038	*
1039	* Build SVG element markup based on the widgets settings.
1040	*
1041	* @return string - An SVG element.
1042	*
1043	* @since 2.7.0
1044	* @access private
1045	*/
1046	private function build_svg() {
1047	$settings = $this->get_settings_for_display();
1048
1049	if ( 'pattern' !== $settings['separator_type'] \|\| empty( $settings['style'] ) ) {
1050	return '';
1051	}
1052
1053	$svg_shapes = $this->get_separator_styles();
1054
1055	$selected_pattern = $svg_shapes[ $settings['style'] ];
1056	$preserve_aspect_ratio = $selected_pattern['preserve_aspect_ratio'] ? 'xMidYMid meet' : 'none';
1057	$view_box = isset( $selected_pattern['view_box'] ) ? $selected_pattern['view_box'] : '0 0 24 24';
1058
1059	$attr = [
1060	'preserveAspectRatio' => $preserve_aspect_ratio,
1061	'overflow' => 'visible',
1062	'height' => '100%',
1063	'viewBox' => $view_box,
1064	];
1065
1066	if ( 'line' !== $selected_pattern['group'] ) {
1067	$attr['fill'] = 'black';
1068	$attr['stroke'] = 'none';
1069	} else {
1070	$attr['fill'] = 'none';
1071	$attr['stroke'] = 'black';
1072	$attr['stroke-width'] = $settings['weight']['size'];
1073	$attr['stroke-linecap'] = 'square';
1074	$attr['stroke-miterlimit'] = '10';
1075	}
1076
1077	$this->add_render_attribute( 'svg', $attr );
1078
1079	$pattern_attribute_string = $this->get_render_attribute_string( 'svg' );
1080	$shape = $selected_pattern['shape'];
1081
1082	return '<svg xmlns="http://www.w3.org/2000/svg" ' . $pattern_attribute_string . '>' . $shape . '</svg>';
1083	}
1084
1085	public function svg_to_data_uri( $svg ) {
1086	return str_replace(
1087	[ '<', '>', '"', '#' ],
1088	[ '%3C', '%3E', "'", '%23' ],
1089	$svg
1090	);
1091	}
1092
1093	/**
1094	* Render divider widget output on the frontend.
1095	*
1096	* Written in PHP and used to generate the final HTML.
1097	*
1098	* @since 1.0.0
1099	* @access protected
1100	*/
1101	protected function render() {
1102	$settings = $this->get_settings_for_display();
1103	$svg_code = $this->build_svg();
1104	$has_icon = 'line_icon' === ( $settings['look'] ) && ! empty( $settings['icon'] );
1105	$has_text = 'line_text' === ( $settings['look'] ) && ! empty( $settings['text'] );
1106
1107	$this->add_render_attribute( 'wrapper', 'class', 'elementor-divider' );
1108
1109	if ( ! empty( $svg_code ) ) {
1110	$this->add_render_attribute( 'wrapper', 'style', '--divider-pattern-url: url("data:image/svg+xml,' . $this->svg_to_data_uri( $svg_code ) . '");' );
1111	}
1112
1113	?>
1114	<div <?php $this->print_render_attribute_string( 'wrapper' ); ?>>
1115	<span class="elementor-divider-separator">
1116	<?php if ( $has_icon ) : ?>
1117	<div class="elementor-icon elementor-divider__element">
1118	<?php
1119	Icons_Manager::render_icon( $settings['icon'], [
1120	'aria-hidden' => 'true',
1121	] );
1122	?></div>
1123	<?php elseif ( $has_text ) :
1124	$this->add_inline_editing_attributes( 'text' );
1125	$this->add_render_attribute( 'text', [ 'class' => [ 'elementor-divider__text', 'elementor-divider__element' ] ] );
1126	?>
1127	<<?php Utils::print_validated_html_tag( $settings['html_tag'] ); ?> <?php $this->print_render_attribute_string( 'text' ); ?>>
1128	<?php
1129	// PHPCS - the main text of a widget should not be escaped.
1130	echo $settings['text']; // phpcs:ignore WordPress.Security.EscapeOutput ?>
1131	</<?php Utils::print_validated_html_tag( $settings['html_tag'] ); ?>>
1132	<?php endif; ?>
1133	</span>
1134	</div>
1135	<?php
1136	}
1137	}
1138