PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 6.8
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v6.8
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/FrmFormsController.php +465 -974 6.316.8 View file →
@@ -6,9 +6,9 @@
6 6 class FrmFormsController {
7 7
8 8 /**
9 9 * Track the form that opened the redirect URL in a new tab. This is used to check if we should show the default
10 - * message in the current tab.
10 + * message in the currect tab.
11 11 *
12 12 * @since 6.2
13 13 *
14 14 * @var array Keys are form IDs and values are 1.
@@ -14,25 +14,13 @@
14 14 * @var array Keys are form IDs and values are 1.
15 15 */
16 16 private static $redirected_in_new_tab = array();
17 17
18 - /**
19 - * The HTML for the Formdiable TinyMCE button (That triggers a popup to insert shortcodes)
20 - * is stored here and re-used as an optimization.
21 - *
22 - * @since 6.11
23 - *
24 - * @var string|null
25 - */
26 - private static $formidable_tinymce_button;
27 -
28 18 public static function menu() {
29 19 $menu_label = __( 'Forms', 'formidable' );
30 -
31 20 if ( ! FrmAppHelper::pro_is_installed() ) {
32 21 $menu_label .= ' (Lite)';
33 22 }
34 -
35 23 add_submenu_page( 'formidable', 'Formidable | ' . $menu_label, $menu_label, 'frm_view_forms', 'formidable', 'FrmFormsController::route' );
36 24
37 25 self::maybe_load_listing_hooks();
38 26 }
@@ -66,12 +54,12 @@
66 54 */
67 55 public static function logic_tip() {
68 56 $images_url = FrmAppHelper::plugin_url() . '/images/';
69 57 $data_message = __( 'Only show the fields you need and create branching forms. Upgrade to get conditional logic and question branching.', 'formidable' );
70 - $data_message .= ' <img src="' . esc_url( $images_url ) . '/survey-logic.png" srcset="' . esc_url( $images_url ) . 'survey-logic@2x.png 2x" alt="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '"/>'; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
71 - echo '<a href="javascript:void(0)" class="frm_noallow frm_show_upgrade frm_add_logic_link frm-collapsed frm-flex-justify" data-upgrade="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '" data-message="' . esc_attr( $data_message ) . '" data-medium="builder" data-content="logic">'; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
58 + $data_message .= ' <img src="' . esc_attr( $images_url ) . '/survey-logic.png" srcset="' . esc_attr( $images_url ) . 'survey-logic@2x.png 2x" alt="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '"/>';
59 + echo '<a href="javascript:void(0)" class="frm_noallow frm_show_upgrade frm_add_logic_link frm-collapsed frm-flex-justify" data-upgrade="' . esc_attr__( 'Conditional Logic options', 'formidable' ) . '" data-message="' . esc_attr( $data_message ) . '" data-medium="builder" data-content="logic">';
72 60 esc_html_e( 'Conditional Logic', 'formidable' );
73 - FrmAppHelper::icon_by_class( 'frmfont frm_arrowdown8_icon', array( 'aria-hidden' => 'true' ) );
61 + FrmAppHelper::icon_by_class( 'frmfont frm_arrowdown6_icon', array( 'aria-hidden' => 'true' ) );
74 62 echo '</a>';
75 63 }
76 64
77 65 /**
@@ -78,15 +66,12 @@
78 66 * By default, Divi processes form shortcodes on the edit post page.
79 67 * Now that won't do.
80 68 *
81 69 * @since 3.01
82 - *
83 - * @param array $shortcodes List of shortcodes to process.
84 - *
85 - * @return array
86 70 */
87 71 public static function prevent_divi_conflict( $shortcodes ) {
88 72 $shortcodes[] = 'formidable';
73 +
89 74 return $shortcodes;
90 75 }
91 76
92 77 /**
@@ -97,14 +82,12 @@
97 82
98 83 $message = '';
99 84 $params = FrmForm::list_page_params();
100 85 $errors = self::process_bulk_form_actions( array() );
101 -
102 86 if ( isset( $errors['message'] ) ) {
103 87 $message = $errors['message'];
104 88 unset( $errors['message'] );
105 89 }
106 -
107 90 $errors = apply_filters( 'frm_admin_list_form_action', $errors );
108 91
109 92 self::display_forms_list( $params, $message, $errors );
110 93 }
@@ -113,30 +96,18 @@
113 96 * Create the default email action
114 97 *
115 98 * @since 2.02.11
116 99 *
117 - * @param int|object $form
118 - *
119 - * @return void
100 + * @param object|int $form
120 101 */
121 102 private static function create_default_email_action( $form ) {
122 103 FrmForm::maybe_get_form( $form );
123 -
124 - if ( ! is_object( $form ) ) {
125 - return;
126 - }
127 -
128 104 $create_email = apply_filters( 'frm_create_default_email_action', true, $form );
129 105
130 - if ( ! $create_email ) {
131 - return;
106 + if ( $create_email ) {
107 + $action_control = FrmFormActionsController::get_form_actions( 'email' );
108 + $action_control->create( $form->id );
132 109 }
133 -
134 - /**
135 - * @var FrmFormAction
136 - */
137 - $action_control = FrmFormActionsController::get_form_actions( 'email' );
138 - $action_control->create( $form->id );
139 110 }
140 111
141 112 /**
142 113 * Create the default On submit action
@@ -142,19 +113,13 @@
142 113 * Create the default On submit action
143 114 *
144 115 * @since 6.0.0
145 116 *
146 - * @param int|object $form Form object or ID.
147 - *
148 - * @return void
117 + * @param object|int $form Form object or ID.
149 118 */
150 119 private static function create_default_on_submit_action( $form ) {
151 120 FrmForm::maybe_get_form( $form );
152 121
153 - if ( ! is_object( $form ) ) {
154 - return;
155 - }
156 -
157 122 /**
158 123 * Enable or disable the default On Submit action.
159 124 *
160 125 * @since 6.0.0
@@ -163,73 +128,22 @@
163 128 * @param object $form Form object.
164 129 */
165 130 $create = apply_filters( 'frm_create_default_on_submit_action', true, $form );
166 131
167 - if ( ! $create ) {
168 - return;
132 + if ( $create ) {
133 + $action_control = FrmFormActionsController::get_form_actions( FrmOnSubmitAction::$slug );
134 + $action_control->create( $form->id );
169 135 }
170 -
171 - /**
172 - * @var FrmFormAction
173 - */
174 - $action_control = FrmFormActionsController::get_form_actions( FrmOnSubmitAction::$slug );
175 - $action_control->create( $form->id );
176 136 }
177 137
178 - /**
179 - * Creates submit button field.
180 - *
181 - * @since 6.9
182 - *
183 - * @param int|object $form Form ID or object.
184 - *
185 - * @return void
186 - */
187 - private static function create_submit_button_field( $form ) {
188 - FrmForm::maybe_get_form( $form );
189 -
190 - if ( ! is_object( $form ) ) {
191 - return;
192 - }
193 -
194 - if ( FrmSubmitHelper::get_submit_field( $form->id ) ) {
195 - // Do not create submit button field if it exists.
196 - return;
197 - }
198 -
199 - FrmField::create(
200 - array(
201 - 'type' => FrmSubmitHelper::FIELD_TYPE,
202 - 'name' => __( 'Submit', 'formidable' ),
203 - 'field_order' => FrmSubmitHelper::DEFAULT_ORDER,
204 - 'form_id' => $form->id,
205 - 'field_options' => FrmFieldsHelper::get_default_field_options( FrmSubmitHelper::FIELD_TYPE ),
206 - 'description' => '',
207 - 'default_value' => '',
208 - 'options' => array(),
209 - )
210 - );
211 - }
212 -
213 - /**
214 - * @param array|false $values
215 - *
216 - * @return void
217 - */
218 138 public static function edit( $values = false ) {
219 139 FrmAppHelper::permission_check( 'frm_edit_forms' );
220 140
221 141 $id = isset( $values['id'] ) ? absint( $values['id'] ) : FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
222 142
223 - self::get_edit_vars( $id );
143 + return self::get_edit_vars( $id );
224 144 }
225 145
226 - /**
227 - * @param mixed $id
228 - * @param string $message
229 - *
230 - * @return void
231 - */
232 146 public static function settings( $id = false, $message = '' ) {
233 147 FrmAppHelper::permission_check( 'frm_edit_forms' );
234 148
235 149 if ( ! $id || ! is_numeric( $id ) ) {
@@ -237,9 +151,9 @@
237 151 }
238 152
239 153 FrmOnSubmitHelper::maybe_migrate_submit_settings_to_action( $id );
240 154
241 - self::get_settings_vars( $id, array(), $message );
155 + return self::get_settings_vars( $id, array(), $message );
242 156 }
243 157
244 158 public static function update_settings() {
245 159 FrmAppHelper::permission_check( 'frm_edit_forms' );
@@ -246,9 +160,9 @@
246 160 $process_form = FrmAppHelper::get_post_param( 'process_form', '', 'sanitize_text_field' );
247 161
248 162 if ( ! wp_verify_nonce( $process_form, 'process_form_nonce' ) ) {
249 163 $frm_settings = FrmAppHelper::get_settings();
250 - $error_args = array(
164 + $error_args = array(
251 165 'title' => __( 'Verification failed', 'formidable' ),
252 166 'body' => $frm_settings->admin_permission,
253 167 'cancel_text' => __( 'Cancel', 'formidable' ),
254 168 );
@@ -255,25 +169,24 @@
255 169 FrmAppController::show_error_modal( $error_args );
256 170 return;
257 171 }
258 172
259 - $id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
260 - $errors = FrmForm::validate( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
173 + $id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
174 +
175 + $errors = FrmForm::validate( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
261 176 $warnings = FrmFormsHelper::check_for_warnings( $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
262 177
263 178 if ( count( $errors ) > 0 ) {
264 - self::get_settings_vars( $id, $errors, compact( 'warnings' ) );
265 - return;
179 + return self::get_settings_vars( $id, $errors, compact( 'warnings' ) );
266 180 }
267 181
268 182 do_action( 'frm_before_update_form_settings', $id );
269 183
270 - $antispam_was_on = self::antispam_was_on( $id ); // phpcs:ignore Formidable.CodeAnalysis.InlineSingleUseVariable
184 + $antispam_was_on = self::antispam_was_on( $id );
271 185
272 186 FrmForm::update( $id, $_POST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
273 187
274 188 $antispam_is_on = ! empty( $_POST['options']['antispam'] ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
275 -
276 189 if ( $antispam_is_on !== $antispam_was_on ) {
277 190 FrmAntiSpam::clear_caches();
278 191 }
279 192
@@ -278,14 +191,13 @@
278 191 }
279 192
280 193 $message = __( 'Settings Successfully Updated', 'formidable' );
281 194
282 - self::get_settings_vars( $id, array(), compact( 'message', 'warnings' ) );
195 + return self::get_settings_vars( $id, array(), compact( 'message', 'warnings' ) );
283 196 }
284 197
285 198 /**
286 199 * @param int $form_id
287 - *
288 200 * @return bool
289 201 */
290 202 private static function antispam_was_on( $form_id ) {
291 203 $form = FrmForm::getOne( $form_id );
@@ -291,15 +203,10 @@
291 203 $form = FrmForm::getOne( $form_id );
292 204 return ! empty( $form->options['antispam'] );
293 205 }
294 206
295 - /**
296 - * @param array $values
297 - *
298 - * @return void
299 - */
300 207 public static function update( $values = array() ) {
301 - if ( ! $values ) {
208 + if ( empty( $values ) ) {
302 209 $values = $_POST; // phpcs:ignore WordPress.Security.NonceVerification.Missing
303 210 }
304 211
305 212 // Set radio button and checkbox meta equal to "other" value.
@@ -308,9 +215,8 @@
308 215 }
309 216
310 217 $errors = FrmForm::validate( $values );
311 218 $permission_error = FrmAppHelper::permission_nonce_error( 'frm_edit_forms', 'frm_save_form', 'frm_save_form_nonce' );
312 -
313 219 if ( $permission_error !== false ) {
314 220 $errors['form'] = $permission_error;
315 221 }
316 222
@@ -316,58 +222,42 @@
316 222
317 223 $id = isset( $values['id'] ) ? absint( $values['id'] ) : FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
318 224
319 225 if ( count( $errors ) > 0 ) {
320 - self::get_edit_vars( $id, $errors );
321 - return;
322 - }
226 + return self::get_edit_vars( $id, $errors );
227 + } else {
228 + self::maybe_remove_draft_option_from_fields( $id );
323 229
324 - self::maybe_remove_draft_option_from_fields( $id );
230 + FrmForm::update( $id, $values );
231 + $message = __( 'Form was successfully updated.', 'formidable' );
325 232
326 - FrmForm::update( $id, $values );
327 - $message = __( 'Form was successfully updated.', 'formidable' );
233 + if ( self::is_too_long( $values ) ) {
234 + $message .= '<br/> ' . sprintf(
235 + /* translators: %1$s: Start link HTML, %2$s: end link HTML */
236 + __( 'However, your form is very long and may be %1$sreaching server limits%2$s.', 'formidable' ),
237 + '<a href="https://formidableforms.com/knowledgebase/i-have-a-long-form-why-did-the-options-at-the-end-of-the-form-stop-saving/?utm_source=WordPress&utm_medium=builder&utm_campaign=liteplugin" target="_blank" rel="noopener">',
238 + '</a>'
239 + );
240 + }
328 241
329 - if ( self::is_too_long( $values ) ) {
330 - $message .= '<br/> ' . sprintf(
331 - /* translators: %1$s: Start link HTML, %2$s: end link HTML */
332 - __( 'However, your form is very long and may be %1$sreaching server limits%2$s.', 'formidable' ),
333 - '<a href="' . esc_url( self::get_form_too_long_docs_url() ) . '" target="_blank" rel="noopener">',
334 - '</a>'
335 - );
336 - }
242 + if ( defined( 'DOING_AJAX' ) ) {
243 + wp_die( FrmAppHelper::kses( $message, array( 'a' ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
244 + }
337 245
338 - if ( defined( 'DOING_AJAX' ) ) {
339 - wp_die( FrmAppHelper::kses( $message, array( 'a' ) ) ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
340 - }
341 -
342 - self::get_edit_vars( $id, array(), $message );
246 + return self::get_edit_vars( $id, array(), $message );
247 + }//end if
343 248 }
344 249
345 250 /**
346 - * @since 6.25.1
347 - *
348 - * @return string
349 - */
350 - private static function get_form_too_long_docs_url() {
351 - $utm = array(
352 - 'campaign' => 'builder',
353 - 'content' => 'form-too-long',
354 - );
355 - return FrmAppHelper::admin_upgrade_link( $utm, 'knowledgebase/i-have-a-long-form-why-did-the-options-at-the-end-of-the-form-stop-saving/' );
356 - }
357 -
358 - /**
359 251 * Remove the draft flag from any new fields from this current session.
360 252 *
361 253 * @since 6.8
362 254 *
363 255 * @param int $form_id
364 - *
365 256 * @return void
366 257 */
367 258 private static function maybe_remove_draft_option_from_fields( $form_id ) {
368 259 $draft_field_ids_csv = FrmAppHelper::get_post_param( 'draft_fields', '', 'sanitize_text_field' );
369 -
370 260 if ( ! $draft_field_ids_csv ) {
371 261 // If the draft_fields input is empty there are no new fields in the session.
372 262 return;
373 263 }
@@ -372,9 +262,8 @@
372 262 return;
373 263 }
374 264
375 265 $draft_field_ids = array_filter( explode( ',', $draft_field_ids_csv ), 'is_numeric' );
376 -
377 266 if ( ! $draft_field_ids ) {
378 267 // Exit early if the draft fields input is invalid. It should be a CSV of integer values.
379 268 return;
380 269 }
@@ -379,9 +268,8 @@
379 268 return;
380 269 }
381 270
382 271 $draft_field_rows = FrmFieldsHelper::get_draft_field_results( $form_id, $draft_field_ids );
383 -
384 272 foreach ( $draft_field_rows as $row ) {
385 273 $row->field_options['draft'] = 0;
386 274 FrmField::update( $row->id, array( 'field_options' => $row->field_options ) );
387 275 }
@@ -392,15 +280,35 @@
392 280 * If it's missing, it means other values at the end of the form
393 281 * were likely not saved either.
394 282 *
395 283 * @since 3.06.01
284 + */
285 + private static function is_too_long( $values ) {
286 + return ( ! isset( $values['frm_end'] ) ) || empty( $values['frm_end'] );
287 + }
288 +
289 + /**
290 + * Redirect to the url for creating from a template
291 + * Also delete the current form
396 292 *
397 - * @param array $values
398 - *
399 - * @return bool
293 + * @since 2.0
294 + * @deprecated 3.06
400 295 */
401 - private static function is_too_long( $values ) {
402 - return empty( $values['frm_end'] );
296 + public static function _create_from_template() {
297 + _deprecated_function( __FUNCTION__, '3.06' );
298 +
299 + FrmAppHelper::permission_check( 'frm_edit_forms' );
300 + check_ajax_referer( 'frm_ajax', 'nonce' );
301 +
302 + $current_form = FrmAppHelper::get_param( 'this_form', '', 'get', 'absint' );
303 + $template_id = FrmAppHelper::get_param( 'id', '', 'get', 'absint' );
304 +
305 + if ( $current_form ) {
306 + FrmForm::destroy( $current_form );
307 + }
308 +
309 + echo esc_url_raw( admin_url( 'admin.php?page=formidable&frm_action=duplicate&id=' . absint( $template_id ) ) );
310 + wp_die();
403 311 }
404 312
405 313 public static function duplicate() {
406 314 FrmAppHelper::permission_check( 'frm_edit_forms' );
@@ -417,10 +325,10 @@
417 325 $message = 'form_duplicate_error';
418 326
419 327 if ( $form ) {
420 328 $new_template = FrmAppHelper::simple_get( 'new_template' ) ? '&new_template=true' : '';
421 - $url = admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . absint( $form ) . $new_template );
422 - $message = 'form_duplicated';
329 + $url = admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . absint( $form ) . $new_template );
330 + $message = 'form_duplicated';
423 331 }
424 332
425 333 $url .= '&message=' . $message;
426 334
@@ -428,26 +336,20 @@
428 336 exit();
429 337 }
430 338
431 339 /**
432 - * @return string|null
340 + * @return string
433 341 */
434 342 public static function page_preview() {
435 343 $params = FrmForm::list_page_params();
436 -
437 - if ( ! $params['form'] || is_numeric( $params['form'] ) ) {
438 - return null;
344 + if ( ! $params['form'] ) {
345 + return;
439 346 }
440 347
441 - self::maybe_block_preview( $params['form'] );
442 -
443 348 $form = FrmForm::getOne( $params['form'] );
444 -
445 - if ( ! $form ) {
446 - return null;
349 + if ( $form ) {
350 + return self::show_form( $form->id, '', 'auto', 'auto' );
447 351 }
448 -
449 - return self::show_form( $form->id, '', 'auto', 'auto' );
450 352 }
451 353
452 354 /**
453 355 * @since 3.0
@@ -454,19 +356,9 @@
454 356 *
455 357 * @return void
456 358 */
457 359 public static function show_page_preview() {
458 - $preview = self::page_preview();
459 -
460 - if ( is_null( $preview ) ) {
461 - wp_die(
462 - '<h1>' . esc_html__( 'Form key is invalid', 'formidable' ) . '</h1>',
463 - '<p>' . esc_html__( 'Form key is invalid', 'formidable' ) . '</p>',
464 - 404
465 - );
466 - }
467 -
468 - echo $preview; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
360 + echo self::page_preview(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
469 361 }
470 362
471 363 /**
472 364 * @return void
@@ -477,19 +369,9 @@
477 369
478 370 global $frm_vars;
479 371 $frm_vars['preview'] = true;
480 372
481 - // print_emoji_styles is deprecated.
482 - remove_action( 'wp_print_styles', 'print_emoji_styles' );
483 -
484 - if ( FrmTestModeController::should_add_test_mode_container() ) {
485 - do_action( 'frm_test_mode_init' );
486 - add_action( 'wp_enqueue_scripts', 'FrmTestModeController::register_and_enqueue_required_scripts' );
487 - add_filter( 'frm_filter_final_form', 'FrmTestModeController::maybe_add_test_mode_container', 99 );
488 - }
489 -
490 373 $include_theme = FrmAppHelper::get_param( 'theme', '', 'get', 'absint' );
491 -
492 374 if ( $include_theme ) {
493 375 self::set_preview_query();
494 376 self::load_theme_preview();
495 377 } else {
@@ -512,9 +394,8 @@
512 394 'post_type' => 'page',
513 395 );
514 396
515 397 $page_for_posts = get_option( 'page_for_posts' );
516 -
517 398 if ( is_numeric( $page_for_posts ) ) {
518 399 // Avoid querying for the "Posts Page" or "Blog Page" so we don't display 10 forms.
519 400 $page_query['post__not_in'] = array( $page_for_posts );
520 401 }
@@ -519,15 +400,13 @@
519 400 $page_query['post__not_in'] = array( $page_for_posts );
520 401 }
521 402
522 403 $random_page = get_posts( $page_query );
523 -
524 404 if ( ! $random_page ) {
525 405 return;
526 406 }
527 407
528 408 $random_page = reset( $random_page );
529 -
530 409 if ( ! is_a( $random_page, 'WP_Post' ) ) {
531 410 // The return type can also be int.
532 411 return;
533 412 }
@@ -549,9 +428,8 @@
549 428 *
550 429 * @since 5.5.2
551 430 *
552 431 * @param WP_Post $page The page object.
553 - *
554 432 * @return void
555 433 */
556 434 private static function set_post_global( $page ) {
557 435 global $post;
@@ -559,10 +437,8 @@
559 437 }
560 438
561 439 /**
562 440 * @since 3.0
563 - *
564 - * @return void
565 441 */
566 442 private static function load_theme_preview() {
567 443 add_filter( 'wp_title', 'FrmFormsController::preview_title', 9999 );
568 444 add_filter( 'the_title', 'FrmFormsController::preview_page_title', 9999 );
@@ -570,16 +446,14 @@
570 446 add_action( 'loop_no_results', 'FrmFormsController::show_page_preview' );
571 447 add_filter( 'is_active_sidebar', '__return_false' );
572 448 FrmStylesController::enqueue_css( 'enqueue', true );
573 449
574 - if ( false !== get_template_part( 'page' ) ) {
575 - return;
450 + if ( false === get_template_part( 'page' ) ) {
451 + if ( function_exists( 'wp_is_block_theme' ) && wp_is_block_theme() ) {
452 + add_filter( 'body_class', 'FrmFormsController::preview_block_theme_body_classnames' );
453 + }
454 + self::fallback_when_page_template_part_is_not_supported_by_theme();
576 455 }
577 -
578 - if ( function_exists( 'wp_is_block_theme' ) && wp_is_block_theme() ) {
579 - add_filter( 'body_class', 'FrmFormsController::preview_block_theme_body_classnames' );
580 - }
581 - self::fallback_when_page_template_part_is_not_supported_by_theme();
582 456 }
583 457
584 458 /**
585 459 * Add padding to the body for block themes.
@@ -586,9 +460,8 @@
586 460 *
587 461 * @since 6.5.2
588 462 *
589 463 * @param array $classes The body classes list.
590 - *
591 464 * @return array
592 465 */
593 466 public static function preview_block_theme_body_classnames( $classes ) {
594 467 $classes[] = 'has-global-padding';
@@ -597,41 +470,31 @@
597 470
598 471 /**
599 472 * Not every theme supports get_template_part( 'page' ).
600 473 * When this is not supported, false is returned, and we can handle a fallback.
601 - *
602 - * @return void
603 474 */
604 475 private static function fallback_when_page_template_part_is_not_supported_by_theme() {
605 - if ( ! have_posts() ) {
606 - return;
607 - }
476 + if ( have_posts() ) {
477 + the_post();
478 + self::get_template( 'header' );
608 479
609 - the_post();
610 - self::get_template( 'header' );
480 + // add some generic class names to the container to add some natural padding to the content.
481 + // .entry-content catches the WordPress TwentyTwenty theme.
482 + // .container catches Customizr content.
483 + echo '<div class="container entry-content">';
484 + the_content();
485 + echo '</div>';
611 486
612 - // Add some generic class names to the container to add some natural padding to the content.
613 - // .entry-content catches the WordPress TwentyTwenty theme.
614 - // .container catches Customizr content.
615 - echo '<div class="container entry-content">';
616 - the_content();
617 - echo '</div>';
618 -
619 - // Prevent extra unexpected forms in the footer.
620 - // For some reason this happens in the Twenty Twenty Five theme.
621 - add_filter( 'frm_filter_final_form', '__return_empty_string' );
622 -
623 - self::get_template( 'footer' );
487 + self::get_template( 'footer' );
488 + }
624 489 }
625 490
626 491 /**
627 492 * Calls core function to get a template part if it doesn't cause deprecation warnings. Otherwise skips the deprecation function call
628 - * and renders required html fragments calling required functions.
493 + * and renders required html fragements calling required functions.
629 494 *
630 495 * @since 6.7.1
631 - *
632 496 * @param string $template
633 - *
634 497 * @return void
635 498 */
636 499 private static function get_template( $template ) {
637 500 if ( self::should_try_getting_template( $template ) ) {
@@ -652,11 +515,9 @@
652 515 /**
653 516 * Returns true if calling a template function doesn't trigger deprecation warnings.
654 517 *
655 518 * @since 6.7.1
656 - *
657 519 * @param string $template
658 - *
659 520 * @return bool
660 521 */
661 522 private static function should_try_getting_template( $template ) {
662 523 $stylesheet_path = get_stylesheet_directory();
@@ -670,25 +531,21 @@
670 531 /**
671 532 * Set the page title for the theme preview page
672 533 *
673 534 * @since 3.0
674 - *
675 - * @param string $title
676 - *
677 - * @return string
678 535 */
679 536 public static function preview_page_title( $title ) {
680 - return in_the_loop() ? self::preview_title( $title ) : $title;
537 + if ( in_the_loop() ) {
538 + $title = self::preview_title( $title );
539 + }
540 +
541 + return $title;
681 542 }
682 543
683 544 /**
684 - * Set the page title for the theme preview page.
545 + * Set the page title for the theme preview page
685 546 *
686 547 * @since 3.0
687 - *
688 - * @param string $title
689 - *
690 - * @return string
691 548 */
692 549 public static function preview_title( $title ) {
693 550 return __( 'Form Preview', 'formidable' );
694 551 }
@@ -698,9 +555,8 @@
698 555 *
699 556 * @since 3.0
700 557 *
701 558 * @param string $content
702 - *
703 559 * @return string
704 560 */
705 561 public static function preview_content( $content ) {
706 562 if ( in_the_loop() ) {
@@ -715,92 +571,23 @@
715 571 /**
716 572 * @since 3.0
717 573 */
718 574 private static function load_direct_preview() {
575 + header( 'Content-Type: text/html; charset=' . get_option( 'blog_charset' ) );
576 +
719 577 $key = FrmAppHelper::simple_get( 'form', 'sanitize_title' );
720 -
721 - // phpcs:ignore Universal.Operators.StrictComparisons
722 578 if ( $key == '' ) {
723 579 $key = FrmAppHelper::get_post_param( 'form', '', 'sanitize_title' );
724 580 }
725 581
726 - if ( ! $key ) {
727 - $error = __( 'Form key is missing', 'formidable' );
728 - wp_die(
729 - '<h1>' . esc_html( $error ) . '</h1>',
730 - '<p>' . esc_html( $error ) . '</p>',
731 - 404
732 - );
733 - }
734 -
735 - self::maybe_block_preview( $key );
736 -
737 582 $form = FrmForm::getAll( array( 'form_key' => $key ), '', 1 );
738 -
739 - if ( ! $form ) {
740 - $error = __( 'Form does not exist', 'formidable' );
741 - wp_die(
742 - '<h1>' . esc_html( $error ) . '</h1>',
743 - '<p>' . esc_html( $error ) . '</p>',
744 - 404
745 - );
583 + if ( empty( $form ) ) {
584 + $form = FrmForm::getAll( array(), '', 1 );
746 585 }
747 586
748 - header( 'Content-Type: text/html; charset=' . get_option( 'blog_charset' ) );
749 -
750 - self::fix_deprecated_null_param_warning();
751 -
752 - require FrmAppHelper::plugin_path() . '/classes/views/frm-entries/direct.php';
587 + require( FrmAppHelper::plugin_path() . '/classes/views/frm-entries/direct.php' );
753 588 }
754 589
755 - /**
756 - * Block the form preview for the contact form by default if the user cannot view forms.
757 - * This is to prevent the contact form being exploited.
758 - * Since this form is added by default and every site uses the same key, it is too easy
759 - * to guess this form.
760 - *
761 - * @since 6.20
762 - *
763 - * @param string $form_key Form key.
764 - *
765 - * @return void
766 - */
767 - public static function maybe_block_preview( $form_key ) {
768 - if ( ! FrmFormsHelper::should_block_preview( $form_key ) ) {
769 - return;
770 - }
771 -
772 - $error = __( 'You do not have permission to view this form', 'formidable' );
773 - wp_die(
774 - '<h1>' . esc_html( $error ) . '</h1>',
775 - '<p>' . esc_html( $error ) . '</p>',
776 - 403
777 - );
778 - }
779 -
780 - /**
781 - * Some themes have a null $src value.
782 - * This function adds a filter to ensure that $src is not null.
783 - * WP will call str_starts_with with the null value triggering a deprecated message otherwise.
784 - *
785 - * @since 6.10
786 - *
787 - * @return void
788 - */
789 - private static function fix_deprecated_null_param_warning() {
790 - add_filter(
791 - 'script_loader_src',
792 - /**
793 - * @param string|null $src
794 - *
795 - * @return string
796 - */
797 - function ( $src ) {
798 - return is_null( $src ) ? '' : $src;
799 - }
800 - );
801 - }
802 -
803 590 public static function untrash() {
804 591 self::change_form_status( 'untrash' );
805 592 }
806 593
@@ -805,9 +592,8 @@
805 592 }
806 593
807 594 /**
808 595 * @param array $ids
809 - *
810 596 * @return string
811 597 */
812 598 public static function bulk_untrash( $ids ) {
813 599 FrmAppHelper::permission_check( 'frm_edit_forms' );
@@ -819,9 +605,11 @@
819 605 return '';
820 606 }
821 607
822 608 /* translators: %1$s: Number of forms */
823 - return sprintf( _n( '%1$s form restored from the Trash.', '%1$s forms restored from the Trash.', $count, 'formidable' ), $count );
609 + $message = sprintf( _n( '%1$s form restored from the Trash.', '%1$s forms restored from the Trash.', $count, 'formidable' ), $count );
610 +
611 + return $message;
824 612 }
825 613
826 614 /**
827 615 * @since 3.06
@@ -866,11 +654,10 @@
866 654 // Check nonce url.
867 655 check_admin_referer( $status . '_form_' . $params['id'] );
868 656
869 657 $count = 0;
870 -
871 658 if ( FrmForm::set_status( $params['id'], $available_status[ $status ]['new_status'] ) ) {
872 - ++$count;
659 + $count ++;
873 660 }
874 661
875 662 $form_type = FrmAppHelper::get_simple_request(
876 663 array(
@@ -882,9 +669,9 @@
882 669 /* translators: %1$s: Number of forms */
883 670 $available_status['untrash']['message'] = sprintf( _n( '%1$s form restored from the Trash.', '%1$s forms restored from the Trash.', $count, 'formidable' ), $count );
884 671
885 672 /* translators: %1$s: Number of forms, %2$s: Start link HTML, %3$s: End link HTML */
886 - $available_status['trash']['message'] = sprintf( _n( '%1$s form moved to the Trash. %2$sUndo%3$s', '%1$s forms moved to the Trash. %2$sUndo%3$s', $count, 'formidable' ), $count, '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=untrash&form_type=' . $form_type . '&id=' . $params['id'], 'untrash_form_' . $params['id'] ) ) . '">', '</a>' ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
673 + $available_status['trash']['message'] = sprintf( _n( '%1$s form moved to the Trash. %2$sUndo%3$s', '%1$s forms moved to the Trash. %2$sUndo%3$s', $count, 'formidable' ), $count, '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=untrash&form_type=' . $form_type . '&id=' . $params['id'], 'untrash_form_' . $params['id'] ) ) . '">', '</a>' );
887 674
888 675 $message = $available_status[ $status ]['message'];
889 676
890 677 self::display_forms_list( $params, $message );
@@ -889,28 +676,18 @@
889 676
890 677 self::display_forms_list( $params, $message );
891 678 }
892 679
893 - /**
894 - * @param array $ids
895 - *
896 - * @return string
897 - */
898 680 public static function bulk_trash( $ids ) {
899 681 FrmAppHelper::permission_check( 'frm_delete_forms' );
900 682
901 683 $count = 0;
902 -
903 684 foreach ( $ids as $id ) {
904 685 if ( FrmForm::trash( $id ) ) {
905 - ++$count;
686 + $count ++;
906 687 }
907 688 }
908 689
909 - if ( ! $count ) {
910 - return '';
911 - }
912 -
913 690 $current_page = FrmAppHelper::get_simple_request(
914 691 array(
915 692 'param' => 'form_type',
916 693 'type' => 'request',
@@ -915,16 +692,17 @@
915 692 'param' => 'form_type',
916 693 'type' => 'request',
917 694 )
918 695 );
919 -
920 - return sprintf(
696 + $message = sprintf(
921 697 /* translators: %1$s: Number of forms, %2$s: Start link HTML, %3$s: End link HTML */
922 698 _n( '%1$s form moved to the Trash. %2$sUndo%3$s', '%1$s forms moved to the Trash. %2$sUndo%3$s', $count, 'formidable' ),
923 699 $count,
924 - '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=list&action=bulk_untrash&form_type=' . $current_page . '&item-action=' . implode( ',', $ids ), 'bulk-toplevel_page_formidable' ) ) . '">', // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
700 + '<a href="' . esc_url( wp_nonce_url( '?page=formidable&frm_action=list&action=bulk_untrash&form_type=' . $current_page . '&item-action=' . implode( ',', $ids ), 'bulk-toplevel_page_formidable' ) ) . '">',
925 701 '</a>'
926 702 );
703 +
704 + return $message;
927 705 }
928 706
929 707 public static function destroy() {
930 708 FrmAppHelper::permission_check( 'frm_delete_forms' );
@@ -934,11 +712,10 @@
934 712 // Check nonce url.
935 713 check_admin_referer( 'destroy_form_' . $params['id'] );
936 714
937 715 $count = 0;
938 -
939 716 if ( FrmForm::destroy( $params['id'] ) ) {
940 - ++$count;
717 + $count ++;
941 718 }
942 719
943 720 /* translators: %1$s: Number of forms */
944 721 $message = sprintf( _n( '%1$s Form Permanently Deleted', '%1$s Forms Permanently Deleted', $count, 'formidable' ), $count );
@@ -945,23 +722,16 @@
945 722
946 723 self::display_forms_list( $params, $message );
947 724 }
948 725
949 - /**
950 - * @param array $ids
951 - *
952 - * @return string
953 - */
954 726 public static function bulk_destroy( $ids ) {
955 727 FrmAppHelper::permission_check( 'frm_delete_forms' );
956 728
957 729 $count = 0;
958 -
959 730 foreach ( $ids as $id ) {
960 731 $d = FrmForm::destroy( $id );
961 -
962 732 if ( $d ) {
963 - ++$count;
733 + $count ++;
964 734 }
965 735 }
966 736
967 737 if ( $count ) {
@@ -977,16 +747,17 @@
977 747 */
978 748 public static function delete_all() {
979 749 // Check nonce url.
980 750 $permission_error = FrmAppHelper::permission_nonce_error( 'frm_delete_forms', '_wpnonce', 'bulk-toplevel_page_formidable' );
981 -
982 751 if ( $permission_error !== false ) {
983 752 self::display_forms_list( array(), '', array( $permission_error ) );
753 +
984 754 return;
985 755 }
986 756
987 757 $count = FrmForm::scheduled_delete( time() );
988 758 $url = remove_query_arg( array( 'delete_all' ) );
759 +
989 760 $url .= '&message=forms_permanently_deleted&forms_deleted=' . $count;
990 761
991 762 wp_safe_redirect( $url );
992 763 die();
@@ -1003,9 +774,9 @@
1003 774
1004 775 $new_values = self::get_modal_values();
1005 776 $new_values['form_key'] = $new_values['name'];
1006 777 $new_values['options'] = array(
1007 - 'antispam' => 1,
778 + 'antispam' => 1,
1008 779 'on_submit_migrated' => 1,
1009 780 );
1010 781
1011 782 /**
@@ -1024,9 +795,8 @@
1024 795 * @param int $form_id
1025 796 */
1026 797 do_action( 'frm_build_new_form', $form_id );
1027 798
1028 - self::create_submit_button_field( $form_id );
1029 799 self::create_default_on_submit_action( $form_id );
1030 800 self::create_default_email_action( $form_id );
1031 801
1032 802 $response = array(
@@ -1040,10 +810,8 @@
1040 810 /**
1041 811 * Before creating a new form, get the name and description from the modal.
1042 812 *
1043 813 * @since 4.0
1044 - *
1045 - * @return array<string,string>
1046 814 */
1047 815 public static function get_modal_values() {
1048 816 $name = FrmAppHelper::get_param( 'name', '', 'post', 'sanitize_text_field' );
1049 817 $desc = FrmAppHelper::get_param( 'desc', '', 'post', 'sanitize_textarea_field' );
@@ -1058,26 +826,18 @@
1058 826 * Inserts Formidable button
1059 827 * Hook exists since 2.5.0
1060 828 *
1061 829 * @since 2.0.15
1062 - *
1063 - * @return void
1064 830 */
1065 831 public static function insert_form_button() {
1066 - if ( ! current_user_can( 'frm_view_forms' ) ) {
1067 - return;
1068 - }
1069 -
1070 - // Store the result in memory and re-use it when this function is called multiple times.
1071 - // This helps speed up the form builder when there are a lot of HTML fields, where this
1072 - // Button is inserted once per HTML field.
1073 - // In a form with 66 HTML fields, this saves 0.5 seconds on page load time, tested locally.
1074 - if ( ! isset( self::$formidable_tinymce_button ) ) {
832 + if ( current_user_can( 'frm_view_forms' ) ) {
1075 833 FrmAppHelper::load_admin_wide_js();
1076 - $icon = apply_filters( 'frm_media_icon', FrmAppHelper::svg_logo() );
1077 - self::$formidable_tinymce_button = '<a href="#TB_inline?width=50&height=50&inlineId=frm_insert_form" class="thickbox button add_media frm_insert_form" title="' . esc_attr__( 'Add forms and content', 'formidable' ) . '">' . FrmAppHelper::kses( $icon, 'all' ) . ' ' . esc_html( FrmAppHelper::get_menu_name() ) . '</a>'; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
834 + $menu_name = FrmAppHelper::get_menu_name();
835 + $icon = apply_filters( 'frm_media_icon', FrmAppHelper::svg_logo() );
836 + echo '<a href="#TB_inline?width=50&height=50&inlineId=frm_insert_form" class="thickbox button add_media frm_insert_form" title="' . esc_attr__( 'Add forms and content', 'formidable' ) . '">' .
837 + FrmAppHelper::kses( $icon, 'all' ) . // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
838 + ' ' . esc_html( $menu_name ) . '</a>';
1078 839 }
1079 - echo self::$formidable_tinymce_button; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1080 840 }
1081 841
1082 842 /**
1083 843 * @return void
@@ -1098,21 +858,17 @@
1098 858 $shortcodes = apply_filters( 'frm_popup_shortcodes', $shortcodes );
1099 859
1100 860 include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/insert_form_popup.php';
1101 861
1102 - if ( ! FrmAppHelper::is_form_builder_page() || class_exists( '_WP_Editors', false ) ) {
1103 - return;
862 + if ( FrmAppHelper::is_form_builder_page() && ! class_exists( '_WP_Editors', false ) ) {
863 + // initialize a wysiwyg so we have usable settings defined in tinyMCEPreInit.mceInit
864 + require ABSPATH . WPINC . '/class-wp-editor.php';
865 + ?>
866 + <div class="frm_hidden">
867 + <?php wp_editor( '', 'frm_description_placeholder', array() ); ?>
868 + </div>
869 + <?php
1104 870 }
1105 -
1106 - // Initialize a wysiwyg so we have usable settings defined in tinyMCEPreInit.mceInit
1107 - require ABSPATH . WPINC . '/class-wp-editor.php';
1108 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
1109 - ?>
1110 - <div class="frm_hidden">
1111 - <?php wp_editor( '', 'frm_description_placeholder', array() ); ?>
1112 - </div>
1113 - <?php
1114 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
1115 871 }
1116 872
1117 873 /**
1118 874 * Check the page being loaded, determine if this is a page that should include the form popup.
@@ -1124,9 +880,8 @@
1124 880 private static function should_insert_form_popup() {
1125 881 if ( FrmAppHelper::is_form_builder_page() ) {
1126 882 return true;
1127 883 }
1128 -
1129 884 $page = basename( FrmAppHelper::get_server_value( 'PHP_SELF' ) );
1130 885 return in_array( $page, array( 'post.php', 'page.php', 'page-new.php', 'post-new.php' ), true );
1131 886 }
1132 887
@@ -1134,10 +889,9 @@
1134 889 FrmAppHelper::permission_check( 'frm_view_forms' );
1135 890 check_ajax_referer( 'frm_ajax', 'nonce' );
1136 891
1137 892 $shortcode = FrmAppHelper::get_post_param( 'shortcode', '', 'sanitize_text_field' );
1138 -
1139 - if ( ! $shortcode ) {
893 + if ( empty( $shortcode ) ) {
1140 894 wp_die();
1141 895 }
1142 896
1143 897 echo '<div id="sc-opts-' . esc_attr( $shortcode ) . '" class="frm_shortcode_option">';
@@ -1162,18 +916,17 @@
1162 916 'label' => __( 'Minimize form HTML', 'formidable' ),
1163 917 ),
1164 918 );
1165 919 }
1166 -
1167 920 $opts = apply_filters( 'frm_sc_popup_opts', $opts, $shortcode );
1168 921
1169 922 if ( isset( $opts['form_id'] ) && is_string( $opts['form_id'] ) ) {
1170 - // Allow other shortcodes to use the required form id option
923 + // allow other shortcodes to use the required form id option
1171 924 $form_id = $opts['form_id'];
1172 925 unset( $opts['form_id'] );
1173 926 }
1174 927
1175 - include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/shortcode_opts.php';
928 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/shortcode_opts.php' );
1176 929
1177 930 echo '</div>';
1178 931
1179 932 wp_die();
@@ -1184,9 +937,8 @@
1184 937 *
1185 938 * @param array $params
1186 939 * @param string $message
1187 940 * @param array $errors
1188 - *
1189 941 * @return void
1190 942 */
1191 943 public static function display_forms_list( $params = array(), $message = '', $errors = array() ) {
1192 944 FrmAppHelper::permission_check( 'frm_view_forms' );
@@ -1203,44 +955,33 @@
1203 955 * @param string $table_class Class name for List Helper.
1204 956 */
1205 957 $table_class = apply_filters( 'frm_forms_list_class', 'FrmFormsListHelper' );
1206 958 $wp_list_table = new $table_class( compact( 'params' ) );
1207 - $pagenum = $wp_list_table->get_pagenum();
1208 959
960 + $pagenum = $wp_list_table->get_pagenum();
961 +
1209 962 $wp_list_table->prepare_items();
1210 963
1211 964 $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
1212 -
1213 965 if ( $pagenum > $total_pages && $total_pages > 0 ) {
1214 - wp_safe_redirect( esc_url_raw( add_query_arg( 'paged', $total_pages ) ) );
966 + wp_redirect( esc_url_raw( add_query_arg( 'paged', $total_pages ) ) );
1215 967 die();
1216 968 }
1217 969
1218 - $error = FrmInbox::check_for_error();
1219 -
1220 - if ( $error ) {
1221 - $show_messages = array( $error['subject'] . '. ' . $error['message'] );
1222 - }
1223 -
1224 970 require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/list.php';
1225 971 }
1226 972
1227 973 /**
1228 974 * @param array<string,string> $columns
1229 - *
1230 975 * @return array<string,string>
1231 976 */
1232 977 public static function get_columns( $columns ) {
1233 - $columns['cb'] = '<input type="checkbox" />';
1234 - $columns['name'] = esc_html__( 'Form Title', 'formidable' );
1235 - $columns['entries'] = esc_html__( 'Entries', 'formidable' );
1236 - $columns['id'] = 'ID';
1237 - $columns['form_key'] = esc_html__( 'Key', 'formidable' );
1238 -
1239 - if ( 'trash' !== FrmAppHelper::simple_get( 'form_type' ) ) {
1240 - $columns['shortcode'] = esc_html__( 'Actions', 'formidable' );
1241 - }
1242 -
978 + $columns['cb'] = '<input type="checkbox" />';
979 + $columns['name'] = esc_html__( 'Form Title', 'formidable' );
980 + $columns['entries'] = esc_html__( 'Entries', 'formidable' );
981 + $columns['id'] = 'ID';
982 + $columns['form_key'] = esc_html__( 'Key', 'formidable' );
983 + $columns['shortcode'] = esc_html__( 'Actions', 'formidable' );
1243 984 $columns['created_at'] = esc_html__( 'Date', 'formidable' );
1244 985
1245 986 add_screen_option(
1246 987 'per_page',
@@ -1253,11 +994,8 @@
1253 994
1254 995 return $columns;
1255 996 }
1256 997
1257 - /**
1258 - * @return array<string,string>
1259 - */
1260 998 public static function get_sortable_columns() {
1261 999 return array(
1262 1000 'id' => 'id',
1263 1001 'name' => 'name',
@@ -1268,9 +1006,8 @@
1268 1006 }
1269 1007
1270 1008 /**
1271 1009 * @param mixed $hidden_columns
1272 - *
1273 1010 * @return array
1274 1011 */
1275 1012 public static function hidden_columns( $hidden_columns ) {
1276 1013 if ( ! is_array( $hidden_columns ) ) {
@@ -1291,39 +1028,24 @@
1291 1028
1292 1029 return $hidden_columns;
1293 1030 }
1294 1031
1295 - /**
1296 - * @param mixed $save
1297 - * @param string $option
1298 - * @param int|string $value
1299 - *
1300 - * @return mixed
1301 - */
1302 1032 public static function save_per_page( $save, $option, $value ) {
1303 - if ( $option === 'formidable_page_formidable_per_page' ) {
1304 - return (int) $value;
1033 + if ( $option == 'formidable_page_formidable_per_page' ) {
1034 + $save = (int) $value;
1305 1035 }
1306 1036
1307 1037 return $save;
1308 1038 }
1309 1039
1310 - /**
1311 - * @param int|string $id
1312 - * @param array $errors
1313 - * @param string $message
1314 - * @param bool $create_link
1315 - *
1316 - * @return void
1317 - */
1318 1040 private static function get_edit_vars( $id, $errors = array(), $message = '', $create_link = false ) {
1319 1041 global $frm_vars;
1320 1042
1321 - $form = FrmForm::getOne( $id );
1043 + $form = FrmForm::getOne( $id );
1322 1044 $error_args = array(
1323 - 'title' => __( 'You can\'t edit the form', 'formidable' ),
1324 - 'body' => __( 'You are trying to edit a form that does not exist', 'formidable' ),
1325 - 'cancel_url' => admin_url( 'admin.php?page=formidable' ),
1045 + 'title' => __( 'You can\'t edit the form', 'formidable' ),
1046 + 'body' => __( 'You are trying to edit a form that does not exist', 'formidable' ),
1047 + 'cancel_url' => admin_url( 'admin.php?page=formidable' ),
1326 1048 'continue_url' => add_query_arg(
1327 1049 array(
1328 1050 'page' => 'formidable',
1329 1051 )
@@ -1328,9 +1050,8 @@
1328 1050 'page' => 'formidable',
1329 1051 )
1330 1052 ),
1331 1053 );
1332 -
1333 1054 if ( ! $form ) {
1334 1055 FrmAppController::show_error_modal( $error_args );
1335 1056 return;
1336 1057 }
@@ -1335,10 +1056,10 @@
1335 1056 return;
1336 1057 }
1337 1058
1338 1059 if ( 'trash' === $form->status ) {
1339 - $error_args['body'] = __( 'The form you\'re trying to edit is in trash. You must restore it first before you can make changes', 'formidable' );
1340 - $error_args['continue_url'] = add_query_arg(
1060 + $error_args['body'] = __( 'The form you\'re trying to edit is in trash. You must restore it first before you can make changes', 'formidable' );
1061 + $error_args['continue_url'] = add_query_arg(
1341 1062 array(
1342 1063 'page' => 'formidable',
1343 1064 '_wpnonce' => wp_create_nonce( 'untrash_form_' . $id ),
1344 1065 'form_type' => 'trash',
@@ -1352,18 +1073,18 @@
1352 1073 }
1353 1074
1354 1075 if ( $form->parent_form_id ) {
1355 1076 /* translators: %1$s: Start link HTML, %2$s: End link HTML */
1356 - wp_die( sprintf( esc_html__( 'You are trying to edit a child form. Please edit from %1$shere%2$s', 'formidable' ), '<a href="' . esc_url( FrmForm::get_edit_link( $form->parent_form_id ) ) . '">', '</a>' ) ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
1077 + wp_die( sprintf( esc_html__( 'You are trying to edit a child form. Please edit from %1$shere%2$s', 'formidable' ), '<a href="' . esc_url( FrmForm::get_edit_link( $form->parent_form_id ) ) . '">', '</a>' ) );
1357 1078 }
1358 1079
1359 1080 $frm_field_selection = FrmField::field_selection();
1360 - $fields = FrmField::get_all_for_form( $form->id );
1361 1081
1082 + $fields = FrmField::get_all_for_form( $form->id );
1083 +
1362 1084 // Automatically add end section fields if they don't exist (2.0 migration).
1363 1085 $reset_fields = false;
1364 1086 FrmFormsHelper::auto_add_end_section_fields( $form, $fields, $reset_fields );
1365 - FrmSubmitHelper::maybe_create_submit_field( $form, $fields, $reset_fields );
1366 1087
1367 1088 if ( $reset_fields ) {
1368 1089 $fields = FrmField::get_all_for_form( $form->id, '', 'exclude' );
1369 1090 }
@@ -1383,16 +1104,16 @@
1383 1104 */
1384 1105 $values['fields'] = apply_filters( 'frm_fields_in_form_builder', $fields, compact( 'form' ) );
1385 1106
1386 1107 $edit_message = __( 'Form was successfully updated.', 'formidable' );
1387 -
1388 - if ( $form->is_template && $message === $edit_message ) {
1108 + if ( $form->is_template && $message == $edit_message ) {
1389 1109 $message = __( 'Template was successfully updated.', 'formidable' );
1390 1110 }
1391 1111
1392 1112 self::maybe_update_form_builder_message( $message );
1393 1113
1394 - $has_fields = ! empty( $values['fields'] ) && ! FrmSubmitHelper::only_contains_submit_field( $values['fields'] );
1114 + $all_templates = FrmForm::getAll( array( 'is_template' => 1 ), 'name' );
1115 + $has_fields = isset( $values['fields'] ) && ! empty( $values['fields'] );
1395 1116
1396 1117 if ( defined( 'DOING_AJAX' ) ) {
1397 1118 wp_die();
1398 1119 }
@@ -1399,14 +1120,9 @@
1399 1120
1400 1121 require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/edit.php';
1401 1122 }
1402 1123
1403 - /**
1404 - * @param array $fields
1405 - *
1406 - * @return array
1407 - */
1408 - public static function update_form_builder_fields( $fields ) {
1124 + public static function update_form_builder_fields( $fields, $form ) {
1409 1125 foreach ( $fields as $field ) {
1410 1126 $field->do_not_include_icons = true;
1411 1127 }
1412 1128 return $fields;
@@ -1411,13 +1127,8 @@
1411 1127 }
1412 1128 return $fields;
1413 1129 }
1414 1130
1415 - /**
1416 - * @param string $message
1417 - *
1418 - * @return void
1419 - */
1420 1131 public static function maybe_update_form_builder_message( &$message ) {
1421 1132 if ( 'form_duplicated' === FrmAppHelper::simple_get( 'message' ) ) {
1422 1133 $message = __( 'Form was Successfully Copied', 'formidable' );
1423 1134 }
@@ -1422,22 +1133,13 @@
1422 1133 $message = __( 'Form was Successfully Copied', 'formidable' );
1423 1134 }
1424 1135 }
1425 1136
1426 - /**
1427 - * @param int|string $id
1428 - * @param array $errors
1429 - * @param array|string $args
1430 - *
1431 - * @return void
1432 - */
1433 1137 public static function get_settings_vars( $id, $errors = array(), $args = array() ) {
1434 1138 FrmAppHelper::permission_check( 'frm_edit_forms' );
1435 1139
1436 1140 global $frm_vars;
1437 1141
1438 - self::maybe_print_media_templates();
1439 -
1440 1142 if ( ! is_array( $args ) ) {
1441 1143 // For reverse compatibility.
1442 1144 $args = array(
1443 1145 'message' => $args,
@@ -1450,12 +1152,13 @@
1450 1152 );
1451 1153 $args = array_merge( $defaults, $args );
1452 1154 $message = $args['message'];
1453 1155 $warnings = $args['warnings'];
1454 - $form = FrmForm::getOne( $id );
1455 - $fields = FrmField::get_all_for_form( $id );
1456 - $values = FrmAppHelper::setup_edit_vars( $form, 'forms', $fields, true );
1457 1156
1157 + $form = FrmForm::getOne( $id );
1158 + $fields = FrmField::get_all_for_form( $id );
1159 + $values = FrmAppHelper::setup_edit_vars( $form, 'forms', $fields, true );
1160 +
1458 1161 /**
1459 1162 * Allows changing fields in the form settings.
1460 1163 *
1461 1164 * @since 5.0.04
@@ -1469,42 +1172,17 @@
1469 1172
1470 1173 $sections = self::get_settings_tabs( $values );
1471 1174 $current = FrmAppHelper::simple_get( 't', 'sanitize_title', 'advanced_settings' );
1472 1175
1473 - require FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings.php';
1176 + require( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings.php' );
1474 1177 }
1475 1178
1476 1179 /**
1477 - * Print WordPress media templates email actions does not trigger a "Uncaught Error: Template not found: #tmpl-media-selection" error when the media button is clicked.
1478 - *
1479 - * @since 6.10
1480 - *
1481 - * @return void
1482 - */
1483 - private static function maybe_print_media_templates() {
1484 - if ( FrmAppHelper::pro_is_included() ) {
1485 - // This issue does not exist when Pro is active so exit early.
1486 - return;
1487 - }
1488 -
1489 - add_action(
1490 - 'wp_enqueue_editor',
1491 - function () {
1492 - wp_print_media_templates();
1493 - }
1494 - );
1495 - }
1496 -
1497 - /**
1498 1180 * @since 4.0
1499 - *
1500 - * @param array $atts
1501 - *
1502 - * @return void
1503 1181 */
1504 1182 public static function form_publish_button( $atts ) {
1505 1183 $values = $atts['values'];
1506 - include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/_publish_box.php';
1184 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/_publish_box.php' );
1507 1185 }
1508 1186
1509 1187 /**
1510 1188 * Get a list of all the settings tabs for the form settings page.
@@ -1511,9 +1189,8 @@
1511 1189 *
1512 1190 * @since 4.0
1513 1191 *
1514 1192 * @param array $values
1515 - *
1516 1193 * @return array
1517 1194 */
1518 1195 private static function get_settings_tabs( $values ) {
1519 1196 $sections = array(
@@ -1519,20 +1196,20 @@
1519 1196 $sections = array(
1520 1197 'advanced' => array(
1521 1198 'name' => __( 'General', 'formidable' ),
1522 1199 'title' => __( 'General Form Settings', 'formidable' ),
1523 - 'function' => array( self::class, 'advanced_settings' ),
1524 - 'icon' => 'frmfont frm_small_settings_icon',
1200 + 'function' => array( __CLASS__, 'advanced_settings' ),
1201 + 'icon' => 'frm_icon_font frm_settings_icon',
1525 1202 ),
1526 1203 'email' => array(
1527 1204 'name' => __( 'Actions & Notifications', 'formidable' ),
1528 1205 'function' => array( 'FrmFormActionsController', 'email_settings' ),
1529 1206 'id' => 'frm_notification_settings',
1530 - 'icon' => 'frmfont frm_notification_check_icon',
1207 + 'icon' => 'frm_icon_font frm_mail_bulk_icon',
1531 1208 ),
1532 1209 'permissions' => array(
1533 1210 'name' => __( 'Form Permissions', 'formidable' ),
1534 - 'icon' => 'frmfont frm_lock_closed2_icon',
1211 + 'icon' => 'frm_icon_font frm_lock_icon',
1535 1212 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1536 1213 'data' => array(
1537 1214 'medium' => 'permissions',
1538 1215 'upgrade' => __( 'Form Permissions', 'formidable' ),
@@ -1537,37 +1214,35 @@
1537 1214 'medium' => 'permissions',
1538 1215 'upgrade' => __( 'Form Permissions', 'formidable' ),
1539 1216 'message' => __( 'Allow editing, protect forms and files, limit entries, and save drafts. Upgrade to get form and entry permissions.', 'formidable' ),
1540 1217 'screenshot' => 'permissions.png',
1541 - 'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-permissions', 'form-permissions-settings' ),
1542 1218 ),
1543 1219 ),
1544 - 'scheduling' => array(
1220 + 'scheduling' => array(
1545 1221 'name' => __( 'Form Scheduling', 'formidable' ),
1546 - 'icon' => 'frmfont frm_schedule_icon',
1222 + 'icon' => 'frm_icon_font frm_calendar_icon',
1547 1223 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1548 1224 'data' => array(
1549 1225 'medium' => 'scheduling',
1550 1226 'upgrade' => __( 'Form scheduling settings', 'formidable' ),
1551 1227 'screenshot' => 'scheduling.png',
1552 - 'learn-more' => FrmAppHelper::get_doc_url( 'general-form-settings/#kb-form-scheduling', 'form-scheduling-settings' ),
1553 1228 ),
1554 1229 ),
1555 1230 'buttons' => array(
1556 1231 'name' => __( 'Buttons', 'formidable' ),
1557 - 'class' => self::class,
1232 + 'class' => __CLASS__,
1558 1233 'function' => 'buttons_settings',
1559 - 'icon' => 'frmfont frm-buttons-style',
1234 + 'icon' => 'frm_icon_font frm_button_icon',
1560 1235 ),
1561 1236 'landing' => array(
1562 1237 'name' => __( 'Form Landing Page', 'formidable' ),
1563 - 'icon' => 'frmfont frm_cross_device_icon',
1238 + 'icon' => 'frm_icon_font frm_file_text_icon',
1564 1239 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1565 1240 'data' => FrmAppHelper::get_landing_page_upgrade_data_params(),
1566 1241 ),
1567 1242 'chat' => array(
1568 1243 'name' => __( 'Conversational Forms', 'formidable' ),
1569 - 'icon' => 'frmfont frm_chat_bubbles_icon',
1244 + 'icon' => 'frm_icon_font frm_chat_forms_icon',
1570 1245 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1571 1246 'data' => FrmAppHelper::get_upgrade_data_params(
1572 1247 'chat',
1573 1248 array(
@@ -1573,15 +1248,14 @@
1573 1248 array(
1574 1249 'upgrade' => __( 'Conversational Forms', 'formidable' ),
1575 1250 'message' => __( 'Ask one question at a time for automated conversations.', 'formidable' ),
1576 1251 'screenshot' => 'chat.png',
1577 - 'learn-more' => FrmAppHelper::get_doc_url( 'conversational-forms', 'conversational-forms-settings', false ),
1578 1252 )
1579 1253 ),
1580 1254 ),
1581 - 'abandonment' => array(
1255 + 'abandonment' => array(
1582 1256 'name' => __( 'Form Abandonment', 'formidable' ),
1583 - 'icon' => 'frmfont frm_abandoned_icon',
1257 + 'icon' => 'frm_icon_font frm_abandoned_icon',
1584 1258 'html_class' => 'frm_show_upgrade_tab frm_noallow',
1585 1259 'data' => FrmAppHelper::get_upgrade_data_params(
1586 1260 'abandonment',
1587 1261 array(
@@ -1587,31 +1261,37 @@
1587 1261 array(
1588 1262 'upgrade' => __( 'Form abandonment settings', 'formidable' ),
1589 1263 'message' => __( 'Unlock the power of data capture to boost lead generation and master the art of form optimization.', 'formidable' ),
1590 1264 'screenshot' => 'abandonment.png',
1591 - 'learn-more' => FrmAppHelper::get_doc_url( 'features/form-abandonment-wordpress-plugin', 'form-abandonment-settings', false ),
1592 1265 )
1593 1266 ),
1594 1267 ),
1595 1268 'html' => array(
1596 1269 'name' => __( 'Customize HTML', 'formidable' ),
1597 - 'class' => self::class,
1270 + 'class' => __CLASS__,
1598 1271 'function' => 'html_settings',
1599 - 'icon' => 'frmfont frm_code2_icon',
1272 + 'icon' => 'frm_icon_font frm_code_icon',
1600 1273 ),
1601 1274 );
1602 1275
1603 - if ( ! has_action( 'frm_add_form_style_tab_options' ) && ! has_action( 'frm_add_form_button_options' ) ) {
1604 - unset( $sections['buttons'] );
1276 + foreach ( array( 'landing', 'chat', 'abandonment' ) as $feature ) {
1277 + if ( ! FrmAppHelper::show_new_feature( $feature ) ) {
1278 + unset( $sections[ $feature ] );
1279 + }
1605 1280 }
1606 1281
1607 1282 $sections = apply_filters( 'frm_add_form_settings_section', $sections, $values );
1608 1283
1284 + if ( FrmAppHelper::pro_is_installed() && ! FrmAppHelper::meets_min_pro_version( '4.0' ) ) {
1285 + // Prevent settings from showing in 2 spots.
1286 + unset( $sections['permissions'], $sections['scheduling'] );
1287 + }
1288 +
1609 1289 foreach ( $sections as $key => $section ) {
1610 1290 $defaults = array(
1611 1291 'html_class' => '',
1612 1292 'name' => ucfirst( $key ),
1613 - 'icon' => 'frmfont frm_settings_icon',
1293 + 'icon' => 'frm_icon_font frm_settings_icon',
1614 1294 );
1615 1295
1616 1296 $section = array_merge( $defaults, $section );
1617 1297
@@ -1617,9 +1297,8 @@
1617 1297
1618 1298 if ( ! isset( $section['anchor'] ) ) {
1619 1299 $section['anchor'] = $key;
1620 1300 }
1621 -
1622 1301 $section['anchor'] .= '_settings';
1623 1302
1624 1303 if ( ! isset( $section['title'] ) ) {
1625 1304 $section['title'] = $section['name'];
@@ -1638,26 +1317,23 @@
1638 1317 /**
1639 1318 * @since 4.0
1640 1319 *
1641 1320 * @param array $values
1642 - *
1643 - * @return void
1644 1321 */
1645 1322 public static function advanced_settings( $values ) {
1646 1323 $first_h3 = 'frm_first_h3';
1324 +
1647 1325 include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-advanced.php';
1648 1326 }
1649 1327
1650 1328 /**
1651 1329 * @param array $values
1652 - *
1653 - * @return void
1654 1330 */
1655 1331 public static function render_spam_settings( $values ) {
1656 1332 if ( function_exists( 'akismet_http_post' ) ) {
1657 1333 include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/akismet.php';
1658 1334 }
1659 - include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/stopforumspam.php';
1335 + include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/honeypot.php';
1660 1336 include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/spam-settings/antispam.php';
1661 1337 }
1662 1338
1663 1339 /**
@@ -1663,13 +1339,16 @@
1663 1339 /**
1664 1340 * @since 4.0
1665 1341 *
1666 1342 * @param array $values
1667 - *
1668 - * @return void
1669 1343 */
1670 1344 public static function buttons_settings( $values ) {
1671 - include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-buttons.php';
1345 + $styles = apply_filters( 'frm_get_style_opts', array() );
1346 +
1347 + $frm_settings = FrmAppHelper::get_settings();
1348 + $no_global_style = $frm_settings->load_style === 'none';
1349 +
1350 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-buttons.php' );
1672 1351 }
1673 1352
1674 1353 /**
1675 1354 * @since 4.0
@@ -1674,13 +1353,11 @@
1674 1353 /**
1675 1354 * @since 4.0
1676 1355 *
1677 1356 * @param array $values
1678 - *
1679 - * @return void
1680 1357 */
1681 1358 public static function html_settings( $values ) {
1682 - include FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-html.php';
1359 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/settings-html.php' );
1683 1360 }
1684 1361
1685 1362 /**
1686 1363 * Replace old Submit Button href with new href to avoid errors in Chrome
@@ -1686,11 +1363,9 @@
1686 1363 * Replace old Submit Button href with new href to avoid errors in Chrome
1687 1364 *
1688 1365 * @since 2.03.08
1689 1366 *
1690 - * @param array|bool $values
1691 - *
1692 - * @return void
1367 + * @param array|boolean $values
1693 1368 */
1694 1369 private static function clean_submit_html( &$values ) {
1695 1370 if ( is_array( $values ) && isset( $values['submit_html'] ) ) {
1696 1371 $values['submit_html'] = str_replace( 'javascript:void(0)', '#', $values['submit_html'] );
@@ -1711,18 +1386,9 @@
1711 1386
1712 1387 return $classes;
1713 1388 }
1714 1389
1715 - /**
1716 - * @since 6.27 Added $template_path parameter.
1717 - *
1718 - * @param int|string $form_id
1719 - * @param string $class
1720 - * @param string $template_path The path to a template file to use instead of the default.
1721 - *
1722 - * @return void
1723 - */
1724 - public static function mb_tags_box( $form_id, $class = '', $template_path = 'default' ) {
1390 + public static function mb_tags_box( $form_id, $class = '' ) {
1725 1391 $fields = FrmField::get_all_for_form( $form_id, '', 'include' );
1726 1392
1727 1393 /**
1728 1394 * Allows modifying the list of fields in the tags box.
@@ -1731,30 +1397,23 @@
1731 1397 *
1732 1398 * @param array $fields The list of fields.
1733 1399 * @param array $args The arguments. Contains `form_id`.
1734 1400 */
1735 - $fields = apply_filters( 'frm_fields_in_tags_box', $fields, compact( 'form_id' ) );
1736 - $linked_forms = array();
1737 - $col = 'one';
1738 - $settings_tab = FrmAppHelper::is_admin_page( 'formidable' );
1401 + $fields = apply_filters( 'frm_fields_in_tags_box', $fields, compact( 'form_id' ) );
1402 + $linked_forms = array();
1403 + $col = 'one';
1404 + $settings_tab = FrmAppHelper::is_admin_page( 'formidable' ) ? true : false;
1405 +
1739 1406 $cond_shortcodes = apply_filters( 'frm_conditional_shortcodes', array() );
1740 1407 $entry_shortcodes = self::get_shortcode_helpers( $settings_tab );
1408 +
1741 1409 $advanced_helpers = self::advanced_helpers( compact( 'fields', 'form_id' ) );
1742 1410
1743 - if ( 'default' === $template_path || ! file_exists( $template_path ) ) {
1744 - include FrmAppHelper::plugin_path() . '/classes/views/shared/mb_adv_info.php';
1745 - return;
1746 - }
1747 -
1748 - include $template_path;
1411 + include( FrmAppHelper::plugin_path() . '/classes/views/shared/mb_adv_info.php' );
1749 1412 }
1750 1413
1751 1414 /**
1752 1415 * @since 3.04.01
1753 - *
1754 - * @param array $atts
1755 - *
1756 - * @return array
1757 1416 */
1758 1417 private static function advanced_helpers( $atts ) {
1759 1418 $advanced_helpers = array(
1760 1419 'default' => array(
@@ -1763,12 +1422,10 @@
1763 1422 ),
1764 1423 );
1765 1424
1766 1425 $user_fields = self::user_shortcodes();
1767 -
1768 - if ( $user_fields ) {
1426 + if ( ! empty( $user_fields ) ) {
1769 1427 $user_helpers = array();
1770 -
1771 1428 foreach ( $user_fields as $uk => $uf ) {
1772 1429 $user_helpers[ '|user_id| show="' . $uk . '"' ] = $uf;
1773 1430 unset( $uk, $uf );
1774 1431 }
@@ -1773,9 +1430,9 @@
1773 1430 unset( $uk, $uf );
1774 1431 }
1775 1432
1776 1433 $advanced_helpers['user_id'] = array(
1777 - 'codes' => $user_helpers,
1434 + 'codes' => $user_helpers,
1778 1435 );
1779 1436 }
1780 1437
1781 1438 /**
@@ -1793,10 +1450,8 @@
1793 1450 * Get an array of the options to display in the advanced tab
1794 1451 * of the customization panel
1795 1452 *
1796 1453 * @since 2.0.6
1797 - *
1798 - * @return array
1799 1454 */
1800 1455 private static function get_advanced_shortcodes() {
1801 1456 $adv_shortcodes = array(
1802 1457 'x sep=", "' => array(
@@ -1813,18 +1468,17 @@
1813 1468 'label' => __( 'No Auto P', 'formidable' ),
1814 1469 'title' => __( 'Do not automatically add any paragraphs or line breaks', 'formidable' ),
1815 1470 ),
1816 1471 );
1472 + $adv_shortcodes = apply_filters( 'frm_advanced_shortcodes', $adv_shortcodes );
1817 1473
1818 1474 // __( 'Leave blank instead of defaulting to User Login', 'formidable' ) : blank=1
1819 1475
1820 - return apply_filters( 'frm_advanced_shortcodes', $adv_shortcodes );
1476 + return $adv_shortcodes;
1821 1477 }
1822 1478
1823 1479 /**
1824 1480 * @since 3.04.01
1825 - *
1826 - * @return array
1827 1481 */
1828 1482 private static function user_shortcodes() {
1829 1483 $options = array(
1830 1484 'ID' => __( 'User ID', 'formidable' ),
@@ -1843,12 +1497,8 @@
1843 1497 /**
1844 1498 * Get an array of the helper shortcodes to display in the customization panel
1845 1499 *
1846 1500 * @since 2.0.6
1847 - *
1848 - * @param bool $settings_tab
1849 - *
1850 - * @return array
1851 1501 */
1852 1502 private static function get_shortcode_helpers( $settings_tab ) {
1853 1503 $entry_shortcodes = array(
1854 1504 'id' => __( 'Entry ID', 'formidable' ),
@@ -1859,27 +1509,30 @@
1859 1509 'updated-at' => __( 'Entry updated', 'formidable' ),
1860 1510 '' => '',
1861 1511 'siteurl' => __( 'Site URL', 'formidable' ),
1862 1512 'sitename' => __( 'Site Name', 'formidable' ),
1863 - 'form_name' => __( 'Form Name', 'formidable' ),
1864 1513 );
1865 1514
1866 - $entry_shortcodes = array_merge( FrmShortcodeHelper::get_contextual_shortcode_values(), $entry_shortcodes );
1867 -
1868 1515 if ( ! FrmAppHelper::pro_is_installed() ) {
1869 1516 unset( $entry_shortcodes['post_id'] );
1870 1517 }
1871 1518
1519 + if ( $settings_tab ) {
1520 + $entry_shortcodes['default-message'] = __( 'Default Msg', 'formidable' );
1521 + $entry_shortcodes['default-html'] = __( 'Default HTML', 'formidable' );
1522 + $entry_shortcodes['default-plain'] = __( 'Default Plain', 'formidable' );
1523 + $entry_shortcodes['form_name'] = __( 'Form Name', 'formidable' );
1524 + }
1525 +
1872 1526 /**
1873 1527 * Use this hook to add or remove buttons in the helpers section
1874 1528 * in the customization panel
1875 1529 *
1876 1530 * @since 2.0.6
1877 - *
1878 - * @param array $entry_shortcodes
1879 - * @param bool $settings_tab
1880 1531 */
1881 - return apply_filters( 'frm_helper_shortcodes', $entry_shortcodes, $settings_tab );
1532 + $entry_shortcodes = apply_filters( 'frm_helper_shortcodes', $entry_shortcodes, $settings_tab );
1533 +
1534 + return $entry_shortcodes;
1882 1535 }
1883 1536
1884 1537 /**
1885 1538 * Insert the form class setting into the form.
@@ -1884,9 +1537,8 @@
1884 1537 /**
1885 1538 * Insert the form class setting into the form.
1886 1539 *
1887 1540 * @param stdClass $form
1888 - *
1889 1541 * @return void
1890 1542 */
1891 1543 public static function form_classes( $form ) {
1892 1544 if ( isset( $form->options['form_class'] ) ) {
@@ -1897,9 +1549,9 @@
1897 1549 echo ' frm_js_validate ';
1898 1550 self::add_js_validate_form_to_global_vars( $form );
1899 1551 }
1900 1552
1901 - if ( FrmForm::is_ajax_on( $form ) ) {
1553 + if ( ! FrmFormsHelper::should_use_pro_for_ajax_submit() && FrmForm::is_ajax_on( $form ) ) {
1902 1554 echo ' frm_ajax_submit ';
1903 1555 }
1904 1556 }
1905 1557
@@ -1909,9 +1561,8 @@
1909 1561 * @param stdClass $form
1910 1562 */
1911 1563 public static function add_js_validate_form_to_global_vars( $form ) {
1912 1564 global $frm_vars;
1913 -
1914 1565 if ( ! isset( $frm_vars['js_validate_forms'] ) ) {
1915 1566 $frm_vars['js_validate_forms'] = array();
1916 1567 }
1917 1568 $frm_vars['js_validate_forms'][ $form->id ] = $form;
@@ -1922,11 +1573,11 @@
1922 1573 check_ajax_referer( 'frm_ajax', 'nonce' );
1923 1574
1924 1575 echo FrmEntriesController::show_entry_shortcode( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1925 1576 array(
1926 - 'form_id' => FrmAppHelper::get_post_param( 'form_id', '', 'absint' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1577 + 'form_id' => FrmAppHelper::get_post_param( 'form_id', '', 'absint' ),
1927 1578 'default_email' => true,
1928 - 'plain_text' => FrmAppHelper::get_post_param( 'plain_text', '', 'absint' ), // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
1579 + 'plain_text' => FrmAppHelper::get_post_param( 'plain_text', '', 'absint' ),
1929 1580 )
1930 1581 );
1931 1582 wp_die();
1932 1583 }
@@ -1932,11 +1583,10 @@
1932 1583 }
1933 1584
1934 1585 /**
1935 1586 * @param string $content
1936 - * @param int|stdClass|string $form
1937 - * @param false|int|stdClass|string $entry
1938 - *
1587 + * @param stdClass|string|int $form
1588 + * @param stdClass|string|int|false $entry
1939 1589 * @return string
1940 1590 */
1941 1591 public static function filter_content( $content, $form, $entry = false ) {
1942 1592 $content = self::replace_form_name_shortcodes( $content, $form );
@@ -1941,9 +1591,8 @@
1941 1591 public static function filter_content( $content, $form, $entry = false ) {
1942 1592 $content = self::replace_form_name_shortcodes( $content, $form );
1943 1593
1944 1594 self::get_entry_by_param( $entry );
1945 -
1946 1595 if ( ! $entry ) {
1947 1596 return $content;
1948 1597 }
1949 1598
@@ -1950,19 +1599,12 @@
1950 1599 if ( is_object( $form ) ) {
1951 1600 $form = $form->id;
1952 1601 }
1953 1602
1954 - /*
1955 - * Repeater actions adds `parent_entry` to `$entry` store the parent entry data. If `parent_entry` is not empty,
1956 - * use the parent form ID instead of repeater form ID to fix the parent form field shortcodes doesn't work.
1957 - */
1958 - if ( ! empty( $entry->parent_entry ) ) {
1959 - $form = $entry->parent_entry->form_id;
1960 - }
1961 -
1962 1603 $shortcodes = FrmFieldsHelper::get_shortcodes( $content, $form );
1604 + $content = apply_filters( 'frm_replace_content_shortcodes', $content, $entry, $shortcodes );
1963 1605
1964 - return apply_filters( 'frm_replace_content_shortcodes', $content, $entry, $shortcodes );
1606 + return $content;
1965 1607 }
1966 1608
1967 1609 /**
1968 1610 * Replace any [form_name] shortcodes in a string.
@@ -1968,12 +1610,11 @@
1968 1610 * Replace any [form_name] shortcodes in a string.
1969 1611 *
1970 1612 * @since 5.5
1971 1613 *
1972 - * @param array|string $string
1973 - * @param int|stdClass|string $form
1974 - *
1975 - * @return array|string
1614 + * @param string|array $string
1615 + * @param stdClass|string|int $form
1616 + * @return string|array
1976 1617 */
1977 1618 public static function replace_form_name_shortcodes( $string, $form ) {
1978 1619 if ( ! is_string( $string ) ) {
1979 1620 return $string;
@@ -1978,9 +1619,9 @@
1978 1619 if ( ! is_string( $string ) ) {
1979 1620 return $string;
1980 1621 }
1981 1622
1982 - if ( ! str_contains( $string, '[form_name]' ) ) {
1623 + if ( false === strpos( $string, '[form_name]' ) ) {
1983 1624 return $string;
1984 1625 }
1985 1626
1986 1627 if ( ! is_object( $form ) ) {
@@ -1991,40 +1632,25 @@
1991 1632 return str_replace( '[form_name]', $form_name, $string );
1992 1633 }
1993 1634
1994 1635 /**
1995 - * @param false|int|stdClass|string $entry
1996 - *
1636 + * @param stdClass|string|int|false $entry
1997 1637 * @return void
1998 1638 */
1999 1639 private static function get_entry_by_param( &$entry ) {
2000 - if ( $entry && is_object( $entry ) ) {
2001 - return;
2002 - }
1640 + if ( ! $entry || ! is_object( $entry ) ) {
1641 + if ( ! $entry || ! is_numeric( $entry ) ) {
1642 + $entry = FrmAppHelper::get_post_param( 'id', false, 'sanitize_title' );
1643 + }
2003 1644
2004 - if ( ! $entry || ! is_numeric( $entry ) ) {
2005 - $entry = FrmAppHelper::get_post_param( 'id', false, 'sanitize_title' );
1645 + FrmEntry::maybe_get_entry( $entry );
2006 1646 }
2007 -
2008 - FrmEntry::maybe_get_entry( $entry );
2009 1647 }
2010 1648
2011 - /**
2012 - * @param string $content
2013 - * @param false|object $entry
2014 - * @param array $shortcodes
2015 - *
2016 - * @return string
2017 - */
2018 1649 public static function replace_content_shortcodes( $content, $entry, $shortcodes ) {
2019 1650 return FrmFieldsHelper::replace_content_shortcodes( $content, $entry, $shortcodes );
2020 1651 }
2021 1652
2022 - /**
2023 - * @param array $errors
2024 - *
2025 - * @return array
2026 - */
2027 1653 public static function process_bulk_form_actions( $errors ) {
2028 1654 if ( ! $_REQUEST ) {
2029 1655 return $errors;
2030 1656 }
@@ -2029,30 +1655,29 @@
2029 1655 return $errors;
2030 1656 }
2031 1657
2032 1658 $bulkaction = FrmAppHelper::get_param( 'action', '', 'get', 'sanitize_text_field' );
2033 -
2034 - // phpcs:ignore Universal.Operators.StrictComparisons
2035 1659 if ( $bulkaction == - 1 ) {
2036 1660 $bulkaction = FrmAppHelper::get_param( 'action2', '', 'get', 'sanitize_title' );
2037 1661 }
2038 1662
2039 - if ( $bulkaction && str_starts_with( $bulkaction, 'bulk_' ) ) {
1663 + if ( ! empty( $bulkaction ) && strpos( $bulkaction, 'bulk_' ) === 0 ) {
2040 1664 FrmAppHelper::remove_get_action();
1665 +
2041 1666 $bulkaction = str_replace( 'bulk_', '', $bulkaction );
2042 1667 }
2043 1668
2044 1669 $ids = FrmAppHelper::get_param( 'item-action', '', 'get', 'sanitize_text_field' );
1670 + if ( empty( $ids ) ) {
1671 + $errors[] = __( 'No forms were specified', 'formidable' );
2045 1672
2046 - if ( ! $ids ) {
2047 - $errors[] = __( 'No forms were specified', 'formidable' );
2048 1673 return $errors;
2049 1674 }
2050 1675
2051 1676 $permission_error = FrmAppHelper::permission_nonce_error( '', '_wpnonce', 'bulk-toplevel_page_formidable' );
2052 -
2053 1677 if ( $permission_error !== false ) {
2054 1678 $errors[] = $permission_error;
1679 +
2055 1680 return $errors;
2056 1681 }
2057 1682
2058 1683 if ( ! is_array( $ids ) ) {
@@ -2069,9 +1694,9 @@
2069 1694 case 'untrash':
2070 1695 $message = self::bulk_untrash( $ids );
2071 1696 }
2072 1697
2073 - if ( ! empty( $message ) ) {
1698 + if ( isset( $message ) && ! empty( $message ) ) {
2074 1699 $errors['message'] = $message;
2075 1700 }
2076 1701
2077 1702 return $errors;
@@ -2076,24 +1701,9 @@
2076 1701
2077 1702 return $errors;
2078 1703 }
2079 1704
2080 - /**
2081 - * Includes html that shows a message when the device is too small to use Formidable Forms admin pages.
2082 - *
2083 - * @since 6.20
2084 - *
2085 - * @return void
2086 - */
2087 - public static function include_device_too_small_message() {
2088 - if ( ! FrmAppHelper::is_formidable_admin() ) {
2089 - return;
2090 - }
2091 -
2092 - include FrmAppHelper::plugin_path() . '/classes/views/shared/small-device-message.php';
2093 - }
2094 -
2095 - public static function route() { // phpcs:ignore Generic.Metrics.CyclomaticComplexity.MaxExceeded
1705 + public static function route() {
2096 1706 $action = isset( $_REQUEST['frm_action'] ) ? 'frm_action' : 'action';
2097 1707 $vars = array();
2098 1708 FrmAppHelper::include_svg();
2099 1709
@@ -2103,28 +1713,25 @@
2103 1713 // Javascript needs to be allowed in some field settings.
2104 1714 // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.NonceVerification.Missing
2105 1715 $json_vars = htmlspecialchars_decode( nl2br( str_replace( '&quot;', '"', wp_unslash( $_POST['frm_compact_fields'] ) ) ) );
2106 1716 $json_vars = json_decode( $json_vars, true );
1717 + if ( empty( $json_vars ) ) {
1718 + // json decoding failed so we should return an error message.
1719 + $action = FrmAppHelper::get_param( $action, '', 'get', 'sanitize_title' );
1720 + if ( 'edit' == $action ) {
1721 + $action = 'update';
1722 + }
2107 1723
2108 - if ( $json_vars ) {
1724 + add_filter( 'frm_validate_form', 'FrmFormsController::json_error' );
1725 + } else {
2109 1726 $vars = FrmAppHelper::json_to_array( $json_vars );
2110 1727 $action = $vars[ $action ];
2111 1728 unset( $_REQUEST['frm_compact_fields'], $_POST['frm_compact_fields'] ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
2112 1729 $_REQUEST = array_merge( $_REQUEST, $vars ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
2113 1730 $_POST = array_merge( $_POST, $_REQUEST ); // phpcs:ignore WordPress.Security.NonceVerification.Missing
2114 - } else {
2115 - // Json decoding failed so we should return an error message.
2116 - $action = FrmAppHelper::get_param( $action, '', 'get', 'sanitize_title' );
2117 -
2118 - if ( 'edit' === $action ) {
2119 - $action = 'update';
2120 - }
2121 -
2122 - add_filter( 'frm_validate_form', 'FrmFormsController::json_error' );
2123 1731 }
2124 1732 } else {
2125 1733 $action = FrmAppHelper::get_param( $action, '', 'get', 'sanitize_title' );
2126 -
2127 1734 if ( isset( $_REQUEST['delete_all'] ) ) {
2128 1735 // Override the action for this page.
2129 1736 $action = 'delete_all';
2130 1737 }
@@ -2133,8 +1740,10 @@
2133 1740 add_action( 'frm_load_form_hooks', 'FrmHooksController::trigger_load_form_hooks' );
2134 1741 FrmAppHelper::trigger_hook_load( 'form' );
2135 1742
2136 1743 switch ( $action ) {
1744 + case 'new':
1745 + return self::new_form( $vars );
2137 1746 case 'create':
2138 1747 case 'edit':
2139 1748 case 'update':
2140 1749 case 'trash':
@@ -2143,39 +1752,33 @@
2143 1752 case 'settings':
2144 1753 case 'update_settings':
2145 1754 return self::$action( $vars );
2146 1755 case 'lite-reports':
2147 - self::no_reports( $vars );
2148 - return null;
1756 + return self::no_reports( $vars );
2149 1757 case 'views':
2150 - self::no_views( $vars );
2151 - return null;
1758 + return self::no_views( $vars );
2152 1759 default:
2153 1760 do_action( 'frm_form_action_' . $action );
2154 -
2155 1761 if ( apply_filters( 'frm_form_stop_action_' . $action, false ) ) {
2156 - return null;
1762 + return;
2157 1763 }
2158 1764
2159 1765 $action = FrmAppHelper::get_param( 'action', '', 'get', 'sanitize_text_field' );
2160 -
2161 - // phpcs:ignore Universal.Operators.StrictComparisons
2162 1766 if ( $action == - 1 ) {
2163 1767 $action = FrmAppHelper::get_param( 'action2', '', 'get', 'sanitize_title' );
2164 1768 }
2165 1769
2166 - if ( str_starts_with( $action, 'bulk_' ) ) {
1770 + if ( strpos( $action, 'bulk_' ) === 0 ) {
2167 1771 FrmAppHelper::remove_get_action();
2168 1772
2169 1773 self::list_form();
2170 - return null;
1774 + return;
2171 1775 }
2172 1776
2173 1777 $message = FrmAppHelper::get_param( 'message' );
2174 -
2175 1778 if ( 'form_duplicate_error' === $message ) {
2176 1779 self::display_forms_list( array(), '', array( __( 'There was a problem duplicating the form', 'formidable' ) ) );
2177 - return null;
1780 + return;
2178 1781 }
2179 1782
2180 1783 if ( 'forms_permanently_deleted' === $message ) {
2181 1784 $count = FrmAppHelper::get_param( 'forms_deleted', 0, 'get', 'absint' );
@@ -2181,14 +1784,14 @@
2181 1784 $count = FrmAppHelper::get_param( 'forms_deleted', 0, 'get', 'absint' );
2182 1785 /* translators: %1$s: Number of forms */
2183 1786 $message = sprintf( _n( '%1$s form permanently deleted.', '%1$s forms permanently deleted.', $count, 'formidable' ), $count );
2184 1787 self::display_forms_list( array(), $message, '' );
2185 - return null;
1788 + return;
2186 1789 }
2187 1790
2188 1791 self::display_forms_list();
2189 1792
2190 - return null;
1793 + return;
2191 1794 }//end switch
2192 1795 }
2193 1796
2194 1797 /**
@@ -2207,44 +1810,29 @@
2207 1810
2208 1811 // Get posted data
2209 1812 $form_id = FrmAppHelper::get_post_param( 'form_id', '', 'absint' );
2210 1813 $name = FrmAppHelper::get_post_param( 'form_name', '', 'sanitize_text_field' );
2211 - $form = FrmForm::getOne( $form_id );
2212 1814
2213 - if ( ! $form ) {
2214 - wp_send_json_error( __( 'Form not found', 'formidable' ) );
2215 - }
1815 + // Update the form name and form key.
1816 + $form_key = FrmAppHelper::get_unique_key( sanitize_title( $name ), 'frm_forms', 'form_key' );
1817 + FrmForm::update( $form_id, compact( 'name', 'form_key' ) );
2216 1818
2217 - if ( $name === $form->name ) {
2218 - // Nothing to change so exit early.
2219 - wp_send_json_success();
2220 - }
1819 + wp_send_json_success( compact( 'form_key' ) );
1820 + }
2221 1821
2222 - $to_update = array(
2223 - 'name' => $name,
2224 - );
1822 + public static function json_error( $errors ) {
1823 + $errors['json'] = __( 'Abnormal HTML characters prevented your form from saving correctly', 'formidable' );
2225 1824
2226 - if ( '' === $name ) {
2227 - $form_key = $form->form_key;
2228 - } else {
2229 - // Only update form_key if name is not empty.
2230 - $form_key = FrmAppHelper::get_unique_key( sanitize_title( $name ), 'frm_forms', 'form_key' );
2231 - $to_update['form_key'] = $form_key;
2232 - }
2233 -
2234 - FrmForm::update( $form_id, $to_update );
2235 -
2236 - wp_send_json_success( compact( 'form_key' ) );
1825 + return $errors;
2237 1826 }
2238 1827
2239 1828 /**
2240 - * @param array $errors
1829 + * Education for premium features.
2241 1830 *
2242 - * @return array
1831 + * @since 4.05
2243 1832 */
2244 - public static function json_error( $errors ) {
2245 - $errors['json'] = __( 'Abnormal HTML characters prevented your form from saving correctly', 'formidable' );
2246 - return $errors;
1833 + public static function add_form_style_tab_options() {
1834 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/add_form_style_options.php' );
2247 1835 }
2248 1836
2249 1837 /**
2250 1838 * Add education about views.
@@ -2249,12 +1837,8 @@
2249 1837 /**
2250 1838 * Add education about views.
2251 1839 *
2252 1840 * @since 4.07
2253 - *
2254 - * @param array $values
2255 - *
2256 - * @return void
2257 1841 */
2258 1842 public static function no_views( $values = array() ) {
2259 1843 FrmAppHelper::include_svg();
2260 1844 $id = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
@@ -2266,12 +1850,8 @@
2266 1850 /**
2267 1851 * Add education about reports.
2268 1852 *
2269 1853 * @since 4.07
2270 - *
2271 - * @param array $values
2272 - *
2273 - * @return void
2274 1854 */
2275 1855 public static function no_reports( $values = array() ) {
2276 1856 $id = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
2277 1857 $form = $id ? FrmForm::getOne( $id ) : false;
@@ -2296,9 +1876,10 @@
2296 1876 /**
2297 1877 * @since 4.05.02
2298 1878 */
2299 1879 private static function move_menu_to_footer() {
2300 - if ( empty( FrmAppHelper::get_settings()->admin_bar ) ) {
1880 + $settings = FrmAppHelper::get_settings();
1881 + if ( empty( $settings->admin_bar ) ) {
2301 1882 remove_action( 'wp_body_open', 'wp_admin_bar_render', 0 );
2302 1883 }
2303 1884 }
2304 1885
@@ -2303,15 +1884,13 @@
2303 1884 }
2304 1885
2305 1886 public static function admin_bar_configure() {
2306 1887 global $frm_vars;
2307 -
2308 1888 if ( empty( $frm_vars['forms_loaded'] ) ) {
2309 1889 return;
2310 1890 }
2311 1891
2312 1892 $actions = array();
2313 -
2314 1893 foreach ( $frm_vars['forms_loaded'] as $form ) {
2315 1894 if ( is_object( $form ) ) {
2316 1895 $actions[ $form->id ] = $form->name;
2317 1896 }
@@ -2317,9 +1896,9 @@
2317 1896 }
2318 1897 unset( $form );
2319 1898 }
2320 1899
2321 - if ( ! $actions ) {
1900 + if ( empty( $actions ) ) {
2322 1901 return;
2323 1902 }
2324 1903
2325 1904 self::add_menu_to_admin_bar();
@@ -2345,12 +1924,8 @@
2345 1924 }
2346 1925
2347 1926 /**
2348 1927 * @since 2.05.07
2349 - *
2350 - * @param array $actions
2351 - *
2352 - * @return void
2353 1928 */
2354 1929 private static function add_forms_to_admin_bar( $actions ) {
2355 1930 global $wp_admin_bar;
2356 1931
@@ -2356,13 +1931,14 @@
2356 1931
2357 1932 asort( $actions );
2358 1933
2359 1934 foreach ( $actions as $form_id => $name ) {
1935 +
2360 1936 $wp_admin_bar->add_node(
2361 1937 array(
2362 1938 'parent' => 'frm-forms',
2363 1939 'id' => 'edit_form_' . $form_id,
2364 - 'title' => $name ? $name : FrmFormsHelper::get_no_title_text(),
1940 + 'title' => empty( $name ) ? __( '(no title)', 'formidable' ) : $name,
2365 1941 'href' => FrmForm::get_edit_link( $form_id ),
2366 1942 )
2367 1943 );
2368 1944 }
@@ -2371,16 +1947,14 @@
2371 1947 /**
2372 1948 * The formidable shortcode
2373 1949 *
2374 1950 * @param array $atts The params from the shortcode.
2375 - *
2376 1951 * @return string
2377 1952 */
2378 1953 public static function get_form_shortcode( $atts ) {
2379 1954 global $frm_vars;
2380 -
2381 - if ( ! empty( $frm_vars['skip_shortcode'] ) ) {
2382 - $sc = '[formidable';
1955 + if ( isset( $frm_vars['skip_shortcode'] ) && $frm_vars['skip_shortcode'] ) {
1956 + $sc = '[formidable';
2383 1957 $sc .= FrmAppHelper::array_to_html_params( $atts );
2384 1958 return $sc . ']';
2385 1959 }
2386 1960
@@ -2405,12 +1979,11 @@
2405 1979
2406 1980 /**
2407 1981 * @since 5.2.01
2408 1982 *
2409 - * @param false|int|string $id
2410 - * @param false|string $key
2411 - *
2412 - * @return false|stdClass
1983 + * @param string|int|false $id
1984 + * @param string|false $key
1985 + * @return stdClass|false
2413 1986 */
2414 1987 private static function maybe_get_form_by_id_or_key( $id, $key ) {
2415 1988 if ( ! $id ) {
2416 1989 $id = $key;
@@ -2418,14 +1991,13 @@
2418 1991 return self::maybe_get_form_to_show( $id );
2419 1992 }
2420 1993
2421 1994 /**
2422 - * @param false|int|string $id
2423 - * @param false|string $key
2424 - * @param bool|int|string $title may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
2425 - * @param bool|int|string $description may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
1995 + * @param string|int|false $id
1996 + * @param string|false $key
1997 + * @param string|int|bool $title may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
1998 + * @param string|int|bool $description may be 'auto', true, false, 'true', 'false', 'yes', '1', 1, '0', 0.
2426 1999 * @param array $atts
2427 - *
2428 2000 * @return string
2429 2001 */
2430 2002 public static function show_form( $id = '', $key = '', $title = false, $description = false, $atts = array() ) {
2431 2003 $form = self::maybe_get_form_by_id_or_key( $id, $key );
@@ -2446,13 +2018,14 @@
2446 2018
2447 2019 add_action( 'frm_load_form_hooks', 'FrmHooksController::trigger_load_form_hooks' );
2448 2020 FrmAppHelper::trigger_hook_load( 'form', $form );
2449 2021
2450 - $form = apply_filters( 'frm_pre_display_form', $form );
2022 + $form = apply_filters( 'frm_pre_display_form', $form );
2023 +
2451 2024 $frm_settings = FrmAppHelper::get_settings( array( 'current_form' => $form->id ) );
2452 2025
2453 2026 if ( self::is_viewable_draft_form( $form ) ) {
2454 - // Don't show a draft form on a page
2027 + // don't show a draft form on a page
2455 2028 $form = __( 'Please select a valid form', 'formidable' );
2456 2029 } elseif ( ! FrmForm::is_visible_to_user( $form ) ) {
2457 2030 $form = do_shortcode( $frm_settings->login_msg );
2458 2031 } else {
@@ -2471,19 +2044,17 @@
2471 2044 return $form;
2472 2045 }
2473 2046
2474 2047 /**
2475 - * @param false|int|string $id
2476 - *
2477 - * @return false|stdClass
2048 + * @param string|int|false $id
2049 + * @return stdClass|false
2478 2050 */
2479 2051 private static function maybe_get_form_to_show( $id ) {
2480 2052 $form = false;
2481 2053
2482 - if ( $id ) {
2054 + if ( ! empty( $id ) ) {
2483 2055 // Form id or key is set.
2484 2056 $form = FrmForm::getOne( $id );
2485 -
2486 2057 if ( ! $form || $form->parent_form_id || $form->status === 'trash' ) {
2487 2058 $form = false;
2488 2059 }
2489 2060 }
@@ -2490,25 +2061,12 @@
2490 2061
2491 2062 return $form;
2492 2063 }
2493 2064
2494 - /**
2495 - * @param object $form
2496 - *
2497 - * @return bool
2498 - */
2499 2065 private static function is_viewable_draft_form( $form ) {
2500 2066 return $form->status === 'draft' && current_user_can( 'frm_edit_forms' ) && ! FrmAppHelper::is_preview_page();
2501 2067 }
2502 2068
2503 - /**
2504 - * @param object $form
2505 - * @param bool $title
2506 - * @param bool $description
2507 - * @param array $atts
2508 - *
2509 - * @return string
2510 - */
2511 2069 public static function get_form( $form, $title, $description, $atts = array() ) {
2512 2070 ob_start();
2513 2071
2514 2072 do_action( 'frm_before_get_form', $atts );
@@ -2515,9 +2073,10 @@
2515 2073
2516 2074 self::get_form_contents( $form, $title, $description, $atts );
2517 2075 self::enqueue_scripts( FrmForm::get_params( $form ) );
2518 2076
2519 - $contents = ob_get_clean();
2077 + $contents = ob_get_contents();
2078 + ob_end_clean();
2520 2079
2521 2080 self::maybe_minimize_form( $atts, $contents );
2522 2081
2523 2082 return $contents;
@@ -2522,25 +2081,12 @@
2522 2081
2523 2082 return $contents;
2524 2083 }
2525 2084
2526 - /**
2527 - * @param array $params
2528 - *
2529 - * @return void
2530 - */
2531 2085 public static function enqueue_scripts( $params ) {
2532 2086 do_action( 'frm_enqueue_form_scripts', $params );
2533 2087 }
2534 2088
2535 - /**
2536 - * @param object $form
2537 - * @param bool $title
2538 - * @param bool $description
2539 - * @param array $atts
2540 - *
2541 - * @return void
2542 - */
2543 2089 public static function get_form_contents( $form, $title, $description, $atts ) {
2544 2090 $params = FrmForm::get_params( $form );
2545 2091 $errors = self::get_saved_errors( $form, $params );
2546 2092 $fields = FrmFieldsHelper::get_form_fields( $form->id, $errors );
@@ -2547,10 +2093,9 @@
2547 2093 $reset = false;
2548 2094 $pass_args = compact( 'form', 'fields', 'errors', 'title', 'description', 'reset' );
2549 2095
2550 2096 $pass_args['action'] = $params['action'];
2551 - // phpcs:ignore WordPress.Security.NonceVerification.Missing, Universal.Operators.StrictComparisons
2552 - $handle_process_here = $params['action'] === 'create' && $params['posted_form_id'] == $form->id && $_POST;
2097 + $handle_process_here = $params['action'] === 'create' && $params['posted_form_id'] == $form->id && $_POST; // phpcs:ignore WordPress.Security.NonceVerification.Missing
2553 2098
2554 2099 if ( ! $handle_process_here ) {
2555 2100 FrmFormState::set_initial_value( 'title', $title );
2556 2101 FrmFormState::set_initial_value( 'description', $description );
@@ -2555,21 +2100,22 @@
2555 2100 FrmFormState::set_initial_value( 'title', $title );
2556 2101 FrmFormState::set_initial_value( 'description', $description );
2557 2102
2558 2103 do_action( 'frm_display_form_action', $params, $fields, $form, $title, $description );
2559 -
2560 2104 if ( apply_filters( 'frm_continue_to_new', true, $form->id, $params['action'] ) ) {
2561 2105 self::show_form_after_submit( $pass_args );
2562 2106 }
2563 - } elseif ( $errors ) {
2107 + } elseif ( ! empty( $errors ) ) {
2564 2108 self::show_form_after_submit( $pass_args );
2109 +
2565 2110 } else {
2111 +
2566 2112 do_action( 'frm_validate_form_creation', $params, $fields, $form, $title, $description );
2567 2113
2568 2114 if ( apply_filters( 'frm_continue_to_create', true, $form->id ) ) {
2569 - $entry_id = self::just_created_entry( $form->id );
2570 - $pass_args['entry_id'] = $entry_id;
2571 - $pass_args['reset'] = true;
2115 + $entry_id = self::just_created_entry( $form->id );
2116 + $pass_args['entry_id'] = $entry_id;
2117 + $pass_args['reset'] = true;
2572 2118
2573 2119 self::run_on_submit_actions( $pass_args );
2574 2120
2575 2121 do_action(
@@ -2586,19 +2132,13 @@
2586 2132 /**
2587 2133 * If the form was processed earlier (init), get the generated errors
2588 2134 *
2589 2135 * @since 2.05
2590 - *
2591 - * @param object $form
2592 - * @param array $params
2593 - *
2594 - * @return array
2595 2136 */
2596 2137 private static function get_saved_errors( $form, $params ) {
2597 2138 global $frm_vars;
2598 2139
2599 - // phpcs:ignore WordPress.Security.NonceVerification.Missing, Universal.Operators.StrictComparisons
2600 - if ( $params['posted_form_id'] == $form->id && $_POST && isset( $frm_vars['created_entries'][ $form->id ] ) ) {
2140 + if ( $params['posted_form_id'] == $form->id && $_POST && isset( $frm_vars['created_entries'][ $form->id ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
2601 2141 $errors = $frm_vars['created_entries'][ $form->id ]['errors'];
2602 2142 } else {
2603 2143 $errors = array();
2604 2144 }
@@ -2615,16 +2155,13 @@
2615 2155 }
2616 2156
2617 2157 /**
2618 2158 * @since 2.2.7
2619 - *
2620 - * @param int|string $form_id
2621 - *
2622 - * @return int
2623 2159 */
2624 2160 public static function just_created_entry( $form_id ) {
2625 2161 global $frm_vars;
2626 - return isset( $frm_vars['created_entries'] ) && isset( $frm_vars['created_entries'][ $form_id ] ) && isset( $frm_vars['created_entries'][ $form_id ]['entry_id'] ) ? $frm_vars['created_entries'][ $form_id ]['entry_id'] : 0; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
2162 +
2163 + return ( isset( $frm_vars['created_entries'] ) && isset( $frm_vars['created_entries'][ $form_id ] ) && isset( $frm_vars['created_entries'][ $form_id ]['entry_id'] ) ) ? $frm_vars['created_entries'][ $form_id ]['entry_id'] : 0;
2627 2164 }
2628 2165
2629 2166 /**
2630 2167 * Gets confirmation method.
@@ -2637,19 +2174,17 @@
2637 2174 *
2638 2175 * @type object $form Form object.
2639 2176 * @type int $entry_id Entry ID.
2640 2177 * }
2641 - *
2642 - * @return array|string
2178 + * @return string|array
2643 2179 */
2644 2180 private static function get_confirmation_method( $atts ) {
2645 2181 $action = FrmOnSubmitHelper::current_event( $atts );
2646 2182 $opt = 'update' === $action ? 'edit_action' : 'success_action';
2647 - $method = ! empty( $atts['form']->options[ $opt ] ) ? $atts['form']->options[ $opt ] : 'message';
2183 + $method = ( isset( $atts['form']->options[ $opt ] ) && ! empty( $atts['form']->options[ $opt ] ) ) ? $atts['form']->options[ $opt ] : 'message';
2648 2184
2649 2185 if ( ! empty( $atts['entry_id'] ) ) {
2650 2186 $met_actions = self::get_met_on_submit_actions( $atts, $action );
2651 -
2652 2187 if ( $met_actions ) {
2653 2188 $method = $met_actions;
2654 2189 }
2655 2190 }
@@ -2655,22 +2190,15 @@
2655 2190 }
2656 2191
2657 2192 $method = apply_filters( 'frm_success_filter', $method, $atts['form'], $action );
2658 2193
2659 - if ( $method !== 'message' && ( ! $atts['entry_id'] || ! is_numeric( $atts['entry_id'] ) ) ) {
2660 - return 'message';
2194 + if ( $method != 'message' && ( ! $atts['entry_id'] || ! is_numeric( $atts['entry_id'] ) ) ) {
2195 + $method = 'message';
2661 2196 }
2662 2197
2663 2198 return $method;
2664 2199 }
2665 2200
2666 - /**
2667 - * @param object $form
2668 - * @param array $params
2669 - * @param array $args
2670 - *
2671 - * @return void
2672 - */
2673 2201 public static function maybe_trigger_redirect( $form, $params, $args ) {
2674 2202 if ( ! isset( $params['id'] ) ) {
2675 2203 global $frm_vars;
2676 2204 $params['id'] = $frm_vars['created_entries'][ $form->id ]['entry_id'];
@@ -2697,12 +2225,14 @@
2697 2225 * @param array $params See {@see FrmFormsController::maybe_trigger_redirect()}.
2698 2226 * @param array $args See {@see FrmFormsController::maybe_trigger_redirect()}.
2699 2227 */
2700 2228 public static function maybe_trigger_redirect_with_action( $conf_method, $form, $params, $args ) {
2701 - if ( is_array( $conf_method ) && 1 === count( $conf_method ) && 'redirect' === FrmOnSubmitHelper::get_action_type( $conf_method[0] ) && empty( $conf_method[0]->post_content['redirect_delay'] ) ) { // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
2702 - $event = FrmOnSubmitHelper::current_event( $params );
2703 - FrmOnSubmitHelper::populate_on_submit_data( $form->options, $conf_method[0], $event );
2704 - $conf_method = 'redirect';
2229 + if ( is_array( $conf_method ) && 1 === count( $conf_method ) ) {
2230 + if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $conf_method[0] ) ) {
2231 + $event = FrmOnSubmitHelper::current_event( $params );
2232 + FrmOnSubmitHelper::populate_on_submit_data( $form->options, $conf_method[0], $event );
2233 + $conf_method = 'redirect';
2234 + }
2705 2235 }
2706 2236
2707 2237 if ( 'redirect' === $conf_method ) {
2708 2238 self::trigger_redirect( $form, $params, $args );
@@ -2708,15 +2238,8 @@
2708 2238 self::trigger_redirect( $form, $params, $args );
2709 2239 }
2710 2240 }
2711 2241
2712 - /**
2713 - * @param object $form
2714 - * @param array $params
2715 - * @param array $args
2716 - *
2717 - * @return void
2718 - */
2719 2242 public static function trigger_redirect( $form, $params, $args ) {
2720 2243 $success_args = array(
2721 2244 'action' => $params['action'],
2722 2245 'conf_method' => 'redirect',
@@ -2754,9 +2277,9 @@
2754 2277 unset( $extra_args['form'] );
2755 2278
2756 2279 do_action( 'frm_success_action', $args['conf_method'], $args['form'], $args['form']->options, $args['entry_id'], $extra_args );
2757 2280
2758 - $opt = ! isset( $args['action'] ) || $args['action'] === 'create' ? 'success' : 'edit';
2281 + $opt = ( ! isset( $args['action'] ) || $args['action'] === 'create' ) ? 'success' : 'edit';
2759 2282
2760 2283 $args['success_opt'] = $opt;
2761 2284 $args['ajax'] = ! empty( $frm_vars['ajax'] );
2762 2285
@@ -2775,9 +2298,8 @@
2775 2298 * @since 6.0
2776 2299 *
2777 2300 * @param array $args See {@see FrmFormsController::run_success_action()}.
2778 2301 * @param string $event Form event. Default is `create`.
2779 - *
2780 2302 * @return array Array of actions that meet the conditional logics.
2781 2303 */
2782 2304 public static function get_met_on_submit_actions( $args, $event = 'create' ) {
2783 2305 if ( ! FrmOnSubmitHelper::form_has_migrated( $args['form'] ) ) {
@@ -2783,16 +2305,16 @@
2783 2305 if ( ! FrmOnSubmitHelper::form_has_migrated( $args['form'] ) ) {
2784 2306 return array();
2785 2307 }
2786 2308
2787 - // If a redirect action has already opened the URL in a new tab, we show the default message in the current tab.
2309 + // If a redirect action has already opened the URL in a new tab, we show the default message in the currect tab.
2788 2310 if ( ! empty( self::$redirected_in_new_tab[ $args['form']->id ] ) ) {
2789 2311 return array( FrmOnSubmitHelper::get_fallback_action_after_open_in_new_tab( $event ) );
2790 2312 }
2791 2313
2792 - $entry = FrmEntry::getOne( $args['entry_id'], true );
2793 - $actions = FrmOnSubmitHelper::get_actions( $args['form']->id );
2794 - $met_actions = array();
2314 + $entry = FrmEntry::getOne( $args['entry_id'], true );
2315 + $actions = FrmOnSubmitHelper::get_actions( $args['form']->id );
2316 + $met_actions = array();
2795 2317 $has_redirect = false;
2796 2318
2797 2319 foreach ( $actions as $action ) {
2798 2320 if ( ! in_array( $event, $action->post_content['event'], true ) ) {
@@ -2804,11 +2326,13 @@
2804 2326 }
2805 2327
2806 2328 $action_type = FrmOnSubmitHelper::get_action_type( $action );
2807 2329
2808 - if ( 'redirect' === $action_type && $has_redirect ) {
2809 - // Do not process because we run the first redirect action only.
2810 - continue;
2330 + if ( 'redirect' === $action_type ) {
2331 + if ( $has_redirect ) {
2332 + // Do not process because we run the first redirect action only.
2333 + continue;
2334 + }
2811 2335 }
2812 2336
2813 2337 if ( ! self::is_valid_on_submit_action( $action, $args, $event ) ) {
2814 2338 continue;
@@ -2833,10 +2357,10 @@
2833 2357 * @param array $args See {@see FrmFormsController::run_success_action()}. `$args['event']` is also added.
2834 2358 */
2835 2359 $met_actions = apply_filters( 'frm_get_met_on_submit_actions', $met_actions, $args );
2836 2360
2837 - if ( ! $met_actions ) {
2838 - return array( FrmOnSubmitHelper::get_fallback_action( $event ) );
2361 + if ( empty( $met_actions ) ) {
2362 + $met_actions = array( FrmOnSubmitHelper::get_fallback_action( $event ) );
2839 2363 }
2840 2364
2841 2365 return $met_actions;
2842 2366 }
@@ -2848,9 +2372,8 @@
2848 2372 *
2849 2373 * @param object $action Form action object.
2850 2374 * @param array $args See {@see FrmFormsController::run_success_action()}.
2851 2375 * @param string $event Form event. Default is `create`.
2852 - *
2853 2376 * @return bool
2854 2377 */
2855 2378 private static function is_valid_on_submit_action( $action, $args, $event = 'create' ) {
2856 2379 $action_type = FrmOnSubmitHelper::get_action_type( $action );
@@ -2872,9 +2395,8 @@
2872 2395 return false;
2873 2396 }
2874 2397
2875 2398 $page = get_post( $action->post_content['success_page_id'] );
2876 -
2877 2399 if ( ! $page || 'trash' === $page->post_status ) {
2878 2400 return false;
2879 2401 }
2880 2402 }
@@ -2896,9 +2418,8 @@
2896 2418 'entry_id' => $args['entry_id'],
2897 2419 'action' => FrmOnSubmitHelper::current_event( $args ),
2898 2420 )
2899 2421 );
2900 -
2901 2422 if ( ! is_array( $args['conf_method'] ) ) {
2902 2423 self::run_success_action( $args );
2903 2424 return;
2904 2425 }
@@ -2925,9 +2446,8 @@
2925 2446 * @param array $args See {@see FrmFormsController::run_success_action()}.
2926 2447 */
2927 2448 public static function run_multi_on_submit_actions( $args ) {
2928 2449 $redirect_action = null;
2929 -
2930 2450 foreach ( $args['conf_method'] as $action ) {
2931 2451 if ( 'redirect' === FrmOnSubmitHelper::get_action_type( $action ) ) {
2932 2452 // We catch the redirect action to run it last.
2933 2453 $redirect_action = $action;
@@ -2938,15 +2458,13 @@
2938 2458
2939 2459 unset( $action );
2940 2460 }
2941 2461
2942 - if ( ! $redirect_action ) {
2943 - return;
2462 + if ( $redirect_action ) {
2463 + // Show script to delay the redirection.
2464 + $args['force_delay_redirect'] = true;
2465 + self::run_single_on_submit_action( $args, $redirect_action );
2944 2466 }
2945 -
2946 - // Show script to delay the redirection.
2947 - $args['force_delay_redirect'] = true;
2948 - self::run_single_on_submit_action( $args, $redirect_action );
2949 2467 }
2950 2468
2951 2469 /**
2952 2470 * Runs single On Submit action.
@@ -2967,9 +2485,8 @@
2967 2485 * @since 6.0
2968 2486 *
2969 2487 * @param array $args See {@see FrmFormsController::run_success_action()}.
2970 2488 * @param object $action On Submit action object.
2971 - *
2972 2489 * @return array
2973 2490 */
2974 2491 private static function get_run_success_action_args( $args, $action ) {
2975 2492 $new_args = $args;
@@ -2975,9 +2492,10 @@
2975 2492 $new_args = $args;
2976 2493
2977 2494 FrmOnSubmitHelper::populate_on_submit_data( $new_args['form']->options, $action, $args['action'] );
2978 2495
2979 - $opt = 'update' === $args['action'] ? 'edit_' : 'success_';
2496 + $opt = 'update' === $args['action'] ? 'edit_' : 'success_';
2497 +
2980 2498 $new_args['conf_method'] = $new_args['form']->options[ $opt . 'action' ];
2981 2499
2982 2500 /**
2983 2501 * Filters the run success action args.
@@ -2992,18 +2510,12 @@
2992 2510 }
2993 2511
2994 2512 /**
2995 2513 * @since 3.0
2996 - *
2997 - * @param array $args
2998 - *
2999 - * @return void
3000 2514 */
3001 2515 private static function load_page_after_submit( $args ) {
3002 2516 global $post;
3003 2517 $opt = $args['success_opt'];
3004 -
3005 - // phpcs:ignore Universal.Operators.StrictComparisons
3006 2518 if ( ! $post || $args['form']->options[ $opt . '_page_id' ] != $post->ID ) {
3007 2519 $page = get_post( $args['form']->options[ $opt . '_page_id' ] );
3008 2520 $old_post = $post;
3009 2521 $post = $page;
@@ -3027,9 +2539,8 @@
3027 2539 }
3028 2540
3029 2541 /**
3030 2542 * @since 3.0
3031 - *
3032 2543 * @param array $args See {@see FrmFormsController::run_success_action()}.
3033 2544 */
3034 2545 private static function redirect_after_submit( $args ) {
3035 2546 add_filter( 'frm_use_wpautop', '__return_false' );
@@ -3043,10 +2554,11 @@
3043 2554 FrmEntriesController::delete_entry_before_redirect( $success_url, $args['form'], $args );
3044 2555
3045 2556 add_filter( 'frm_redirect_url', 'FrmEntriesController::prepare_redirect_url' );
3046 2557 $success_url = apply_filters( 'frm_redirect_url', $success_url, $args['form'], $args );
3047 - $doing_ajax = FrmAppHelper::doing_ajax();
3048 2558
2559 + $doing_ajax = FrmAppHelper::doing_ajax();
2560 +
3049 2561 if ( ! empty( $args['ajax'] ) && $doing_ajax && empty( $args['force_delay_redirect'] ) ) {
3050 2562 // Is AJAX submit and there is just one Redirect action runs.
3051 2563 echo json_encode( self::get_ajax_redirect_response_data( $args + compact( 'success_url' ) ) );
3052 2564 wp_die();
@@ -3051,9 +2563,9 @@
3051 2563 echo json_encode( self::get_ajax_redirect_response_data( $args + compact( 'success_url' ) ) );
3052 2564 wp_die();
3053 2565 }
3054 2566
3055 - if ( ! headers_sent() && empty( $args['force_delay_redirect'] ) && empty( $args['form']->options['redirect_delay'] ) ) {
2567 + if ( ! headers_sent() && empty( $args['force_delay_redirect'] ) ) {
3056 2568 // Not AJAX submit, no headers sent, and there is just one Redirect action runs.
3057 2569 if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3058 2570 self::print_open_in_new_tab_js_with_fallback_handler( $success_url, $args );
3059 2571 self::$redirected_in_new_tab[ $args['form']->id ] = 1;
@@ -3095,51 +2607,31 @@
3095 2607 *
3096 2608 * @since 6.3.1
3097 2609 *
3098 2610 * @param array $args See {@see FrmFormsController::run_success_action()}.
3099 - *
3100 2611 * @return array
3101 2612 */
3102 2613 private static function get_ajax_redirect_response_data( $args ) {
3103 - $response_data = array(
3104 - 'redirect' => $args['success_url'],
3105 - 'content' => '',
3106 - );
3107 - $unset_content = true;
2614 + $response_data = array( 'redirect' => $args['success_url'] );
3108 2615
3109 - if ( ! empty( $args['form']->options['redirect_delay'] ) ) {
3110 - $response_data['delay'] = $args['form']->options['redirect_delay_time'];
3111 - $response_data['content'] .= self::get_redirect_message( $args['success_url'], $args['form']->options['redirect_delay_msg'], $args );
3112 - $unset_content = false;
3113 - }
3114 -
3115 2616 if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3116 2617 $response_data['openInNewTab'] = 1;
3117 2618
3118 - // Only show open in new tab text if there is no delay.
3119 - if ( empty( $response_data['content'] ) ) {
3120 - $args['message'] = FrmOnSubmitHelper::get_default_new_tab_msg();
2619 + $args['message'] = FrmOnSubmitHelper::get_default_new_tab_msg();
3121 2620
3122 - $args['form']->options['success_msg'] = $args['message'];
3123 - $args['form']->options['edit_msg'] = $args['message'];
2621 + $args['form']->options['success_msg'] = $args['message'];
2622 + $args['form']->options['edit_msg'] = $args['message'];
2623 + if ( ! isset( $args['fields'] ) ) {
2624 + $args['fields'] = FrmField::get_all_for_form( $args['form']->id );
2625 + }
3124 2626
3125 - if ( ! isset( $args['fields'] ) ) {
3126 - $args['fields'] = FrmField::get_all_for_form( $args['form']->id );
3127 - }
2627 + $args['message'] = self::prepare_submit_message( $args['form'], $args['entry_id'], $args );
3128 2628
3129 - $args['message'] = self::prepare_submit_message( $args['form'], $args['entry_id'], $args );
2629 + ob_start();
2630 + self::show_lone_success_messsage( $args );
2631 + $response_data['content'] = ob_get_clean();
3130 2632
3131 - ob_start();
3132 - self::show_lone_success_message( $args );
3133 - $response_data['content'] .= ob_get_clean();
3134 - $unset_content = false;
3135 - }//end if
3136 -
3137 2633 $response_data['fallbackMsg'] = self::get_redirect_fallback_message( $args['success_url'], $args );
3138 - }//end if
3139 -
3140 - if ( $unset_content && '' === $response_data['content'] ) {
3141 - unset( $response_data['content'] );
3142 2634 }
3143 2635
3144 2636 return $response_data;
3145 2637 }
@@ -3151,9 +2643,9 @@
3151 2643 *
3152 2644 * @param array $args See {@see FrmFormsController::run_success_action()}.
3153 2645 */
3154 2646 private static function redirect_after_submit_using_js( $args ) {
3155 - $success_msg = $args['form']->options['redirect_delay_msg'];
2647 + $success_msg = FrmOnSubmitHelper::get_default_redirect_msg();
3156 2648 $redirect_msg = self::get_redirect_message( $args['success_url'], $success_msg, $args );
3157 2649 $success_url = esc_url_raw( $args['success_url'] );
3158 2650
3159 2651 /**
@@ -3160,11 +2652,11 @@
3160 2652 * Filters the delay time before redirecting when On Submit Redirect action is delayed.
3161 2653 *
3162 2654 * @since 6.0
3163 2655 *
3164 - * @param int $delay_time Delay time in milliseconds.
2656 + * @param int $delay_time Delay time in miliseconds.
3165 2657 */
3166 - $delay_time = apply_filters( 'frm_redirect_delay_time', 1000 * $args['form']->options['redirect_delay_time'] );
2658 + $delay_time = apply_filters( 'frm_redirect_delay_time', 8000 );
3167 2659
3168 2660 if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3169 2661 $redirect_js = 'window.open("' . $success_url . '", "_blank")';
3170 2662 } else {
@@ -3174,15 +2666,13 @@
3174 2666 add_filter( 'frm_use_wpautop', '__return_true' );
3175 2667
3176 2668 echo FrmAppHelper::maybe_kses( $redirect_msg ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
3177 2669 echo '<script>';
3178 -
3179 2670 if ( empty( $args['doing_ajax'] ) ) {
3180 2671 // Not AJAX submit, delay JS until window.load.
3181 2672 echo 'window.onload=function(){';
3182 2673 }
3183 2674 echo 'setTimeout(function(){' . $redirect_js . '}, ' . intval( $delay_time ) . ');'; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
3184 -
3185 2675 if ( empty( $args['doing_ajax'] ) ) {
3186 2676 echo '};';
3187 2677 }
3188 2678 echo '</script>';
@@ -3195,16 +2685,11 @@
3195 2685 * @param string $success_msg
3196 2686 * @param array $args
3197 2687 */
3198 2688 private static function get_redirect_message( $success_url, $success_msg, $args ) {
3199 - $success_msg = apply_filters( 'frm_content', $success_msg, $args['form'], $args['entry_id'] );
3200 - $success_msg = do_shortcode( FrmAppHelper::use_wpautop( $success_msg ) );
3201 -
3202 - // phpcs:disable Generic.WhiteSpace.ScopeIndent
3203 - $redirect_msg = '<div class="' . esc_attr( FrmFormsHelper::get_form_style_class( $args['form'] ) ) . '"><div class="frm-redirect-msg" role="status">' . $success_msg . '<br/>' . // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
2689 + $redirect_msg = '<div class="' . esc_attr( FrmFormsHelper::get_form_style_class( $args['form'] ) ) . '"><div class="frm-redirect-msg" role="status">' . $success_msg . '<br/>' .
3204 2690 self::get_redirect_fallback_message( $success_url, $args ) .
3205 2691 '</div></div>';
3206 - // phpcs:enable Generic.WhiteSpace.ScopeIndent
3207 2692
3208 2693 $redirect_args = array(
3209 2694 'entry_id' => $args['entry_id'],
3210 2695 'form_id' => $args['form']->id,
@@ -3220,14 +2705,12 @@
3220 2705 * @since 6.3.1
3221 2706 *
3222 2707 * @param string $success_url Redirect URL.
3223 2708 * @param array $args Contains `form` object.
3224 - *
3225 2709 * @return string
3226 2710 */
3227 2711 private static function get_redirect_fallback_message( $success_url, $args ) {
3228 2712 $target = '';
3229 -
3230 2713 if ( ! empty( $args['form']->options['open_in_new_tab'] ) ) {
3231 2714 $target = ' target="_blank"';
3232 2715 }
3233 2716
@@ -3242,12 +2725,8 @@
3242 2725 /**
3243 2726 * Prepare to show the success message and empty form after submit
3244 2727 *
3245 2728 * @since 2.05
3246 - *
3247 - * @param array $atts
3248 - *
3249 - * @return void
3250 2729 */
3251 2730 public static function show_message_after_save( $atts ) {
3252 2731 $atts['message'] = self::prepare_submit_message( $atts['form'], $atts['entry_id'], $atts );
3253 2732
@@ -3253,9 +2732,8 @@
3253 2732
3254 2733 if ( ! isset( $atts['form']->options['show_form'] ) || $atts['form']->options['show_form'] ) {
3255 2734 if ( isset( $atts['action'] ) && 'update' === $atts['action'] && is_callable( array( 'FrmProEntriesController', 'show_front_end_form_with_entry' ) ) ) {
3256 2735 $entry = FrmEntry::getOne( $atts['entry_id'] );
3257 -
3258 2736 if ( $entry ) {
3259 2737 // This is copied from the Pro plugin.
3260 2738 $atts['conf_message'] = FrmProEntriesController::confirmation( 'message', $atts['form'], $atts['form']->options, $entry->id, $atts );
3261 2739 $atts['show_form'] = FrmProEntriesController::is_form_displayed_after_edit( $atts['form'] );
@@ -3264,9 +2742,9 @@
3264 2742 } else {
3265 2743 self::show_form_after_submit( $atts );
3266 2744 }
3267 2745 } else {
3268 - self::show_lone_success_message( $atts );
2746 + self::show_lone_success_messsage( $atts );
3269 2747 }
3270 2748 }
3271 2749
3272 2750 /**
@@ -3272,12 +2750,8 @@
3272 2750 /**
3273 2751 * Show an empty form
3274 2752 *
3275 2753 * @since 2.05
3276 - *
3277 - * @param array $args
3278 - *
3279 - * @return void
3280 2754 */
3281 2755 private static function show_form_after_submit( $args ) {
3282 2756 self::fill_atts_for_form_display( $args );
3283 2757
@@ -3296,11 +2770,12 @@
3296 2770 }
3297 2771 unset( $args );
3298 2772
3299 2773 $include_form_tag = apply_filters( 'frm_include_form_tag', true, $form );
3300 - $frm_settings = FrmAppHelper::get_settings();
3301 - $submit = $form->options['submit_value'] ?? $frm_settings->submit_value;
3302 2774
2775 + $frm_settings = FrmAppHelper::get_settings();
2776 + $submit = isset( $form->options['submit_value'] ) ? $form->options['submit_value'] : $frm_settings->submit_value;
2777 +
3303 2778 global $frm_vars;
3304 2779 self::maybe_load_css( $form, $values['custom_style'], $frm_vars['load_css'] );
3305 2780
3306 2781 $message_placement = self::message_placement( $form, $message );
@@ -3308,36 +2783,27 @@
3308 2783 include FrmAppHelper::plugin_path() . '/classes/views/frm-entries/new.php';
3309 2784 }
3310 2785
3311 2786 /**
3312 - * Gets message placement.
2787 + * @return string - 'before', 'after', or 'submit'
3313 2788 *
3314 2789 * @since 4.05.02
3315 - * @since 6.26 This method changed from `private` to `public`.
3316 - *
3317 - * @param object $form Form object.
3318 - * @param string $message The message.
3319 - *
3320 - * @return string Accepts 'before', 'after', or 'submit'.
3321 2790 */
3322 - public static function message_placement( $form, $message ) {
2791 + private static function message_placement( $form, $message ) {
3323 2792 $place = 'before';
3324 2793
3325 2794 if ( $message && isset( $form->options['form_class'] ) ) {
3326 - if ( str_contains( $form->options['form_class'], 'frm_below_success' ) ) {
2795 + if ( strpos( $form->options['form_class'], 'frm_below_success' ) !== false ) {
3327 2796 $place = 'after';
3328 - } elseif ( str_contains( $form->options['form_class'], 'frm_inline_success' ) ) {
2797 + } elseif ( strpos( $form->options['form_class'], 'frm_inline_success' ) !== false ) {
3329 2798 $place = 'submit';
3330 2799 }
3331 2800 }
3332 2801
3333 2802 /**
3334 - * Filter the message placement.
2803 + * @return string - 'before' or 'after'
3335 2804 *
3336 2805 * @since 4.05.02
3337 - *
3338 - * @param string $place Accepts 'before', 'after', or 'submit'.
3339 - * @param array $args Args.
3340 2806 */
3341 2807 return apply_filters( 'frm_message_placement', $place, compact( 'form', 'message' ) );
3342 2808 }
3343 2809
@@ -3344,12 +2810,8 @@
3344 2810 /**
3345 2811 * Get all the values needed on the new.php entry page
3346 2812 *
3347 2813 * @since 2.05
3348 - *
3349 - * @param array $args
3350 - *
3351 - * @return void
3352 2814 */
3353 2815 private static function fill_atts_for_form_display( &$args ) {
3354 2816 if ( ! isset( $args['title'] ) && isset( $args['show_title'] ) ) {
3355 2817 $args['title'] = $args['show_title'];
@@ -3374,24 +2836,21 @@
3374 2836 /**
3375 2837 * Show the success message without the form
3376 2838 *
3377 2839 * @since 2.05
3378 - *
3379 - * @param array $atts
3380 - *
3381 - * @return void
3382 2840 */
3383 - private static function show_lone_success_message( $atts ) {
2841 + private static function show_lone_success_messsage( $atts ) {
3384 2842 global $frm_vars;
3385 2843 $values = FrmEntriesHelper::setup_new_vars( $atts['fields'], $atts['form'], true );
3386 2844 self::maybe_load_css( $atts['form'], $values['custom_style'], $frm_vars['load_css'] );
3387 2845
3388 2846 $include_extra_container = 'frm_forms' . FrmFormsHelper::get_form_style_class( $values );
3389 - $errors = array();
3390 - $form = $atts['form'];
3391 - $message = $atts['message'];
3392 2847
3393 - include FrmAppHelper::plugin_path() . '/classes/views/frm-entries/errors.php';
2848 + $errors = array();
2849 + $form = $atts['form'];
2850 + $message = $atts['message'];
2851 +
2852 + include( FrmAppHelper::plugin_path() . '/classes/views/frm-entries/errors.php' );
3394 2853 }
3395 2854
3396 2855 /**
3397 2856 * Prepare the success message before it's shown
@@ -3398,20 +2857,19 @@
3398 2857 *
3399 2858 * @since 2.05
3400 2859 * @since 6.0.x Added the third parameter.
3401 2860 *
3402 - * @param object $form Form object.
3403 - * @param int|string $entry_id Entry ID.
3404 - * @param array $args See {@see FrmFormsController::run_success_action()}.
3405 - *
2861 + * @param object $form Form object.
2862 + * @param int $entry_id Entry ID.
2863 + * @param array $args See {@see FrmFormsController::run_success_action()}.
3406 2864 * @return string
3407 2865 */
3408 2866 private static function prepare_submit_message( $form, $entry_id, $args = array() ) {
3409 2867 $frm_settings = FrmAppHelper::get_settings( array( 'current_form' => $form->id ) );
3410 - $opt = $args['success_opt'] ?? 'success';
2868 + $opt = isset( $args['success_opt'] ) ? $args['success_opt'] : 'success';
3411 2869
3412 2870 if ( $entry_id && is_numeric( $entry_id ) ) {
3413 - $message = $form->options[ $opt . '_msg' ] ?? $frm_settings->success_msg;
2871 + $message = isset( $form->options[ $opt . '_msg' ] ) ? $form->options[ $opt . '_msg' ] : $frm_settings->success_msg;
3414 2872 $class = 'frm_message';
3415 2873 } else {
3416 2874 $message = $frm_settings->failed_msg;
3417 2875 $class = FrmFormsHelper::form_error_class();
@@ -3428,9 +2886,9 @@
3428 2886 public static function front_head() {
3429 2887 $version = FrmAppHelper::plugin_version();
3430 2888 $suffix = FrmAppHelper::js_suffix();
3431 2889
3432 - if ( $suffix && self::has_combo_js_file() ) {
2890 + if ( ! empty( $suffix ) && self::has_combo_js_file() ) {
3433 2891 wp_register_script( 'formidable', FrmAppHelper::plugin_url() . '/js/frm.min.js', array( 'jquery' ), $version, true );
3434 2892 } else {
3435 2893 wp_register_script( 'formidable', FrmAppHelper::plugin_url() . "/js/formidable{$suffix}.js", array( 'jquery' ), $version, true );
3436 2894 }
@@ -3437,9 +2895,9 @@
3437 2895
3438 2896 add_filter( 'script_loader_tag', 'FrmFormsController::defer_script_loading', 10, 2 );
3439 2897
3440 2898 if ( FrmAppHelper::is_admin() ) {
3441 - // Don't load this in back-end
2899 + // don't load this in back-end
3442 2900 return;
3443 2901 }
3444 2902
3445 2903 FrmAppHelper::localize_script( 'front' );
@@ -3452,15 +2910,8 @@
3452 2910 public static function has_combo_js_file() {
3453 2911 return is_readable( FrmAppHelper::plugin_path() . '/js/frm.min.js' );
3454 2912 }
3455 2913
3456 - /**
3457 - * @param object $form
3458 - * @param int|string $this_load
3459 - * @param bool $global_load
3460 - *
3461 - * @return void
3462 - */
3463 2914 public static function maybe_load_css( $form, $this_load, $global_load ) {
3464 2915 $load_css = FrmForm::is_form_loaded( $form, $this_load, $global_load );
3465 2916
3466 2917 if ( ! $load_css ) {
@@ -3490,9 +2941,8 @@
3490 2941 return;
3491 2942 }
3492 2943
3493 2944 global $wp_styles;
3494 -
3495 2945 if ( is_array( $wp_styles->queue ) && in_array( 'formidable', $wp_styles->queue, true ) ) {
3496 2946 wp_print_styles( 'formidable' );
3497 2947 }
3498 2948 }
@@ -3507,57 +2957,32 @@
3507 2957 private static function should_load_late() {
3508 2958 return ! function_exists( 'aioseo' );
3509 2959 }
3510 2960
3511 - /**
3512 - * @param string $tag
3513 - * @param string $handle
3514 - *
3515 - * @return string
3516 - */
3517 2961 public static function defer_script_loading( $tag, $handle ) {
3518 - if ( 'captcha-api' === $handle && ! str_contains( $tag, 'defer' ) ) {
3519 - return str_replace( ' src', ' defer="defer" async="async" src', $tag );
2962 + if ( 'captcha-api' == $handle && ! strpos( $tag, 'defer' ) ) {
2963 + $tag = str_replace( ' src', ' defer="defer" async="async" src', $tag );
3520 2964 }
3521 2965
3522 2966 return $tag;
3523 2967 }
3524 2968
3525 - /**
3526 - * @param string $location
3527 - *
3528 - * @return void
3529 - */
3530 2969 public static function footer_js( $location = 'footer' ) {
3531 2970 global $frm_vars;
3532 2971
3533 2972 FrmStylesController::enqueue_css();
3534 2973
3535 - if ( FrmAppHelper::is_admin() || $location === 'header' || empty( $frm_vars['forms_loaded'] ) ) {
3536 - return;
2974 + if ( ! FrmAppHelper::is_admin() && $location != 'header' && ! empty( $frm_vars['forms_loaded'] ) ) {
2975 + // load formidable js
2976 + wp_enqueue_script( 'formidable' );
3537 2977 }
3538 -
3539 - // Load formidable js
3540 - wp_enqueue_script( 'formidable' );
3541 -
3542 - FrmHoneypot::maybe_print_honeypot_js();
3543 -
3544 - if ( ! method_exists( 'FrmProFormsHelper', 'load_currency_js' ) ) {
3545 - // Load currency JS if Pro is not installed.
3546 - FrmFormsHelper::load_currency_js();
3547 - }
3548 2978 }
3549 2979
3550 2980 /**
3551 2981 * @since 2.0.8
3552 - *
3553 - * @param array $atts
3554 - * @param string $content
3555 - *
3556 - * @return void
3557 2982 */
3558 2983 private static function maybe_minimize_form( $atts, &$content ) {
3559 - // Check if minimizing is turned on
2984 + // check if minimizing is turned on
3560 2985 if ( self::is_minification_on( $atts ) ) {
3561 2986 $content = str_replace( array( "\r\n", "\r", "\n", "\t", ' ' ), '', $content );
3562 2987 }
3563 2988 }
@@ -3563,15 +2988,12 @@
3563 2988 }
3564 2989
3565 2990 /**
3566 2991 * @since 2.0.8
3567 - *
3568 - * @param array $atts
3569 - *
3570 - * @return bool
2992 + * @return boolean
3571 2993 */
3572 2994 private static function is_minification_on( $atts ) {
3573 - return ! empty( $atts['minimize'] );
2995 + return isset( $atts['minimize'] ) && ! empty( $atts['minimize'] );
3574 2996 }
3575 2997
3576 2998 /**
3577 2999 * @since 5.0.16
@@ -3579,13 +3001,11 @@
3579 3001 * @return void
3580 3002 */
3581 3003 public static function landing_page_preview_option() {
3582 3004 $dir = apply_filters( 'frm_landing_page_preview_option', false );
3583 -
3584 3005 if ( false === $dir || ! file_exists( $dir . 'landing-page-preview-option.php' ) ) {
3585 3006 $dir = self::get_form_views_path();
3586 3007 }
3587 -
3588 3008 include $dir . 'landing-page-preview-option.php';
3589 3009 }
3590 3010
3591 3011 /**
@@ -3611,15 +3031,13 @@
3611 3031
3612 3032 check_ajax_referer( 'frm_ajax', 'nonce' );
3613 3033
3614 3034 $type = FrmAppHelper::get_post_param( 'type', '', 'sanitize_text_field' );
3615 -
3616 3035 if ( ! $type || ! in_array( $type, array( 'form', 'view' ), true ) ) {
3617 3036 die( 0 );
3618 3037 }
3619 3038
3620 3039 $object_id = FrmAppHelper::get_post_param( 'object_id', '', 'absint' );
3621 -
3622 3040 if ( ! $object_id ) {
3623 3041 die( 0 );
3624 3042 }
3625 3043
@@ -3631,15 +3049,13 @@
3631 3049 $postarr['post_content'] = apply_filters( 'frm_create_page_with_' . $type . '_shortcode_content', '', $object_id );
3632 3050 }
3633 3051
3634 3052 $name = FrmAppHelper::get_post_param( 'name', '', 'sanitize_text_field' );
3635 -
3636 3053 if ( $name ) {
3637 3054 $postarr['post_title'] = $name;
3638 3055 }
3639 3056
3640 3057 $success = wp_insert_post( $postarr );
3641 -
3642 3058 if ( ! is_numeric( $success ) || ! $success ) {
3643 3059 die( 0 );
3644 3060 }
3645 3061
@@ -3653,9 +3069,8 @@
3653 3069 /**
3654 3070 * @since 5.3
3655 3071 *
3656 3072 * @param int $form_id
3657 - *
3658 3073 * @return string
3659 3074 */
3660 3075 private static function get_page_shortcode_content_for_form( $form_id ) {
3661 3076 $shortcode = '[formidable id="' . $form_id . '"]';
@@ -3675,10 +3090,10 @@
3675 3090 }
3676 3091
3677 3092 check_ajax_referer( 'frm_ajax', 'nonce' );
3678 3093
3679 - $html = FrmAppHelper::clip(
3680 - function () {
3094 + $html = FrmAppHelper::clip(
3095 + function() {
3681 3096 FrmAppHelper::maybe_autocomplete_pages_options(
3682 3097 array(
3683 3098 'field_name' => 'frm_page_dropdown',
3684 3099 'page_id' => '',
@@ -3686,12 +3101,13 @@
3686 3101 )
3687 3102 );
3688 3103 }
3689 3104 );
3105 + $post_type_object = get_post_type_object( 'page' );
3690 3106 wp_send_json(
3691 3107 array(
3692 3108 'html' => $html,
3693 - 'edit_page_url' => admin_url( sprintf( get_post_type_object( 'page' )->_edit_link . '&action=edit', 0 ) ),
3109 + 'edit_page_url' => admin_url( sprintf( $post_type_object->_edit_link . '&action=edit', 0 ) ),
3694 3110 )
3695 3111 );
3696 3112 }
3697 3113
@@ -3696,14 +3112,89 @@
3696 3112 }
3697 3113
3698 3114 /**
3699 3115 * @deprecated 4.0
3116 + */
3117 + public static function new_form( $values = array() ) {
3118 + FrmDeprecated::new_form( $values );
3119 + }
3120 +
3121 + /**
3122 + * @deprecated 4.0
3123 + */
3124 + public static function create( $values = array() ) {
3125 + _deprecated_function( __METHOD__, '4.0', 'FrmFormsController::update' );
3126 + self::update( $values );
3127 + }
3128 +
3129 + /**
3130 + * @deprecated 3.0
3131 + * @codeCoverageIgnore
3132 + */
3133 + public static function bulk_create_template( $ids ) {
3134 + return FrmDeprecated::bulk_create_template( $ids );
3135 + }
3136 +
3137 + /**
3138 + * @deprecated 3.0
3139 + * @codeCoverageIgnore
3140 + */
3141 + public static function edit_key() {
3142 + FrmDeprecated::edit_key();
3143 + }
3144 +
3145 + /**
3146 + * @deprecated 3.0
3147 + * @codeCoverageIgnore
3148 + */
3149 + public static function edit_description() {
3150 + FrmDeprecated::edit_description();
3151 + }
3152 +
3153 + /**
3154 + * @deprecated 4.08
3155 + * @since 3.06
3156 + */
3157 + public static function add_new() {
3158 + _deprecated_function( __FUNCTION__, '4.08' );
3159 + }
3160 +
3161 + /**
3162 + * Create a custom template from a form
3700 3163 *
3701 - * @param array $values
3164 + * @since 3.06
3165 + * @deprecated 6.7
3166 + */
3167 + public static function build_template() {
3168 + _deprecated_function( __METHOD__, '6.7' );
3169 + }
3170 +
3171 + /**
3172 + * @deprecated 6.7
3702 3173 *
3174 + * @return bool
3175 + */
3176 + public static function expired() {
3177 + _deprecated_function( __METHOD__, '6.7' );
3178 + return FrmAddonsController::is_license_expired();
3179 + }
3180 +
3181 + /**
3182 + * Get data from api before rendering it so that we can flag the modal as expired
3183 + *
3184 + * @deprecated 6.7
3185 + *
3703 3186 * @return void
3704 3187 */
3705 - public static function create( $values = array() ) {
3706 - _deprecated_function( __METHOD__, '4.0', 'FrmFormsController::update' );
3707 - self::update( $values );
3188 + public static function before_list_templates() {
3189 + _deprecated_function( __METHOD__, '6.7' );
3190 + }
3191 +
3192 + /**
3193 + * @deprecated 6.7
3194 + *
3195 + * @return void
3196 + */
3197 + public static function list_templates() {
3198 + _deprecated_function( __METHOD__, '6.7' );
3708 3199 }
3709 3200 }