PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 6.24
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v6.24
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 +164 -293 6.326.24 View file →
@@ -6,9 +6,8 @@
6 6 class FrmForm {
7 7
8 8 /**
9 9 * @param array $values
10 - *
11 10 * @return bool|int id on success or false on failure.
12 11 */
13 12 public static function create( $values ) {
14 13 global $wpdb;
@@ -16,24 +15,24 @@
16 15 $values = FrmAppHelper::maybe_filter_array( $values, array( 'name', 'description' ) );
17 16
18 17 $new_values = array(
19 18 'form_key' => FrmAppHelper::get_unique_key( $values['form_key'], $wpdb->prefix . 'frm_forms', 'form_key' ),
20 - 'name' => FrmAppHelper::truncate( $values['name'], 255, 1, '', true ),
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,15 +69,8 @@
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 73 * @return bool|int 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;
@@ -84,9 +75,8 @@
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
@@ -126,9 +116,9 @@
126 116
127 117 $form_id = $wpdb->insert_id;
128 118 FrmField::duplicate( $id, $form_id, $copy_keys, $blog_id );
129 119
130 - // Update form settings after fields are created
120 + // update form settings after fields are created
131 121 do_action( 'frm_after_duplicate_form', $form_id, $new_values, array( 'old_id' => $id ) );
132 122
133 123 return $form_id;
134 124 }
@@ -135,14 +125,8 @@
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 130 $new_opts = $values['options'];
147 131 FrmAppHelper::unserialize_or_decode( $new_opts );
148 132 $values['options'] = $new_opts;
@@ -152,9 +136,8 @@
152 136 }
153 137
154 138 $new_opts = apply_filters( 'frm_after_duplicate_form_values', $new_opts, $form_id );
155 139
156 - // phpcs:ignore Universal.Operators.StrictComparisons
157 140 if ( $new_opts != $values['options'] ) {
158 141 global $wpdb;
159 142 $wpdb->update( $wpdb->prefix . 'frm_forms', array( 'options' => maybe_serialize( $new_opts ) ), array( 'id' => $form_id ) );
160 143 }
@@ -167,10 +150,8 @@
167 150 *
168 151 * @since 5.3
169 152 *
170 153 * @param int $form_id Form ID.
171 - *
172 - * @return void
173 154 */
174 155 private static function switch_field_ids_in_fields( $form_id ) {
175 156 global $wpdb;
176 157
@@ -176,9 +157,8 @@
176 157
177 158 // Keys of fields that you want to check to replace field ID.
178 159 $keys = array( 'default_value', 'field_options' );
179 160 $sql_cols = 'fi.id';
180 -
181 161 foreach ( $keys as $key ) {
182 162 $sql_cols .= ',fi.' . $key;
183 163 }
184 164
@@ -206,14 +186,11 @@
206 186 *
207 187 * @since 5.3
208 188 *
209 189 * @param array $field Field array.
210 - *
211 - * @return void
212 190 */
213 191 private static function switch_field_ids_in_field( $field ) {
214 192 $new_values = array();
215 -
216 193 foreach ( $field as $key => $value ) {
217 194 if ( 'id' === $key || ! $value ) {
218 195 continue;
219 196 }
@@ -235,20 +212,14 @@
235 212 $new_values[ $key ] = $new_val;
236 213 }
237 214 }//end foreach
238 215
239 - if ( $new_values ) {
216 + if ( ! empty( $new_values ) ) {
240 217 FrmField::update( $field['id'], $new_values );
241 218 }
242 219 }
243 220
244 221 /**
245 - * Update a form.
246 - *
247 - * @param int $id Form ID.
248 - * @param array $values Form values to update.
249 - * @param bool $create_link Whether this is being called from link creation.
250 - *
251 222 * @return bool|int
252 223 */
253 224 public static function update( $id, $values, $create_link = false ) {
254 225 global $wpdb;
@@ -263,13 +234,14 @@
263 234 $values['form_key'] = FrmAppHelper::get_unique_key( $values['form_key'], $wpdb->prefix . 'frm_forms', 'form_key', $id );
264 235 }
265 236
266 237 $form_fields = array( 'form_key', 'name', 'description', 'status', 'parent_form_id' );
267 - $new_values = self::set_update_options( array(), $values, array( 'form_id' => $id ) );
268 238
239 + $new_values = self::set_update_options( array(), $values, array( 'form_id' => $id ) );
240 +
269 241 foreach ( $values as $value_key => $value ) {
270 - if ( $value_key && in_array( $value_key, $form_fields, true ) ) {
271 - $new_values[ $value_key ] = 'name' === $value_key ? FrmAppHelper::truncate( $value, 255, 1, '', true ) : $value;
242 + if ( $value_key && in_array( $value_key, $form_fields ) ) {
243 + $new_values[ $value_key ] = $value;
272 244 }
273 245 }
274 246
275 247 if ( ! empty( $values['new_status'] ) ) {
@@ -275,11 +247,10 @@
275 247 if ( ! empty( $values['new_status'] ) ) {
276 248 $new_values['status'] = $values['new_status'];
277 249 }
278 250
279 - if ( $new_values ) {
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'] ) ) {
@@ -309,12 +279,12 @@
309 279
310 280 $options = ! empty( $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' ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
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
318 288 /**
319 289 * Allows modifying form options before updating or creating.
320 290 *
@@ -331,14 +301,11 @@
331 301 return $new_values;
332 302 }
333 303
334 304 /**
335 - * @param int $id Form ID.
336 - * @param array $values Form values array.
337 - *
338 305 * @return array
339 306 */
340 - public static function update_fields( $id, $values ) { // phpcs:ignore SlevomatCodingStandard.Complexity.Cognitive.ComplexityTooHigh
307 + public static function update_fields( $id, $values ) {
341 308
342 309 if ( ! isset( $values['item_meta'] ) && ! isset( $values['field_options'] ) ) {
343 310 return $values;
344 311 }
@@ -343,10 +310,9 @@
343 310 return $values;
344 311 }
345 312
346 313 $all_fields = FrmField::get_all_for_form( $id );
347 -
348 - if ( ! $all_fields ) {
314 + if ( empty( $all_fields ) ) {
349 315 return $values;
350 316 }
351 317
352 318 if ( ! isset( $values['item_meta'] ) ) {
@@ -354,28 +320,28 @@
354 320 }
355 321
356 322 $field_array = array();
357 323 $existing_keys = array_keys( $values['item_meta'] );
358 -
359 324 foreach ( $all_fields as $fid ) {
360 - // phpcs:ignore WordPress.PHP.StrictInArray.MissingTrueStrict, SlevomatCodingStandard.Files.LineLength.LineTooLong
361 325 if ( ! in_array( $fid->id, $existing_keys ) && ( isset( $values['frm_fields_submitted'] ) && in_array( $fid->id, $values['frm_fields_submitted'] ) ) || isset( $values['options'] ) ) {
362 326 $values['item_meta'][ $fid->id ] = '';
363 327 }
364 -
365 328 $field_array[ $fid->id ] = $fid;
366 329 }
367 330 unset( $all_fields );
368 331
369 332 foreach ( $values['item_meta'] as $field_id => $default_value ) {
370 - $field = $field_array[ $field_id ] ?? FrmField::getOne( $field_id );
333 + if ( isset( $field_array[ $field_id ] ) ) {
334 + $field = $field_array[ $field_id ];
335 + } else {
336 + $field = FrmField::getOne( $field_id );
337 + }
371 338
372 339 if ( ! $field ) {
373 340 continue;
374 341 }
375 342
376 - $is_settings_page = isset( $values['options'] ) || isset( $values['field_options'][ 'custom_html_' . $field_id ] );
377 -
343 + $is_settings_page = ( isset( $values['options'] ) || isset( $values['field_options'][ 'custom_html_' . $field_id ] ) );
378 344 if ( $is_settings_page ) {
379 345 self::get_settings_page_html( $values, $field );
380 346
381 347 if ( ! defined( 'WP_IMPORTING' ) ) {
@@ -388,14 +354,10 @@
388 354 // Don't check for POST html.
389 355 unset( $update_options['custom_html'] );
390 356 $update_options = apply_filters( 'frm_field_options_to_update', $update_options );
391 357
392 - if ( ! is_array( $field->field_options ) ) {
393 - $field->field_options = array();
394 - }
395 -
396 358 foreach ( $update_options as $opt => $default ) {
397 - $field->field_options[ $opt ] = $values['field_options'][ $opt . '_' . $field_id ] ?? $default;
359 + $field->field_options[ $opt ] = isset( $values['field_options'][ $opt . '_' . $field_id ] ) ? $values['field_options'][ $opt . '_' . $field_id ] : $default;
398 360 self::sanitize_field_opt( $opt, $field->field_options[ $opt ] );
399 361 }
400 362
401 363 $field->field_options = apply_filters( 'frm_update_field_options', $field->field_options, $field, $values );
@@ -404,17 +366,15 @@
404 366 'field_options' => $field->field_options,
405 367 'default_value' => isset( $values[ 'default_value_' . $field_id ] ) ? FrmAppHelper::maybe_json_encode( $values[ 'default_value_' . $field_id ] ) : '',
406 368 );
407 369
408 - if ( ! FrmAppHelper::allow_unfiltered_html() && isset( $values['field_options'][ 'options_' . $field_id ] ) && is_array( $values['field_options'][ 'options_' . $field_id ] ) ) { // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
370 + if ( ! FrmAppHelper::allow_unfiltered_html() && isset( $values['field_options'][ 'options_' . $field_id ] ) && is_array( $values['field_options'][ 'options_' . $field_id ] ) ) {
409 371 foreach ( $values['field_options'][ 'options_' . $field_id ] as $option_key => $option ) {
410 - if ( ! is_array( $option ) ) {
411 - continue;
372 + if ( is_array( $option ) ) {
373 + foreach ( $option as $key => $item ) {
374 + $values['field_options'][ 'options_' . $field_id ][ $option_key ][ $key ] = FrmAppHelper::kses( $item, 'all' );
375 + }
412 376 }
413 -
414 - foreach ( $option as $key => $item ) {
415 - $values['field_options'][ 'options_' . $field_id ][ $option_key ][ $key ] = FrmAppHelper::kses( $item, 'all' );
416 - }
417 377 }
418 378 }
419 379
420 380 self::prepare_field_update_values( $field, $values, $new_field );
@@ -433,34 +393,31 @@
433 393 * Resets the 'max' option of a field when changing paragraph field type to other field types like text, email etc.
434 394 *
435 395 * @since 6.7
436 396 *
437 - * @param object $field
438 - * @param array $values
439 - * @param array $new_field
440 - *
397 + * @param array $field
398 + * @param array $values
399 + * @param array $new_field
441 400 * @return void
442 401 */
443 402 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 - return;
448 - }
403 + if ( $field->type === 'textarea' &&
404 + ! empty( $values['field_options'][ 'type_' . $field->id ] ) &&
405 + in_array( $values['field_options'][ 'type_' . $field->id ], array( 'text', 'email', 'url', 'password', 'phone' ), true ) ) {
449 406
450 - $new_field['field_options']['max'] = '';
407 + $new_field['field_options']['max'] = '';
451 408
452 - /**
453 - * Update posted field setting so that new 'max' option is displayed after form is saved and page reloads.
454 - * FrmFieldsHelper::fill_default_field_opts populates field options by calling self::get_posted_field_setting.
455 - */
456 - $_POST['field_options'][ 'max_' . $field->id ] = '';
409 + /**
410 + * Update posted field setting so that new 'max' option is displayed after form is saved and page reloads.
411 + * FrmFieldsHelper::fill_default_field_opts populates field options by calling self::get_posted_field_setting.
412 + */
413 + $_POST['field_options'][ 'max_' . $field->id ] = '';
414 + }
457 415 }
458 416
459 417 /**
460 418 * @param string $opt
461 419 * @param mixed $value
462 - *
463 420 * @return void
464 421 */
465 422 private static function sanitize_field_opt( $opt, &$value ) {
466 423 if ( ! is_string( $value ) ) {
@@ -481,19 +438,23 @@
481 438 if ( ! $should_sanitize ) {
482 439 return;
483 440 }
484 441
485 - $value = $opt === 'calc' ? self::sanitize_calc( $value ) : FrmAppHelper::kses( $value, 'all' );
442 + if ( $opt === 'calc' ) {
443 + $value = self::sanitize_calc( $value );
444 + } else {
445 + $value = FrmAppHelper::kses( $value, 'all' );
446 + }
447 +
486 448 $value = trim( $value );
487 449 }
488 450
489 451 /**
490 452 * @param string $value
491 - *
492 453 * @return string
493 454 */
494 455 private static function sanitize_calc( $value ) {
495 - if ( str_contains( $value, '<' ) ) {
456 + if ( false !== strpos( $value, '<' ) ) {
496 457 $value = self::normalize_calc_spaces( $value );
497 458 }
498 459 // Allow <= and >=.
499 460 $allow = array( '<= ', ' >=' );
@@ -499,9 +460,10 @@
499 460 $allow = array( '<= ', ' >=' );
500 461 $temp = array( '< = ', ' > =' );
501 462 $value = str_replace( $allow, $temp, $value );
502 463 $value = strip_tags( $value );
503 - return str_replace( $temp, $allow, $value );
464 + $value = str_replace( $temp, $allow, $value );
465 + return $value;
504 466 }
505 467
506 468 /**
507 469 * Format a comparison like 5<10 to 5 < 10. Also works on 5< 10, 5 <10, 5<=10 variations.
@@ -507,9 +469,8 @@
507 469 * Format a comparison like 5<10 to 5 < 10. Also works on 5< 10, 5 <10, 5<=10 variations.
508 470 * This is to avoid an issue with unspaced calculations being recognized as HTML that gets removed when strip_tags is called.
509 471 *
510 472 * @param string $calc
511 - *
512 473 * @return string
513 474 */
514 475 private static function normalize_calc_spaces( $calc ) {
515 476 // Check for a pattern with 5 parts
@@ -517,48 +478,34 @@
517 478 // $2 a space (optional).
518 479 // $3 an equals sign (optional) that follows the < operator for <= comparisons.
519 480 // $4 another space (optional).
520 481 // $5 \d|\[ the second comparison digit or the start of a comparison shortcode.
521 - return preg_replace( '/(\d|\])( ){0,1}<(=){0,1}( ){0,1}(\d|\[)/', '$1 <$3 $5', $calc );
482 + $calc = preg_replace( '/(\d|\])( ){0,1}<(=){0,1}( ){0,1}(\d|\[)/', '$1 <$3 $5', $calc );
483 +
484 + return $calc;
522 485 }
523 486
524 487 /**
525 488 * Updating the settings page
526 - *
527 - * @param array $values Form values array.
528 - * @param object $field Field object, passed by reference.
529 - *
530 - * @return void
531 489 */
532 490 private static function get_settings_page_html( $values, &$field ) {
533 491 if ( isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ) {
534 492 $prev_opts = array();
535 - $fallback_html = $field->field_options['custom_html'] ?? FrmFieldsHelper::get_default_html( $field->type );
493 + $fallback_html = isset( $field->field_options['custom_html'] ) ? $field->field_options['custom_html'] : FrmFieldsHelper::get_default_html( $field->type );
536 494
537 - $field->field_options['custom_html'] = $values['field_options'][ 'custom_html_' . $field->id ] ?? $fallback_html;
495 + $field->field_options['custom_html'] = isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ? $values['field_options'][ 'custom_html_' . $field->id ] : $fallback_html;
538 496 } elseif ( $field->type === 'hidden' || $field->type === 'user_id' ) {
539 497 $prev_opts = $field->field_options;
540 498 }
541 499
542 - if ( ! isset( $prev_opts ) ) {
543 - return;
500 + if ( isset( $prev_opts ) ) {
501 + $field->field_options = apply_filters( 'frm_update_form_field_options', $field->field_options, $field, $values );
502 + if ( $prev_opts != $field->field_options ) {
503 + FrmField::update( $field->id, array( 'field_options' => $field->field_options ) );
504 + }
544 505 }
545 -
546 - $field->field_options = apply_filters( 'frm_update_form_field_options', $field->field_options, $field, $values );
547 -
548 - // phpcs:ignore Universal.Operators.StrictComparisons
549 - if ( $prev_opts != $field->field_options ) {
550 - FrmField::update( $field->id, array( 'field_options' => $field->field_options ) );
551 - }
552 506 }
553 507
554 - /**
555 - * @param object $field
556 - * @param array $values
557 - * @param array $new_field
558 - *
559 - * @return void
560 - */
561 508 private static function prepare_field_update_values( $field, $values, &$new_field ) {
562 509 $field_cols = array(
563 510 'field_order' => 0,
564 511 'field_key' => '',
@@ -567,12 +514,11 @@
567 514 'description' => '',
568 515 'options' => '',
569 516 'name' => '',
570 517 );
571 -
572 518 foreach ( $field_cols as $col => $default ) {
573 519 $default = $default === '' ? $field->{$col} : $default;
574 - $new_field[ $col ] = $values['field_options'][ $col . '_' . $field->id ] ?? $default;
520 + $new_field[ $col ] = isset( $values['field_options'][ $col . '_' . $field->id ] ) ? $values['field_options'][ $col . '_' . $field->id ] : $default;
575 521 }
576 522
577 523 if ( $field->type === 'submit' && isset( $new_field['field_order'] ) && (int) $new_field['field_order'] === FrmSubmitHelper::DEFAULT_ORDER ) {
578 524 $new_field['field_order'] = $field->field_order;
@@ -588,12 +534,9 @@
588 534 * Get a list of all form settings that should be translated
589 535 * on a multilingual site.
590 536 *
591 537 * @since 3.06.01
592 - *
593 538 * @param object $form The form object.
594 - *
595 - * @return array
596 539 */
597 540 public static function translatable_strings( $form ) {
598 541 $strings = array(
599 542 'name',
@@ -610,20 +553,19 @@
610 553 return apply_filters( 'frm_form_strings', $strings, $form );
611 554 }
612 555
613 556 /**
614 - * @param array|int $id
615 - * @param string $status
557 + * @param int $id
558 + * @param string $status
616 559 *
617 560 * @return bool|int
618 561 */
619 562 public static function set_status( $id, $status ) {
620 - if ( 'trash' === $status ) {
563 + if ( 'trash' == $status ) {
621 564 return self::trash( $id );
622 565 }
623 566
624 567 $statuses = array( 'published', 'draft', 'trash' );
625 -
626 568 if ( ! in_array( $status, $statuses, true ) ) {
627 569 return false;
628 570 }
629 571
@@ -637,9 +579,9 @@
637 579 );
638 580 FrmDb::get_where_clause_and_values( $where );
639 581 array_unshift( $where['values'], $status );
640 582
641 - $query_results = $wpdb->query( $wpdb->prepare( 'UPDATE ' . $wpdb->prefix . 'frm_forms SET status = %s ' . $where['where'], $where['values'] ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared, SlevomatCodingStandard.Files.LineLength.LineTooLong
583 + $query_results = $wpdb->query( $wpdb->prepare( 'UPDATE ' . $wpdb->prefix . 'frm_forms SET status = %s ' . $where['where'], $where['values'] ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
642 584 } else {
643 585 $query_results = $wpdb->update( $wpdb->prefix . 'frm_forms', array( 'status' => $status ), array( 'id' => $id ) );
644 586 $wpdb->update( $wpdb->prefix . 'frm_forms', array( 'status' => $status ), array( 'parent_form_id' => $id ) );
645 587 }
@@ -651,10 +593,8 @@
651 593 return $query_results;
652 594 }
653 595
654 596 /**
655 - * @param int|string $id Form ID.
656 - *
657 597 * @return bool|int
658 598 */
659 599 public static function trash( $id ) {
660 600 if ( ! EMPTY_TRASH_DAYS ) {
@@ -661,9 +601,8 @@
661 601 return self::destroy( $id );
662 602 }
663 603
664 604 $form = self::getOne( $id );
665 -
666 605 if ( ! $form ) {
667 606 return false;
668 607 }
669 608
@@ -704,10 +643,8 @@
704 643 return $query_results;
705 644 }
706 645
707 646 /**
708 - * @param int|string $id Form ID.
709 - *
710 647 * @return bool|int
711 648 */
712 649 public static function destroy( $id ) {
713 650 global $wpdb;
@@ -712,18 +649,15 @@
712 649 public static function destroy( $id ) {
713 650 global $wpdb;
714 651
715 652 $form = self::getOne( $id );
716 -
717 653 if ( ! $form ) {
718 654 return false;
719 655 }
720 -
721 656 $id = $form->id;
722 657
723 658 // Disconnect the entries from this form
724 - $entries = FrmDb::get_col( 'frm_items', array( 'form_id' => $id ) );
725 -
659 + $entries = FrmDb::get_col( $wpdb->prefix . 'frm_items', array( 'form_id' => $id ) );
726 660 foreach ( $entries as $entry_id ) {
727 661 FrmEntry::destroy( $entry_id );
728 662 unset( $entry_id );
729 663 }
@@ -728,29 +662,26 @@
728 662 unset( $entry_id );
729 663 }
730 664
731 665 // Disconnect the fields from this form
732 - $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 ) ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
666 + $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 ) );
733 667
734 668 $query_results = $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . $wpdb->prefix . 'frm_forms WHERE id=%d OR parent_form_id=%d', $id, $id ) );
669 + if ( $query_results ) {
670 + // Delete all form actions linked to this form
671 + /**
672 + * @var FrmFormAction
673 + */
674 + $action_control = FrmFormActionsController::get_form_actions( 'email' );
675 + $action_control->destroy( $id, 'all' );
735 676
736 - if ( ! $query_results ) {
737 - return $query_results;
677 + // Clear form caching
678 + self::clear_form_cache();
679 +
680 + do_action( 'frm_destroy_form', $id );
681 + do_action( 'frm_destroy_form_' . $id );
738 682 }
739 683
740 - // Delete all form actions linked to this form
741 - /**
742 - * @var FrmFormAction
743 - */
744 - $action_control = FrmFormActionsController::get_form_actions( 'email' );
745 - $action_control->destroy( $id, 'all' );
746 -
747 - // Clear form caching
748 - self::clear_form_cache();
749 -
750 - do_action( 'frm_destroy_form', $id );
751 - do_action( 'frm_destroy_form_' . $id );
752 -
753 684 return $query_results;
754 685 }
755 686
756 687 /**
@@ -755,31 +686,28 @@
755 686
756 687 /**
757 688 * Delete trashed forms based on how long they have been trashed
758 689 *
759 - * @param int|string $delete_timestamp Timestamp cutoff for deletion.
760 - *
761 690 * @return int The number of forms deleted
762 691 */
763 692 public static function scheduled_delete( $delete_timestamp = '' ) {
764 - $trash_forms = FrmDb::get_results( 'frm_forms', array( 'status' => 'trash' ), 'id, parent_form_id, options' );
693 + global $wpdb;
765 694
695 + $trash_forms = FrmDb::get_results( $wpdb->prefix . 'frm_forms', array( 'status' => 'trash' ), 'id, parent_form_id, options' );
696 +
766 697 if ( ! $trash_forms ) {
767 698 return 0;
768 699 }
769 700
770 - if ( ! $delete_timestamp ) {
701 + if ( empty( $delete_timestamp ) ) {
771 702 $delete_timestamp = time() - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS );
772 703 }
773 704
774 705 $count = 0;
775 -
776 706 foreach ( $trash_forms as $form ) {
777 707 FrmAppHelper::unserialize_or_decode( $form->options );
778 -
779 708 if ( ! isset( $form->options['trash_time'] ) || $form->options['trash_time'] < $delete_timestamp ) {
780 709 self::destroy( $form->id );
781 -
782 710 if ( empty( $form->parent_form_id ) ) {
783 711 ++$count;
784 712 }
785 713 }
@@ -790,17 +718,16 @@
790 718 return $count;
791 719 }
792 720
793 721 /**
794 - * @param int|string $id Form ID or key.
795 - *
796 722 * @return string form name
797 723 */
798 724 public static function getName( $id ) {
799 725 $form = FrmDb::check_cache( $id, 'frm_form' );
726 + if ( $form ) {
727 + $r = stripslashes( $form->name );
800 728
801 - if ( $form ) {
802 - return stripslashes( $form->name );
729 + return $r;
803 730 }
804 731
805 732 $query_key = is_numeric( $id ) ? 'id' : 'form_key';
806 733 $r = FrmDb::get_var( 'frm_forms', array( $query_key => $id ), 'name' );
@@ -805,9 +732,11 @@
805 732 $query_key = is_numeric( $id ) ? 'id' : 'form_key';
806 733 $r = FrmDb::get_var( 'frm_forms', array( $query_key => $id ), 'name' );
807 734
808 735 // An empty form name can result in a null value.
809 - return is_null( $r ) ? '' : stripslashes( $r );
736 + $r = is_null( $r ) ? '' : stripslashes( $r );
737 +
738 + return $r;
810 739 }
811 740
812 741 /**
813 742 * @since 3.0
@@ -822,9 +751,9 @@
822 751
823 752 /**
824 753 * @since 3.0
825 754 *
826 - * @param int|string $id
755 + * @param int $id
827 756 *
828 757 * @return string form key
829 758 */
830 759 public static function get_key_by_id( $id ) {
@@ -829,14 +758,15 @@
829 758 */
830 759 public static function get_key_by_id( $id ) {
831 760 $id = (int) $id;
832 761 $cache = FrmDb::check_cache( $id, 'frm_form' );
833 -
834 762 if ( $cache ) {
835 763 return $cache->form_key;
836 764 }
837 765
838 - return FrmDb::get_var( 'frm_forms', array( 'id' => $id ), 'form_key' );
766 + $key = FrmDb::get_var( 'frm_forms', array( 'id' => $id ), 'form_key' );
767 +
768 + return $key;
839 769 }
840 770
841 771 /**
842 772 * If $form is numeric, get the form object
@@ -841,15 +771,12 @@
841 771 /**
842 772 * If $form is numeric, get the form object
843 773 *
844 774 * @since 2.0.9
845 - *
846 - * @param array|int|object $form
847 - *
848 - * @return void
775 + * @param int|object $form
849 776 */
850 777 public static function maybe_get_form( &$form ) {
851 - if ( ! is_object( $form ) && ! is_array( $form ) && $form ) {
778 + if ( ! is_object( $form ) && ! is_array( $form ) && ! empty( $form ) ) {
852 779 $form = self::getOne( $form );
853 780 }
854 781 }
855 782
@@ -855,9 +782,8 @@
855 782
856 783 /**
857 784 * @param int|string $id
858 785 * @param false|int $blog_id
859 - *
860 786 * @return stdClass|null
861 787 */
862 788 public static function getOne( $id, $blog_id = false ) {
863 789 global $wpdb;
@@ -862,24 +788,29 @@
862 788 public static function getOne( $id, $blog_id = false ) {
863 789 global $wpdb;
864 790
865 791 if ( $blog_id && is_multisite() ) {
866 - $prefix = $wpdb->get_blog_prefix( $blog_id );
792 + global $wpmuBaseTablePrefix;
793 + $prefix = $wpmuBaseTablePrefix ? $wpmuBaseTablePrefix . $blog_id . '_' : $wpdb->get_blog_prefix( $blog_id );
794 +
867 795 $table_name = $prefix . 'frm_forms';
868 796 } else {
869 797 $table_name = $wpdb->prefix . 'frm_forms';
870 798 $cache = wp_cache_get( $id, 'frm_form' );
871 -
872 799 if ( $cache ) {
873 800 if ( isset( $cache->options ) ) {
874 801 FrmAppHelper::unserialize_or_decode( $cache->options );
875 802 }
876 -
877 803 return self::prepare_form_row_data( $cache );
878 804 }
879 805 }
880 806
881 - $where = is_numeric( $id ) ? array( 'id' => $id ) : array( 'form_key' => $id );
807 + if ( is_numeric( $id ) ) {
808 + $where = array( 'id' => $id );
809 + } else {
810 + $where = array( 'form_key' => $id );
811 + }
812 +
882 813 $results = FrmDb::get_row( $table_name, $where );
883 814
884 815 if ( isset( $results->options ) ) {
885 816 FrmDb::set_cache( $results->id, $results, 'frm_form' );
@@ -894,14 +825,12 @@
894 825 *
895 826 * @since 6.8.3
896 827 *
897 828 * @param stdClass|null $row The database row for a target form.
898 - *
899 829 * @return stdClass|null
900 830 */
901 831 private static function prepare_form_row_data( $row ) {
902 832 $row = wp_unslash( $row );
903 -
904 833 if ( ! is_object( $row ) ) {
905 834 return $row;
906 835 }
907 836
@@ -917,18 +846,14 @@
917 846 return apply_filters( 'frm_form_object', $row );
918 847 }
919 848
920 849 /**
921 - * @param array|string $where Where conditions array or raw WHERE string.
922 - * @param string $order_by Order by clause.
923 - * @param int|string $limit Limit clause or number.
924 - *
925 - * @return array|object Array of objects. If $limit is 1, a single object is returned.
850 + * @return array|object of objects
926 851 */
927 852 public static function getAll( $where = array(), $order_by = '', $limit = '' ) {
928 - if ( is_array( $where ) && $where ) {
853 + if ( is_array( $where ) && ! empty( $where ) ) {
929 854 if ( ! empty( $where['is_template'] ) && ! isset( $where['status'] ) && ! isset( $where['status !'] ) ) {
930 - // Don't get trashed templates
855 + // don't get trashed templates
931 856 $where['status'] = array( null, '', 'published' );
932 857 }
933 858
934 859 $results = FrmDb::get_results( 'frm_forms', $where, '*', compact( 'order_by', 'limit' ) );
@@ -935,9 +860,9 @@
935 860 } else {
936 861 global $wpdb;
937 862
938 863 // The query has already been prepared if this is not an array.
939 - $query = 'SELECT * FROM ' . $wpdb->prefix . 'frm_forms' . FrmDb::prepend_and_or_where( ' WHERE ', $where ) . FrmDb::esc_order( $order_by ) . FrmDb::esc_limit( $limit ); // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
864 + $query = 'SELECT * FROM ' . $wpdb->prefix . 'frm_forms' . FrmDb::prepend_and_or_where( ' WHERE ', $where ) . FrmDb::esc_order( $order_by ) . FrmDb::esc_limit( $limit );
940 865 $results = $wpdb->get_results( $query ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
941 866 }
942 867
943 868 if ( $results ) {
@@ -946,10 +871,10 @@
946 871 FrmAppHelper::unserialize_or_decode( $result->options );
947 872 }
948 873 }
949 874
950 - if ( $limit === ' LIMIT 1' || (int) $limit === 1 ) {
951 - // Return the first form object if we are only getting one form
875 + if ( $limit === ' LIMIT 1' || $limit == 1 ) {
876 + // return the first form object if we are only getting one form
952 877 $results = reset( $results );
953 878 }
954 879
955 880 return wp_unslash( $results );
@@ -962,20 +887,20 @@
962 887 *
963 888 * @param array $query
964 889 * @param int $limit
965 890 * @param string $inc_children
966 - *
967 - * @return array|object Array of forms. A single form object is returned if $limit is set to 1.
891 + * @return array|object of forms A single form object would be passed if $limit was set to 1.
968 892 */
969 893 public static function get_published_forms( $query = array(), $limit = 999, $inc_children = 'exclude' ) {
970 894 $query['is_template'] = 0;
971 895 $query['status'] = array( null, '', 'published' );
972 -
973 896 if ( $inc_children === 'exclude' ) {
974 897 $query['parent_form_id'] = array( null, 0 );
975 898 }
976 899
977 - return self::getAll( $query, 'name', $limit );
900 + $forms = self::getAll( $query, 'name', $limit );
901 +
902 + return $forms;
978 903 }
979 904
980 905 /**
981 906 * @return object count of forms
@@ -980,16 +905,18 @@
980 905 /**
981 906 * @return object count of forms
982 907 */
983 908 public static function get_count() {
909 + global $wpdb;
910 +
984 911 $cache_key = 'frm_form_counts';
985 - $counts = wp_cache_get( $cache_key, 'frm_form' );
986 912
913 + $counts = wp_cache_get( $cache_key, 'frm_form' );
987 914 if ( false !== $counts ) {
988 915 return $counts;
989 916 }
990 917
991 - $results = FrmDb::get_results(
918 + $results = (array) FrmDb::get_results(
992 919 'frm_forms',
993 920 array(
994 921 'or' => 1,
995 922 'parent_form_id' => null,
@@ -1001,17 +928,19 @@
1001 928 $statuses = array( 'published', 'draft', 'template', 'trash' );
1002 929 $counts = array_fill_keys( $statuses, 0 );
1003 930
1004 931 foreach ( $results as $row ) {
1005 - if ( 'trash' === $row->status ) {
932 + if ( 'trash' != $row->status ) {
933 + if ( $row->is_template ) {
934 + ++$counts['template'];
935 + } else {
936 + ++$counts['published'];
937 + }
938 + } else {
1006 939 ++$counts['trash'];
1007 - } elseif ( $row->is_template ) {
1008 - ++$counts['template'];
1009 - } else {
1010 - ++$counts['published'];
1011 940 }
1012 941
1013 - if ( 'draft' === $row->status ) {
942 + if ( 'draft' == $row->status ) {
1014 943 ++$counts['draft'];
1015 944 }
1016 945
1017 946 unset( $row );
@@ -1028,10 +957,8 @@
1028 957 * Called when a form is created, updated, duplicated, or deleted
1029 958 * or when the form status is changed
1030 959 *
1031 960 * @since 2.0.4
1032 - *
1033 - * @return void
1034 961 */
1035 962 public static function clear_form_cache() {
1036 963 FrmDb::cache_delete_group( 'frm_form' );
1037 964 }
@@ -1036,29 +963,23 @@
1036 963 FrmDb::cache_delete_group( 'frm_form' );
1037 964 }
1038 965
1039 966 /**
1040 - * @param array $values Form values to validate.
1041 - *
1042 967 * @return array of errors
1043 968 */
1044 969 public static function validate( $values ) {
1045 970 $errors = array();
971 +
1046 972 return apply_filters( 'frm_validate_form', $errors, $values );
1047 973 }
1048 974
1049 - /**
1050 - * @param object|null $form
1051 - *
1052 - * @return array
1053 - */
1054 975 public static function get_params( $form = null ) {
1055 976 global $frm_vars;
1056 977
1057 - if ( $form ) {
978 + if ( ! $form ) {
979 + $form = self::getAll( array(), 'name', 1 );
980 + } else {
1058 981 self::maybe_get_form( $form );
1059 - } else {
1060 - $form = self::getAll( array(), 'name', 1 );
1061 982 }
1062 983
1063 984 if ( isset( $frm_vars['form_params'] ) && is_array( $frm_vars['form_params'] ) && isset( $frm_vars['form_params'][ $form->id ] ) ) {
1064 985 return $frm_vars['form_params'][ $form->id ];
@@ -1081,14 +1002,12 @@
1081 1002 );
1082 1003
1083 1004 $values = array();
1084 1005 $values['posted_form_id'] = FrmAppHelper::get_param( 'form_id', '', 'get', 'absint' );
1085 -
1086 1006 if ( ! $values['posted_form_id'] ) {
1087 1007 $values['posted_form_id'] = FrmAppHelper::get_param( 'form', '', 'get', 'absint' );
1088 1008 }
1089 1009
1090 - // phpcs:ignore Universal.Operators.StrictComparisons
1091 1010 if ( $form->id == $values['posted_form_id'] ) {
1092 1011 // If there are two forms on the same page, make sure not to submit both.
1093 1012 foreach ( $default_values as $var => $default ) {
1094 1013 if ( $var === 'action' ) {
@@ -1104,9 +1023,9 @@
1104 1023 unset( $var, $default );
1105 1024 }
1106 1025 }
1107 1026
1108 - if ( in_array( $values['action'], array( 'create', 'update' ), true ) &&
1027 + if ( in_array( $values['action'], array( 'create', 'update' ) ) &&
1109 1028 ( ! $_POST || ( ! isset( $_POST['action'] ) && ! isset( $_POST['frm_action'] ) ) ) // phpcs:ignore WordPress.Security.NonceVerification.Missing
1110 1029 ) {
1111 1030 $values['action'] = 'new';
1112 1031 }
@@ -1113,11 +1032,8 @@
1113 1032
1114 1033 return $values;
1115 1034 }
1116 1035
1117 - /**
1118 - * @return array
1119 - */
1120 1036 public static function list_page_params() {
1121 1037 $values = array();
1122 1038 $defaults = array(
1123 1039 'template' => 0,
@@ -1127,9 +1043,8 @@
1127 1043 'search' => '',
1128 1044 'sort' => '',
1129 1045 'sdir' => '',
1130 1046 );
1131 -
1132 1047 foreach ( $defaults as $var => $default ) {
1133 1048 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
1134 1049 }
1135 1050
@@ -1135,16 +1050,10 @@
1135 1050
1136 1051 return $values;
1137 1052 }
1138 1053
1139 - /**
1140 - * @param int|object|string|null $form
1141 - *
1142 - * @return array
1143 - */
1144 1054 public static function get_admin_params( $form = null ) {
1145 1055 $form_id = $form;
1146 -
1147 1056 if ( $form === null ) {
1148 1057 $form_id = self::get_current_form_id();
1149 1058 } elseif ( $form && is_object( $form ) ) {
1150 1059 $form_id = $form->id;
@@ -1162,9 +1071,8 @@
1162 1071 'sdir' => '',
1163 1072 'fid' => '',
1164 1073 'keep_post' => '',
1165 1074 );
1166 -
1167 1075 foreach ( $defaults as $var => $default ) {
1168 1076 $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' );
1169 1077 }
1170 1078
@@ -1170,55 +1078,47 @@
1170 1078
1171 1079 return $values;
1172 1080 }
1173 1081
1174 - /**
1175 - * @param string $default_form
1176 - *
1177 - * @return int|string
1178 - */
1179 1082 public static function get_current_form_id( $default_form = 'none' ) {
1180 - $form = 'first' === $default_form ? self::get_current_form() : self::maybe_get_current_form();
1181 - return $form ? $form->id : 0;
1083 + if ( 'first' === $default_form ) {
1084 + $form = self::get_current_form();
1085 + } else {
1086 + $form = self::maybe_get_current_form();
1087 + }
1088 + $form_id = $form ? $form->id : 0;
1089 +
1090 + return $form_id;
1182 1091 }
1183 1092
1184 - /**
1185 - * @param int|string $form_id
1186 - *
1187 - * @return false|int|object|string
1188 - */
1189 1093 public static function maybe_get_current_form( $form_id = 0 ) {
1190 1094 global $frm_vars;
1191 1095
1192 - if ( ! empty( $frm_vars['current_form'] ) && ( ! $form_id || (int) $form_id === (int) $frm_vars['current_form']->id ) ) {
1096 + if ( ! empty( $frm_vars['current_form'] ) && ( ! $form_id || $form_id == $frm_vars['current_form']->id ) ) {
1193 1097 return $frm_vars['current_form'];
1194 1098 }
1195 1099
1196 1100 $form_id = FrmAppHelper::get_param( 'form', $form_id, 'get', 'absint' );
1101 + if ( $form_id ) {
1102 + $form_id = self::set_current_form( $form_id );
1103 + }
1197 1104
1198 - return $form_id ? self::set_current_form( $form_id ) : $form_id;
1105 + return $form_id;
1199 1106 }
1200 1107
1201 - /**
1202 - * @param int $form_id
1203 - *
1204 - * @return false|object
1205 - */
1206 1108 public static function get_current_form( $form_id = 0 ) {
1207 1109 $form = self::maybe_get_current_form( $form_id );
1208 - return is_numeric( $form ) ? self::set_current_form( $form ) : $form;
1110 + if ( is_numeric( $form ) ) {
1111 + $form = self::set_current_form( $form );
1112 + }
1113 +
1114 + return $form;
1209 1115 }
1210 1116
1211 - /**
1212 - * @param int $form_id
1213 - *
1214 - * @return false|object
1215 - */
1216 1117 public static function set_current_form( $form_id ) {
1217 1118 global $frm_vars;
1218 1119
1219 1120 $query = array();
1220 -
1221 1121 if ( $form_id ) {
1222 1122 $query['id'] = $form_id;
1223 1123 }
1224 1124
@@ -1226,19 +1126,11 @@
1226 1126
1227 1127 return $frm_vars['current_form'];
1228 1128 }
1229 1129
1230 - /**
1231 - * @param object $form
1232 - * @param int|string $this_load
1233 - * @param bool $global_load
1234 - *
1235 - * @return bool
1236 - */
1237 1130 public static function is_form_loaded( $form, $this_load, $global_load ) {
1238 1131 global $frm_vars;
1239 1132 $small_form = new stdClass();
1240 -
1241 1133 foreach ( array( 'id', 'form_key', 'name' ) as $var ) {
1242 1134 $small_form->{$var} = $form->{$var};
1243 1135 unset( $var );
1244 1136 }
@@ -1244,9 +1136,9 @@
1244 1136 }
1245 1137
1246 1138 $frm_vars['forms_loaded'][] = $small_form;
1247 1139
1248 - if ( $this_load && ! $global_load ) {
1140 + if ( $this_load && empty( $global_load ) ) {
1249 1141 $global_load = true;
1250 1142 $frm_vars['load_css'] = true;
1251 1143 }
1252 1144
@@ -1259,9 +1151,9 @@
1259 1151 * @param object $form
1260 1152 *
1261 1153 * @return bool
1262 1154 */
1263 - public static function is_visible_to_user( $form ) {
1155 + public static function &is_visible_to_user( $form ) {
1264 1156 if ( $form->logged_in && isset( $form->options['logged_in_role'] ) ) {
1265 1157 $visible = FrmAppHelper::user_has_permission( $form->options['logged_in_role'] );
1266 1158 } else {
1267 1159 $visible = true;
@@ -1266,39 +1158,26 @@
1266 1158 } else {
1267 1159 $visible = true;
1268 1160 }
1269 1161
1270 - /**
1271 - * @since 6.25
1272 - *
1273 - * @param bool $visible
1274 - * @param object $form
1275 - */
1276 - return (bool) apply_filters( 'frm_form_is_visible', $visible, $form );
1162 + return $visible;
1277 1163 }
1278 1164
1279 - /**
1280 - * @param object $form
1281 - *
1282 - * @return bool
1283 - */
1284 1165 public static function show_submit( $form ) {
1285 - $show = ! $form->is_template && $form->status === 'published' && ! FrmAppHelper::is_admin();
1286 - return apply_filters( 'frm_show_submit_button', $show, $form );
1166 + $show = ( ! $form->is_template && $form->status === 'published' && ! FrmAppHelper::is_admin() );
1167 + $show = apply_filters( 'frm_show_submit_button', $show, $form );
1168 +
1169 + return $show;
1287 1170 }
1288 1171
1289 1172 /**
1290 1173 * @since 2.3
1291 - *
1292 - * @param array $atts Attributes including form, option, and default.
1293 - *
1294 - * @return mixed
1295 1174 */
1296 1175 public static function get_option( $atts ) {
1297 1176 $form = $atts['form'];
1298 - $default = $atts['default'] ?? '';
1177 + $default = isset( $atts['default'] ) ? $atts['default'] : '';
1299 1178
1300 - return $form->options[ $atts['option'] ] ?? $default;
1179 + return isset( $form->options[ $atts['option'] ] ) ? $form->options[ $atts['option'] ] : $default;
1301 1180 }
1302 1181
1303 1182 /**
1304 1183 * Get the link to edit this form.
@@ -1303,12 +1182,9 @@
1303 1182 /**
1304 1183 * Get the link to edit this form.
1305 1184 *
1306 1185 * @since 4.0
1307 - *
1308 1186 * @param int $form_id The id of the form.
1309 - *
1310 - * @return string
1311 1187 */
1312 1188 public static function get_edit_link( $form_id ) {
1313 1189 return admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . $form_id );
1314 1190 }
@@ -1318,9 +1194,8 @@
1318 1194 *
1319 1195 * @since 6.2
1320 1196 *
1321 1197 * @param stdClass $form
1322 - *
1323 1198 * @return bool
1324 1199 */
1325 1200 public static function is_ajax_on( $form ) {
1326 1201 return ! empty( $form->options['ajax_submit'] );
@@ -1329,12 +1204,12 @@
1329 1204 /**
1330 1205 * Get the latest form available.
1331 1206 *
1332 1207 * @since 6.8
1333 - *
1334 1208 * @return object
1335 1209 */
1336 1210 public static function get_latest_form() {
1211 +
1337 1212 $args = array(
1338 1213 array(
1339 1214 'or' => 1,
1340 1215 'parent_form_id' => null,
@@ -1350,12 +1225,12 @@
1350 1225 /**
1351 1226 * Count and return total forms.
1352 1227 *
1353 1228 * @since 6.8
1354 - *
1355 1229 * @return int
1356 1230 */
1357 1231 public static function get_forms_count() {
1232 +
1358 1233 $args = array(
1359 1234 array(
1360 1235 'or' => 1,
1361 1236 'parent_form_id' => null,
@@ -1369,13 +1244,11 @@
1369 1244 }
1370 1245
1371 1246 /**
1372 1247 * @deprecated 2.03.05 This is still referenced in a few add ons (API, locations).
1373 - *
1374 1248 * @codeCoverageIgnore
1375 1249 *
1376 1250 * @param string $key
1377 - *
1378 1251 * @return int form id
1379 1252 */
1380 1253 public static function getIdByKey( $key ) {
1381 1254 _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_id_by_key' );
@@ -1383,13 +1256,11 @@
1383 1256 }
1384 1257
1385 1258 /**
1386 1259 * @deprecated 2.03.05 This is still referenced in the API add on as of v1.13.
1387 - *
1388 1260 * @codeCoverageIgnore
1389 1261 *
1390 1262 * @param int|string $id
1391 - *
1392 1263 * @return string
1393 1264 */
1394 1265 public static function getKeyById( $id ) {
1395 1266 _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_key_by_id' );