PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 5.4
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v5.4
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/models/FrmForm.php +88 -424 6.265.4 View file →
@@ -6,10 +6,9 @@
6 6 class FrmForm {
7 7
8 8 /**
9 9 * @param array $values
10 - *
11 - * @return bool|int id on success or false on failure.
10 + * @return int|boolean id on success or false on failure
12 11 */
13 12 public static function create( $values ) {
14 13 global $wpdb;
15 14
@@ -18,22 +17,22 @@
18 17 $new_values = array(
19 18 'form_key' => FrmAppHelper::get_unique_key( $values['form_key'], $wpdb->prefix . 'frm_forms', 'form_key' ),
20 19 'name' => $values['name'],
21 20 'description' => $values['description'],
22 - 'status' => $values['status'] ?? 'published',
23 - 'logged_in' => $values['logged_in'] ?? 0,
21 + 'status' => isset( $values['status'] ) ? $values['status'] : 'published',
22 + 'logged_in' => isset( $values['logged_in'] ) ? $values['logged_in'] : 0,
24 23 'is_template' => isset( $values['is_template'] ) ? (int) $values['is_template'] : 0,
25 24 'parent_form_id' => isset( $values['parent_form_id'] ) ? absint( $values['parent_form_id'] ) : 0,
26 25 'editable' => isset( $values['editable'] ) ? (int) $values['editable'] : 0,
27 - 'created_at' => $values['created_at'] ?? current_time( 'mysql', 1 ),
26 + 'created_at' => isset( $values['created_at'] ) ? $values['created_at'] : current_time( 'mysql', 1 ),
28 27 );
29 28
30 29 $options = isset( $values['options'] ) ? (array) $values['options'] : array();
31 30 FrmFormsHelper::fill_form_options( $options, $values );
32 31
33 - $options['before_html'] = $values['options']['before_html'] ?? FrmFormsHelper::get_default_html( 'before' );
34 - $options['after_html'] = $values['options']['after_html'] ?? FrmFormsHelper::get_default_html( 'after' );
35 - $options['submit_html'] = $values['options']['submit_html'] ?? FrmFormsHelper::get_default_html( 'submit' );
32 + $options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' );
33 + $options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' );
34 + $options['submit_html'] = isset( $values['options']['submit_html'] ) ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' );
36 35
37 36 /**
38 37 * Allows modifying form options before updating or creating.
39 38 *
@@ -60,9 +59,8 @@
60 59 /**
61 60 * @since 5.0.08
62 61 *
63 62 * @param array $options
64 - *
65 63 * @return array
66 64 */
67 65 private static function maybe_filter_form_options( $options ) {
68 66 if ( ! FrmAppHelper::allow_unfiltered_html() && ! empty( $options['submit_html'] ) ) {
@@ -71,22 +69,14 @@
71 69 return FrmAppHelper::maybe_filter_array( $options, array( 'submit_value', 'success_msg', 'before_html', 'after_html' ) );
72 70 }
73 71
74 72 /**
75 - * Duplicate a form.
76 - *
77 - * @param int $id Form ID to duplicate.
78 - * @param bool $template Whether the duplicated form is a template.
79 - * @param bool $copy_keys Whether to copy the original form key.
80 - * @param false|int $blog_id Blog ID when duplicating across sites, or false for current site.
81 - *
82 - * @return bool|int ID on success or false on failure
73 + * @return int|boolean ID on success or false on failure
83 74 */
84 75 public static function duplicate( $id, $template = false, $copy_keys = false, $blog_id = false ) {
85 76 global $wpdb;
86 77
87 78 $values = self::getOne( $id, $blog_id );
88 -
89 79 if ( ! $values ) {
90 80 return false;
91 81 }
92 82
@@ -103,10 +93,10 @@
103 93 'is_template' => $template ? 1 : 0,
104 94 );
105 95
106 96 if ( $blog_id ) {
107 - $new_values['status'] = 'published';
108 - $new_options = $values->options;
97 + $new_values['status'] = 'published';
98 + $new_options = $values->options;
109 99 FrmAppHelper::unserialize_or_decode( $new_options );
110 100 $new_options['email_to'] = get_option( 'admin_email' );
111 101 $new_options['copy'] = false;
112 102 $new_values['options'] = $new_options;
@@ -135,16 +125,10 @@
135 125
136 126 return false;
137 127 }
138 128
139 - /**
140 - * @param int $form_id
141 - * @param array $values
142 - *
143 - * @return void
144 - */
145 129 public static function after_duplicate( $form_id, $values ) {
146 - $new_opts = $values['options'];
130 + $new_opts = $values['options'];
147 131 FrmAppHelper::unserialize_or_decode( $new_opts );
148 132 $values['options'] = $new_opts;
149 133
150 134 if ( isset( $new_opts['success_msg'] ) ) {
@@ -166,10 +150,8 @@
166 150 *
167 151 * @since 5.3
168 152 *
169 153 * @param int $form_id Form ID.
170 - *
171 - * @return void
172 154 */
173 155 private static function switch_field_ids_in_fields( $form_id ) {
174 156 global $wpdb;
175 157
@@ -175,11 +157,10 @@
175 157
176 158 // Keys of fields that you want to check to replace field ID.
177 159 $keys = array( 'default_value', 'field_options' );
178 160 $sql_cols = 'fi.id';
179 -
180 161 foreach ( $keys as $key ) {
181 - $sql_cols .= ',fi.' . $key;
162 + $sql_cols .= ( ',fi.' . $key );
182 163 }
183 164
184 165 $fields = FrmDb::get_results(
185 166 "{$wpdb->prefix}frm_fields AS fi LEFT OUTER JOIN {$wpdb->prefix}frm_forms AS fr ON fi.form_id = fr.id",
@@ -205,14 +186,11 @@
205 186 *
206 187 * @since 5.3
207 188 *
208 189 * @param array $field Field array.
209 - *
210 - * @return void
211 190 */
212 191 private static function switch_field_ids_in_field( $field ) {
213 192 $new_values = array();
214 -
215 193 foreach ( $field as $key => $value ) {
216 194 if ( 'id' === $key || ! $value ) {
217 195 continue;
218 196 }
@@ -232,9 +210,9 @@
232 210
233 211 if ( $new_val !== $value ) {
234 212 $new_values[ $key ] = $new_val;
235 213 }
236 - }//end foreach
214 + }
237 215
238 216 if ( ! empty( $new_values ) ) {
239 217 FrmField::update( $field['id'], $new_values );
240 218 }
@@ -240,15 +218,9 @@
240 218 }
241 219 }
242 220
243 221 /**
244 - * Update a form.
245 - *
246 - * @param int $id Form ID.
247 - * @param array $values Form values to update.
248 - * @param bool $create_link Whether this is being called from link creation.
249 - *
250 - * @return bool|int
222 + * @return int|boolean
251 223 */
252 224 public static function update( $id, $values, $create_link = false ) {
253 225 global $wpdb;
254 226
@@ -271,15 +243,14 @@
271 243 $new_values[ $value_key ] = $value;
272 244 }
273 245 }
274 246
275 - if ( ! empty( $values['new_status'] ) ) {
247 + if ( isset( $values['new_status'] ) && ! empty( $values['new_status'] ) ) {
276 248 $new_values['status'] = $values['new_status'];
277 249 }
278 250
279 251 if ( ! empty( $new_values ) ) {
280 252 $query_results = $wpdb->update( $wpdb->prefix . 'frm_forms', $new_values, array( 'id' => $id ) );
281 -
282 253 if ( $query_results ) {
283 254 self::clear_form_cache();
284 255 }
285 256 } else {
@@ -298,9 +269,8 @@
298 269 /**
299 270 * @param array $new_values
300 271 * @param array $values
301 272 * @param array $args
302 - *
303 273 * @return array
304 274 */
305 275 public static function set_update_options( $new_values, $values, $args = array() ) {
306 276 if ( ! isset( $values['options'] ) ) {
@@ -306,16 +276,21 @@
306 276 if ( ! isset( $values['options'] ) ) {
307 277 return $new_values;
308 278 }
309 279
310 - $options = ! empty( $values['options'] ) ? (array) $values['options'] : array();
280 + $options = isset( $values['options'] ) ? (array) $values['options'] : array();
311 281 FrmFormsHelper::fill_form_options( $options, $values );
312 282
313 - $options['custom_style'] = $values['options']['custom_style'] ?? 0;
314 - $options['before_html'] = $values['options']['before_html'] ?? FrmFormsHelper::get_default_html( 'before' );
315 - $options['after_html'] = $values['options']['after_html'] ?? FrmFormsHelper::get_default_html( 'after' );
316 - $options['submit_html'] = isset( $values['options']['submit_html'] ) && '' !== $values['options']['submit_html'] ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' );
283 + $options['custom_style'] = isset( $values['options']['custom_style'] ) ? $values['options']['custom_style'] : 0;
284 + $options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' );
285 + $options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' );
286 + $options['submit_html'] = ( isset( $values['options']['submit_html'] ) && '' !== $values['options']['submit_html'] ) ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' );
317 287
288 + if ( ! empty( $options['success_url'] ) && ! empty( $args['form_id'] ) ) {
289 + $options['success_url'] = FrmFormsHelper::maybe_add_sanitize_url_attr( $options['success_url'], (int) $args['form_id'] );
290 + $values['options']['success_url'] = $options['success_url'];
291 + }
292 +
318 293 /**
319 294 * Allows modifying form options before updating or creating.
320 295 *
321 296 * @since 5.4 Added the third param.
@@ -331,11 +306,8 @@
331 306 return $new_values;
332 307 }
333 308
334 309 /**
335 - * @param int $id Form ID.
336 - * @param array $values Form values array.
337 - *
338 310 * @return array
339 311 */
340 312 public static function update_fields( $id, $values ) {
341 313
@@ -343,9 +315,8 @@
343 315 return $values;
344 316 }
345 317
346 318 $all_fields = FrmField::get_all_for_form( $id );
347 -
348 319 if ( empty( $all_fields ) ) {
349 320 return $values;
350 321 }
351 322
@@ -354,9 +325,8 @@
354 325 }
355 326
356 327 $field_array = array();
357 328 $existing_keys = array_keys( $values['item_meta'] );
358 -
359 329 foreach ( $all_fields as $fid ) {
360 330 if ( ! in_array( $fid->id, $existing_keys ) && ( isset( $values['frm_fields_submitted'] ) && in_array( $fid->id, $values['frm_fields_submitted'] ) ) || isset( $values['options'] ) ) {
361 331 $values['item_meta'][ $fid->id ] = '';
362 332 }
@@ -375,9 +345,8 @@
375 345 continue;
376 346 }
377 347
378 348 $is_settings_page = ( isset( $values['options'] ) || isset( $values['field_options'][ 'custom_html_' . $field_id ] ) );
379 -
380 349 if ( $is_settings_page ) {
381 350 self::get_settings_page_html( $values, $field );
382 351
383 352 if ( ! defined( 'WP_IMPORTING' ) ) {
@@ -384,20 +353,15 @@
384 353 continue;
385 354 }
386 355 }
387 356
388 - // Updating the form.
357 + //updating the form
389 358 $update_options = FrmFieldsHelper::get_default_field_options_from_field( $field );
390 - // Don't check for POST html.
391 - unset( $update_options['custom_html'] );
359 + unset( $update_options['custom_html'] ); // don't check for POST html
392 360 $update_options = apply_filters( 'frm_field_options_to_update', $update_options );
393 361
394 - if ( ! is_array( $field->field_options ) ) {
395 - $field->field_options = array();
396 - }
397 -
398 362 foreach ( $update_options as $opt => $default ) {
399 - $field->field_options[ $opt ] = $values['field_options'][ $opt . '_' . $field_id ] ?? $default;
363 + $field->field_options[ $opt ] = isset( $values['field_options'][ $opt . '_' . $field_id ] ) ? $values['field_options'][ $opt . '_' . $field_id ] : $default;
400 364 self::sanitize_field_opt( $opt, $field->field_options[ $opt ] );
401 365 }
402 366
403 367 $field->field_options = apply_filters( 'frm_update_field_options', $field->field_options, $field, $values );
@@ -406,94 +370,32 @@
406 370 'field_options' => $field->field_options,
407 371 'default_value' => isset( $values[ 'default_value_' . $field_id ] ) ? FrmAppHelper::maybe_json_encode( $values[ 'default_value_' . $field_id ] ) : '',
408 372 );
409 373
410 - if ( ! FrmAppHelper::allow_unfiltered_html() && isset( $values['field_options'][ 'options_' . $field_id ] ) && is_array( $values['field_options'][ 'options_' . $field_id ] ) ) {
411 - foreach ( $values['field_options'][ 'options_' . $field_id ] as $option_key => $option ) {
412 - if ( is_array( $option ) ) {
413 - foreach ( $option as $key => $item ) {
414 - $values['field_options'][ 'options_' . $field_id ][ $option_key ][ $key ] = FrmAppHelper::kses( $item, 'all' );
415 - }
416 - }
417 - }
418 - }
419 -
420 374 self::prepare_field_update_values( $field, $values, $new_field );
421 - self::maybe_update_max_option( $field, $values, $new_field );
422 375
423 376 FrmField::update( $field_id, $new_field );
424 377
425 378 FrmField::delete_form_transient( $field->form_id );
426 - }//end foreach
379 + }
427 380 self::clear_form_cache();
428 381
429 382 return $values;
430 383 }
431 384
432 - /**
433 - * Resets the 'max' option of a field when changing paragraph field type to other field types like text, email etc.
434 - *
435 - * @since 6.7
436 - *
437 - * @param array $field
438 - * @param array $values
439 - * @param array $new_field
440 - *
441 - * @return void
442 - */
443 - private static function maybe_update_max_option( $field, $values, &$new_field ) {
444 - if ( $field->type === 'textarea' &&
445 - ! empty( $values['field_options'][ 'type_' . $field->id ] ) &&
446 - in_array( $values['field_options'][ 'type_' . $field->id ], array( 'text', 'email', 'url', 'password', 'phone' ), true ) ) {
447 -
448 - $new_field['field_options']['max'] = '';
449 -
450 - /**
451 - * Update posted field setting so that new 'max' option is displayed after form is saved and page reloads.
452 - * FrmFieldsHelper::fill_default_field_opts populates field options by calling self::get_posted_field_setting.
453 - */
454 - $_POST['field_options'][ 'max_' . $field->id ] = '';
455 - }
456 - }
457 -
458 - /**
459 - * @param string $opt
460 - * @param mixed $value
461 - *
462 - * @return void
463 - */
464 385 private static function sanitize_field_opt( $opt, &$value ) {
465 - if ( ! is_string( $value ) ) {
466 - return;
386 + if ( is_string( $value ) ) {
387 + if ( $opt === 'calc' ) {
388 + $value = self::sanitize_calc( $value );
389 + } else {
390 + $value = FrmAppHelper::kses( $value, 'all' );
391 + }
392 + $value = trim( $value );
467 393 }
468 -
469 - /**
470 - * Allow the option to turn off sanitization for a field. This way a custom rule can be used instead.
471 - * Make sure to add custom sanitization using the frm_update_field_options filter as the data will no longer be sanitized.
472 - *
473 - * @since 6.0
474 - *
475 - * @param bool $should_sanitize
476 - * @param string $opt
477 - */
478 - $should_sanitize = apply_filters( 'frm_should_sanitize_field_opt_string', true, $opt );
479 -
480 - if ( ! $should_sanitize ) {
481 - return;
482 - }
483 -
484 - if ( $opt === 'calc' ) {
485 - $value = self::sanitize_calc( $value );
486 - } else {
487 - $value = FrmAppHelper::kses( $value, 'all' );
488 - }
489 -
490 - $value = trim( $value );
491 394 }
492 395
493 396 /**
494 397 * @param string $value
495 - *
496 398 * @return string
497 399 */
498 400 private static function sanitize_calc( $value ) {
499 401 if ( false !== strpos( $value, '<' ) ) {
@@ -498,10 +400,9 @@
498 400 private static function sanitize_calc( $value ) {
499 401 if ( false !== strpos( $value, '<' ) ) {
500 402 $value = self::normalize_calc_spaces( $value );
501 403 }
502 - // Allow <= and >=.
503 - $allow = array( '<= ', ' >=' );
404 + $allow = array( '<= ', ' >=' ); // Allow <= and >=
504 405 $temp = array( '< = ', ' > =' );
505 406 $value = str_replace( $allow, $temp, $value );
506 407 $value = strip_tags( $value );
507 408 $value = str_replace( $temp, $allow, $value );
@@ -512,44 +413,35 @@
512 413 * Format a comparison like 5<10 to 5 < 10. Also works on 5< 10, 5 <10, 5<=10 variations.
513 414 * This is to avoid an issue with unspaced calculations being recognized as HTML that gets removed when strip_tags is called.
514 415 *
515 416 * @param string $calc
516 - *
517 417 * @return string
518 418 */
519 419 private static function normalize_calc_spaces( $calc ) {
520 420 // Check for a pattern with 5 parts
521 - // $1 \d|\] the first comparison digit or the end of a comparison shortcode.
421 + // $1 \d the first comparison digit.
522 422 // $2 a space (optional).
523 423 // $3 an equals sign (optional) that follows the < operator for <= comparisons.
524 424 // $4 another space (optional).
525 - // $5 \d|\[ the second comparison digit or the start of a comparison shortcode.
526 - $calc = preg_replace( '/(\d|\])( ){0,1}<(=){0,1}( ){0,1}(\d|\[)/', '$1 <$3 $5', $calc );
527 -
528 - return $calc;
425 + // $5 \d the second comparison digit.
426 + return preg_replace( '/(\d)( ){0,1}<(=){0,1}( ){0,1}(\d)/', '$1 <$3 $5', $calc );
529 427 }
530 428
531 429 /**
532 430 * Updating the settings page
533 - *
534 - * @param array $values Form values array.
535 - * @param object $field Field object, passed by reference.
536 - *
537 - * @return void
538 431 */
539 432 private static function get_settings_page_html( $values, &$field ) {
540 433 if ( isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ) {
541 434 $prev_opts = array();
542 - $fallback_html = $field->field_options['custom_html'] ?? FrmFieldsHelper::get_default_html( $field->type );
435 + $fallback_html = isset( $field->field_options['custom_html'] ) ? $field->field_options['custom_html'] : FrmFieldsHelper::get_default_html( $field->type );
543 436
544 - $field->field_options['custom_html'] = $values['field_options'][ 'custom_html_' . $field->id ] ?? $fallback_html;
545 - } elseif ( $field->type === 'hidden' || $field->type === 'user_id' ) {
437 + $field->field_options['custom_html'] = isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ? $values['field_options'][ 'custom_html_' . $field->id ] : $fallback_html;
438 + } elseif ( $field->type == 'hidden' || $field->type == 'user_id' ) {
546 439 $prev_opts = $field->field_options;
547 440 }
548 441
549 442 if ( isset( $prev_opts ) ) {
550 443 $field->field_options = apply_filters( 'frm_update_form_field_options', $field->field_options, $field, $values );
551 -
552 444 if ( $prev_opts != $field->field_options ) {
553 445 FrmField::update( $field->id, array( 'field_options' => $field->field_options ) );
554 446 }
555 447 }
@@ -554,15 +446,8 @@
554 446 }
555 447 }
556 448 }
557 449
558 - /**
559 - * @param object $field
560 - * @param array $values
561 - * @param array $new_field
562 - *
563 - * @return void
564 - */
565 450 private static function prepare_field_update_values( $field, $values, &$new_field ) {
566 451 $field_cols = array(
567 452 'field_order' => 0,
568 453 'field_key' => '',
@@ -571,16 +456,12 @@
571 456 'description' => '',
572 457 'options' => '',
573 458 'name' => '',
574 459 );
575 -
576 460 foreach ( $field_cols as $col => $default ) {
577 - $default = $default === '' ? $field->{$col} : $default;
578 - $new_field[ $col ] = $values['field_options'][ $col . '_' . $field->id ] ?? $default;
579 - }
461 + $default = ( $default === '' ) ? $field->{$col} : $default;
580 462
581 - if ( $field->type === 'submit' && isset( $new_field['field_order'] ) && (int) $new_field['field_order'] === FrmSubmitHelper::DEFAULT_ORDER ) {
582 - $new_field['field_order'] = $field->field_order;
463 + $new_field[ $col ] = isset( $values['field_options'][ $col . '_' . $field->id ] ) ? $values['field_options'][ $col . '_' . $field->id ] : $default;
583 464 }
584 465
585 466 // Don't save the template option.
586 467 if ( is_array( $new_field['options'] ) && isset( $new_field['options']['000'] ) ) {
@@ -592,12 +473,9 @@
592 473 * Get a list of all form settings that should be translated
593 474 * on a multilingual site.
594 475 *
595 476 * @since 3.06.01
596 - *
597 - * @param object $form The form object.
598 - *
599 - * @return array
477 + * @param object $form - The form object
600 478 */
601 479 public static function translatable_strings( $form ) {
602 480 $strings = array(
603 481 'name',
@@ -604,12 +482,8 @@
604 482 'description',
605 483 'submit_value',
606 484 'submit_msg',
607 485 'success_msg',
608 - 'invalid_msg',
609 - 'failed_msg',
610 - 'login_msg',
611 - 'admin_permission',
612 486 );
613 487
614 488 return apply_filters( 'frm_form_strings', $strings, $form );
615 489 }
@@ -614,12 +488,11 @@
614 488 return apply_filters( 'frm_form_strings', $strings, $form );
615 489 }
616 490
617 491 /**
618 - * @param int $id
619 492 * @param string $status
620 493 *
621 - * @return bool|int
494 + * @return int|boolean
622 495 */
623 496 public static function set_status( $id, $status ) {
624 497 if ( 'trash' == $status ) {
625 498 return self::trash( $id );
@@ -625,10 +498,9 @@
625 498 return self::trash( $id );
626 499 }
627 500
628 501 $statuses = array( 'published', 'draft', 'trash' );
629 -
630 - if ( ! in_array( $status, $statuses, true ) ) {
502 + if ( ! in_array( $status, $statuses ) ) {
631 503 return false;
632 504 }
633 505
634 506 global $wpdb;
@@ -655,11 +527,9 @@
655 527 return $query_results;
656 528 }
657 529
658 530 /**
659 - * @param int|string $id Form ID.
660 - *
661 - * @return bool|int
531 + * @return int|boolean
662 532 */
663 533 public static function trash( $id ) {
664 534 if ( ! EMPTY_TRASH_DAYS ) {
665 535 return self::destroy( $id );
@@ -665,17 +535,12 @@
665 535 return self::destroy( $id );
666 536 }
667 537
668 538 $form = self::getOne( $id );
669 -
670 539 if ( ! $form ) {
671 540 return false;
672 541 }
673 542
674 - if ( $form->status === 'trash' ) {
675 - return false;
676 - }
677 -
678 543 $options = $form->options;
679 544 $options['trash_time'] = time();
680 545
681 546 global $wpdb;
@@ -708,26 +573,21 @@
708 573 return $query_results;
709 574 }
710 575
711 576 /**
712 - * @param int|string $id Form ID.
713 - *
714 - * @return bool|int
577 + * @return int|boolean
715 578 */
716 579 public static function destroy( $id ) {
717 580 global $wpdb;
718 581
719 582 $form = self::getOne( $id );
720 -
721 583 if ( ! $form ) {
722 584 return false;
723 585 }
724 -
725 586 $id = $form->id;
726 587
727 588 // Disconnect the entries from this form
728 589 $entries = FrmDb::get_col( $wpdb->prefix . 'frm_items', array( 'form_id' => $id ) );
729 -
730 590 foreach ( $entries as $entry_id ) {
731 591 FrmEntry::destroy( $entry_id );
732 592 unset( $entry_id );
733 593 }
@@ -735,14 +595,10 @@
735 595 // Disconnect the fields from this form
736 596 $wpdb->query( $wpdb->prepare( 'DELETE fi FROM ' . $wpdb->prefix . 'frm_fields AS fi LEFT JOIN ' . $wpdb->prefix . 'frm_forms fr ON (fi.form_id = fr.id) WHERE fi.form_id=%d OR parent_form_id=%d', $id, $id ) );
737 597
738 598 $query_results = $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . $wpdb->prefix . 'frm_forms WHERE id=%d OR parent_form_id=%d', $id, $id ) );
739 -
740 599 if ( $query_results ) {
741 600 // Delete all form actions linked to this form
742 - /**
743 - * @var FrmFormAction
744 - */
745 601 $action_control = FrmFormActionsController::get_form_actions( 'email' );
746 602 $action_control->destroy( $id, 'all' );
747 603
748 604 // Clear form caching
@@ -757,16 +613,14 @@
757 613
758 614 /**
759 615 * Delete trashed forms based on how long they have been trashed
760 616 *
761 - * @param int|string $delete_timestamp Timestamp cutoff for deletion.
762 - *
763 617 * @return int The number of forms deleted
764 618 */
765 619 public static function scheduled_delete( $delete_timestamp = '' ) {
766 620 global $wpdb;
767 621
768 - $trash_forms = FrmDb::get_results( $wpdb->prefix . 'frm_forms', array( 'status' => 'trash' ), 'id, parent_form_id, options' );
622 + $trash_forms = FrmDb::get_results( $wpdb->prefix . 'frm_forms', array( 'status' => 'trash' ), 'id, options' );
769 623
770 624 if ( ! $trash_forms ) {
771 625 return 0;
772 626 }
@@ -775,18 +629,13 @@
775 629 $delete_timestamp = time() - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS );
776 630 }
777 631
778 632 $count = 0;
779 -
780 633 foreach ( $trash_forms as $form ) {
781 634 FrmAppHelper::unserialize_or_decode( $form->options );
782 -
783 635 if ( ! isset( $form->options['trash_time'] ) || $form->options['trash_time'] < $delete_timestamp ) {
784 636 self::destroy( $form->id );
785 -
786 - if ( empty( $form->parent_form_id ) ) {
787 - ++$count;
788 - }
637 + $count ++;
789 638 }
790 639
791 640 unset( $form );
792 641 }
@@ -794,15 +643,12 @@
794 643 return $count;
795 644 }
796 645
797 646 /**
798 - * @param int|string $id Form ID or key.
799 - *
800 647 * @return string form name
801 648 */
802 649 public static function getName( $id ) {
803 650 $form = FrmDb::check_cache( $id, 'frm_form' );
804 -
805 651 if ( $form ) {
806 652 $r = stripslashes( $form->name );
807 653
808 654 return $r;
@@ -809,12 +655,10 @@
809 655 }
810 656
811 657 $query_key = is_numeric( $id ) ? 'id' : 'form_key';
812 658 $r = FrmDb::get_var( 'frm_forms', array( $query_key => $id ), 'name' );
659 + $r = stripslashes( $r );
813 660
814 - // An empty form name can result in a null value.
815 - $r = is_null( $r ) ? '' : stripslashes( $r );
816 -
817 661 return $r;
818 662 }
819 663
820 664 /**
@@ -830,9 +674,9 @@
830 674
831 675 /**
832 676 * @since 3.0
833 677 *
834 - * @param int|string $id
678 + * @param int $id
835 679 *
836 680 * @return string form key
837 681 */
838 682 public static function get_key_by_id( $id ) {
@@ -837,9 +681,8 @@
837 681 */
838 682 public static function get_key_by_id( $id ) {
839 683 $id = (int) $id;
840 684 $cache = FrmDb::check_cache( $id, 'frm_form' );
841 -
842 685 if ( $cache ) {
843 686 return $cache->form_key;
844 687 }
845 688
@@ -850,13 +693,11 @@
850 693
851 694 /**
852 695 * If $form is numeric, get the form object
853 696 *
697 + * @param object|int $form
698 + *
854 699 * @since 2.0.9
855 - *
856 - * @param int|object $form
857 - *
858 - * @return void
859 700 */
860 701 public static function maybe_get_form( &$form ) {
861 702 if ( ! is_object( $form ) && ! is_array( $form ) && ! empty( $form ) ) {
862 703 $form = self::getOne( $form );
@@ -863,28 +704,27 @@
863 704 }
864 705 }
865 706
866 707 /**
867 - * @param int|string $id
868 - * @param false|int $blog_id
869 - *
870 - * @return stdClass|null
708 + * @return object form
871 709 */
872 710 public static function getOne( $id, $blog_id = false ) {
873 711 global $wpdb;
874 712
875 713 if ( $blog_id && is_multisite() ) {
876 - $prefix = $wpdb->get_blog_prefix( $blog_id );
714 + global $wpmuBaseTablePrefix;
715 + $prefix = $wpmuBaseTablePrefix ? $wpmuBaseTablePrefix . $blog_id . '_' : $wpdb->get_blog_prefix( $blog_id );
716 +
877 717 $table_name = $prefix . 'frm_forms';
878 718 } else {
879 719 $table_name = $wpdb->prefix . 'frm_forms';
880 720 $cache = wp_cache_get( $id, 'frm_form' );
881 -
882 721 if ( $cache ) {
883 722 if ( isset( $cache->options ) ) {
884 723 FrmAppHelper::unserialize_or_decode( $cache->options );
885 724 }
886 - return self::prepare_form_row_data( $cache );
725 +
726 + return wp_unslash( $cache );
887 727 }
888 728 }
889 729
890 730 if ( is_numeric( $id ) ) {
@@ -899,49 +739,17 @@
899 739 FrmDb::set_cache( $results->id, $results, 'frm_form' );
900 740 FrmAppHelper::unserialize_or_decode( $results->options );
901 741 }
902 742
903 - return self::prepare_form_row_data( $results );
743 + return apply_filters( 'frm_form_object', wp_unslash( $results ) );
904 744 }
905 745
906 746 /**
907 - * Make sure that if $row is an object, that $row->options is an array and not a string.
908 - *
909 - * @since 6.8.3
910 - *
911 - * @param stdClass|null $row The database row for a target form.
912 - *
913 - * @return stdClass|null
747 + * @return object|array of objects
914 748 */
915 - private static function prepare_form_row_data( $row ) {
916 - $row = wp_unslash( $row );
917 -
918 - if ( ! is_object( $row ) ) {
919 - return $row;
920 - }
921 -
922 - if ( ! is_array( $row->options ) ) {
923 - $row->options = FrmFormsHelper::get_default_opts();
924 - }
925 -
926 - /**
927 - * @since 4.03.02
928 - *
929 - * @param stdClass $row
930 - */
931 - return apply_filters( 'frm_form_object', $row );
932 - }
933 -
934 - /**
935 - * @param array|string $where Where conditions array or raw WHERE string.
936 - * @param string $order_by Order by clause.
937 - * @param int|string $limit Limit clause or number.
938 - *
939 - * @return array|object of objects
940 - */
941 749 public static function getAll( $where = array(), $order_by = '', $limit = '' ) {
942 750 if ( is_array( $where ) && ! empty( $where ) ) {
943 - if ( ! empty( $where['is_template'] ) && ! isset( $where['status'] ) && ! isset( $where['status !'] ) ) {
751 + if ( isset( $where['is_template'] ) && $where['is_template'] && ! isset( $where['status'] ) && ! isset( $where['status !'] ) ) {
944 752 // don't get trashed templates
945 753 $where['status'] = array( null, '', 'published' );
946 754 }
947 755
@@ -948,9 +756,9 @@
948 756 $results = FrmDb::get_results( 'frm_forms', $where, '*', compact( 'order_by', 'limit' ) );
949 757 } else {
950 758 global $wpdb;
951 759
952 - // The query has already been prepared if this is not an array.
760 + // the query has already been prepared if this is not an array
953 761 $query = 'SELECT * FROM ' . $wpdb->prefix . 'frm_forms' . FrmDb::prepend_and_or_where( ' WHERE ', $where ) . FrmDb::esc_order( $order_by ) . FrmDb::esc_limit( $limit );
954 762 $results = $wpdb->get_results( $query ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
955 763 }
956 764
@@ -960,9 +768,9 @@
960 768 FrmAppHelper::unserialize_or_decode( $result->options );
961 769 }
962 770 }
963 771
964 - if ( $limit === ' LIMIT 1' || $limit == 1 ) {
772 + if ( $limit == ' LIMIT 1' || $limit == 1 ) {
965 773 // return the first form object if we are only getting one form
966 774 $results = reset( $results );
967 775 }
968 776
@@ -972,20 +780,14 @@
972 780 /**
973 781 * Get all published forms
974 782 *
975 783 * @since 2.0
976 - *
977 - * @param array $query
978 - * @param int $limit
979 - * @param string $inc_children
980 - *
981 - * @return array|object of forms A single form object would be passed if $limit was set to 1.
784 + * @return array of forms
982 785 */
983 786 public static function get_published_forms( $query = array(), $limit = 999, $inc_children = 'exclude' ) {
984 787 $query['is_template'] = 0;
985 788 $query['status'] = array( null, '', 'published' );
986 -
987 - if ( $inc_children === 'exclude' ) {
789 + if ( $inc_children == 'exclude' ) {
988 790 $query['parent_form_id'] = array( null, 0 );
989 791 }
990 792
991 793 $forms = self::getAll( $query, 'name', $limit );
@@ -1001,14 +803,13 @@
1001 803
1002 804 $cache_key = 'frm_form_counts';
1003 805
1004 806 $counts = wp_cache_get( $cache_key, 'frm_form' );
1005 -
1006 807 if ( false !== $counts ) {
1007 808 return $counts;
1008 809 }
1009 810
1010 - $results = FrmDb::get_results(
811 + $results = (array) FrmDb::get_results(
1011 812 'frm_forms',
1012 813 array(
1013 814 'or' => 1,
1014 815 'parent_form_id' => null,
@@ -1022,18 +823,18 @@
1022 823
1023 824 foreach ( $results as $row ) {
1024 825 if ( 'trash' != $row->status ) {
1025 826 if ( $row->is_template ) {
1026 - ++$counts['template'];
827 + $counts['template'] ++;
1027 828 } else {
1028 - ++$counts['published'];
829 + $counts['published'] ++;
1029 830 }
1030 831 } else {
1031 - ++$counts['trash'];
832 + $counts['trash'] ++;
1032 833 }
1033 834
1034 835 if ( 'draft' == $row->status ) {
1035 - ++$counts['draft'];
836 + $counts['draft'] ++;
1036 837 }
1037 838
1038 839 unset( $row );
1039 840 }
@@ -1049,10 +850,8 @@
1049 850 * Called when a form is created, updated, duplicated, or deleted
1050 851 * or when the form status is changed
1051 852 *
1052 853 * @since 2.0.4
1053 - *
1054 - * @return void
1055 854 */
1056 855 public static function clear_form_cache() {
1057 856 FrmDb::cache_delete_group( 'frm_form' );
1058 857 }
@@ -1057,22 +856,16 @@
1057 856 FrmDb::cache_delete_group( 'frm_form' );
1058 857 }
1059 858
1060 859 /**
1061 - * @param array $values Form values to validate.
1062 - *
1063 860 * @return array of errors
1064 861 */
1065 862 public static function validate( $values ) {
1066 863 $errors = array();
864 +
1067 865 return apply_filters( 'frm_validate_form', $errors, $values );
1068 866 }
1069 867
1070 - /**
1071 - * @param object|null $form
1072 - *
1073 - * @return array
1074 - */
1075 868 public static function get_params( $form = null ) {
1076 869 global $frm_vars;
1077 870
1078 871 if ( ! $form ) {
@@ -1102,17 +895,16 @@
1102 895 );
1103 896
1104 897 $values = array();
1105 898 $values['posted_form_id'] = FrmAppHelper::get_param( 'form_id', '', 'get', 'absint' );
1106 -
1107 899 if ( ! $values['posted_form_id'] ) {
1108 900 $values['posted_form_id'] = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
1109 901 }
1110 902
1111 903 if ( $form->id == $values['posted_form_id'] ) {
1112 - // If there are two forms on the same page, make sure not to submit both.
904 + //if there are two forms on the same page, make sure not to submit both
1113 905 foreach ( $default_values as $var => $default ) {
1114 - if ( $var === 'action' ) {
906 + if ( $var == 'action' ) {
1115 907 $values[ $var ] = FrmAppHelper::get_param( $action_var, $default, 'get', 'sanitize_title' );
1116 908 } else {
1117 909 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
1118 910 }
@@ -1133,11 +925,8 @@
1133 925
1134 926 return $values;
1135 927 }
1136 928
1137 - /**
1138 - * @return array
1139 - */
1140 929 public static function list_page_params() {
1141 930 $values = array();
1142 931 $defaults = array(
1143 932 'template' => 0,
@@ -1147,9 +936,8 @@
1147 936 'search' => '',
1148 937 'sort' => '',
1149 938 'sdir' => '',
1150 939 );
1151 -
1152 940 foreach ( $defaults as $var => $default ) {
1153 941 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
1154 942 }
1155 943
@@ -1155,16 +943,10 @@
1155 943
1156 944 return $values;
1157 945 }
1158 946
1159 - /**
1160 - * @param int|object|string|null $form
1161 - *
1162 - * @return array
1163 - */
1164 947 public static function get_admin_params( $form = null ) {
1165 948 $form_id = $form;
1166 -
1167 949 if ( $form === null ) {
1168 950 $form_id = self::get_current_form_id();
1169 951 } elseif ( $form && is_object( $form ) ) {
1170 952 $form_id = $form->id;
@@ -1182,9 +964,8 @@
1182 964 'sdir' => '',
1183 965 'fid' => '',
1184 966 'keep_post' => '',
1185 967 );
1186 -
1187 968 foreach ( $defaults as $var => $default ) {
1188 969 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
1189 970 }
1190 971
@@ -1190,39 +971,27 @@
1190 971
1191 972 return $values;
1192 973 }
1193 974
1194 - /**
1195 - * @param string $default_form
1196 - *
1197 - * @return int|string
1198 - */
1199 975 public static function get_current_form_id( $default_form = 'none' ) {
1200 - if ( 'first' === $default_form ) {
976 + if ( 'first' == $default_form ) {
1201 977 $form = self::get_current_form();
1202 978 } else {
1203 979 $form = self::maybe_get_current_form();
1204 980 }
1205 -
1206 981 $form_id = $form ? $form->id : 0;
1207 982
1208 983 return $form_id;
1209 984 }
1210 985
1211 - /**
1212 - * @param int|string $form_id
1213 - *
1214 - * @return false|int|object|string
1215 - */
1216 986 public static function maybe_get_current_form( $form_id = 0 ) {
1217 987 global $frm_vars;
1218 988
1219 - if ( ! empty( $frm_vars['current_form'] ) && ( ! $form_id || $form_id == $frm_vars['current_form']->id ) ) {
989 + if ( isset( $frm_vars['current_form'] ) && $frm_vars['current_form'] && ( ! $form_id || $form_id == $frm_vars['current_form']->id ) ) {
1220 990 return $frm_vars['current_form'];
1221 991 }
1222 992
1223 993 $form_id = FrmAppHelper::get_param( 'form', $form_id, 'get', 'absint' );
1224 -
1225 994 if ( $form_id ) {
1226 995 $form_id = self::set_current_form( $form_id );
1227 996 }
1228 997
@@ -1228,16 +997,10 @@
1228 997
1229 998 return $form_id;
1230 999 }
1231 1000
1232 - /**
1233 - * @param int $form_id
1234 - *
1235 - * @return false|object
1236 - */
1237 1001 public static function get_current_form( $form_id = 0 ) {
1238 1002 $form = self::maybe_get_current_form( $form_id );
1239 -
1240 1003 if ( is_numeric( $form ) ) {
1241 1004 $form = self::set_current_form( $form );
1242 1005 }
1243 1006
@@ -1243,18 +1006,12 @@
1243 1006
1244 1007 return $form;
1245 1008 }
1246 1009
1247 - /**
1248 - * @param int $form_id
1249 - *
1250 - * @return false|object
1251 - */
1252 1010 public static function set_current_form( $form_id ) {
1253 1011 global $frm_vars;
1254 1012
1255 1013 $query = array();
1256 -
1257 1014 if ( $form_id ) {
1258 1015 $query['id'] = $form_id;
1259 1016 }
1260 1017
@@ -1262,19 +1019,11 @@
1262 1019
1263 1020 return $frm_vars['current_form'];
1264 1021 }
1265 1022
1266 - /**
1267 - * @param object $form
1268 - * @param int|string $this_load
1269 - * @param bool $global_load
1270 - *
1271 - * @return bool
1272 - */
1273 1023 public static function is_form_loaded( $form, $this_load, $global_load ) {
1274 1024 global $frm_vars;
1275 1025 $small_form = new stdClass();
1276 -
1277 1026 foreach ( array( 'id', 'form_key', 'name' ) as $var ) {
1278 1027 $small_form->{$var} = $form->{$var};
1279 1028 unset( $var );
1280 1029 }
@@ -1285,9 +1034,9 @@
1285 1034 $global_load = true;
1286 1035 $frm_vars['load_css'] = true;
1287 1036 }
1288 1037
1289 - return empty( $frm_vars['css_loaded'] ) && $global_load;
1038 + return ( ( ! isset( $frm_vars['css_loaded'] ) || ! $frm_vars['css_loaded'] ) && $global_load );
1290 1039 }
1291 1040
1292 1041 /**
1293 1042 * @since 4.06.03
@@ -1302,26 +1051,13 @@
1302 1051 } else {
1303 1052 $visible = true;
1304 1053 }
1305 1054
1306 - /**
1307 - * @since 6.25
1308 - *
1309 - * @param bool $visible
1310 - * @param object $form
1311 - */
1312 - $visible = (bool) apply_filters( 'frm_form_is_visible', $visible, $form );
1313 -
1314 1055 return $visible;
1315 1056 }
1316 1057
1317 - /**
1318 - * @param object $form
1319 - *
1320 - * @return bool
1321 - */
1322 1058 public static function show_submit( $form ) {
1323 - $show = ( ! $form->is_template && $form->status === 'published' && ! FrmAppHelper::is_admin() );
1059 + $show = ( ! $form->is_template && $form->status == 'published' && ! FrmAppHelper::is_admin() );
1324 1060 $show = apply_filters( 'frm_show_submit_button', $show, $form );
1325 1061
1326 1062 return $show;
1327 1063 }
@@ -1327,18 +1063,14 @@
1327 1063 }
1328 1064
1329 1065 /**
1330 1066 * @since 2.3
1331 - *
1332 - * @param array $atts Attributes including form, option, and default.
1333 - *
1334 - * @return mixed
1335 1067 */
1336 1068 public static function get_option( $atts ) {
1337 - $form = $atts['form'];
1338 - $default = $atts['default'] ?? '';
1069 + $form = $atts['form'];
1070 + $default = isset( $atts['default'] ) ? $atts['default'] : '';
1339 1071
1340 - return $form->options[ $atts['option'] ] ?? $default;
1072 + return isset( $form->options[ $atts['option'] ] ) ? $form->options[ $atts['option'] ] : $default;
1341 1073 }
1342 1074
1343 1075 /**
1344 1076 * Get the link to edit this form.
@@ -1343,12 +1075,9 @@
1343 1075 /**
1344 1076 * Get the link to edit this form.
1345 1077 *
1346 1078 * @since 4.0
1347 - *
1348 1079 * @param int $form_id The id of the form.
1349 - *
1350 - * @return string
1351 1080 */
1352 1081 public static function get_edit_link( $form_id ) {
1353 1082 return admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . $form_id );
1354 1083 }
@@ -1353,67 +1082,9 @@
1353 1082 return admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . $form_id );
1354 1083 }
1355 1084
1356 1085 /**
1357 - * Check if the "Submit this form with AJAX" setting is toggled on.
1358 - *
1359 - * @since 6.2
1360 - *
1361 - * @param stdClass $form
1362 - *
1363 - * @return bool
1364 - */
1365 - public static function is_ajax_on( $form ) {
1366 - return ! empty( $form->options['ajax_submit'] );
1367 - }
1368 -
1369 - /**
1370 - * Get the latest form available.
1371 - *
1372 - * @since 6.8
1373 - *
1374 - * @return object
1375 - */
1376 - public static function get_latest_form() {
1377 -
1378 - $args = array(
1379 - array(
1380 - 'or' => 1,
1381 - 'parent_form_id' => null,
1382 - 'parent_form_id <' => 1,
1383 - ),
1384 - 'is_template' => 0,
1385 - 'status !' => 'trash',
1386 - );
1387 -
1388 - return self::getAll( $args, 'created_at desc', 1 );
1389 - }
1390 -
1391 - /**
1392 - * Count and return total forms.
1393 - *
1394 - * @since 6.8
1395 - *
1396 - * @return int
1397 - */
1398 - public static function get_forms_count() {
1399 -
1400 - $args = array(
1401 - array(
1402 - 'or' => 1,
1403 - 'parent_form_id' => null,
1404 - 'parent_form_id <' => 1,
1405 - ),
1406 - 'is_template' => 0,
1407 - 'status !' => 'trash',
1408 - );
1409 -
1410 - return FrmDb::get_count( 'frm_forms', $args );
1411 - }
1412 -
1413 - /**
1414 - * @deprecated 2.03.05 This is still referenced in a few add ons (API, locations).
1415 - *
1086 + * @deprecated 3.0
1416 1087 * @codeCoverageIgnore
1417 1088 *
1418 1089 * @param string $key
1419 1090 *
@@ -1419,22 +1090,15 @@
1419 1090 *
1420 1091 * @return int form id
1421 1092 */
1422 1093 public static function getIdByKey( $key ) {
1423 - _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_id_by_key' );
1424 - return self::get_id_by_key( $key );
1094 + return FrmFormDeprecated::getIdByKey( $key );
1425 1095 }
1426 1096
1427 1097 /**
1428 - * @deprecated 2.03.05 This is still referenced in the API add on as of v1.13.
1429 - *
1098 + * @deprecated 3.0
1430 1099 * @codeCoverageIgnore
1431 - *
1432 - * @param int|string $id
1433 - *
1434 - * @return string
1435 1100 */
1436 1101 public static function getKeyById( $id ) {
1437 - _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_key_by_id' );
1438 - return self::get_key_by_id( $id );
1102 + return FrmFormDeprecated::getKeyById( $id );
1439 1103 }
1440 1104 }