PluginProbe
Elementor Website Builder – more than just a page builder / 4.1.0-beta1
Elementor Website Builder – more than just a page builder v4.1.0-beta1
4.3.3 4.3.2 4.3.1 4.3.0 4.3.0-beta3 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 All 456 releases
← All changes | modules/atomic-widgets/elements/atomic-form/atomic-form.php +81 -202 4.3.0-beta1 → 4.1.0-beta1 View file →
@@ -3,9 +3,8 @@
3 3
4 4 use Elementor\Modules\AtomicWidgets\Controls\Section;
5 5 use Elementor\Modules\AtomicWidgets\Controls\Types\Chips_Control;
6 6 use Elementor\Modules\AtomicWidgets\Controls\Types\Email_Form_Action_Control;
7 -use Elementor\Modules\AtomicWidgets\Controls\Types\Switch_Control;
8 7 use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
9 8 use Elementor\Modules\AtomicWidgets\Controls\Types\Toggle_Control;
10 9 use Elementor\Modules\AtomicWidgets\Elements\Atomic_Paragraph\Atomic_Paragraph;
11 10 use Elementor\Modules\AtomicWidgets\Elements\Atomic_Form\Form_Success_Message\Form_Success_Message;
@@ -12,19 +11,17 @@
12 11 use Elementor\Modules\AtomicWidgets\Elements\Atomic_Form\Form_Error_Message\Form_Error_Message;
13 12 use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Element_Base;
14 13 use Elementor\Modules\AtomicWidgets\Elements\Base\Element_Builder;
15 14 use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Element_Template;
16 -use Elementor\Modules\AtomicWidgets\Elements\Base\Html_Tag_Computer;
17 15 use Elementor\Modules\AtomicWidgets\Elements\Base\Widget_Builder;
18 16 use Elementor\Modules\AtomicWidgets\PropDependencies\Manager as Dependency_Manager;
19 17 use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
20 18 use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
21 -use Elementor\Modules\AtomicWidgets\PropTypes\Emails_Prop_Type;
19 +use Elementor\Modules\AtomicWidgets\PropTypes\Email_Prop_Type;
22 20 use Elementor\Modules\AtomicWidgets\PropTypes\Key_Value_Prop_Type;
23 -use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Boolean_Prop_Type;
24 21 use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\Number_Prop_Type;
25 22 use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
26 -use Elementor\Modules\AtomicWidgets\PropTypes\Escaped_Html_Prop_Type;
23 +use Elementor\Modules\AtomicWidgets\PropTypes\Html_V3_Prop_Type;
27 24 use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Array_Prop_Type;
28 25 use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
29 26 use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
30 27 use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
@@ -29,9 +26,8 @@
29 26 use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
30 27 use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
31 28 use Elementor\Core\Breakpoints\Manager as Breakpoints_Manager;
32 29 use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
33 -use Elementor\Plugin;
34 30
35 31 if ( ! defined( 'ABSPATH' ) ) {
36 32 exit; // Exit if accessed directly.
37 33 }
@@ -83,17 +79,18 @@
83 79 public function get_icon() {
84 80 return 'eicon-atomic-form';
85 81 }
86 82
87 - public static function get_computed_html_tag( array $settings ): string {
88 - return Html_Tag_Computer::compute( $settings, 'form' );
89 - }
83 + protected static function define_props_schema(): array {
84 + $email_dependencies = Dependency_Manager::make()
85 + ->where( [
86 + 'operator' => 'contains',
87 + 'path' => [ 'actions-after-submit' ],
88 + 'value' => self::ACTION_EMAIL,
89 + 'effect' => 'hide',
90 + ] )
91 + ->get();
90 92
91 - public static function get_base_props_schema(): array {
92 - return self::define_props_schema();
93 - }
94 -
95 - protected static function define_props_schema(): array {
96 93 $submissions_metadata_dependencies = Dependency_Manager::make()
97 94 ->where( [
98 95 'operator' => 'contains',
99 96 'path' => [ 'actions-after-submit' ],
@@ -110,21 +107,18 @@
110 107 'effect' => 'hide',
111 108 ] )
112 109 ->get();
113 110
114 - $props = [
111 + return [
115 112 'classes' => Classes_Prop_Type::make()
116 113 ->default( [] ),
117 114 'form-name' => String_Prop_Type::make()
118 115 ->default( __( 'Form', 'elementor' ) ),
119 - 'webmcp-autosubmit' => Boolean_Prop_Type::make()
120 - ->default( false ),
121 116 'form-state' => String_Prop_Type::make()
122 117 ->enum( [ 'default', 'success', 'error' ] )
123 118 ->default( 'default' )
124 119 ->meta( 'generates_class', 'form-state-{value}' ),
125 120 'actions-after-submit' => String_Array_Prop_Type::make()
126 - ->initial_value( [ String_Prop_Type::generate( self::ACTION_EMAIL ) ] )
127 121 ->default( [ String_Prop_Type::generate( self::ACTION_EMAIL ) ] ),
128 122 'submissions_metadata' => String_Array_Prop_Type::make()
129 123 ->set_dependencies( $submissions_metadata_dependencies )
130 124 ->default( [
@@ -130,83 +124,78 @@
130 124 ->default( [
131 125 String_Prop_Type::generate( self::METADATA_REMOTE_IP ),
132 126 String_Prop_Type::generate( self::METADATA_USER_AGENT ),
133 127 ] ),
134 - ];
135 -
136 - $props = array_merge( $props, self::get_emails_prop_settings(), [
128 + 'email' => Email_Prop_Type::make()
129 + ->set_dependencies( $email_dependencies )
130 + ->meta( Overridable_Prop_Type::ignore() )
131 + ->default( [
132 + 'to' => String_Prop_Type::generate( self::get_default_recipient_email() ),
133 + 'from' => String_Prop_Type::generate( self::get_default_sender_email() ),
134 + ] ),
137 135 'webhook_url' => String_Prop_Type::make()
138 136 ->set_dependencies( $webhook_dependencies )
139 137 ->meta( Overridable_Prop_Type::ignore() )
140 138 ->default( '' ),
141 139 'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
142 - ] );
143 -
144 - return $props;
140 + ];
145 141 }
146 142
147 143 protected function define_atomic_controls(): array {
148 144 $state_control = Toggle_Control::bind_to( 'form-state' )
149 - ->add_options( [
150 - 'default' => [
151 - 'title' => __( 'Normal', 'elementor' ),
152 - ],
153 - 'success' => [
154 - 'title' => __( 'Success', 'elementor' ),
155 - ],
156 - 'error' => [
157 - 'title' => __( 'Error', 'elementor' ),
158 - ],
159 - ] )
160 - ->set_exclusive( true )
161 - ->set_convert_options( true )
162 - ->set_size( 'tiny' )
163 - ->set_full_width( true )
164 145 ->set_label( __( 'States', 'elementor' ) )
165 146 ->set_meta( [ 'topDivider' => true ] );
166 147
167 - $email_control_settings = $this->get_emails_control_settings();
168 - $form_action_chips = $email_control_settings['form-action-chips'];
169 - $email_controls = $email_control_settings['email-controls'];
170 -
171 - if ( class_exists( '\ElementorPro\License\API' ) ) {
172 - $has_form_submissions_feature = \ElementorPro\License\API::is_licence_has_feature( 'form-submissions' );
173 -
174 - if ( $has_form_submissions_feature ) {
175 - $form_action_chips = array_merge( $form_action_chips, [
176 - [
177 - 'label' => __( 'Collect submissions', 'elementor' ),
178 - 'value' => self::ACTION_COLLECT_SUBMISSIONS,
148 + if ( $state_control instanceof Toggle_Control ) {
149 + $state_control
150 + ->add_options( [
151 + 'default' => [
152 + 'title' => __( 'Normal', 'elementor' ),
179 153 ],
180 - ] );
181 - }
154 + 'success' => [
155 + 'title' => __( 'Success', 'elementor' ),
156 + ],
157 + 'error' => [
158 + 'title' => __( 'Error', 'elementor' ),
159 + ],
160 + ] )
161 + ->set_exclusive( true )
162 + ->set_convert_options( true )
163 + ->set_size( 'tiny' )
164 + ->set_full_width( true );
182 165 }
183 166
184 - $content_controls = [
185 - Text_Control::bind_to( 'form-name' )
186 - ->set_label( __( 'Form name', 'elementor' ) ),
187 - $state_control,
188 - Chips_Control::bind_to( 'actions-after-submit' )
189 - ->set_options( array_merge( $form_action_chips, [
190 - [
191 - 'label' => __( 'Webhook', 'elementor' ),
192 - 'value' => self::ACTION_WEBHOOK,
193 - ],
194 - ] ) )
195 - ->set_label( __( 'Actions after submit', 'elementor' ) )
196 - ->set_meta( [ 'topDivider' => true ] ),
197 - ];
198 -
199 167 return [
200 168 Section::make()
201 169 ->set_label( __( 'Content', 'elementor' ) )
202 - ->set_id( 'content' )
203 - ->set_items( $content_controls ),
204 - ...$email_controls,
205 - Section::make()
206 - ->set_label( __( 'Collect submissions', 'elementor' ) )
207 170 ->set_items( [
171 + Text_Control::bind_to( 'form-name' )
172 + ->set_label( __( 'Form name', 'elementor' ) ),
173 + $state_control,
174 + Chips_Control::bind_to( 'actions-after-submit' )
175 + ->set_label( __( 'Actions after submit', 'elementor' ) )
176 + ->set_meta( [ 'topDivider' => true ] )
177 + ->set_options( [
178 + [
179 + 'label' => __( 'Email', 'elementor' ),
180 + 'value' => self::ACTION_EMAIL,
181 + ],
182 + [
183 + 'label' => __( 'Collect submissions', 'elementor' ),
184 + 'value' => self::ACTION_COLLECT_SUBMISSIONS,
185 + ],
186 + [
187 + 'label' => __( 'Webhook', 'elementor' ),
188 + 'value' => self::ACTION_WEBHOOK,
189 + ],
190 + ] ),
191 + Email_Form_Action_Control::bind_to( 'email' )
192 + ->set_meta( [
193 + 'topDivider' => true,
194 + ] ),
208 195 Chips_Control::bind_to( 'submissions_metadata' )
196 + ->set_label( __( 'Include metadata', 'elementor' ) )
197 + ->set_meta( [ 'topDivider' => true ] )
209 198 ->set_options( [
210 199 [
211 200 'label' => __( 'User IP', 'elementor' ),
212 201 'value' => self::METADATA_REMOTE_IP,
@@ -214,17 +203,13 @@
214 203 [
215 204 'label' => __( 'User Agent', 'elementor' ),
216 205 'value' => self::METADATA_USER_AGENT,
217 206 ],
218 - ] )
219 - ->set_label( __( 'Include metadata', 'elementor' ) ),
220 - ] ),
221 - Section::make()
222 - ->set_label( __( 'Webhook', 'elementor' ) )
223 - ->set_items( [
207 + ] ),
224 208 Text_Control::bind_to( 'webhook_url' )
209 + ->set_label( __( 'Webhook URL', 'elementor' ) )
225 210 ->set_placeholder( __( 'https://your-webhook-url.com', 'elementor' ) )
226 - ->set_label( __( 'Webhook URL', 'elementor' ) ),
211 + ->set_meta( [ 'topDivider' => true ] ),
227 212 ] ),
228 213 Section::make()
229 214 ->set_label( __( 'Settings', 'elementor' ) )
230 215 ->set_id( 'settings' )
@@ -231,24 +216,12 @@
231 216 ->set_items( [
232 217 Text_Control::bind_to( '_cssid' )
233 218 ->set_label( __( 'ID', 'elementor' ) )
234 219 ->set_meta( $this->get_css_id_control_meta() ),
235 - Switch_Control::bind_to( 'webmcp-autosubmit' )
236 - ->set_label( __( 'Agent auto-submit', 'elementor' ) ),
237 220 ] ),
238 221 ];
239 222 }
240 223
241 - protected function define_base_settings(): array {
242 - $settings = [];
243 -
244 - foreach ( self::build_email_action_defaults() as $key => $default_email ) {
245 - $settings[ $key ] = Emails_Prop_Type::generate( $default_email );
246 - }
247 -
248 - return $settings;
249 - }
250 -
251 224 protected function define_base_styles(): array {
252 225 return [
253 226 static::BASE_STYLE_KEY => Style_Definition::make()
254 227 ->add_variant(
@@ -288,8 +261,12 @@
288 261 protected function define_panel_categories(): array {
289 262 return [ 'atomic-form' ];
290 263 }
291 264
265 + protected function define_default_html_tag() {
266 + return 'form';
267 + }
268 +
292 269 protected function define_default_children() {
293 270
294 271 $prefix = 'e-form-';
295 272
@@ -310,9 +287,12 @@
310 287 $children[] = $this->build_checkbox_row( __( 'Checkbox', 'elementor' ), $prefix . 'checkbox' );
311 288
312 289 $children[] = Widget_Builder::make( 'e-form-submit-button' )
313 290 ->settings( [
314 - 'text' => Escaped_Html_Prop_Type::generate( __( 'Submit', 'elementor' ) ),
291 + 'text' => Html_V3_Prop_Type::generate( [
292 + 'content' => String_Prop_Type::generate( __( 'Submit', 'elementor' ) ),
293 + 'children' => [],
294 + ] ),
315 295 ] )
316 296 ->build();
317 297 $children[] = $this->build_status_message(
318 298 __( 'Great! We’ve received your information.', 'elementor' ),
@@ -347,9 +327,12 @@
347 327
348 328 private function build_label( string $text, string $input_id ): array {
349 329 return Widget_Builder::make( 'e-form-label' )
350 330 ->settings( [
351 - 'text' => Escaped_Html_Prop_Type::generate( $text ),
331 + 'text' => Html_V3_Prop_Type::generate( [
332 + 'content' => String_Prop_Type::generate( $text ),
333 + 'children' => [],
334 + ] ),
352 335 'input-id' => String_Prop_Type::generate( $input_id ),
353 336 ] )
354 337 ->build();
355 338 }
@@ -374,9 +357,12 @@
374 357 ->build();
375 358 }
376 359
377 360 private function build_status_message( string $message, string $state, string $title ): array {
378 - $paragraph_value = Escaped_Html_Prop_Type::generate( $message );
361 + $paragraph_value = Html_V3_Prop_Type::generate( [
362 + 'content' => String_Prop_Type::generate( $message ),
363 + 'children' => [],
364 + ] );
379 365
380 366 $element_type = 'success' === $state
381 367 ? Form_Success_Message::get_element_type()
382 368 : Form_Error_Message::get_element_type();
@@ -381,9 +367,8 @@
381 367 ? Form_Success_Message::get_element_type()
382 368 : Form_Error_Message::get_element_type();
383 369
384 370 return Element_Builder::make( $element_type )
385 - ->meta( [ 'required' => true ] )
386 371 ->settings( [
387 372 'attributes' => Attributes_Prop_Type::generate( [
388 373 Key_Value_Prop_Type::generate( [] ),
389 374 ] ),
@@ -411,23 +396,11 @@
411 396 $context = $this->build_base_template_context();
412 397
413 398 $context['form_state'] = 'default';
414 399
415 - if ( ! $this->is_webmcp_enabled() ) {
416 - return $context;
417 - }
418 -
419 - $form_name = (string) ( $this->get_atomic_settings()['form-name'] ?? '' );
420 - $context['webmcp_tool_name'] = Webmcp_Utils::build_tool_name( $form_name, (string) $this->get_id() );
421 - $context['webmcp_tool_description'] = Webmcp_Utils::build_tool_description( $form_name );
422 -
423 400 return $context;
424 401 }
425 402
426 - private function is_webmcp_enabled(): bool {
427 - return ! Plugin::$instance->editor->is_edit_mode();
428 - }
429 -
430 403 public static function is_instance_form( $instance ): bool {
431 404 return $instance instanceof Atomic_Form;
432 405 }
433 406
@@ -432,100 +405,6 @@
432 405 }
433 406
434 407 public function render_markdown(): string {
435 408 return '';
436 - }
437 -
438 - private static function get_emails_prop_settings(): array {
439 - $props = [];
440 -
441 - foreach ( self::build_email_action_defaults() as $key => $default_value ) {
442 - $props[ $key ] = Emails_Prop_Type::make()
443 - ->set_dependencies( self::make_action_dependency( $key ) )
444 - ->meta( Overridable_Prop_Type::ignore() )
445 - ->initial_value( $default_value )
446 - ->default( $default_value );
447 - }
448 -
449 - return $props;
450 - }
451 -
452 - private function get_emails_control_settings(): array {
453 - $form_action_chips = [];
454 - $email_controls = [];
455 -
456 - for ( $i = 0; $i < self::get_email_action_count(); $i++ ) {
457 - $key = self::get_email_action_key( $i );
458 - $label = self::get_email_action_label( $i );
459 -
460 - $form_action_chips[] = [
461 - 'label' => $label,
462 - 'value' => $key,
463 - ];
464 -
465 - $email_controls[] = Section::make()
466 - ->set_label( $label )
467 - ->set_items( [
468 - Email_Form_Action_Control::bind_to( $key )
469 - ->set_free_chips( true )
470 - ->set_label( $label ),
471 - ] );
472 - }
473 -
474 - return [
475 - 'form-action-chips' => $form_action_chips,
476 - 'email-controls' => $email_controls,
477 - ];
478 - }
479 -
480 - private static function get_email_action_key( int $index ): string {
481 - return 0 === $index
482 - ? self::ACTION_EMAIL
483 - : self::ACTION_EMAIL . '_' . ( $index + 1 );
484 - }
485 -
486 - private static function get_email_action_label( int $index ): string {
487 - if ( 0 === $index ) {
488 - return __( 'Email', 'elementor' );
489 - }
490 -
491 - // translators: %d is the index of the email action.
492 - return sprintf( __( 'Email %d', 'elementor' ), $index + 1 );
493 - }
494 -
495 - private static function build_email_action_defaults(): array {
496 - $defaults = [];
497 - $default_email = self::get_default_email_value();
498 -
499 - for ( $i = 0; $i < self::get_email_action_count(); $i++ ) {
500 - $key = self::get_email_action_key( $i );
501 - $defaults[ $key ] = $default_email;
502 - }
503 -
504 - return $defaults;
505 - }
506 -
507 - private static function get_default_email_value(): array {
508 - return [
509 - 'to' => String_Array_Prop_Type::generate( [
510 - String_Prop_Type::generate( self::get_default_recipient_email() ),
511 - ] ),
512 - 'from' => String_Prop_Type::generate( self::get_default_sender_email() ),
513 - 'message' => String_Prop_Type::generate( '[all-fields]' ),
514 - ];
515 - }
516 -
517 - private static function make_action_dependency( string $action_key ): ?array {
518 - return Dependency_Manager::make()
519 - ->where( [
520 - 'operator' => 'contains',
521 - 'path' => [ 'actions-after-submit' ],
522 - 'value' => $action_key,
523 - 'effect' => 'hide',
524 - ] )
525 - ->get();
526 - }
527 -
528 - private static function get_email_action_count(): int {
529 - return apply_filters( 'elementor/atomic/form/email_action_count', 1 );
530 409 }
531 410 }