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