PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / trunk
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More vtrunk
6.35 6.34 6.33.1 6.33 6.32.1 6.32 6.31 6.25 6.25.1 6.26 6.26.1 6.27 6.28 6.29 6.3 6.3.1 6.3.2 6.30 6.4 6.4.1 6.4.2 6.5 6.5.1 6.5.2 6.5.3 All 141 releases
← All changes | classes/controllers/FrmFormActionsController.php +465 -100 6.26 → trunk View file →
@@ -10,9 +10,9 @@
10 10 */
11 11 public static $action_post_type = 'frm_form_actions';
12 12
13 13 /**
14 - * @var array|null
14 + * @var Frm_Form_Action_Factory|null
15 15 */
16 16 public static $registered_actions;
17 17
18 18 /**
@@ -37,8 +37,9 @@
37 37 'has_archive' => false,
38 38 )
39 39 );
40 40
41 + self::maybe_setup_unlicensed_action_gate();
41 42 self::actions_init();
42 43 }
43 44
44 45 public static function actions_init() {
@@ -53,35 +54,35 @@
53 54 public static function register_actions() {
54 55 $action_classes = array(
55 56 'on_submit' => 'FrmOnSubmitAction',
56 57 'email' => 'FrmEmailAction',
58 + 'gated_content' => 'FrmGatedContentAction',
57 59 'wppost' => 'FrmDefPostAction',
58 60 'register' => 'FrmDefRegAction',
59 - 'paypal' => 'FrmDefPayPalAction',
61 + 'stripe' => 'FrmStripeLiteAction',
62 + 'square' => 'FrmSquareAction',
63 + 'paypal' => 'FrmPayPalLiteAction',
64 + 'paypal-legacy' => 'FrmDefPayPalLegacyAction',
60 65 'payment' => 'FrmTransLiteAction',
61 66 'quiz' => 'FrmDefQuizAction',
62 67 'quiz_outcome' => 'FrmDefQuizOutcomeAction',
68 + 'api' => 'FrmDefApiAction',
63 69 'mailchimp' => 'FrmDefMlcmpAction',
64 - 'api' => 'FrmDefApiAction',
65 - 'salesforce' => 'FrmDefSalesforceAction',
66 70 'activecampaign' => 'FrmDefActiveCampaignAction',
67 71 'constantcontact' => 'FrmDefConstContactAction',
68 72 'getresponse' => 'FrmDefGetResponseAction',
73 + 'mailpoet' => 'FrmDefMailpoetAction',
74 + 'convertkit' => 'FrmDefConvertKitAction',
75 + 'aweber' => 'FrmDefAweberAction',
76 + 'twilio' => 'FrmDefTwilioAction',
77 + 'salesforce' => 'FrmDefSalesforceAction',
69 78 'hubspot' => 'FrmDefHubspotAction',
79 + 'highrise' => 'FrmDefHighriseAction',
70 80 'zapier' => 'FrmDefZapierAction',
81 + 'googlespreadsheet' => 'FrmDefGoogleSpreadsheetAction',
71 82 'n8n' => 'FrmDefN8NAction',
72 - 'twilio' => 'FrmDefTwilioAction',
73 - 'highrise' => 'FrmDefHighriseAction',
74 - 'mailpoet' => 'FrmDefMailpoetAction',
75 - 'aweber' => 'FrmDefAweberAction',
76 - 'convertkit' => 'FrmDefConvertKitAction',
77 - 'googlespreadsheet' => 'FrmDefGoogleSpreadsheetAction',
78 83 );
79 84
80 - if ( ! FrmAppHelper::show_new_feature( 'n8n' ) ) {
81 - unset( $action_classes['n8n'] );
82 - }
83 -
84 85 $action_classes = apply_filters( 'frm_registered_form_actions', $action_classes );
85 86 $action_classes = self::maybe_unset_highrise( $action_classes );
86 87
87 88 include_once FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/email_action.php';
@@ -86,14 +87,66 @@
86 87
87 88 include_once FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/email_action.php';
88 89 include_once FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/default_actions.php';
89 90
91 + // This needs to be called after we include default_actions.php or FrmDefPayPalLegacyAction will never exist.
92 + if ( 'FrmPayPalLiteAction' === $action_classes['paypal'] || ! class_exists( 'FrmPaymentAction' ) || ! class_exists( 'FrmDefPayPalLegacyAction' ) ) {
93 + unset( $action_classes['paypal-legacy'] );
94 + }
95 +
90 96 foreach ( $action_classes as $action_class ) {
91 97 self::$registered_actions->register( $action_class );
92 98 }
99 +
100 + self::apply_default_action_descriptions();
93 101 }
94 102
95 103 /**
104 + * Sets default descriptions on registered actions from a central list.
105 + *
106 + * Keeps the description when an add-on replaces a base action class without its own.
107 + *
108 + * @since 6.31
109 + *
110 + * @return void
111 + */
112 + private static function apply_default_action_descriptions() {
113 + $descriptions = array(
114 + 'on_submit' => __( 'Success messages', 'formidable' ),
115 + 'email' => __( 'Autoresponder alerts', 'formidable' ),
116 + 'wppost' => __( 'Content publishing', 'formidable' ),
117 + 'register' => __( 'Account creation', 'formidable' ),
118 + 'payment' => __( 'Transaction alerts', 'formidable' ),
119 + 'stripe' => __( 'Payment gateway', 'formidable' ),
120 + 'square' => __( 'Payment gateway', 'formidable' ),
121 + 'paypal' => __( 'Payment gateway', 'formidable' ),
122 + 'quiz' => __( 'Automated grading', 'formidable' ),
123 + 'quiz_outcome' => __( 'Result logic', 'formidable' ),
124 + 'aweber' => __( 'List triggers', 'formidable' ),
125 + 'mailchimp' => __( 'Subscription confirmation', 'formidable' ),
126 + 'zapier' => __( 'App automation', 'formidable' ),
127 + 'n8n' => __( 'Workflow automation', 'formidable' ),
128 + 'twilio' => __( 'Text notifications', 'formidable' ),
129 + 'activecampaign' => __( 'Contact automation', 'formidable' ),
130 + 'salesforce' => __( 'Lead automation', 'formidable' ),
131 + 'constantcontact' => __( 'Content distribution', 'formidable' ),
132 + 'getresponse' => __( 'Success notifications', 'formidable' ),
133 + 'hubspot' => __( 'CRM alerts', 'formidable' ),
134 + 'mailpoet' => __( 'Plugin automation', 'formidable' ),
135 + 'api' => __( 'System integration', 'formidable' ),
136 + 'googlespreadsheet' => __( 'Spreadsheet sync', 'formidable' ),
137 + 'convertkit' => __( 'Broadcast publishing', 'formidable' ),
138 + 'gated_content' => __( 'Access control', 'formidable' ),
139 + );
140 +
141 + foreach ( self::$registered_actions->actions as $action ) {
142 + if ( $action->action_options['description'] === '' && isset( $descriptions[ $action->id_base ] ) ) {
143 + $action->action_options['description'] = $descriptions[ $action->id_base ];
144 + }
145 + }
146 + }
147 +
148 + /**
96 149 * Remove the Highrise action if it is not registered.
97 150 *
98 151 * @since 6.23
99 152 *
@@ -113,11 +166,10 @@
113 166 *
114 167 * @param array $values
115 168 */
116 169 public static function email_settings( $values ) {
117 - $form = FrmForm::getOne( $values['id'] );
118 - $groups = self::form_action_groups();
119 -
170 + $form = FrmForm::getOne( $values['id'] );
171 + $groups = self::form_action_groups();
120 172 $action_controls = self::get_form_actions();
121 173 self::maybe_add_action_to_group( $action_controls, $groups );
122 174
123 175 $allowed = self::active_actions( $action_controls );
@@ -141,12 +193,23 @@
141 193 foreach ( $groups as $group ) {
142 194 if ( isset( $group['actions'] ) ) {
143 195 $grouped = array_merge( $grouped, $group['actions'] );
144 196 }
197 +
198 + // Also collect actions from sections
199 + if ( ! isset( $group['sections'] ) ) {
200 + continue;
201 + }
202 +
203 + foreach ( $group['sections'] as $section ) {
204 + if ( isset( $section['actions'] ) ) {
205 + $grouped = array_merge( $grouped, $section['actions'] );
206 + }
207 + }
145 208 }
146 209
147 210 foreach ( $action_controls as $action ) {
148 - if ( isset( $groups[ $action->id_base ] ) || in_array( $action->id_base, $grouped ) ) {
211 + if ( isset( $groups[ $action->id_base ] ) || in_array( $action->id_base, $grouped, true ) ) {
149 212 continue;
150 213 }
151 214
152 215 $this_group = $action->action_options['group'];
@@ -169,32 +232,48 @@
169 232 *
170 233 * @return array
171 234 */
172 235 public static function form_action_groups() {
236 + // Get all action controls to check which are active
237 + $action_controls = self::get_form_actions();
238 +
239 + // Determine which actions are currently available
240 + $available_actions = self::get_available_my_actions( $action_controls );
241 +
242 + // Featured actions are add-ons that are NOT currently available
243 + $all_addon_actions = array(
244 + 'api',
245 + 'register',
246 + 'n8n',
247 + 'quiz',
248 + 'quiz_outcome',
249 + 'googlespreadsheet',
250 + );
251 + $featured_actions = array_diff( $all_addon_actions, $available_actions );
252 +
173 253 $groups = array(
174 - 'misc' => array(
175 - 'name' => '',
176 - 'icon' => 'frm_icon_font frm_shuffle_icon',
177 - 'actions' => array(
178 - 'email',
179 - 'wppost',
180 - 'register',
181 - 'quiz',
182 - 'quiz_outcome',
183 - 'twilio',
254 + 'my_actions' => array(
255 + 'name' => __( 'My Actions', 'formidable' ),
256 + 'icon' => 'frmfont frm_shuffle_icon',
257 + 'sections' => array(
258 + 'active' => array(
259 + 'name' => '',
260 + 'actions' => $available_actions,
261 + ),
262 + 'featured' => array(
263 + 'name' => __( 'Featured', 'formidable' ),
264 + 'actions' => array_values( $featured_actions ),
265 + ),
184 266 ),
185 267 ),
186 - 'payment' => array(
187 - 'name' => __( 'eCommerce', 'formidable' ),
188 - 'icon' => 'frm_icon_font frm_credit_card_alt_icon',
189 - 'actions' => array(
190 - 'paypal',
191 - 'payment',
192 - ),
268 + 'payment' => array(
269 + 'name' => __( 'E-Commerce', 'formidable' ),
270 + 'icon' => 'frmfont frm_credit_card_alt_icon',
271 + 'actions' => self::get_payment_actions( $action_controls ),
193 272 ),
194 - 'marketing' => array(
195 - 'name' => __( 'Email Marketing', 'formidable' ),
196 - 'icon' => 'frm_icon_font frm_mail_bulk_icon',
273 + 'marketing' => array(
274 + 'name' => __( 'Marketing', 'formidable' ),
275 + 'icon' => 'frmfont frm_mail_bulk_icon',
197 276 'actions' => array(
198 277 'mailchimp',
199 278 'activecampaign',
200 279 'constantcontact',
@@ -201,15 +280,21 @@
201 280 'getresponse',
202 281 'aweber',
203 282 'mailpoet',
204 283 'convertkit',
284 + 'twilio',
205 285 ),
206 286 ),
207 - 'crm' => array(
287 + 'crm' => array(
208 288 'name' => __( 'CRM', 'formidable' ),
209 - 'icon' => 'frm_icon_font frm_address_card_icon',
289 + 'icon' => 'frmfont frm_address_card_icon',
210 290 'actions' => self::get_crm_actions(),
211 291 ),
292 + 'misc' => array(
293 + 'name' => __( 'Misc', 'formidable' ),
294 + 'icon' => 'frmfont frm_shuffle_icon',
295 + 'actions' => self::get_misc_actions( $action_controls ),
296 + ),
212 297 );
213 298
214 299 return apply_filters( 'frm_action_groups', $groups );
215 300 }
@@ -214,8 +299,102 @@
214 299 return apply_filters( 'frm_action_groups', $groups );
215 300 }
216 301
217 302 /**
303 + * Get the actions that are currently available (active) for My Actions section.
304 + *
305 + * @since 6.31
306 + *
307 + * @param array $action_controls The registered action controls.
308 + *
309 + * @return array
310 + */
311 + private static function get_available_my_actions( $action_controls ) {
312 + $available = array(
313 + 'on_submit',
314 + 'email',
315 + 'stripe',
316 + 'square',
317 + 'paypal',
318 + );
319 +
320 + // Include all actions that are marked as active, including custom actions.
321 + // This ensures custom actions appear in "My Actions" when enabled.
322 + foreach ( $action_controls as $action_id => $action_control ) {
323 + if ( ! in_array( $action_id, $available, true ) && ! empty( $action_control->action_options['active'] ) ) {
324 + $available[] = $action_id;
325 + }
326 + }
327 +
328 + return $available;
329 + }
330 +
331 + /**
332 + * Get the actions to include in the Misc section.
333 + *
334 + * @since 6.31
335 + *
336 + * @param array $action_controls The registered action controls.
337 + *
338 + * @return array
339 + */
340 + private static function get_misc_actions( $action_controls ) {
341 + $misc_actions = array(
342 + 'on_submit',
343 + 'email',
344 + 'wppost',
345 + 'register',
346 + 'api',
347 + 'n8n',
348 + 'quiz',
349 + 'quiz_outcome',
350 + 'googlespreadsheet',
351 + );
352 +
353 + // Include all active actions that aren't in specific groups (payment, marketing, crm).
354 + // This ensures custom actions appear in "Misc" when enabled.
355 + $payment_actions = self::get_payment_actions( $action_controls );
356 + $marketing_actions = array( 'mailchimp', 'activecampaign', 'constantcontact', 'getresponse', 'aweber', 'mailpoet', 'convertkit', 'twilio' );
357 +
358 + $excluded_actions = array_merge( $payment_actions, $marketing_actions, self::get_crm_actions() );
359 +
360 + foreach ( $action_controls as $action_id => $action_control ) {
361 + if ( ! in_array( $action_id, $misc_actions, true ) && ! in_array( $action_id, $excluded_actions, true ) && ! empty( $action_control->action_options['active'] ) ) {
362 + $misc_actions[] = $action_id;
363 + }
364 + }
365 +
366 + return $misc_actions;
367 + }
368 +
369 + /**
370 + * Get the actions to include in the E-Commerce section.
371 + *
372 + * @since 6.33
373 + *
374 + * @param array $action_controls
375 + *
376 + * @return array
377 + */
378 + private static function get_payment_actions( $action_controls ) {
379 + $payment_actions = array(
380 + 'paypal',
381 + 'stripe',
382 + 'square',
383 + );
384 +
385 + if ( isset( $action_controls['paypal-legacy'] ) ) {
386 + $payment_actions[] = 'paypal-legacy';
387 + }
388 +
389 + if ( isset( $action_controls['payment'] ) ) {
390 + $payment_actions[] = 'payment';
391 + }
392 +
393 + return $payment_actions;
394 + }
395 +
396 + /**
218 397 * Get the actions to include in the CRM section.
219 398 *
220 399 * @since 6.23
221 400 *
@@ -224,8 +403,9 @@
224 403 private static function get_crm_actions() {
225 404 $crm_actions = array(
226 405 'salesforce',
227 406 'hubspot',
407 + 'zapier',
228 408 );
229 409
230 410 // Only include Highrise when the add-on is active.
231 411 // This is because Highrise is deprecated. We don't want to show it in Lite.
@@ -248,12 +428,13 @@
248 428 private static function active_actions( $action_controls ) {
249 429 $allowed = array();
250 430
251 431 foreach ( $action_controls as $action_control ) {
252 - if ( isset( $action_control->action_options['active'] ) && $action_control->action_options['active'] ) {
432 + if ( ! empty( $action_control->action_options['active'] ) ) {
253 433 $allowed[] = $action_control->id_base;
254 434 }
255 435 }
436 +
256 437 return $allowed;
257 438 }
258 439
259 440 /**
@@ -264,11 +445,10 @@
264 445 * @param object $action_control
265 446 * @param array $allowed
266 447 */
267 448 public static function show_action_icon_link( $action_control, $allowed ) {
268 - $data = array();
269 - $classes = ' frm_' . $action_control->id_base . '_action frm_single_action';
270 -
449 + $data = array();
450 + $classes = ' frm_' . $action_control->id_base . '_action frm_single_action';
271 451 $group_class = ' frm-group-' . $action_control->action_options['group'];
272 452
273 453 /* translators: %s: Name of form action */
274 454 $upgrade_label = sprintf( esc_html__( '%s form actions', 'formidable' ), $action_control->action_options['tooltip'] );
@@ -274,16 +454,20 @@
274 454 $upgrade_label = sprintf( esc_html__( '%s form actions', 'formidable' ), $action_control->action_options['tooltip'] );
275 455
276 456 $default_shown = array( 'wppost', 'register', 'payment', 'quiz', 'hubspot' );
277 457 $default_shown = array_values( array_diff( $default_shown, $allowed ) );
278 - $default_position = array_search( $action_control->id_base, $default_shown );
458 + $default_position = array_search( $action_control->id_base, $default_shown, true );
279 459 $allowed_count = count( $allowed );
280 460
281 - if ( isset( $action_control->action_options['active'] ) && $action_control->action_options['active'] ) {
461 + if ( ! empty( $action_control->action_options['active'] ) ) {
282 462 $classes .= ' frm_active_action';
283 463 } else {
284 464 $classes .= ' frm_inactive_action';
285 465
466 + if ( str_contains( $action_control->action_options['classes'], 'frm_show_expired_modal' ) ) {
467 + $classes .= ' frm_show_expired_modal';
468 + }
469 +
286 470 if ( $default_position !== false && ( $allowed_count + $default_position ) < 6 ) {
287 471 $group_class .= ' frm-default-show';
288 472 }
289 473
@@ -304,20 +488,42 @@
304 488
305 489 if ( $requires && 'free' !== $requires ) {
306 490 $data['data-requires'] = $requires;
307 491 }
492 +
493 + $learn_more_slug = ! empty( $action_control->action_options['learn-more'] )
494 + ? $action_control->action_options['learn-more']
495 + : self::get_learn_more_slug( $action_control->id_base );
496 +
497 + if ( $learn_more_slug ) {
498 + $data['data-learn-more'] = FrmAppHelper::get_doc_url(
499 + $learn_more_slug,
500 + 'settings-' . $action_control->id_base,
501 + ! str_contains( $learn_more_slug, '/' )
502 + );
503 + }
308 504 }//end if
309 505
310 - // HTML to include on the icon.
311 - $icon_atts = array();
506 + include FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/_action_icon.php';
507 + }
312 508
313 - if ( $action_control->action_options['color'] !== 'var(--primary-700)' ) {
314 - $icon_atts = array(
509 + /**
510 + * Get the HTML attributes for the action icon.
511 + *
512 + * @since 6.31
513 + *
514 + * @param object $action_control
515 + *
516 + * @return array
517 + */
518 + public static function get_action_icon_atts( $action_control ) {
519 + if ( 'var(--primary-700)' !== $action_control->action_options['color'] ) {
520 + return array(
315 521 'style' => '--primary-700:' . $action_control->action_options['color'],
316 522 );
317 523 }
318 524
319 - include FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/_action_icon.php';
525 + return array();
320 526 }
321 527
322 528 /**
323 529 * @param string $action
@@ -326,19 +532,19 @@
326 532 */
327 533 public static function get_form_actions( $action = 'all' ) {
328 534 $temp_actions = self::$registered_actions;
329 535
330 - if ( empty( $temp_actions ) ) {
536 + if ( $temp_actions ) {
537 + $temp_actions = $temp_actions->actions;
538 + } else {
331 539 self::actions_init();
332 540 $temp_actions = self::$registered_actions->actions;
333 - } else {
334 - $temp_actions = $temp_actions->actions;
335 541 }
336 542
337 543 $actions = array();
338 544
339 545 foreach ( $temp_actions as $a ) {
340 - if ( 'all' !== $action && $a->id_base == $action ) {
546 + if ( 'all' !== $action && $a->id_base === $action ) {
341 547 return $a;
342 548 }
343 549
344 550 $actions[ $a->id_base ] = $a;
@@ -355,9 +561,9 @@
355 561 *
356 562 * @return void
357 563 */
358 564 public static function list_actions( $form, $values ) {
359 - if ( empty( $form ) ) {
565 + if ( ! $form ) {
360 566 return;
361 567 }
362 568
363 569 /**
@@ -384,11 +590,15 @@
384 590 }
385 591
386 592 self::maybe_show_limit_warning( $form->id, $form_actions );
387 593
594 + echo '<p class="frm-mb-lg frm-no-actions-message' . ( $form_actions ? ' frm_hidden' : '' ) . '"> '
595 + . esc_html__( 'No actions have been added yet. Select an action above to get started.', 'formidable' )
596 + . '</p>';
597 +
388 598 foreach ( $form_actions as $action ) {
389 599 if ( ! isset( $action_map[ $action->post_excerpt ] ) ) {
390 - // don't try and show settings if action no longer exists
600 + // Don't try and show settings if action no longer exists
391 601 continue;
392 602 }
393 603
394 604 self::action_control( $action, $form, $action->ID, $action_controls[ $action_map[ $action->post_excerpt ] ], $values );
@@ -421,9 +631,9 @@
421 631
422 632 $documentation_url = 'https://formidableforms.com/knowledgebase/frm_form_action_limit/#kb-increase-limit-of-form-actions';
423 633
424 634 echo '<div class="frm_warning_style">';
425 - FrmAppHelper::icon_by_class( 'frm_icon_font frm_alert_icon' );
635 + FrmAppHelper::icon_by_class( 'frmfont frm_alert_icon' );
426 636 echo '&nbsp;';
427 637 printf(
428 638 // translators: %s: URL to documentation
429 639 esc_html__( 'You have reached your form action limit. To increase this limit, you will require additional code. Visit our documentation at %s.', 'formidable' ),
@@ -452,13 +662,18 @@
452 662 public static function add_form_action() {
453 663 FrmAppHelper::permission_check( 'frm_edit_forms' );
454 664 check_ajax_referer( 'frm_ajax', 'nonce' );
455 665
666 + $action_key = FrmAppHelper::get_param( 'list_id', '', 'post', 'absint' );
667 + $action_type = FrmAppHelper::get_param( 'type', '', 'post', 'sanitize_text_field' );
668 + $lite_actions = array_fill_keys( self::get_lite_actions(), true );
669 +
670 + if ( ! FrmAppHelper::pro_is_connected() && ! isset( $lite_actions[ $action_type ] ) ) {
671 + wp_die();
672 + }
673 +
456 674 global $frm_vars;
457 675
458 - $action_key = FrmAppHelper::get_param( 'list_id', '', 'post', 'absint' );
459 - $action_type = FrmAppHelper::get_param( 'type', '', 'post', 'sanitize_text_field' );
460 -
461 676 /**
462 677 * @var FrmFormAction
463 678 */
464 679 $action_control = self::get_form_actions( $action_type );
@@ -463,38 +678,60 @@
463 678 */
464 679 $action_control = self::get_form_actions( $action_type );
465 680 $action_control->_set( $action_key );
466 681
467 - $form_id = FrmAppHelper::get_param( 'form_id', '', 'post', 'absint' );
682 + $form_id = FrmAppHelper::get_param( 'form_id', '', 'post', 'absint' );
683 + $form_action = $action_control->prepare_new( $form_id );
684 + $existing_titles = (array) FrmAppHelper::get_post_param( 'existing_titles', array(), 'sanitize_text_field' );
468 685
469 - $form_action = $action_control->prepare_new( $form_id );
686 + if ( $existing_titles ) {
687 + $form_action->post_title = self::get_unique_action_title( $form_action->post_title, $existing_titles );
688 + }
689 +
470 690 $use_logging = self::should_show_log_message( $action_type );
691 + $values = array();
692 + $form = self::fields_to_values( $form_id, $values );
471 693
472 - $values = array();
473 - $form = self::fields_to_values( $form_id, $values );
474 -
475 694 include FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/form_action.php';
476 695 wp_die();
477 696 }
478 697
698 + /**
699 + * Returns the first available title not in $existing_titles, appending " (2)", " (3)", etc. if needed.
700 + *
701 + * @since 6.31
702 + *
703 + * @param string $base_title Default action title from the action type.
704 + * @param string[] $existing_titles Titles currently visible in the form editor.
705 + *
706 + * @return string
707 + */
708 + private static function get_unique_action_title( $base_title, array $existing_titles ) {
709 + $taken = array_flip( $existing_titles );
710 + $title = $base_title;
711 +
712 + for ( $n = 2; isset( $taken[ $title ] ); $n++ ) {
713 + $title = $base_title . ' (' . $n . ')';
714 + }
715 +
716 + return $title;
717 + }
718 +
479 719 public static function fill_action() {
480 720 FrmAppHelper::permission_check( 'frm_edit_forms' );
481 721 check_ajax_referer( 'frm_ajax', 'nonce' );
482 722
483 - $action_key = FrmAppHelper::get_param( 'action_id', '', 'post', 'absint' );
484 - $action_type = FrmAppHelper::get_param( 'action_type', '', 'post', 'sanitize_text_field' );
485 -
723 + $action_key = FrmAppHelper::get_param( 'action_id', '', 'post', 'absint' );
724 + $action_type = FrmAppHelper::get_param( 'action_type', '', 'post', 'sanitize_text_field' );
486 725 $action_control = self::get_form_actions( $action_type );
487 726
488 - if ( empty( $action_control ) ) {
727 + if ( ! $action_control ) {
489 728 wp_die();
490 729 }
491 730
492 731 $form_action = $action_control->get_single_action( $action_key );
493 -
494 - $values = array();
495 - $form = self::fields_to_values( $form_action->menu_order, $values );
496 -
732 + $values = array();
733 + $form = self::fields_to_values( $form_action->menu_order, $values );
497 734 $use_logging = self::should_show_log_message( $action_type );
498 735
499 736 include FrmAppHelper::plugin_path() . '/classes/views/frm-form-actions/_action_inside.php';
500 737 wp_die();
@@ -507,9 +744,25 @@
507 744 *
508 745 * @return bool
509 746 */
510 747 private static function should_show_log_message( $action_type ) {
511 - $logging = array( 'api', 'salesforce', 'constantcontact', 'activecampaign' );
748 + $logging = array(
749 + 'activecampaign',
750 + 'api',
751 + 'aweber',
752 + 'campaignmonitor',
753 + 'constantcontact',
754 + 'convertkit',
755 + 'getresponse',
756 + 'googlespreadsheet',
757 + 'hubspot',
758 + 'mailchimp',
759 + 'mailpoet',
760 + 'n8n',
761 + 'salesforce',
762 + 'twilio',
763 + 'zapier',
764 + );
512 765 return in_array( $action_type, $logging, true ) && ! function_exists( 'frm_log_autoloader' );
513 766 }
514 767
515 768 /**
@@ -586,15 +839,15 @@
586 839
587 840 foreach ( $registered_actions as $registered_action ) {
588 841 $action_ids = $registered_action->update_callback( $form_id );
589 842
590 - if ( ! empty( $action_ids ) ) {
843 + if ( $action_ids ) {
591 844 $new_actions[] = $action_ids;
592 845 }
593 846 }
594 847
595 848 // Only use array_merge if there are new actions.
596 - if ( ! empty( $new_actions ) ) {
849 + if ( $new_actions ) {
597 850 $new_actions = call_user_func_array( 'array_merge', $new_actions );
598 851 }
599 852
600 853 $old_actions = array_diff( $old_actions, $new_actions );
@@ -609,14 +862,17 @@
609 862 *
610 863 * @return void
611 864 */
612 865 public static function delete_missing_actions( $old_actions ) {
613 - if ( ! empty( $old_actions ) ) {
614 - foreach ( $old_actions as $old_id ) {
615 - wp_delete_post( $old_id );
616 - }
617 - FrmDb::cache_delete_group( 'frm_actions' );
866 + if ( ! $old_actions ) {
867 + return;
618 868 }
869 +
870 + foreach ( $old_actions as $old_id ) {
871 + wp_delete_post( $old_id );
872 + }
873 +
874 + FrmDb::cache_delete_group( 'frm_actions' );
619 875 }
620 876
621 877 /**
622 878 * @param int|string $entry_id
@@ -621,9 +877,9 @@
621 877 /**
622 878 * @param int|string $entry_id
623 879 * @param int|string $form_id
624 880 * @param array $args
625 - *
881 + *
626 882 * @return void
627 883 */
628 884 public static function trigger_create_actions( $entry_id, $form_id, $args = array() ) {
629 885 $filter_args = $args;
@@ -644,21 +900,21 @@
644 900
645 901 /**
646 902 * @param string $event
647 903 * @param int|object|string $form
648 - * @param int|string $entry
904 + * @param int|object|string $entry
649 905 * @param string $type
650 906 * @param array $args
651 - *
907 + *
652 908 * @return void
653 909 */
654 - public static function trigger_actions( $event, $form, $entry, $type = 'all', $args = array() ) {
910 + public static function trigger_actions( $event, $form, $entry, $type = 'all', $args = array() ) { // phpcs:ignore SlevomatCodingStandard.Complexity.Cognitive.ComplexityTooHigh
655 911 $action_status = array(
656 912 'post_status' => 'publish',
657 913 );
658 - $form_actions = FrmFormAction::get_action_for_form( ( is_object( $form ) ? $form->id : $form ), $type, $action_status );
914 + $form_actions = FrmFormAction::get_action_for_form( is_object( $form ) ? $form->id : $form, $type, $action_status );
659 915
660 - if ( empty( $form_actions ) ) {
916 + if ( ! $form_actions ) {
661 917 return;
662 918 }
663 919
664 920 FrmForm::maybe_get_form( $form );
@@ -682,9 +938,8 @@
682 938 $this_event = $event;
683 939 }
684 940
685 941 foreach ( $form_actions as $action ) {
686 -
687 942 $skip_this_action = ! in_array( $this_event, $action->post_content['event'], true ) || FrmOnSubmitAction::$slug === $action->post_excerpt;
688 943 $skip_this_action = apply_filters( 'frm_skip_form_action', $skip_this_action, compact( 'action', 'entry', 'form', 'event' ) );
689 944
690 945 if ( $skip_this_action ) {
@@ -694,16 +949,16 @@
694 949 if ( ! is_object( $entry ) ) {
695 950 $entry = FrmEntry::getOne( $entry, true );
696 951 }
697 952
698 - if ( empty( $entry ) || ( FrmEntriesHelper::DRAFT_ENTRY_STATUS === (int) $entry->is_draft && 'draft' !== $event ) ) {
953 + if ( ! $entry || ( FrmEntriesHelper::DRAFT_ENTRY_STATUS === (int) $entry->is_draft && 'draft' !== $event ) ) {
699 954 continue;
700 955 }
701 956
702 - $child_entry = ( is_numeric( $form->parent_form_id ) && $form->parent_form_id ) || ( $entry && ( $entry->form_id != $form->id || $entry->parent_item_id ) ) || ! empty( $args['is_child'] );
957 + $child_entry = ( is_numeric( $form->parent_form_id ) && $form->parent_form_id ) || ( $entry && ( (int) $entry->form_id !== (int) $form->id || $entry->parent_item_id ) ) || ! empty( $args['is_child'] ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
703 958
704 959 if ( $child_entry ) {
705 - // maybe trigger actions for sub forms
960 + // Maybe trigger actions for sub forms
706 961 $trigger_children = apply_filters( 'frm_use_embedded_form_actions', false, compact( 'form', 'entry' ) );
707 962
708 963 if ( ! $trigger_children ) {
709 964 continue;
@@ -723,9 +978,9 @@
723 978
724 979 unset( $action );
725 980 }//end foreach
726 981
727 - if ( ! empty( $stored_actions ) ) {
982 + if ( $stored_actions ) {
728 983 asort( $action_priority );
729 984
730 985 // Make sure hooks are loaded.
731 986 new FrmNotification();
@@ -792,11 +1047,9 @@
792 1047 if ( ! isset( $frm_vars['action_type'] ) ) {
793 1048 return $where;
794 1049 }
795 1050
796 - $where .= $wpdb->prepare( ' AND post_excerpt = %s ', $frm_vars['action_type'] );
797 -
798 - return $where;
1051 + return $where . $wpdb->prepare( ' AND post_excerpt = %s ', $frm_vars['action_type'] );
799 1052 }
800 1053
801 1054 /**
802 1055 * Prevent WPML from filtering form actions based on the active language.
@@ -808,13 +1061,125 @@
808 1061 *
809 1062 * @return bool|null
810 1063 */
811 1064 public static function prevent_wpml_translations( $null, $post_type ) {
812 - if ( self::$action_post_type === $post_type ) {
813 - return false;
1065 + return self::$action_post_type === $post_type ? false : $null;
1066 + }
1067 +
1068 + /**
1069 + * If Pro is not connected, hook a filter that will force all non-Lite
1070 + * actions to inactive so the upgrade popup is shown instead.
1071 + *
1072 + * @since 6.31
1073 + *
1074 + * @return void
1075 + */
1076 + private static function maybe_setup_unlicensed_action_gate() {
1077 + if ( FrmAppHelper::pro_is_connected() ) {
1078 + return;
814 1079 }
815 - return $null;
1080 +
1081 + add_filter( 'frm_registered_form_actions', array( self::class, 'disable_unlicensed_actions' ), 100 );
816 1082 }
1083 +
1084 + /**
1085 + * For every registered action that is not a Lite action, add a per-action
1086 + * options filter that forces it to inactive with the upgrade class.
1087 + *
1088 + * Runs inside apply_filters('frm_registered_form_actions') at priority 100,
1089 + * so the per-key option filters are in place before the class constructors
1090 + * run in the foreach loop that follows.
1091 + *
1092 + * @since 6.31
1093 + *
1094 + * @param array $actions Map of action_key => class_name.
1095 + *
1096 + * @return array
1097 + */
1098 + public static function disable_unlicensed_actions( $actions ) {
1099 + $lite_actions = array_fill_keys( self::get_lite_actions(), true );
1100 +
1101 + foreach ( array_keys( $actions ) as $key ) {
1102 + if ( isset( $lite_actions[ $key ] ) ) {
1103 + continue;
1104 + }
1105 +
1106 + add_filter(
1107 + 'frm_' . $key . '_action_options',
1108 + function ( $options ) {
1109 + $options['active'] = false;
1110 +
1111 + if ( ! str_contains( $options['classes'], 'frm_show_upgrade' ) ) {
1112 + $options['classes'] .= ' frm_show_upgrade';
1113 + }
1114 +
1115 + return $options;
1116 + }
1117 + );
1118 + }//end foreach
1119 +
1120 + return $actions;
1121 + }
1122 +
1123 + /**
1124 + * Get action keys that are available in Lite without a Pro license.
1125 + *
1126 + * @since 6.31
1127 + *
1128 + * @return string[]
1129 + */
1130 + public static function get_lite_actions() {
1131 + return apply_filters( 'frm_lite_form_actions', array( 'on_submit', 'email', 'payment', 'stripe', 'square', 'paypal', 'gated_content' ) );
1132 + }
1133 +
1134 + /**
1135 + * Single source of truth for learn-more URL slugs used in
1136 + * upgrade modals for non-Lite form actions.
1137 + *
1138 + * Slugs without '/' are KB doc slugs (knowledgebase/ prefix is added).
1139 + * Slugs with '/' are direct paths (e.g. features/) used as-is.
1140 + *
1141 + * @since 6.31
1142 + *
1143 + * @return array<string,string> Map of action_key => URL slug.
1144 + */
1145 + public static function get_action_learn_more_links() {
1146 + return array(
1147 + 'wppost' => 'features/user-submitted-posts-wordpress-forms',
1148 + 'register' => 'user-registration',
1149 + 'paypal' => 'features/paypal-wordpress-payments',
1150 + 'quiz' => 'quiz-maker-forms',
1151 + 'quiz_outcome' => 'quiz-maker-forms',
1152 + 'aweber' => 'features/aweber-addon',
1153 + 'mailchimp' => 'features/mailchimp-addon',
1154 + 'zapier' => 'features/form-entry-routing-with-zapier',
1155 + 'twilio' => 'features/twilio-sms-form-notifications',
1156 + 'activecampaign' => 'features/entries-to-activecampaign',
1157 + 'salesforce' => 'features/form-entries-to-salesforce',
1158 + 'constantcontact' => 'features/entries-to-constant-contact',
1159 + 'getresponse' => 'features/form-entries-to-getresponse',
1160 + 'hubspot' => 'features/form-entries-to-hubspot',
1161 + 'mailpoet' => 'features/mailpoet-newsletters-addon',
1162 + 'api' => 'features/wordpress-form-api',
1163 + 'googlespreadsheet' => 'features/google-sheets',
1164 + 'n8n' => 'features/connect-your-forms-to-any-app-with-n8n',
1165 + 'convertkit' => 'features/convertkit',
1166 + );
1167 + }
1168 +
1169 + /**
1170 + * Look up the learn-more doc slug for a given action key.
1171 + *
1172 + * @since 6.31
1173 + *
1174 + * @param string $action_key Action identifier (e.g. 'register').
1175 + *
1176 + * @return string Doc slug or empty string.
1177 + */
1178 + private static function get_learn_more_slug( $action_key ) {
1179 + $links = self::get_action_learn_more_links();
1180 + return $links[ $action_key ] ?? '';
1181 + }
817 1182 }
818 1183
819 1184 class Frm_Form_Action_Factory {
820 1185
@@ -850,9 +1215,9 @@
850 1215 public function _register_actions() {
851 1216 $keys = array_keys( $this->actions );
852 1217
853 1218 foreach ( $keys as $key ) {
854 - // don't register new action if old action with the same id is already registered
1219 + // Don't register new action if old action with the same id is already registered
855 1220 if ( ! isset( $this->actions[ $key ] ) ) {
856 1221 $this->actions[ $key ]->_register();
857 1222 }
858 1223 }