PluginProbe
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More / 6.8
Formidable Forms – WordPress Form Builder for Contact Forms, Calculators, Quizzes & More v6.8
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/FrmEntry.php +164 -358 6.326.8 View file →
@@ -5,23 +5,18 @@
5 5
6 6 class FrmEntry {
7 7
8 8 /**
9 - * @since 6.16.3
10 - *
11 - * @var array
12 - */
13 - private static $unique_id_match_checks = array();
14 -
15 - /**
16 9 * Create a new entry
17 10 *
18 11 * @param array $values
19 12 *
20 - * @return bool|int Entry ID.
13 + * @return int | boolean $entry_id
21 14 */
22 15 public static function create( $values ) {
23 - return self::create_entry( $values, 'standard' );
16 + $entry_id = self::create_entry( $values, 'standard' );
17 +
18 + return $entry_id;
24 19 }
25 20
26 21 /**
27 22 * Create a new entry with some differences depending on type
@@ -28,44 +23,27 @@
28 23 *
29 24 * @param array $values
30 25 * @param string $type
31 26 *
32 - * @return bool|int Entry ID.
27 + * @return int | boolean $entry_id
33 28 */
34 29 private static function create_entry( $values, $type ) {
35 30 $new_values = self::before_insert_entry_in_database( $values, $type );
36 31
37 32 // Don't check XML entries for duplicates
38 - if ( $type !== 'xml' && self::is_duplicate( $new_values, $values ) ) {
33 + if ( $type != 'xml' && self::is_duplicate( $new_values, $values ) ) {
39 34 return false;
40 35 }
41 36
42 - return self::continue_to_create_entry( $values, $new_values );
43 - }
37 + $entry_id = self::continue_to_create_entry( $values, $new_values );
44 38
45 - /**
46 - * Flag the memoized unique id check after a new entry is created.
47 - * This prevents possibly DB requests and helps avoid issues when creating repeater entries.
48 - *
49 - * @since 6.16.3
50 - *
51 - * @param string $unique_id
52 - *
53 - * @return void
54 - */
55 - private static function flag_new_unique_key( $unique_id ) {
56 - if ( ! isset( self::$unique_id_match_checks[ $unique_id ] ) ) {
57 - self::$unique_id_match_checks[ $unique_id ] = false;
58 - }
39 + return $entry_id;
59 40 }
60 41
61 42 /**
62 43 * Check for duplicate entries created in the last minute
63 44 *
64 - * @param array $new_values New values.
65 - * @param array $values Values.
66 - *
67 - * @return bool
45 + * @return boolean
68 46 */
69 47 public static function is_duplicate( $new_values, $values ) {
70 48 $duplicate_entry_time = apply_filters( 'frm_time_to_check_duplicates', 60, $new_values );
71 49
@@ -72,18 +50,13 @@
72 50 if ( false === self::is_duplicate_check_needed( $values, $duplicate_entry_time ) ) {
73 51 return false;
74 52 }
75 53
76 - if ( self::maybe_check_for_unique_id_match( $values, $new_values['created_at'] ) ) {
77 - return true;
78 - }
79 -
80 54 $check_val = $new_values;
81 - $check_val['created_at >'] = gmdate( 'Y-m-d H:i:s', strtotime( $new_values['created_at'] ) - absint( $duplicate_entry_time ) );
55 + $check_val['created_at >'] = gmdate( 'Y-m-d H:i:s', ( strtotime( $new_values['created_at'] ) - absint( $duplicate_entry_time ) ) );
82 56
83 57 unset( $check_val['created_at'], $check_val['updated_at'], $check_val['is_draft'], $check_val['id'], $check_val['item_key'] );
84 58
85 - // phpcs:ignore Universal.Operators.StrictComparisons
86 59 if ( $new_values['item_key'] == $new_values['name'] ) {
87 60 unset( $check_val['name'] );
88 61 }
89 62
@@ -88,34 +61,26 @@
88 61 }
89 62
90 63 $check_val = apply_filters( 'frm_duplicate_check_val', $check_val );
91 64
92 - if ( ! isset( $values['item_meta'] ) ) {
93 - return false;
94 - }
65 + global $wpdb;
66 + $entry_exists = FrmDb::get_col( $wpdb->prefix . 'frm_items', $check_val, 'id', array( 'order_by' => 'created_at DESC' ) );
95 67
96 - $entry_exists = FrmDb::get_col( 'frm_items', $check_val, 'id', array( 'order_by' => 'created_at DESC' ) );
97 -
98 - if ( ! $entry_exists ) {
68 + if ( ! $entry_exists || ! isset( $values['item_meta'] ) ) {
99 69 return false;
100 70 }
101 71
102 72 global $frm_vars;
103 73 $frm_vars['checking_duplicates'] = true;
104 - $is_duplicate = false;
105 74
75 + $is_duplicate = false;
106 76 foreach ( $entry_exists as $entry_exist ) {
107 77 $is_duplicate = true;
108 78
109 - // Make sure it's a duplicate
79 + // make sure it's a duplicate
110 80 $metas = FrmEntryMeta::get_entry_meta_info( $entry_exist );
111 81 $field_metas = array();
112 -
113 82 foreach ( $metas as $meta ) {
114 - if ( 0 === (int) $meta->field_id ) {
115 - continue;
116 - }
117 -
118 83 $field_metas[ $meta->field_id ] = $meta->meta_value;
119 84 }
120 85
121 86 $filtered_vals = array_filter( $values['item_meta'] );
@@ -122,13 +87,13 @@
122 87 $filtered_vals = self::convert_values_to_their_saved_value( $filtered_vals, $entry_exist );
123 88 $field_metas = array_filter( $field_metas );
124 89
125 90 // If prev entry is empty and current entry is not, they are not duplicates
126 - if ( ! $field_metas && $filtered_vals ) {
91 + if ( empty( $field_metas ) && ! empty( $filtered_vals ) ) {
127 92 return false;
128 93 }
129 94
130 - // Compare serialized values and not arrays
95 + // compare serialized values and not arrays
131 96 $new_meta = array_map( 'maybe_serialize', $filtered_vals );
132 97
133 98 if ( $field_metas === $new_meta ) {
134 99 $is_duplicate = true;
@@ -141,12 +106,12 @@
141 106 continue;
142 107 }
143 108
144 109 $diff = array_diff_assoc( $field_metas, $new_meta );
145 -
146 - foreach ( $diff as $meta_value ) {
147 - if ( $meta_value ) {
110 + foreach ( $diff as $field_id => $meta_value ) {
111 + if ( ! empty( $meta_value ) ) {
148 112 $is_duplicate = false;
113 + continue;
149 114 }
150 115 }
151 116
152 117 if ( $is_duplicate ) {
@@ -159,95 +124,25 @@
159 124 return $is_duplicate;
160 125 }
161 126
162 127 /**
163 - * @since 6.16.3
164 - *
165 - * @param array $values POST request data.
166 - * @param string $created_at The timestamp of the entry we are checking for.
167 - *
168 - * @return bool
169 - */
170 - private static function maybe_check_for_unique_id_match( $values, $created_at ) {
171 - if ( ! self::should_check_for_unique_id_match() ) {
172 - return false;
173 - }
174 -
175 - if ( empty( $values['unique_id'] ) ) {
176 - return false;
177 - }
178 -
179 - $unique_id = sanitize_key( $values['unique_id'] );
180 -
181 - if ( ! $unique_id ) {
182 - // Only continue if a unique ID was generated on form submit.
183 - return false;
184 - }
185 -
186 - if ( isset( self::$unique_id_match_checks[ $unique_id ] ) ) {
187 - return self::$unique_id_match_checks[ $unique_id ];
188 - }
189 -
190 - $timestamp = strtotime( $created_at );
191 -
192 - if ( false === $timestamp ) {
193 - $timestamp = time();
194 - }
195 -
196 - self::$unique_id_match_checks[ $unique_id ] = (bool) FrmDb::get_var(
197 - 'frm_item_metas',
198 - array(
199 - 'field_id' => 0,
200 - 'meta_value' => serialize( compact( 'unique_id' ) ),
201 - 'created_at >' => gmdate( 'Y-m-d H:i:s', $timestamp - MONTH_IN_SECONDS ),
202 - ),
203 - 'id'
204 - );
205 -
206 - return self::$unique_id_match_checks[ $unique_id ];
207 - }
208 -
209 - /**
210 - * @since 6.16.3
211 - *
212 - * @return bool
213 - */
214 - private static function should_check_for_unique_id_match() {
215 - /**
216 - * Allow users to opt out of the DB query, in case it causes performance issues.
217 - *
218 - * @since 6.16.3
219 - *
220 - * @param bool $should_extend
221 - */
222 - $should_check = apply_filters( 'frm_check_for_unique_id_match', true );
223 - return (bool) $should_check;
224 - }
225 -
226 - /**
227 128 * Convert form data to the actual value that would be saved into the database.
129 + * This is important for the duplicate check as something like 'a:2:{s:5:"typed";s:0:"";s:6:"output";s:0:"";}' (a signature value) is actually an empty string and does not get saved.
228 130 *
229 - * This is important for the duplicate check as something like 'a:2:{s:5:"typed";s:0:"";s:6:"output";s:0:"";}'
230 - * (a signature value) is actually an empty string and does not get saved.
231 - *
232 131 * @param array $filter_vals
233 132 * @param int $entry_id
234 - *
235 133 * @return array
236 134 */
237 135 private static function convert_values_to_their_saved_value( $filter_vals, $entry_id ) {
238 136 $reduced = array();
239 -
240 137 foreach ( $filter_vals as $field_id => $value ) {
241 138 $field = FrmFieldFactory::get_field_object( $field_id );
242 139 $reduced[ $field_id ] = $field->get_value_to_save( $value, array( 'entry_id' => $entry_id ) );
243 140 $reduced[ $field_id ] = $field->set_value_before_save( $reduced[ $field_id ] );
244 -
245 - if ( '' === $reduced[ $field_id ] || array() === $reduced[ $field_id ] ) {
141 + if ( '' === $reduced[ $field_id ] || ( is_array( $reduced[ $field_id ] ) && 0 === count( $reduced[ $field_id ] ) ) ) {
246 142 unset( $reduced[ $field_id ] );
247 143 }
248 144 }
249 -
250 145 return $reduced;
251 146 }
252 147
253 148 /**
@@ -261,9 +156,9 @@
261 156 * @return bool
262 157 */
263 158 private static function is_duplicate_check_needed( $values, $duplicate_entry_time ) {
264 159 // If time for checking duplicates is set to an empty value, don't check for duplicates
265 - if ( ! $duplicate_entry_time ) {
160 + if ( empty( $duplicate_entry_time ) ) {
266 161 return false;
267 162 }
268 163
269 164 // If CSV is importing, don't check for duplicates
@@ -271,20 +166,20 @@
271 166 return false;
272 167 }
273 168
274 169 // If repeating field entries are getting created, don't check for duplicates
275 - return empty( $values['parent_form_id'] );
170 + if ( isset( $values['parent_form_id'] ) && $values['parent_form_id'] ) {
171 + return false;
172 + }
173 +
174 + return true;
276 175 }
277 176
278 - /**
279 - * @param int|string $id
280 - *
281 - * @return false|int
282 - */
283 177 public static function duplicate( $id ) {
284 178 global $wpdb;
285 179
286 - $values = self::getOne( $id );
180 + $values = self::getOne( $id );
181 +
287 182 $new_values = array();
288 183 $new_values['item_key'] = FrmAppHelper::get_unique_key( '', $wpdb->prefix . 'frm_items', 'item_key' );
289 184 $new_values['name'] = $values->name;
290 185 $new_values['is_draft'] = $values->is_draft;
@@ -294,9 +189,8 @@
294 189 $new_values['created_at'] = current_time( 'mysql', 1 );
295 190 $new_values['updated_at'] = $new_values['created_at'];
296 191
297 192 $query_results = $wpdb->insert( $wpdb->prefix . 'frm_items', $new_values );
298 -
299 193 if ( ! $query_results ) {
300 194 return false;
301 195 }
302 196
@@ -302,9 +196,8 @@
302 196
303 197 $entry_id = $wpdb->insert_id;
304 198
305 199 global $frm_vars;
306 -
307 200 if ( ! isset( $frm_vars['saved_entries'] ) ) {
308 201 $frm_vars['saved_entries'] = array();
309 202 }
310 203 $frm_vars['saved_entries'][] = (int) $entry_id;
@@ -322,12 +215,14 @@
322 215 *
323 216 * @param int $id
324 217 * @param array $values
325 218 *
326 - * @return bool|int Update results.
219 + * @return boolean|int $update_results
327 220 */
328 221 public static function update( $id, $values ) {
329 - return self::update_entry( $id, $values, 'standard' );
222 + $update_results = self::update_entry( $id, $values, 'standard' );
223 +
224 + return $update_results;
330 225 }
331 226
332 227 /**
333 228 * Update an entry with some differences depending on the update type
@@ -333,24 +228,23 @@
333 228 * Update an entry with some differences depending on the update type
334 229 *
335 230 * @since 2.0.16
336 231 *
337 - * @param int $id
338 - * @param array $values
339 - * @param string $update_type
232 + * @param int $id
233 + * @param array $values
340 234 *
341 - * @return bool|int Query results.
235 + * @return boolean|int $query_results
342 236 */
343 237 private static function update_entry( $id, $values, $update_type ) {
344 238 global $wpdb;
345 239
346 240 $update = self::before_update_entry( $id, $values, $update_type );
347 -
348 241 if ( ! $update ) {
349 242 return false;
350 243 }
351 244
352 - $new_values = self::package_entry_to_update( $id, $values );
245 + $new_values = self::package_entry_to_update( $id, $values );
246 +
353 247 $query_results = $wpdb->update( $wpdb->prefix . 'frm_items', $new_values, compact( 'id' ) );
354 248
355 249 self::after_update_entry( $query_results, $id, $values, $new_values );
356 250
@@ -359,10 +253,9 @@
359 253
360 254 /**
361 255 * Delete an entry.
362 256 *
363 - * @param int|string $id
364 - *
257 + * @param string|int $id
365 258 * @return bool True on success, false if nothing was deleted.
366 259 */
367 260 public static function destroy( $id ) {
368 261 global $wpdb;
@@ -369,11 +262,11 @@
369 262 $id = (int) $id;
370 263
371 264 // Item meta is required for conditional logic in actions with 'delete' events.
372 265 $entry = self::getOne( $id, true );
373 -
374 266 if ( ! $entry ) {
375 - return false;
267 + $result = false;
268 + return $result;
376 269 }
377 270
378 271 /**
379 272 * Trigger an action to run custom logic before the entry is deleted.
@@ -401,20 +294,12 @@
401 294
402 295 return $result;
403 296 }
404 297
405 - /**
406 - * @param int $id
407 - * @param mixed $value
408 - * @param int|string $form_id
409 - *
410 - * @return false|int
411 - */
412 298 public static function update_form( $id, $value, $form_id ) {
413 299 global $wpdb;
414 300 $form_id = isset( $value ) ? $form_id : null;
415 301 $result = $wpdb->update( $wpdb->prefix . 'frm_items', array( 'form_id' => $form_id ), array( 'id' => $id ) );
416 -
417 302 if ( $result ) {
418 303 self::clear_cache();
419 304 }
420 305
@@ -425,10 +310,8 @@
425 310 * Clear entry caching
426 311 * Called when an entry is changed
427 312 *
428 313 * @since 2.0.5
429 - *
430 - * @return void
431 314 */
432 315 public static function clear_cache() {
433 316 FrmDb::cache_delete_group( 'frm_entry' );
434 317 FrmDb::cache_delete_group( 'frm_item' );
@@ -440,42 +323,33 @@
440 323 * After switching to the wp_loaded hook for processing entries,
441 324 * we can no longer use 'name', but check it as a fallback
442 325 *
443 326 * @since 2.0.11
444 - *
445 - * @param array $values
446 - * @param array|string $default
447 - *
448 - * @return string
449 327 */
450 328 public static function get_new_entry_name( $values, $default = '' ) {
451 - $name = $values['item_name'] ?? $values['name'] ?? $default;
452 - return is_array( $name ) ? reset( $name ) : $name;
329 + $name = isset( $values['item_name'] ) ? $values['item_name'] : ( isset( $values['name'] ) ? $values['name'] : $default );
330 + if ( is_array( $name ) ) {
331 + $name = reset( $name );
332 + }
333 +
334 + return $name;
453 335 }
454 336
455 337 /**
456 338 * If $entry is numeric, get the entry object
457 339 *
340 + * @param int|object $entry By reference.
341 + *
458 342 * @since 2.0.9
459 - *
460 - * @param int|object|string $entry By reference.
461 - *
462 - * @return void
463 343 */
464 344 public static function maybe_get_entry( &$entry ) {
465 345 if ( $entry && is_numeric( $entry ) ) {
466 346 $entry = self::getOne( $entry );
467 - } elseif ( ! $entry || 'false' === $entry ) {
347 + } elseif ( empty( $entry ) || 'false' === $entry ) {
468 348 $entry = false;
469 349 }
470 350 }
471 351
472 - /**
473 - * @param int|string $id
474 - * @param bool $meta
475 - *
476 - * @return object|null
477 - */
478 352 public static function getOne( $id, $meta = false ) {
479 353 global $wpdb;
480 354
481 355 $query = "SELECT it.*, fr.name as form_name, fr.form_key as form_key FROM {$wpdb->prefix}frm_items it
@@ -480,9 +354,9 @@
480 354
481 355 $query = "SELECT it.*, fr.name as form_name, fr.form_key as form_key FROM {$wpdb->prefix}frm_items it
482 356 LEFT OUTER JOIN {$wpdb->prefix}frm_forms fr ON it.form_id=fr.id WHERE ";
483 357
484 - $query .= is_numeric( $id ) ? 'it.id=%d' : 'it.item_key=%s';
358 + $query .= is_numeric( $id ) ? 'it.id=%d' : 'it.item_key=%s';
485 359 $query_args = array( $id );
486 360 $query = $wpdb->prepare( $query, $query_args ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
487 361
488 362 if ( ! $meta ) {
@@ -491,9 +365,8 @@
491 365 return $entry;
492 366 }
493 367
494 368 $entry = FrmDb::check_cache( $id, 'frm_entry' );
495 -
496 369 if ( $entry !== false ) {
497 370 self::prepare_entry( $entry );
498 371 return $entry;
499 372 }
@@ -508,13 +381,11 @@
508 381 /**
509 382 * @since 4.02.03
510 383 *
511 384 * @param object $entry
512 - *
513 - * @return void
514 385 */
515 386 private static function prepare_entry( &$entry ) {
516 - if ( ! $entry ) {
387 + if ( empty( $entry ) ) {
517 388 return;
518 389 }
519 390
520 391 FrmAppHelper::unserialize_or_decode( $entry->description );
@@ -525,10 +396,8 @@
525 396 /**
526 397 * @since 4.02.03
527 398 *
528 399 * @param array $entries
529 - *
530 - * @return void
531 400 */
532 401 private static function prepare_entries( &$entries ) {
533 402 foreach ( $entries as $k => $entry ) {
534 403 self::prepare_entry( $entry );
@@ -535,13 +404,8 @@
535 404 $entries[ $k ] = $entry;
536 405 }
537 406 }
538 407
539 - /**
540 - * @param object|null $entry
541 - *
542 - * @return object|null
543 - */
544 408 public static function get_meta( $entry ) {
545 409 if ( ! $entry ) {
546 410 return $entry;
547 411 }
@@ -558,15 +422,13 @@
558 422
559 423 $entry->metas = array();
560 424
561 425 $include_key = apply_filters( 'frm_include_meta_keys', false, array( 'form_id' => $entry->form_id ) );
562 -
563 426 foreach ( $metas as $meta_val ) {
564 427 FrmFieldsHelper::prepare_field_value( $meta_val->meta_value, $meta_val->type );
565 428
566 - if ( (int) $meta_val->item_id === (int) $entry->id ) {
429 + if ( $meta_val->item_id == $entry->id ) {
567 430 $entry->metas[ $meta_val->field_id ] = $meta_val->meta_value;
568 -
569 431 if ( $include_key ) {
570 432 $entry->metas[ $meta_val->field_key ] = $entry->metas[ $meta_val->field_id ];
571 433 }
572 434 continue;
@@ -571,9 +433,9 @@
571 433 }
572 434 continue;
573 435 }
574 436
575 - // Include sub entries in an array
437 + // include sub entries in an array
576 438 if ( ! isset( $entry->metas[ $meta_val->field_id ] ) ) {
577 439 $entry->metas[ $meta_val->field_id ] = array();
578 440 }
579 441
@@ -579,9 +441,9 @@
579 441
580 442 $entry->metas[ $meta_val->field_id ][] = $meta_val->meta_value;
581 443
582 444 unset( $meta_val );
583 - }//end foreach
445 + }
584 446 unset( $metas );
585 447
586 448 FrmDb::set_cache( $entry->id, $entry, 'frm_entry' );
587 449
@@ -589,45 +451,43 @@
589 451 }
590 452
591 453 /**
592 454 * @param string $id
593 - *
594 - * @return bool
595 455 */
596 456 public static function exists( $id ) {
457 + global $wpdb;
458 +
597 459 if ( FrmDb::check_cache( $id, 'frm_entry' ) ) {
598 - return true;
460 + $exists = true;
461 +
462 + return $exists;
599 463 }
600 464
601 - $where = is_numeric( $id ) ? array( 'id' => $id ) : array( 'item_key' => $id );
602 - $id = FrmDb::get_var( 'frm_items', $where );
465 + if ( is_numeric( $id ) ) {
466 + $where = array( 'id' => $id );
467 + } else {
468 + $where = array( 'item_key' => $id );
469 + }
470 + $id = FrmDb::get_var( $wpdb->prefix . 'frm_items', $where );
603 471
604 - return $id && $id > 0;
472 + return ( $id && $id > 0 );
605 473 }
606 474
607 - /**
608 - * @param array|string $where
609 - * @param string $order_by
610 - * @param string $limit
611 - * @param bool $meta
612 - * @param bool $inc_form
613 - *
614 - * @return array
615 - */
616 475 public static function getAll( $where, $order_by = '', $limit = '', $meta = false, $inc_form = true ) {
617 476 global $wpdb;
618 477
619 - $limit = FrmDb::esc_limit( $limit );
478 + $limit = FrmDb::esc_limit( $limit );
479 +
620 480 $cache_key = FrmAppHelper::maybe_json_encode( $where ) . $order_by . $limit . $inc_form;
621 481 $entries = wp_cache_get( $cache_key, 'frm_entry' );
622 482
623 483 if ( false === $entries ) {
624 - $fields = 'it.id, it.item_key, it.name, it.ip, it.form_id, it.post_id, it.user_id, it.parent_item_id, it.updated_by, it.created_at, it.updated_at, it.is_draft, it.description'; // phpcs:ignore SlevomatCodingStandard.Files.LineLength.LineTooLong
484 + $fields = 'it.id, it.item_key, it.name, it.ip, it.form_id, it.post_id, it.user_id, it.parent_item_id, it.updated_by, it.created_at, it.updated_at, it.is_draft, it.description';
625 485 $table = $wpdb->prefix . 'frm_items it ';
626 486
627 487 if ( $inc_form ) {
628 488 $fields = 'it.*, fr.name as form_name,fr.form_key as form_key';
629 - $table .= 'LEFT OUTER JOIN ' . $wpdb->prefix . 'frm_forms fr ON it.form_id=fr.id ';
489 + $table .= 'LEFT OUTER JOIN ' . $wpdb->prefix . 'frm_forms fr ON it.form_id=fr.id ';
630 490 }
631 491
632 492 if ( preg_match( '/ meta_([0-9]+)/', $order_by, $order_matches ) ) {
633 493 $fields .= self::sort_by_field( $order_matches[1] );
@@ -633,9 +493,9 @@
633 493 $fields .= self::sort_by_field( $order_matches[1] );
634 494 unset( $order_matches );
635 495 }
636 496
637 - // Prepare the query
497 + // prepare the query
638 498 $query = 'SELECT ' . $fields . ' FROM ' . $table . FrmDb::prepend_and_or_where( ' WHERE ', $where ) . $order_by . $limit;
639 499
640 500 $entries = $wpdb->get_results( $query, OBJECT_K ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
641 501 unset( $query );
@@ -653,11 +513,9 @@
653 513 $where = array( 'it.form_id' => substr( $where, 11 ) );
654 514 }
655 515
656 516 $meta_where = array( 'field_id !' => 0 );
657 -
658 - // phpcs:ignore Universal.Operators.StrictComparisons
659 - if ( $limit == '' && is_array( $where ) && count( $where ) === 1 && isset( $where['it.form_id'] ) ) {
517 + if ( $limit == '' && is_array( $where ) && count( $where ) == 1 && isset( $where['it.form_id'] ) ) {
660 518 $meta_where['fi.form_id'] = $where['it.form_id'];
661 519 } else {
662 520 $meta_where['item_id'] = array_keys( $entries );
663 521 }
@@ -700,15 +558,15 @@
700 558 return $entries;
701 559 }
702 560
703 561 /**
704 - * @param int|string $field_id
705 - *
562 + * @param int $field_id
706 563 * @return string
707 564 */
708 565 private static function sort_by_field( $field_id ) {
709 566 global $wpdb;
710 - $field_id = (int) $field_id;
567 + $field_id = (int) $field_id;
568 +
711 569 $field_options = FrmDb::get_var( 'frm_fields', array( 'id' => $field_id ), 'field_options' );
712 570 FrmAppHelper::unserialize_or_decode( $field_options );
713 571
714 572 if ( empty( $field_options['post_field'] ) ) {
@@ -721,11 +579,9 @@
721 579 }
722 580
723 581 // Pagination Methods
724 582 /**
725 - * @param array|int|string $where If int, use the form id.
726 - *
727 - * @return int|string
583 + * @param int|array|string $where If int, use the form id.
728 584 */
729 585 public static function getRecordCount( $where = '' ) {
730 586 global $wpdb;
731 587 $table_join = $wpdb->prefix . 'frm_items it JOIN ' . $wpdb->prefix . 'frm_forms fr ON it.form_id=fr.id';
@@ -735,35 +591,29 @@
735 591 $where = array( 'form_id' => $where );
736 592 }
737 593
738 594 if ( is_array( $where ) ) {
739 - return FrmDb::get_count( $table_join, $where );
595 + $count = FrmDb::get_count( $table_join, $where );
596 + } else {
597 + $cache_key = 'count_' . FrmAppHelper::maybe_json_encode( $where );
598 + $query = 'SELECT COUNT(*) FROM ' . $table_join . FrmDb::prepend_and_or_where( ' WHERE ', $where );
599 + $count = FrmDb::check_cache( $cache_key, 'frm_entry', $query, 'get_var' );
740 600 }
741 601
742 - $cache_key = 'count_' . FrmAppHelper::maybe_json_encode( $where );
743 - $query = 'SELECT COUNT(*) FROM ' . $table_join . FrmDb::prepend_and_or_where( ' WHERE ', $where );
744 -
745 - return FrmDb::check_cache( $cache_key, 'frm_entry', $query, 'get_var' );
602 + return $count;
746 603 }
747 604
748 - /**
749 - * @param int|string $p_size
750 - * @param array|int|string $where
751 - *
752 - * @return int
753 - */
754 605 public static function getPageCount( $p_size, $where = '' ) {
755 606 $p_size = (int) $p_size;
756 -
607 + $count = 1;
757 608 if ( $p_size ) {
758 609 if ( ! is_numeric( $where ) ) {
759 610 $where = self::getRecordCount( $where );
760 611 }
761 -
762 - return ceil( (int) $where / $p_size );
612 + $count = ceil( (int) $where / $p_size );
763 613 }
764 614
765 - return 1;
615 + return $count;
766 616 }
767 617
768 618 /**
769 619 * Prepare the data before inserting it into the database
@@ -772,18 +622,21 @@
772 622 *
773 623 * @param array $values
774 624 * @param string $type
775 625 *
776 - * @return array New values.
626 + * @return array $new_values
777 627 */
778 628 private static function before_insert_entry_in_database( &$values, $type ) {
629 +
779 630 self::sanitize_entry_post( $values );
780 631
781 - if ( $type !== 'xml' ) {
632 + if ( $type != 'xml' ) {
782 633 $values = apply_filters( 'frm_pre_create_entry', $values );
783 634 }
784 635
785 - return self::package_entry_data( $values );
636 + $new_values = self::package_entry_data( $values );
637 +
638 + return $new_values;
786 639 }
787 640
788 641 /**
789 642 * Create an entry and perform after create actions
@@ -792,13 +645,12 @@
792 645 *
793 646 * @param array $values
794 647 * @param array $new_values
795 648 *
796 - * @return bool|int Entry ID.
649 + * @return boolean|int $entry_id
797 650 */
798 651 private static function continue_to_create_entry( $values, $new_values ) {
799 652 $entry_id = self::insert_entry_into_database( $new_values );
800 -
801 653 if ( ! $entry_id ) {
802 654 return false;
803 655 }
804 656
@@ -812,10 +664,8 @@
812 664 *
813 665 * @since 2.0
814 666 *
815 667 * @param array $values The POST values by reference.
816 - *
817 - * @return void
818 668 */
819 669 public static function sanitize_entry_post( &$values ) {
820 670 $sanitize_method = array(
821 671 'form_id' => 'absint',
@@ -840,9 +690,9 @@
840 690 * @since 2.0.16
841 691 *
842 692 * @param array $values
843 693 *
844 - * @return array New values.
694 + * @return array $new_values
845 695 */
846 696 private static function package_entry_data( &$values ) {
847 697 global $wpdb;
848 698
@@ -852,9 +702,9 @@
852 702
853 703 $item_name = self::get_new_entry_name( $values, $values['item_key'] );
854 704 $new_values = array(
855 705 'item_key' => FrmAppHelper::get_unique_key( $values['item_key'], $wpdb->prefix . 'frm_items', 'item_key' ),
856 - 'name' => FrmAppHelper::truncate( $item_name, 255, 1, '', true ),
706 + 'name' => FrmAppHelper::truncate( $item_name, 255, 1, '' ),
857 707 'ip' => self::get_ip( $values ),
858 708 'is_draft' => self::get_is_draft_value( $values ),
859 709 'form_id' => (int) self::get_entry_value( $values, 'form_id', null ),
860 710 'post_id' => (int) self::get_entry_value( $values, 'post_id', 0 ),
@@ -864,22 +714,15 @@
864 714 'description' => self::get_entry_description( $values ),
865 715 'user_id' => self::get_entry_user_id( $values ),
866 716 );
867 717
868 - $new_values['updated_by'] = $values['updated_by'] ?? $new_values['user_id'];
718 + $new_values['updated_by'] = isset( $values['updated_by'] ) ? $values['updated_by'] : $new_values['user_id'];
869 719
870 720 return $new_values;
871 721 }
872 722
873 - /**
874 - * @param array $values
875 - * @param string $name
876 - * @param mixed $default
877 - *
878 - * @return mixed
879 - */
880 723 private static function get_entry_value( $values, $name, $default ) {
881 - return $values[ $name ] ?? $default;
724 + return isset( $values[ $name ] ) ? $values[ $name ] : $default;
882 725 }
883 726
884 727 /**
885 728 * Get the ip for a new entry.
@@ -896,11 +739,10 @@
896 739 return '';
897 740 }
898 741
899 742 $ip = FrmAppHelper::get_ip_address();
900 -
901 743 if ( defined( 'WP_IMPORTING' ) && WP_IMPORTING ) {
902 - return self::get_entry_value( $values, 'ip', $ip );
744 + $ip = self::get_entry_value( $values, 'ip', $ip );
903 745 }
904 746
905 747 return $ip;
906 748 }
@@ -944,9 +786,15 @@
944 786 *
945 787 * @return string
946 788 */
947 789 private static function get_updated_at( $values ) {
948 - return $values['updated_at'] ?? self::get_created_at( $values );
790 + if ( isset( $values['updated_at'] ) ) {
791 + $updated_at = $values['updated_at'];
792 + } else {
793 + $updated_at = self::get_created_at( $values );
794 + }
795 +
796 + return $updated_at;
949 797 }
950 798
951 799 /**
952 800 * Get the description value for a new entry
@@ -957,18 +805,20 @@
957 805 *
958 806 * @return string
959 807 */
960 808 private static function get_entry_description( $values ) {
961 - if ( ! empty( $values['description'] ) ) {
962 - return FrmAppHelper::maybe_json_encode( $values['description'] );
809 + if ( isset( $values['description'] ) && ! empty( $values['description'] ) ) {
810 + $description = FrmAppHelper::maybe_json_encode( $values['description'] );
811 + } else {
812 + $description = json_encode(
813 + array(
814 + 'browser' => FrmAppHelper::get_server_value( 'HTTP_USER_AGENT' ),
815 + 'referrer' => FrmAppHelper::get_server_value( 'HTTP_REFERER' ),
816 + )
817 + );
963 818 }
964 819
965 - return json_encode(
966 - array(
967 - 'browser' => FrmAppHelper::get_server_value( 'HTTP_USER_AGENT' ),
968 - 'referrer' => FrmAppHelper::get_server_value( 'HTTP_REFERER' ),
969 - )
970 - );
820 + return $description;
971 821 }
972 822
973 823 /**
974 824 * Get the user_id value for a new entry
@@ -980,13 +830,15 @@
980 830 * @return int
981 831 */
982 832 private static function get_entry_user_id( $values ) {
983 833 if ( isset( $values['frm_user_id'] ) && ( is_numeric( $values['frm_user_id'] ) || FrmAppHelper::is_admin() ) ) {
984 - return $values['frm_user_id'];
834 + $user_id = $values['frm_user_id'];
835 + } else {
836 + $current_user_id = get_current_user_id();
837 + $user_id = $current_user_id ? $current_user_id : 0;
985 838 }
986 839
987 - $current_user_id = get_current_user_id();
988 - return $current_user_id ? $current_user_id : 0;
840 + return $user_id;
989 841 }
990 842
991 843 /**
992 844 * Insert new entry into the database
@@ -994,9 +846,9 @@
994 846 * @since 2.0.16
995 847 *
996 848 * @param array $new_values
997 849 *
998 - * @return bool|int Entry ID.
850 + * @return int | boolean $entry_id
999 851 */
1000 852 private static function insert_entry_into_database( $new_values ) {
1001 853 global $wpdb;
1002 854
@@ -1001,9 +853,15 @@
1001 853 global $wpdb;
1002 854
1003 855 $query_results = $wpdb->insert( $wpdb->prefix . 'frm_items', $new_values );
1004 856
1005 - return $query_results ? $wpdb->insert_id : false;
857 + if ( ! $query_results ) {
858 + $entry_id = false;
859 + } else {
860 + $entry_id = $wpdb->insert_id;
861 + }
862 +
863 + return $entry_id;
1006 864 }
1007 865
1008 866 /**
1009 867 * Add the new entry to global $frm_vars
@@ -1009,11 +867,9 @@
1009 867 * Add the new entry to global $frm_vars
1010 868 *
1011 869 * @since 2.0.16
1012 870 *
1013 - * @param int|string $entry_id
1014 - *
1015 - * @return void
871 + * @param int $entry_id
1016 872 */
1017 873 private static function add_new_entry_to_frm_vars( $entry_id ) {
1018 874 global $frm_vars;
1019 875
@@ -1028,63 +884,32 @@
1028 884 * Add entry metas, if there are any
1029 885 *
1030 886 * @since 2.0.16
1031 887 *
1032 - * @param array $values
1033 - * @param int|string $entry_id
1034 - *
888 + * @param array $values
889 + * @param int $entry_id
1035 890 * @return void
1036 891 */
1037 892 private static function maybe_add_entry_metas( $values, $entry_id ) {
1038 893 if ( isset( $values['item_meta'] ) ) {
1039 894 FrmEntryMeta::update_entry_metas( $entry_id, $values['item_meta'] );
1040 - self::maybe_add_unique_id_meta( $values, $entry_id );
1041 895 }
1042 896 self::maybe_add_captcha_meta( (int) $values['form_id'], (int) $entry_id );
1043 897 }
1044 898
1045 899 /**
1046 - * @since 6.16.3
1047 - *
1048 - * @param array $values
1049 - * @param int $entry_id
1050 - *
1051 - * @return void
1052 - */
1053 - private static function maybe_add_unique_id_meta( $values, $entry_id ) {
1054 - if ( ! empty( $values['parent_form_id'] ) || empty( $values['unique_id'] ) || ! self::should_check_for_unique_id_match() ) {
1055 - return;
1056 - }
1057 -
1058 - // This unique ID is inserted with JS on form submit.
1059 - // It is used to check for duplicate entries.
1060 - $unique_id = sanitize_key( $values['unique_id'] );
1061 -
1062 - if ( ! $unique_id ) {
1063 - return;
1064 - }
1065 -
1066 - FrmEntryMeta::add_entry_meta( $entry_id, 0, '', compact( 'unique_id' ) );
1067 - self::flag_new_unique_key( $unique_id );
1068 - }
1069 -
1070 - /**
1071 900 * @since 5.0.15
1072 901 *
1073 902 * @param int $form_id
1074 903 * @param int $entry_id
1075 - *
1076 904 * @return void
1077 905 */
1078 906 private static function maybe_add_captcha_meta( $form_id, $entry_id ) {
1079 907 global $frm_vars;
1080 -
1081 - if ( ! array_key_exists( 'captcha_scores', $frm_vars ) || ! array_key_exists( $form_id, $frm_vars['captcha_scores'] ) ) {
1082 - return;
908 + if ( array_key_exists( 'captcha_scores', $frm_vars ) && array_key_exists( $form_id, $frm_vars['captcha_scores'] ) ) {
909 + $captcha_score_meta = array( 'captcha_score' => $frm_vars['captcha_scores'][ $form_id ] );
910 + FrmEntryMeta::add_entry_meta( $entry_id, 0, '', maybe_serialize( $captcha_score_meta ) );
1083 911 }
1084 -
1085 - $captcha_score_meta = array( 'captcha_score' => $frm_vars['captcha_scores'][ $form_id ] );
1086 - FrmEntryMeta::add_entry_meta( $entry_id, 0, '', maybe_serialize( $captcha_score_meta ) );
1087 912 }
1088 913
1089 914 /**
1090 915 * Trigger frm_after_create_entry hooks
@@ -1093,27 +918,15 @@
1093 918 *
1094 919 * @param int $entry_id
1095 920 * @param array $values
1096 921 * @param array $new_values
1097 - *
1098 - * @return void
1099 922 */
1100 923 private static function after_entry_created_actions( $entry_id, $values, $new_values ) {
1101 - // This is a child entry.
1102 - $is_child = isset( $values['parent_nonce'] ) && ! empty( $values['parent_form_id'] ) && wp_verify_nonce( $values['parent_nonce'], 'parent' );
924 + // this is a child entry
925 + $is_child = isset( $values['parent_form_id'] ) && isset( $values['parent_nonce'] ) && ! empty( $values['parent_form_id'] ) && wp_verify_nonce( $values['parent_nonce'], 'parent' );
1103 926
1104 927 do_action( 'frm_after_create_entry', $entry_id, $new_values['form_id'], compact( 'is_child' ) );
1105 928 do_action( 'frm_after_create_entry_' . $new_values['form_id'], $entry_id, compact( 'is_child' ) );
1106 -
1107 - if ( ! empty( $values['form_key'] ) ) {
1108 - /**
1109 - * @since 6.30
1110 - *
1111 - * @param int $entry_id
1112 - * @param array $is_child
1113 - */
1114 - do_action( 'frm_after_create_entry_' . $values['form_key'], $entry_id, compact( 'is_child' ) );
1115 - }
1116 929 }
1117 930
1118 931 /**
1119 932 * Actions to perform immediately after an entry is inserted in the frm_items database
@@ -1122,12 +935,11 @@
1122 935 *
1123 936 * @param array $values
1124 937 * @param array $new_values
1125 938 * @param int $entry_id
1126 - *
1127 - * @return void
1128 939 */
1129 940 private static function after_insert_entry_in_database( $values, $new_values, $entry_id ) {
941 +
1130 942 self::add_new_entry_to_frm_vars( $entry_id );
1131 943
1132 944 self::maybe_add_entry_metas( $values, $entry_id );
1133 945
@@ -1140,13 +952,13 @@
1140 952 * Perform some actions right before updating an entry
1141 953 *
1142 954 * @since 2.0.16
1143 955 *
1144 - * @param int|string $id
1145 - * @param array $values
1146 - * @param string $update_type
956 + * @param int $id
957 + * @param array $values
958 + * @param string $update_type
1147 959 *
1148 - * @return bool Update.
960 + * @return boolean $update
1149 961 */
1150 962 private static function before_update_entry( $id, &$values, $update_type ) {
1151 963 $update = true;
1152 964
@@ -1151,14 +963,13 @@
1151 963 $update = true;
1152 964
1153 965 global $frm_vars;
1154 966
1155 - // phpcs:ignore WordPress.PHP.StrictInArray.MissingTrueStrict
1156 - if ( isset( $frm_vars['saved_entries'] ) && is_array( $frm_vars['saved_entries'] ) && in_array( (int) $id, $frm_vars['saved_entries'] ) ) {
967 + if ( isset( $frm_vars['saved_entries'] ) && is_array( $frm_vars['saved_entries'] ) && in_array( (int) $id, (array) $frm_vars['saved_entries'] ) ) {
1157 968 $update = false;
1158 969 }
1159 970
1160 - if ( $update && $update_type !== 'xml' ) {
971 + if ( $update && $update_type != 'xml' ) {
1161 972 $values = apply_filters( 'frm_pre_update_entry', $values, $id );
1162 973 }
1163 974
1164 975 return $update;
@@ -1171,19 +982,19 @@
1171 982 *
1172 983 * @param int $id
1173 984 * @param array $values
1174 985 *
1175 - * @return array New values.
986 + * @return array $new_values
1176 987 */
1177 988 private static function package_entry_to_update( $id, $values ) {
1178 989 global $wpdb;
1179 990
1180 991 $new_values = array(
1181 - 'name' => FrmAppHelper::truncate( self::get_new_entry_name( $values ), 255, 1, '', true ),
992 + 'name' => self::get_new_entry_name( $values ),
1182 993 'form_id' => (int) self::get_entry_value( $values, 'form_id', null ),
1183 994 'is_draft' => self::get_is_draft_value( $values ),
1184 995 'updated_at' => current_time( 'mysql', 1 ),
1185 - 'updated_by' => $values['updated_by'] ?? get_current_user_id(),
996 + 'updated_by' => isset( $values['updated_by'] ) ? $values['updated_by'] : get_current_user_id(),
1186 997 );
1187 998
1188 999 if ( isset( $values['post_id'] ) ) {
1189 1000 $new_values['post_id'] = (int) $values['post_id'];
@@ -1200,9 +1011,11 @@
1200 1011 if ( isset( $values['frm_user_id'] ) && is_numeric( $values['frm_user_id'] ) ) {
1201 1012 $new_values['user_id'] = $values['frm_user_id'];
1202 1013 }
1203 1014
1204 - return apply_filters( 'frm_update_entry', $new_values, $id );
1015 + $new_values = apply_filters( 'frm_update_entry', $new_values, $id );
1016 +
1017 + return $new_values;
1205 1018 }
1206 1019
1207 1020 /**
1208 1021 * Perform some actions right after updating an entry
@@ -1208,14 +1021,12 @@
1208 1021 * Perform some actions right after updating an entry
1209 1022 *
1210 1023 * @since 2.0.16
1211 1024 *
1212 - * @param bool|int $query_results
1213 - * @param int|string $id
1214 - * @param array $values
1215 - * @param array $new_values
1216 - *
1217 - * @return void
1025 + * @param boolean|int $query_results
1026 + * @param int $id
1027 + * @param array $values
1028 + * @param array $new_values
1218 1029 */
1219 1030 private static function after_update_entry( $query_results, $id, $values, $new_values ) {
1220 1031 if ( $query_results ) {
1221 1032 self::clear_cache();
@@ -1221,9 +1032,8 @@
1221 1032 self::clear_cache();
1222 1033 }
1223 1034
1224 1035 global $frm_vars;
1225 -
1226 1036 if ( ! isset( $frm_vars['saved_entries'] ) ) {
1227 1037 $frm_vars['saved_entries'] = array();
1228 1038 }
1229 1039
@@ -1234,17 +1044,8 @@
1234 1044 }
1235 1045
1236 1046 do_action( 'frm_after_update_entry', $id, $new_values['form_id'] );
1237 1047 do_action( 'frm_after_update_entry_' . $new_values['form_id'], $id );
1238 -
1239 - if ( ! empty( $values['form_key'] ) ) {
1240 - /**
1241 - * @since 6.30
1242 - *
1243 - * @param int $entry_id
1244 - */
1245 - do_action( 'frm_after_update_entry_' . $values['form_key'], $id );
1246 - }
1247 1048 }
1248 1049
1249 1050 /**
1250 1051 * Create entry from an XML import
@@ -1253,12 +1054,14 @@
1253 1054 * @since 2.0.16
1254 1055 *
1255 1056 * @param array $values
1256 1057 *
1257 - * @return bool|int Entry ID.
1058 + * @return int | boolean $entry_id
1258 1059 */
1259 1060 public static function create_entry_from_xml( $values ) {
1260 - return self::create_entry( $values, 'xml' );
1061 + $entry_id = self::create_entry( $values, 'xml' );
1062 +
1063 + return $entry_id;
1261 1064 }
1262 1065
1263 1066 /**
1264 1067 * Update entry from an XML import
@@ -1268,12 +1071,14 @@
1268 1071 *
1269 1072 * @param int $id
1270 1073 * @param array $values
1271 1074 *
1272 - * @return bool|int Updated.
1075 + * @return int | boolean $updated
1273 1076 */
1274 1077 public static function update_entry_from_xml( $id, $values ) {
1275 - return self::update_entry( $id, $values, 'xml' );
1078 + $updated = self::update_entry( $id, $values, 'xml' );
1079 +
1080 + return $updated;
1276 1081 }
1277 1082
1278 1083 /**
1279 1084 * @param string $key
@@ -1281,8 +1086,9 @@
1281 1086 * @return int entry_id
1282 1087 */
1283 1088 public static function get_id_by_key( $key ) {
1284 1089 $entry_id = FrmDb::get_var( 'frm_items', array( 'item_key' => sanitize_title( $key ) ) );
1090 +
1285 1091 return (int) $entry_id;
1286 1092 }
1287 1093
1288 1094 /**
@@ -1289,9 +1095,9 @@
1289 1095 * Get entries count.
1290 1096 *
1291 1097 * @since 6.8
1292 1098 *
1293 - * @return int|string
1099 + * @return int
1294 1100 */
1295 1101 public static function get_entries_count() {
1296 1102 $args = array(
1297 1103 'or' => 1,