ProductLineItemNote.php — SureCart – Ecommerce Made Easy For Selling Physical Products, Digital Downloads, Subscriptions, Donations, & Payments 4.5.0

surecart / app / src / Integrations / Elementor / Widgets / ProductLineItemNote.php

surecart / app / src / Integrations / Elementor / Widgets Last commit date

ProductLineItemNote.php

373 lines

1	<?php
2
3	namespace SureCart\Integrations\Elementor\Widgets;
4
5	if ( ! defined( 'ABSPATH' ) ) {
6	exit; // Exit if accessed directly.
7	}
8
9	/**
10	* Product Line Item Note widget.
11	*/
12	class ProductLineItemNote extends \Elementor\Widget_Base {
13	/**
14	* Get widget name.
15	*
16	* @return string
17	*/
18	public function get_name() {
19	return 'surecart-product-line-item-note';
20	}
21
22	/**
23	* Get widget title.
24	*
25	* @return string
26	*/
27	public function get_title() {
28	return esc_html__( 'Product Note', 'surecart' );
29	}
30
31	/**
32	* Get widget icon.
33	*
34	* @return string
35	*/
36	public function get_icon() {
37	return 'eicon-pencil';
38	}
39
40	/**
41	* Get style dependencies.
42	*/
43	public function get_style_depends() {
44	return array( 'surecart-form-control' );
45	}
46
47	/**
48	* Get the widget keywords.
49	*
50	* @return array
51	*/
52	public function get_keywords() {
53	return array( 'surecart', 'note', 'comment', 'message', 'product' );
54	}
55
56	/**
57	* Get the widget categories.
58	*
59	* @return array
60	*/
61	public function get_categories() {
62	return array( 'surecart-elementor-elements' );
63	}
64
65	/**
66	* Register the widget content settings.
67	*
68	* @return void
69	*/
70	protected function register_content_settings() {
71	$this->start_controls_section(
72	'section_content',
73	[
74	'label' => esc_html__( 'Content', 'surecart' ),
75	]
76	);
77
78	$this->add_control(
79	'label',
80	[
81	'label' => esc_html__( 'Label', 'surecart' ),
82	'type' => \Elementor\Controls_Manager::TEXT,
83	'placeholder' => esc_html__( 'Note', 'surecart' ),
84	'default' => 'Note',
85	]
86	);
87
88	$this->add_control(
89	'placeholder',
90	[
91	'label' => esc_html__( 'Placeholder', 'surecart' ),
92	'type' => \Elementor\Controls_Manager::TEXT,
93	'placeholder' => esc_html__( 'Add a note (optional)', 'surecart' ),
94	'default' => esc_html__( 'Add a note (optional)', 'surecart' ),
95	]
96	);
97
98	$this->add_control(
99	'help_text',
100	[
101	'label' => esc_html__( 'Help text', 'surecart' ),
102	'type' => \Elementor\Controls_Manager::TEXT,
103	'placeholder' => esc_html__( 'Enter help text (optional)', 'surecart' ),
104	'description' => esc_html__( 'Optional text that appears below the note field to provide additional guidance.', 'surecart' ),
105	]
106	);
107
108	$this->end_controls_section();
109	}
110
111	/**
112	* Register the widget label style settings.
113	*
114	* @return void
115	*/
116	protected function register_label_style_settings() {
117	$note_selector = '{{WRAPPER}} .wp-block-surecart-product-line-item-note';
118
119	$this->start_controls_section(
120	'section_label_style',
121	array(
122	'label' => esc_html__( 'Label', 'surecart' ),
123	'tab' => \Elementor\Controls_Manager::TAB_STYLE,
124	)
125	);
126
127	$this->add_control(
128	'label_text_color',
129	array(
130	'label' => esc_html__( 'Text color', 'surecart' ),
131	'type' => \Elementor\Controls_Manager::COLOR,
132	'selectors' => [
133	$note_selector => 'color: {{VALUE}}',
134	$note_selector . ' .sc-form-label' => 'color: {{VALUE}}',
135	],
136	'default' => '#000000',
137	)
138	);
139
140	$this->add_group_control(
141	\Elementor\Group_Control_Typography::get_type(),
142	array(
143	'name' => 'label_typography',
144	'label' => esc_html__( 'Typography', 'surecart' ),
145	'selector' => $note_selector . ' label',
146	'fields_options' => [
147	'typography' => [ 'default' => 'yes' ],
148	'font_size' => [
149	'default' => [
150	'unit' => 'px',
151	'size' => 16,
152	],
153	],
154	],
155	)
156	);
157
158	$this->end_controls_section();
159	}
160
161	/**
162	* Register the widget textarea style settings.
163	*
164	* @return void
165	*/
166	protected function register_textarea_style_settings() {
167	$textarea_selector = '{{WRAPPER}} .wp-block-surecart-product-line-item-note .sc-form-control';
168
169	$this->start_controls_section(
170	'section_textarea_style',
171	array(
172	'label' => esc_html__( 'Input field', 'surecart' ),
173	'tab' => \Elementor\Controls_Manager::TAB_STYLE,
174	)
175	);
176
177	$this->add_group_control(
178	\Elementor\Group_Control_Typography::get_type(),
179	array(
180	'name' => 'textarea_typography',
181	'label' => esc_html__( 'Typography', 'surecart' ),
182	'selector' => $textarea_selector,
183	'fields_options' => [
184	'typography' => [ 'default' => 'yes' ],
185	'font_size' => [
186	'default' => [
187	'unit' => 'px',
188	'size' => 14,
189	],
190	],
191	],
192	)
193	);
194
195	$this->add_responsive_control(
196	'textarea_width',
197	array(
198	'label' => esc_html__( 'Width', 'surecart' ),
199	'type' => \Elementor\Controls_Manager::SLIDER,
200	'size_units' => [ 'px', 'em', '%' ],
201	'selectors' => array(
202	$textarea_selector => 'width: {{SIZE}}{{UNIT}};',
203	),
204	'default' => [
205	'size' => 100,
206	'unit' => '%',
207	],
208	'range' => [
209	'px' => [
210	'min' => 0,
211	'max' => 1000,
212	],
213	'em' => [
214	'min' => 0,
215	'step' => 0.1,
216	'max' => 10,
217	],
218	],
219	)
220	);
221
222	$this->add_group_control(
223	\Elementor\Group_Control_Border::get_type(),
224	[
225	'name' => 'textarea_border',
226	'selector' => $textarea_selector,
227	]
228	);
229
230	$this->add_responsive_control(
231	'textarea_border_radius',
232	[
233	'label' => esc_html__( 'Border Radius', 'surecart' ),
234	'type' => \Elementor\Controls_Manager::DIMENSIONS,
235	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
236	'selectors' => [
237	$textarea_selector => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
238	],
239	]
240	);
241
242	$this->add_responsive_control(
243	'textarea_padding',
244	[
245	'label' => esc_html__( 'Padding', 'surecart' ),
246	'type' => \Elementor\Controls_Manager::DIMENSIONS,
247	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
248	'selectors' => [
249	$textarea_selector => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
250	],
251	]
252	);
253
254	$this->end_controls_section();
255	}
256
257	/**
258	* Register the widget help text style settings.
259	*
260	* @return void
261	*/
262	protected function register_help_text_style_settings() {
263	$help_text_selector = '{{WRAPPER}} .wp-block-surecart-product-line-item-note .sc-help-text';
264
265	$this->start_controls_section(
266	'section_help_text_style',
267	array(
268	'label' => esc_html__( 'Help Text', 'surecart' ),
269	'tab' => \Elementor\Controls_Manager::TAB_STYLE,
270	)
271	);
272
273	$this->add_control(
274	'help_text_color',
275	array(
276	'label' => esc_html__( 'Text Color', 'surecart' ),
277	'type' => \Elementor\Controls_Manager::COLOR,
278	'selectors' => [
279	$help_text_selector => 'color: {{VALUE}}',
280	],
281	)
282	);
283
284	$this->add_group_control(
285	\Elementor\Group_Control_Typography::get_type(),
286	array(
287	'name' => 'help_text_typography',
288	'label' => esc_html__( 'Typography', 'surecart' ),
289	'selector' => $help_text_selector,
290	'fields_options' => [
291	'typography' => [ 'default' => 'yes' ],
292	'font_size' => [
293	'default' => [
294	'unit' => 'px',
295	'size' => 12,
296	],
297	],
298	],
299	)
300	);
301
302	$this->add_responsive_control(
303	'help_text_margin',
304	[
305	'label' => esc_html__( 'Margin', 'surecart' ),
306	'type' => \Elementor\Controls_Manager::DIMENSIONS,
307	'size_units' => [ 'px', '%', 'em', 'rem', 'custom' ],
308	'selectors' => [
309	$help_text_selector => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
310	],
311	]
312	);
313
314	$this->end_controls_section();
315	}
316
317	/**
318	* Register the widget controls.
319	*
320	* @return void
321	*/
322	protected function register_controls() {
323	$this->register_content_settings();
324	$this->register_label_style_settings();
325	$this->register_textarea_style_settings();
326	$this->register_help_text_style_settings();
327	}
328
329	/**
330	* Render the widget output on the frontend.
331	*
332	* @return void
333	*/
334	protected function render() {
335	$settings = $this->get_settings_for_display();
336
337	if ( \Elementor\Plugin::$instance->editor->is_edit_mode() ) {
338	?>
339	<div class="wp-block-surecart-product-line-item-note">
340	<?php if ( ! empty( $settings['label'] ) ) : ?>
341	<label class="sc-form-label" for="sc_product_note">
342	<?php echo esc_html( $settings['label'] ); ?>
343	</label>
344	<?php endif; ?>
345
346	<textarea
347	class="sc-form-control"
348	name="sc_product_note"
349	id="sc_product_note"
350	placeholder="<?php echo esc_attr( $settings['placeholder'] ?? __( 'Add a note (optional)', 'surecart' ) ); ?>"
351	rows="1"
352	onfocus="this.rows=3"
353	maxlength="485"
354	></textarea>
355
356	<?php if ( ! empty( $settings['help_text'] ) ) : ?>
357	<div class="sc-help-text">
358	<?php echo esc_html( $settings['help_text'] ); ?>
359	</div>
360	<?php endif; ?>
361	</div>
362	<?php
363	return;
364	}
365
366	?>
367	<div <?php $this->print_render_attribute_string( 'wrapper' ); ?>>
368	<!-- wp:surecart/product-line-item-note { "label" : "<?php echo esc_attr( $settings['label'] ?? '' ); ?>", "placeholder" : "<?php echo esc_attr( $settings['placeholder'] ?? '' ); ?>", "help_text" : "<?php echo esc_attr( $settings['help_text'] ?? '' ); ?>"} /-->
369	</div>
370	<?php
371	}
372	}
373