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