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