| @@ -6,9 +6,8 @@ | ||
| 6 | 6 | class FrmForm { |
| 7 | 7 | |
| 8 | 8 | /** |
| 9 | 9 | * @param array $values |
| 10 | - * | |
| 11 | 10 | * @return bool|int id on success or false on failure. |
| 12 | 11 | */ |
| 13 | 12 | public static function create( $values ) { |
| 14 | 13 | global $wpdb; |
| @@ -18,22 +17,22 @@ | ||
| 18 | 17 | $new_values = array( |
| 19 | 18 | 'form_key' => FrmAppHelper::get_unique_key( $values['form_key'], $wpdb->prefix . 'frm_forms', 'form_key' ), |
| 20 | 19 | 'name' => $values['name'], |
| 21 | 20 | 'description' => $values['description'], |
| 22 | - 'status' => $values['status'] ?? 'published', | |
| 23 | - 'logged_in' => $values['logged_in'] ?? 0, | |
| 21 | + 'status' => isset( $values['status'] ) ? $values['status'] : 'published', | |
| 22 | + 'logged_in' => isset( $values['logged_in'] ) ? $values['logged_in'] : 0, | |
| 24 | 23 | 'is_template' => isset( $values['is_template'] ) ? (int) $values['is_template'] : 0, |
| 25 | 24 | 'parent_form_id' => isset( $values['parent_form_id'] ) ? absint( $values['parent_form_id'] ) : 0, |
| 26 | 25 | 'editable' => isset( $values['editable'] ) ? (int) $values['editable'] : 0, |
| 27 | - 'created_at' => $values['created_at'] ?? current_time( 'mysql', 1 ), | |
| 26 | + 'created_at' => isset( $values['created_at'] ) ? $values['created_at'] : current_time( 'mysql', 1 ), | |
| 28 | 27 | ); |
| 29 | 28 | |
| 30 | 29 | $options = isset( $values['options'] ) ? (array) $values['options'] : array(); |
| 31 | 30 | FrmFormsHelper::fill_form_options( $options, $values ); |
| 32 | 31 | |
| 33 | - $options['before_html'] = $values['options']['before_html'] ?? FrmFormsHelper::get_default_html( 'before' ); | |
| 34 | - $options['after_html'] = $values['options']['after_html'] ?? FrmFormsHelper::get_default_html( 'after' ); | |
| 35 | - $options['submit_html'] = $values['options']['submit_html'] ?? FrmFormsHelper::get_default_html( 'submit' ); | |
| 32 | + $options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' ); | |
| 33 | + $options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' ); | |
| 34 | + $options['submit_html'] = isset( $values['options']['submit_html'] ) ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' ); | |
| 36 | 35 | |
| 37 | 36 | /** |
| 38 | 37 | * Allows modifying form options before updating or creating. |
| 39 | 38 | * |
| @@ -60,9 +59,8 @@ | ||
| 60 | 59 | /** |
| 61 | 60 | * @since 5.0.08 |
| 62 | 61 | * |
| 63 | 62 | * @param array $options |
| 64 | - * | |
| 65 | 63 | * @return array |
| 66 | 64 | */ |
| 67 | 65 | private static function maybe_filter_form_options( $options ) { |
| 68 | 66 | if ( ! FrmAppHelper::allow_unfiltered_html() && ! empty( $options['submit_html'] ) ) { |
| @@ -71,15 +69,8 @@ | ||
| 71 | 69 | return FrmAppHelper::maybe_filter_array( $options, array( 'submit_value', 'success_msg', 'before_html', 'after_html' ) ); |
| 72 | 70 | } |
| 73 | 71 | |
| 74 | 72 | /** |
| 75 | - * Duplicate a form. | |
| 76 | - * | |
| 77 | - * @param int $id Form ID to duplicate. | |
| 78 | - * @param bool $template Whether the duplicated form is a template. | |
| 79 | - * @param bool $copy_keys Whether to copy the original form key. | |
| 80 | - * @param false|int $blog_id Blog ID when duplicating across sites, or false for current site. | |
| 81 | - * | |
| 82 | 73 | * @return bool|int ID on success or false on failure |
| 83 | 74 | */ |
| 84 | 75 | public static function duplicate( $id, $template = false, $copy_keys = false, $blog_id = false ) { |
| 85 | 76 | global $wpdb; |
| @@ -84,9 +75,8 @@ | ||
| 84 | 75 | public static function duplicate( $id, $template = false, $copy_keys = false, $blog_id = false ) { |
| 85 | 76 | global $wpdb; |
| 86 | 77 | |
| 87 | 78 | $values = self::getOne( $id, $blog_id ); |
| 88 | - | |
| 89 | 79 | if ( ! $values ) { |
| 90 | 80 | return false; |
| 91 | 81 | } |
| 92 | 82 | |
| @@ -135,14 +125,8 @@ | ||
| 135 | 125 | |
| 136 | 126 | return false; |
| 137 | 127 | } |
| 138 | 128 | |
| 139 | - /** | |
| 140 | - * @param int $form_id | |
| 141 | - * @param array $values | |
| 142 | - * | |
| 143 | - * @return void | |
| 144 | - */ | |
| 145 | 129 | public static function after_duplicate( $form_id, $values ) { |
| 146 | 130 | $new_opts = $values['options']; |
| 147 | 131 | FrmAppHelper::unserialize_or_decode( $new_opts ); |
| 148 | 132 | $values['options'] = $new_opts; |
| @@ -166,10 +150,8 @@ | ||
| 166 | 150 | * |
| 167 | 151 | * @since 5.3 |
| 168 | 152 | * |
| 169 | 153 | * @param int $form_id Form ID. |
| 170 | - * | |
| 171 | - * @return void | |
| 172 | 154 | */ |
| 173 | 155 | private static function switch_field_ids_in_fields( $form_id ) { |
| 174 | 156 | global $wpdb; |
| 175 | 157 | |
| @@ -175,9 +157,8 @@ | ||
| 175 | 157 | |
| 176 | 158 | // Keys of fields that you want to check to replace field ID. |
| 177 | 159 | $keys = array( 'default_value', 'field_options' ); |
| 178 | 160 | $sql_cols = 'fi.id'; |
| 179 | - | |
| 180 | 161 | foreach ( $keys as $key ) { |
| 181 | 162 | $sql_cols .= ',fi.' . $key; |
| 182 | 163 | } |
| 183 | 164 | |
| @@ -205,14 +186,11 @@ | ||
| 205 | 186 | * |
| 206 | 187 | * @since 5.3 |
| 207 | 188 | * |
| 208 | 189 | * @param array $field Field array. |
| 209 | - * | |
| 210 | - * @return void | |
| 211 | 190 | */ |
| 212 | 191 | private static function switch_field_ids_in_field( $field ) { |
| 213 | 192 | $new_values = array(); |
| 214 | - | |
| 215 | 193 | foreach ( $field as $key => $value ) { |
| 216 | 194 | if ( 'id' === $key || ! $value ) { |
| 217 | 195 | continue; |
| 218 | 196 | } |
| @@ -240,14 +218,8 @@ | ||
| 240 | 218 | } |
| 241 | 219 | } |
| 242 | 220 | |
| 243 | 221 | /** |
| 244 | - * Update a form. | |
| 245 | - * | |
| 246 | - * @param int $id Form ID. | |
| 247 | - * @param array $values Form values to update. | |
| 248 | - * @param bool $create_link Whether this is being called from link creation. | |
| 249 | - * | |
| 250 | 222 | * @return bool|int |
| 251 | 223 | */ |
| 252 | 224 | public static function update( $id, $values, $create_link = false ) { |
| 253 | 225 | global $wpdb; |
| @@ -277,9 +249,8 @@ | ||
| 277 | 249 | } |
| 278 | 250 | |
| 279 | 251 | if ( ! empty( $new_values ) ) { |
| 280 | 252 | $query_results = $wpdb->update( $wpdb->prefix . 'frm_forms', $new_values, array( 'id' => $id ) ); |
| 281 | - | |
| 282 | 253 | if ( $query_results ) { |
| 283 | 254 | self::clear_form_cache(); |
| 284 | 255 | } |
| 285 | 256 | } else { |
| @@ -298,9 +269,8 @@ | ||
| 298 | 269 | /** |
| 299 | 270 | * @param array $new_values |
| 300 | 271 | * @param array $values |
| 301 | 272 | * @param array $args |
| 302 | - * | |
| 303 | 273 | * @return array |
| 304 | 274 | */ |
| 305 | 275 | public static function set_update_options( $new_values, $values, $args = array() ) { |
| 306 | 276 | if ( ! isset( $values['options'] ) ) { |
| @@ -309,11 +279,11 @@ | ||
| 309 | 279 | |
| 310 | 280 | $options = ! empty( $values['options'] ) ? (array) $values['options'] : array(); |
| 311 | 281 | FrmFormsHelper::fill_form_options( $options, $values ); |
| 312 | 282 | |
| 313 | - $options['custom_style'] = $values['options']['custom_style'] ?? 0; | |
| 314 | - $options['before_html'] = $values['options']['before_html'] ?? FrmFormsHelper::get_default_html( 'before' ); | |
| 315 | - $options['after_html'] = $values['options']['after_html'] ?? FrmFormsHelper::get_default_html( 'after' ); | |
| 283 | + $options['custom_style'] = isset( $values['options']['custom_style'] ) ? $values['options']['custom_style'] : 0; | |
| 284 | + $options['before_html'] = isset( $values['options']['before_html'] ) ? $values['options']['before_html'] : FrmFormsHelper::get_default_html( 'before' ); | |
| 285 | + $options['after_html'] = isset( $values['options']['after_html'] ) ? $values['options']['after_html'] : FrmFormsHelper::get_default_html( 'after' ); | |
| 316 | 286 | $options['submit_html'] = isset( $values['options']['submit_html'] ) && '' !== $values['options']['submit_html'] ? $values['options']['submit_html'] : FrmFormsHelper::get_default_html( 'submit' ); |
| 317 | 287 | |
| 318 | 288 | /** |
| 319 | 289 | * Allows modifying form options before updating or creating. |
| @@ -331,11 +301,8 @@ | ||
| 331 | 301 | return $new_values; |
| 332 | 302 | } |
| 333 | 303 | |
| 334 | 304 | /** |
| 335 | - * @param int $id Form ID. | |
| 336 | - * @param array $values Form values array. | |
| 337 | - * | |
| 338 | 305 | * @return array |
| 339 | 306 | */ |
| 340 | 307 | public static function update_fields( $id, $values ) { |
| 341 | 308 | |
| @@ -343,9 +310,8 @@ | ||
| 343 | 310 | return $values; |
| 344 | 311 | } |
| 345 | 312 | |
| 346 | 313 | $all_fields = FrmField::get_all_for_form( $id ); |
| 347 | - | |
| 348 | 314 | if ( empty( $all_fields ) ) { |
| 349 | 315 | return $values; |
| 350 | 316 | } |
| 351 | 317 | |
| @@ -354,9 +320,8 @@ | ||
| 354 | 320 | } |
| 355 | 321 | |
| 356 | 322 | $field_array = array(); |
| 357 | 323 | $existing_keys = array_keys( $values['item_meta'] ); |
| 358 | - | |
| 359 | 324 | foreach ( $all_fields as $fid ) { |
| 360 | 325 | if ( ! in_array( $fid->id, $existing_keys ) && ( isset( $values['frm_fields_submitted'] ) && in_array( $fid->id, $values['frm_fields_submitted'] ) ) || isset( $values['options'] ) ) { |
| 361 | 326 | $values['item_meta'][ $fid->id ] = ''; |
| 362 | 327 | } |
| @@ -375,9 +340,8 @@ | ||
| 375 | 340 | continue; |
| 376 | 341 | } |
| 377 | 342 | |
| 378 | 343 | $is_settings_page = ( isset( $values['options'] ) || isset( $values['field_options'][ 'custom_html_' . $field_id ] ) ); |
| 379 | - | |
| 380 | 344 | if ( $is_settings_page ) { |
| 381 | 345 | self::get_settings_page_html( $values, $field ); |
| 382 | 346 | |
| 383 | 347 | if ( ! defined( 'WP_IMPORTING' ) ) { |
| @@ -390,14 +354,10 @@ | ||
| 390 | 354 | // Don't check for POST html. |
| 391 | 355 | unset( $update_options['custom_html'] ); |
| 392 | 356 | $update_options = apply_filters( 'frm_field_options_to_update', $update_options ); |
| 393 | 357 | |
| 394 | - if ( ! is_array( $field->field_options ) ) { | |
| 395 | - $field->field_options = array(); | |
| 396 | - } | |
| 397 | - | |
| 398 | 358 | foreach ( $update_options as $opt => $default ) { |
| 399 | - $field->field_options[ $opt ] = $values['field_options'][ $opt . '_' . $field_id ] ?? $default; | |
| 359 | + $field->field_options[ $opt ] = isset( $values['field_options'][ $opt . '_' . $field_id ] ) ? $values['field_options'][ $opt . '_' . $field_id ] : $default; | |
| 400 | 360 | self::sanitize_field_opt( $opt, $field->field_options[ $opt ] ); |
| 401 | 361 | } |
| 402 | 362 | |
| 403 | 363 | $field->field_options = apply_filters( 'frm_update_field_options', $field->field_options, $field, $values ); |
| @@ -436,9 +396,8 @@ | ||
| 436 | 396 | * |
| 437 | 397 | * @param array $field |
| 438 | 398 | * @param array $values |
| 439 | 399 | * @param array $new_field |
| 440 | - * | |
| 441 | 400 | * @return void |
| 442 | 401 | */ |
| 443 | 402 | private static function maybe_update_max_option( $field, $values, &$new_field ) { |
| 444 | 403 | if ( $field->type === 'textarea' && |
| @@ -457,9 +416,8 @@ | ||
| 457 | 416 | |
| 458 | 417 | /** |
| 459 | 418 | * @param string $opt |
| 460 | 419 | * @param mixed $value |
| 461 | - * | |
| 462 | 420 | * @return void |
| 463 | 421 | */ |
| 464 | 422 | private static function sanitize_field_opt( $opt, &$value ) { |
| 465 | 423 | if ( ! is_string( $value ) ) { |
| @@ -491,9 +449,8 @@ | ||
| 491 | 449 | } |
| 492 | 450 | |
| 493 | 451 | /** |
| 494 | 452 | * @param string $value |
| 495 | - * | |
| 496 | 453 | * @return string |
| 497 | 454 | */ |
| 498 | 455 | private static function sanitize_calc( $value ) { |
| 499 | 456 | if ( false !== strpos( $value, '<' ) ) { |
| @@ -512,9 +469,8 @@ | ||
| 512 | 469 | * Format a comparison like 5<10 to 5 < 10. Also works on 5< 10, 5 <10, 5<=10 variations. |
| 513 | 470 | * This is to avoid an issue with unspaced calculations being recognized as HTML that gets removed when strip_tags is called. |
| 514 | 471 | * |
| 515 | 472 | * @param string $calc |
| 516 | - * | |
| 517 | 473 | * @return string |
| 518 | 474 | */ |
| 519 | 475 | private static function normalize_calc_spaces( $calc ) { |
| 520 | 476 | // Check for a pattern with 5 parts |
| @@ -529,20 +485,15 @@ | ||
| 529 | 485 | } |
| 530 | 486 | |
| 531 | 487 | /** |
| 532 | 488 | * Updating the settings page |
| 533 | - * | |
| 534 | - * @param array $values Form values array. | |
| 535 | - * @param object $field Field object, passed by reference. | |
| 536 | - * | |
| 537 | - * @return void | |
| 538 | 489 | */ |
| 539 | 490 | private static function get_settings_page_html( $values, &$field ) { |
| 540 | 491 | if ( isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ) { |
| 541 | 492 | $prev_opts = array(); |
| 542 | - $fallback_html = $field->field_options['custom_html'] ?? FrmFieldsHelper::get_default_html( $field->type ); | |
| 493 | + $fallback_html = isset( $field->field_options['custom_html'] ) ? $field->field_options['custom_html'] : FrmFieldsHelper::get_default_html( $field->type ); | |
| 543 | 494 | |
| 544 | - $field->field_options['custom_html'] = $values['field_options'][ 'custom_html_' . $field->id ] ?? $fallback_html; | |
| 495 | + $field->field_options['custom_html'] = isset( $values['field_options'][ 'custom_html_' . $field->id ] ) ? $values['field_options'][ 'custom_html_' . $field->id ] : $fallback_html; | |
| 545 | 496 | } elseif ( $field->type === 'hidden' || $field->type === 'user_id' ) { |
| 546 | 497 | $prev_opts = $field->field_options; |
| 547 | 498 | } |
| 548 | 499 | |
| @@ -547,9 +498,8 @@ | ||
| 547 | 498 | } |
| 548 | 499 | |
| 549 | 500 | if ( isset( $prev_opts ) ) { |
| 550 | 501 | $field->field_options = apply_filters( 'frm_update_form_field_options', $field->field_options, $field, $values ); |
| 551 | - | |
| 552 | 502 | if ( $prev_opts != $field->field_options ) { |
| 553 | 503 | FrmField::update( $field->id, array( 'field_options' => $field->field_options ) ); |
| 554 | 504 | } |
| 555 | 505 | } |
| @@ -554,15 +504,8 @@ | ||
| 554 | 504 | } |
| 555 | 505 | } |
| 556 | 506 | } |
| 557 | 507 | |
| 558 | - /** | |
| 559 | - * @param object $field | |
| 560 | - * @param array $values | |
| 561 | - * @param array $new_field | |
| 562 | - * | |
| 563 | - * @return void | |
| 564 | - */ | |
| 565 | 508 | private static function prepare_field_update_values( $field, $values, &$new_field ) { |
| 566 | 509 | $field_cols = array( |
| 567 | 510 | 'field_order' => 0, |
| 568 | 511 | 'field_key' => '', |
| @@ -571,12 +514,11 @@ | ||
| 571 | 514 | 'description' => '', |
| 572 | 515 | 'options' => '', |
| 573 | 516 | 'name' => '', |
| 574 | 517 | ); |
| 575 | - | |
| 576 | 518 | foreach ( $field_cols as $col => $default ) { |
| 577 | 519 | $default = $default === '' ? $field->{$col} : $default; |
| 578 | - $new_field[ $col ] = $values['field_options'][ $col . '_' . $field->id ] ?? $default; | |
| 520 | + $new_field[ $col ] = isset( $values['field_options'][ $col . '_' . $field->id ] ) ? $values['field_options'][ $col . '_' . $field->id ] : $default; | |
| 579 | 521 | } |
| 580 | 522 | |
| 581 | 523 | if ( $field->type === 'submit' && isset( $new_field['field_order'] ) && (int) $new_field['field_order'] === FrmSubmitHelper::DEFAULT_ORDER ) { |
| 582 | 524 | $new_field['field_order'] = $field->field_order; |
| @@ -592,12 +534,9 @@ | ||
| 592 | 534 | * Get a list of all form settings that should be translated |
| 593 | 535 | * on a multilingual site. |
| 594 | 536 | * |
| 595 | 537 | * @since 3.06.01 |
| 596 | - * | |
| 597 | 538 | * @param object $form The form object. |
| 598 | - * | |
| 599 | - * @return array | |
| 600 | 539 | */ |
| 601 | 540 | public static function translatable_strings( $form ) { |
| 602 | 541 | $strings = array( |
| 603 | 542 | 'name', |
| @@ -625,9 +564,8 @@ | ||
| 625 | 564 | return self::trash( $id ); |
| 626 | 565 | } |
| 627 | 566 | |
| 628 | 567 | $statuses = array( 'published', 'draft', 'trash' ); |
| 629 | - | |
| 630 | 568 | if ( ! in_array( $status, $statuses, true ) ) { |
| 631 | 569 | return false; |
| 632 | 570 | } |
| 633 | 571 | |
| @@ -655,10 +593,8 @@ | ||
| 655 | 593 | return $query_results; |
| 656 | 594 | } |
| 657 | 595 | |
| 658 | 596 | /** |
| 659 | - * @param int|string $id Form ID. | |
| 660 | - * | |
| 661 | 597 | * @return bool|int |
| 662 | 598 | */ |
| 663 | 599 | public static function trash( $id ) { |
| 664 | 600 | if ( ! EMPTY_TRASH_DAYS ) { |
| @@ -665,9 +601,8 @@ | ||
| 665 | 601 | return self::destroy( $id ); |
| 666 | 602 | } |
| 667 | 603 | |
| 668 | 604 | $form = self::getOne( $id ); |
| 669 | - | |
| 670 | 605 | if ( ! $form ) { |
| 671 | 606 | return false; |
| 672 | 607 | } |
| 673 | 608 | |
| @@ -708,10 +643,8 @@ | ||
| 708 | 643 | return $query_results; |
| 709 | 644 | } |
| 710 | 645 | |
| 711 | 646 | /** |
| 712 | - * @param int|string $id Form ID. | |
| 713 | - * | |
| 714 | 647 | * @return bool|int |
| 715 | 648 | */ |
| 716 | 649 | public static function destroy( $id ) { |
| 717 | 650 | global $wpdb; |
| @@ -716,18 +649,15 @@ | ||
| 716 | 649 | public static function destroy( $id ) { |
| 717 | 650 | global $wpdb; |
| 718 | 651 | |
| 719 | 652 | $form = self::getOne( $id ); |
| 720 | - | |
| 721 | 653 | if ( ! $form ) { |
| 722 | 654 | return false; |
| 723 | 655 | } |
| 724 | - | |
| 725 | 656 | $id = $form->id; |
| 726 | 657 | |
| 727 | 658 | // Disconnect the entries from this form |
| 728 | 659 | $entries = FrmDb::get_col( $wpdb->prefix . 'frm_items', array( 'form_id' => $id ) ); |
| 729 | - | |
| 730 | 660 | foreach ( $entries as $entry_id ) { |
| 731 | 661 | FrmEntry::destroy( $entry_id ); |
| 732 | 662 | unset( $entry_id ); |
| 733 | 663 | } |
| @@ -735,9 +665,8 @@ | ||
| 735 | 665 | // Disconnect the fields from this form |
| 736 | 666 | $wpdb->query( $wpdb->prepare( 'DELETE fi FROM ' . $wpdb->prefix . 'frm_fields AS fi LEFT JOIN ' . $wpdb->prefix . 'frm_forms fr ON (fi.form_id = fr.id) WHERE fi.form_id=%d OR parent_form_id=%d', $id, $id ) ); |
| 737 | 667 | |
| 738 | 668 | $query_results = $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . $wpdb->prefix . 'frm_forms WHERE id=%d OR parent_form_id=%d', $id, $id ) ); |
| 739 | - | |
| 740 | 669 | if ( $query_results ) { |
| 741 | 670 | // Delete all form actions linked to this form |
| 742 | 671 | /** |
| 743 | 672 | * @var FrmFormAction |
| @@ -757,10 +686,8 @@ | ||
| 757 | 686 | |
| 758 | 687 | /** |
| 759 | 688 | * Delete trashed forms based on how long they have been trashed |
| 760 | 689 | * |
| 761 | - * @param int|string $delete_timestamp Timestamp cutoff for deletion. | |
| 762 | - * | |
| 763 | 690 | * @return int The number of forms deleted |
| 764 | 691 | */ |
| 765 | 692 | public static function scheduled_delete( $delete_timestamp = '' ) { |
| 766 | 693 | global $wpdb; |
| @@ -775,15 +702,12 @@ | ||
| 775 | 702 | $delete_timestamp = time() - ( DAY_IN_SECONDS * EMPTY_TRASH_DAYS ); |
| 776 | 703 | } |
| 777 | 704 | |
| 778 | 705 | $count = 0; |
| 779 | - | |
| 780 | 706 | foreach ( $trash_forms as $form ) { |
| 781 | 707 | FrmAppHelper::unserialize_or_decode( $form->options ); |
| 782 | - | |
| 783 | 708 | if ( ! isset( $form->options['trash_time'] ) || $form->options['trash_time'] < $delete_timestamp ) { |
| 784 | 709 | self::destroy( $form->id ); |
| 785 | - | |
| 786 | 710 | if ( empty( $form->parent_form_id ) ) { |
| 787 | 711 | ++$count; |
| 788 | 712 | } |
| 789 | 713 | } |
| @@ -794,15 +718,12 @@ | ||
| 794 | 718 | return $count; |
| 795 | 719 | } |
| 796 | 720 | |
| 797 | 721 | /** |
| 798 | - * @param int|string $id Form ID or key. | |
| 799 | - * | |
| 800 | 722 | * @return string form name |
| 801 | 723 | */ |
| 802 | 724 | public static function getName( $id ) { |
| 803 | 725 | $form = FrmDb::check_cache( $id, 'frm_form' ); |
| 804 | - | |
| 805 | 726 | if ( $form ) { |
| 806 | 727 | $r = stripslashes( $form->name ); |
| 807 | 728 | |
| 808 | 729 | return $r; |
| @@ -830,9 +751,9 @@ | ||
| 830 | 751 | |
| 831 | 752 | /** |
| 832 | 753 | * @since 3.0 |
| 833 | 754 | * |
| 834 | - * @param int|string $id | |
| 755 | + * @param int $id | |
| 835 | 756 | * |
| 836 | 757 | * @return string form key |
| 837 | 758 | */ |
| 838 | 759 | public static function get_key_by_id( $id ) { |
| @@ -837,9 +758,8 @@ | ||
| 837 | 758 | */ |
| 838 | 759 | public static function get_key_by_id( $id ) { |
| 839 | 760 | $id = (int) $id; |
| 840 | 761 | $cache = FrmDb::check_cache( $id, 'frm_form' ); |
| 841 | - | |
| 842 | 762 | if ( $cache ) { |
| 843 | 763 | return $cache->form_key; |
| 844 | 764 | } |
| 845 | 765 | |
| @@ -851,12 +771,9 @@ | ||
| 851 | 771 | /** |
| 852 | 772 | * If $form is numeric, get the form object |
| 853 | 773 | * |
| 854 | 774 | * @since 2.0.9 |
| 855 | - * | |
| 856 | 775 | * @param int|object $form |
| 857 | - * | |
| 858 | - * @return void | |
| 859 | 776 | */ |
| 860 | 777 | public static function maybe_get_form( &$form ) { |
| 861 | 778 | if ( ! is_object( $form ) && ! is_array( $form ) && ! empty( $form ) ) { |
| 862 | 779 | $form = self::getOne( $form ); |
| @@ -865,9 +782,8 @@ | ||
| 865 | 782 | |
| 866 | 783 | /** |
| 867 | 784 | * @param int|string $id |
| 868 | 785 | * @param false|int $blog_id |
| 869 | - * | |
| 870 | 786 | * @return stdClass|null |
| 871 | 787 | */ |
| 872 | 788 | public static function getOne( $id, $blog_id = false ) { |
| 873 | 789 | global $wpdb; |
| @@ -872,14 +788,15 @@ | ||
| 872 | 788 | public static function getOne( $id, $blog_id = false ) { |
| 873 | 789 | global $wpdb; |
| 874 | 790 | |
| 875 | 791 | if ( $blog_id && is_multisite() ) { |
| 876 | - $prefix = $wpdb->get_blog_prefix( $blog_id ); | |
| 792 | + global $wpmuBaseTablePrefix; | |
| 793 | + $prefix = $wpmuBaseTablePrefix ? $wpmuBaseTablePrefix . $blog_id . '_' : $wpdb->get_blog_prefix( $blog_id ); | |
| 794 | + | |
| 877 | 795 | $table_name = $prefix . 'frm_forms'; |
| 878 | 796 | } else { |
| 879 | 797 | $table_name = $wpdb->prefix . 'frm_forms'; |
| 880 | 798 | $cache = wp_cache_get( $id, 'frm_form' ); |
| 881 | - | |
| 882 | 799 | if ( $cache ) { |
| 883 | 800 | if ( isset( $cache->options ) ) { |
| 884 | 801 | FrmAppHelper::unserialize_or_decode( $cache->options ); |
| 885 | 802 | } |
| @@ -908,14 +825,12 @@ | ||
| 908 | 825 | * |
| 909 | 826 | * @since 6.8.3 |
| 910 | 827 | * |
| 911 | 828 | * @param stdClass|null $row The database row for a target form. |
| 912 | - * | |
| 913 | 829 | * @return stdClass|null |
| 914 | 830 | */ |
| 915 | 831 | private static function prepare_form_row_data( $row ) { |
| 916 | 832 | $row = wp_unslash( $row ); |
| 917 | - | |
| 918 | 833 | if ( ! is_object( $row ) ) { |
| 919 | 834 | return $row; |
| 920 | 835 | } |
| 921 | 836 | |
| @@ -931,12 +846,8 @@ | ||
| 931 | 846 | return apply_filters( 'frm_form_object', $row ); |
| 932 | 847 | } |
| 933 | 848 | |
| 934 | 849 | /** |
| 935 | - * @param array|string $where Where conditions array or raw WHERE string. | |
| 936 | - * @param string $order_by Order by clause. | |
| 937 | - * @param int|string $limit Limit clause or number. | |
| 938 | - * | |
| 939 | 850 | * @return array|object of objects |
| 940 | 851 | */ |
| 941 | 852 | public static function getAll( $where = array(), $order_by = '', $limit = '' ) { |
| 942 | 853 | if ( is_array( $where ) && ! empty( $where ) ) { |
| @@ -976,15 +887,13 @@ | ||
| 976 | 887 | * |
| 977 | 888 | * @param array $query |
| 978 | 889 | * @param int $limit |
| 979 | 890 | * @param string $inc_children |
| 980 | - * | |
| 981 | 891 | * @return array|object of forms A single form object would be passed if $limit was set to 1. |
| 982 | 892 | */ |
| 983 | 893 | public static function get_published_forms( $query = array(), $limit = 999, $inc_children = 'exclude' ) { |
| 984 | 894 | $query['is_template'] = 0; |
| 985 | 895 | $query['status'] = array( null, '', 'published' ); |
| 986 | - | |
| 987 | 896 | if ( $inc_children === 'exclude' ) { |
| 988 | 897 | $query['parent_form_id'] = array( null, 0 ); |
| 989 | 898 | } |
| 990 | 899 | |
| @@ -1001,14 +910,13 @@ | ||
| 1001 | 910 | |
| 1002 | 911 | $cache_key = 'frm_form_counts'; |
| 1003 | 912 | |
| 1004 | 913 | $counts = wp_cache_get( $cache_key, 'frm_form' ); |
| 1005 | - | |
| 1006 | 914 | if ( false !== $counts ) { |
| 1007 | 915 | return $counts; |
| 1008 | 916 | } |
| 1009 | 917 | |
| 1010 | - $results = FrmDb::get_results( | |
| 918 | + $results = (array) FrmDb::get_results( | |
| 1011 | 919 | 'frm_forms', |
| 1012 | 920 | array( |
| 1013 | 921 | 'or' => 1, |
| 1014 | 922 | 'parent_form_id' => null, |
| @@ -1049,10 +957,8 @@ | ||
| 1049 | 957 | * Called when a form is created, updated, duplicated, or deleted |
| 1050 | 958 | * or when the form status is changed |
| 1051 | 959 | * |
| 1052 | 960 | * @since 2.0.4 |
| 1053 | - * | |
| 1054 | - * @return void | |
| 1055 | 961 | */ |
| 1056 | 962 | public static function clear_form_cache() { |
| 1057 | 963 | FrmDb::cache_delete_group( 'frm_form' ); |
| 1058 | 964 | } |
| @@ -1057,22 +963,16 @@ | ||
| 1057 | 963 | FrmDb::cache_delete_group( 'frm_form' ); |
| 1058 | 964 | } |
| 1059 | 965 | |
| 1060 | 966 | /** |
| 1061 | - * @param array $values Form values to validate. | |
| 1062 | - * | |
| 1063 | 967 | * @return array of errors |
| 1064 | 968 | */ |
| 1065 | 969 | public static function validate( $values ) { |
| 1066 | 970 | $errors = array(); |
| 971 | + | |
| 1067 | 972 | return apply_filters( 'frm_validate_form', $errors, $values ); |
| 1068 | 973 | } |
| 1069 | 974 | |
| 1070 | - /** | |
| 1071 | - * @param object|null $form | |
| 1072 | - * | |
| 1073 | - * @return array | |
| 1074 | - */ | |
| 1075 | 975 | public static function get_params( $form = null ) { |
| 1076 | 976 | global $frm_vars; |
| 1077 | 977 | |
| 1078 | 978 | if ( ! $form ) { |
| @@ -1102,9 +1002,8 @@ | ||
| 1102 | 1002 | ); |
| 1103 | 1003 | |
| 1104 | 1004 | $values = array(); |
| 1105 | 1005 | $values['posted_form_id'] = FrmAppHelper::get_param( 'form_id', '', 'get', 'absint' ); |
| 1106 | - | |
| 1107 | 1006 | if ( ! $values['posted_form_id'] ) { |
| 1108 | 1007 | $values['posted_form_id'] = FrmAppHelper::get_param( 'form', '', 'get', 'absint' ); |
| 1109 | 1008 | } |
| 1110 | 1009 | |
| @@ -1133,11 +1032,8 @@ | ||
| 1133 | 1032 | |
| 1134 | 1033 | return $values; |
| 1135 | 1034 | } |
| 1136 | 1035 | |
| 1137 | - /** | |
| 1138 | - * @return array | |
| 1139 | - */ | |
| 1140 | 1036 | public static function list_page_params() { |
| 1141 | 1037 | $values = array(); |
| 1142 | 1038 | $defaults = array( |
| 1143 | 1039 | 'template' => 0, |
| @@ -1147,9 +1043,8 @@ | ||
| 1147 | 1043 | 'search' => '', |
| 1148 | 1044 | 'sort' => '', |
| 1149 | 1045 | 'sdir' => '', |
| 1150 | 1046 | ); |
| 1151 | - | |
| 1152 | 1047 | foreach ( $defaults as $var => $default ) { |
| 1153 | 1048 | $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' ); |
| 1154 | 1049 | } |
| 1155 | 1050 | |
| @@ -1155,16 +1050,10 @@ | ||
| 1155 | 1050 | |
| 1156 | 1051 | return $values; |
| 1157 | 1052 | } |
| 1158 | 1053 | |
| 1159 | - /** | |
| 1160 | - * @param int|object|string|null $form | |
| 1161 | - * | |
| 1162 | - * @return array | |
| 1163 | - */ | |
| 1164 | 1054 | public static function get_admin_params( $form = null ) { |
| 1165 | 1055 | $form_id = $form; |
| 1166 | - | |
| 1167 | 1056 | if ( $form === null ) { |
| 1168 | 1057 | $form_id = self::get_current_form_id(); |
| 1169 | 1058 | } elseif ( $form && is_object( $form ) ) { |
| 1170 | 1059 | $form_id = $form->id; |
| @@ -1182,9 +1071,8 @@ | ||
| 1182 | 1071 | 'sdir' => '', |
| 1183 | 1072 | 'fid' => '', |
| 1184 | 1073 | 'keep_post' => '', |
| 1185 | 1074 | ); |
| 1186 | - | |
| 1187 | 1075 | foreach ( $defaults as $var => $default ) { |
| 1188 | 1076 | $values[ $var ] = FrmAppHelper::get_param( $var, $default, 'get', 'sanitize_text_field' ); |
| 1189 | 1077 | } |
| 1190 | 1078 | |
| @@ -1190,13 +1078,8 @@ | ||
| 1190 | 1078 | |
| 1191 | 1079 | return $values; |
| 1192 | 1080 | } |
| 1193 | 1081 | |
| 1194 | - /** | |
| 1195 | - * @param string $default_form | |
| 1196 | - * | |
| 1197 | - * @return int|string | |
| 1198 | - */ | |
| 1199 | 1082 | public static function get_current_form_id( $default_form = 'none' ) { |
| 1200 | 1083 | if ( 'first' === $default_form ) { |
| 1201 | 1084 | $form = self::get_current_form(); |
| 1202 | 1085 | } else { |
| @@ -1201,19 +1084,13 @@ | ||
| 1201 | 1084 | $form = self::get_current_form(); |
| 1202 | 1085 | } else { |
| 1203 | 1086 | $form = self::maybe_get_current_form(); |
| 1204 | 1087 | } |
| 1205 | - | |
| 1206 | 1088 | $form_id = $form ? $form->id : 0; |
| 1207 | 1089 | |
| 1208 | 1090 | return $form_id; |
| 1209 | 1091 | } |
| 1210 | 1092 | |
| 1211 | - /** | |
| 1212 | - * @param int|string $form_id | |
| 1213 | - * | |
| 1214 | - * @return false|int|object|string | |
| 1215 | - */ | |
| 1216 | 1093 | public static function maybe_get_current_form( $form_id = 0 ) { |
| 1217 | 1094 | global $frm_vars; |
| 1218 | 1095 | |
| 1219 | 1096 | if ( ! empty( $frm_vars['current_form'] ) && ( ! $form_id || $form_id == $frm_vars['current_form']->id ) ) { |
| @@ -1220,9 +1097,8 @@ | ||
| 1220 | 1097 | return $frm_vars['current_form']; |
| 1221 | 1098 | } |
| 1222 | 1099 | |
| 1223 | 1100 | $form_id = FrmAppHelper::get_param( 'form', $form_id, 'get', 'absint' ); |
| 1224 | - | |
| 1225 | 1101 | if ( $form_id ) { |
| 1226 | 1102 | $form_id = self::set_current_form( $form_id ); |
| 1227 | 1103 | } |
| 1228 | 1104 | |
| @@ -1228,16 +1104,10 @@ | ||
| 1228 | 1104 | |
| 1229 | 1105 | return $form_id; |
| 1230 | 1106 | } |
| 1231 | 1107 | |
| 1232 | - /** | |
| 1233 | - * @param int $form_id | |
| 1234 | - * | |
| 1235 | - * @return false|object | |
| 1236 | - */ | |
| 1237 | 1108 | public static function get_current_form( $form_id = 0 ) { |
| 1238 | 1109 | $form = self::maybe_get_current_form( $form_id ); |
| 1239 | - | |
| 1240 | 1110 | if ( is_numeric( $form ) ) { |
| 1241 | 1111 | $form = self::set_current_form( $form ); |
| 1242 | 1112 | } |
| 1243 | 1113 | |
| @@ -1243,18 +1113,12 @@ | ||
| 1243 | 1113 | |
| 1244 | 1114 | return $form; |
| 1245 | 1115 | } |
| 1246 | 1116 | |
| 1247 | - /** | |
| 1248 | - * @param int $form_id | |
| 1249 | - * | |
| 1250 | - * @return false|object | |
| 1251 | - */ | |
| 1252 | 1117 | public static function set_current_form( $form_id ) { |
| 1253 | 1118 | global $frm_vars; |
| 1254 | 1119 | |
| 1255 | 1120 | $query = array(); |
| 1256 | - | |
| 1257 | 1121 | if ( $form_id ) { |
| 1258 | 1122 | $query['id'] = $form_id; |
| 1259 | 1123 | } |
| 1260 | 1124 | |
| @@ -1262,19 +1126,11 @@ | ||
| 1262 | 1126 | |
| 1263 | 1127 | return $frm_vars['current_form']; |
| 1264 | 1128 | } |
| 1265 | 1129 | |
| 1266 | - /** | |
| 1267 | - * @param object $form | |
| 1268 | - * @param int|string $this_load | |
| 1269 | - * @param bool $global_load | |
| 1270 | - * | |
| 1271 | - * @return bool | |
| 1272 | - */ | |
| 1273 | 1130 | public static function is_form_loaded( $form, $this_load, $global_load ) { |
| 1274 | 1131 | global $frm_vars; |
| 1275 | 1132 | $small_form = new stdClass(); |
| 1276 | - | |
| 1277 | 1133 | foreach ( array( 'id', 'form_key', 'name' ) as $var ) { |
| 1278 | 1134 | $small_form->{$var} = $form->{$var}; |
| 1279 | 1135 | unset( $var ); |
| 1280 | 1136 | } |
| @@ -1302,24 +1158,11 @@ | ||
| 1302 | 1158 | } else { |
| 1303 | 1159 | $visible = true; |
| 1304 | 1160 | } |
| 1305 | 1161 | |
| 1306 | - /** | |
| 1307 | - * @since 6.25 | |
| 1308 | - * | |
| 1309 | - * @param bool $visible | |
| 1310 | - * @param object $form | |
| 1311 | - */ | |
| 1312 | - $visible = (bool) apply_filters( 'frm_form_is_visible', $visible, $form ); | |
| 1313 | - | |
| 1314 | 1162 | return $visible; |
| 1315 | 1163 | } |
| 1316 | 1164 | |
| 1317 | - /** | |
| 1318 | - * @param object $form | |
| 1319 | - * | |
| 1320 | - * @return bool | |
| 1321 | - */ | |
| 1322 | 1165 | public static function show_submit( $form ) { |
| 1323 | 1166 | $show = ( ! $form->is_template && $form->status === 'published' && ! FrmAppHelper::is_admin() ); |
| 1324 | 1167 | $show = apply_filters( 'frm_show_submit_button', $show, $form ); |
| 1325 | 1168 | |
| @@ -1327,18 +1170,14 @@ | ||
| 1327 | 1170 | } |
| 1328 | 1171 | |
| 1329 | 1172 | /** |
| 1330 | 1173 | * @since 2.3 |
| 1331 | - * | |
| 1332 | - * @param array $atts Attributes including form, option, and default. | |
| 1333 | - * | |
| 1334 | - * @return mixed | |
| 1335 | 1174 | */ |
| 1336 | 1175 | public static function get_option( $atts ) { |
| 1337 | 1176 | $form = $atts['form']; |
| 1338 | - $default = $atts['default'] ?? ''; | |
| 1177 | + $default = isset( $atts['default'] ) ? $atts['default'] : ''; | |
| 1339 | 1178 | |
| 1340 | - return $form->options[ $atts['option'] ] ?? $default; | |
| 1179 | + return isset( $form->options[ $atts['option'] ] ) ? $form->options[ $atts['option'] ] : $default; | |
| 1341 | 1180 | } |
| 1342 | 1181 | |
| 1343 | 1182 | /** |
| 1344 | 1183 | * Get the link to edit this form. |
| @@ -1343,12 +1182,9 @@ | ||
| 1343 | 1182 | /** |
| 1344 | 1183 | * Get the link to edit this form. |
| 1345 | 1184 | * |
| 1346 | 1185 | * @since 4.0 |
| 1347 | - * | |
| 1348 | 1186 | * @param int $form_id The id of the form. |
| 1349 | - * | |
| 1350 | - * @return string | |
| 1351 | 1187 | */ |
| 1352 | 1188 | public static function get_edit_link( $form_id ) { |
| 1353 | 1189 | return admin_url( 'admin.php?page=formidable&frm_action=edit&id=' . $form_id ); |
| 1354 | 1190 | } |
| @@ -1358,9 +1194,8 @@ | ||
| 1358 | 1194 | * |
| 1359 | 1195 | * @since 6.2 |
| 1360 | 1196 | * |
| 1361 | 1197 | * @param stdClass $form |
| 1362 | - * | |
| 1363 | 1198 | * @return bool |
| 1364 | 1199 | */ |
| 1365 | 1200 | public static function is_ajax_on( $form ) { |
| 1366 | 1201 | return ! empty( $form->options['ajax_submit'] ); |
| @@ -1369,9 +1204,8 @@ | ||
| 1369 | 1204 | /** |
| 1370 | 1205 | * Get the latest form available. |
| 1371 | 1206 | * |
| 1372 | 1207 | * @since 6.8 |
| 1373 | - * | |
| 1374 | 1208 | * @return object |
| 1375 | 1209 | */ |
| 1376 | 1210 | public static function get_latest_form() { |
| 1377 | 1211 | |
| @@ -1391,9 +1225,8 @@ | ||
| 1391 | 1225 | /** |
| 1392 | 1226 | * Count and return total forms. |
| 1393 | 1227 | * |
| 1394 | 1228 | * @since 6.8 |
| 1395 | - * | |
| 1396 | 1229 | * @return int |
| 1397 | 1230 | */ |
| 1398 | 1231 | public static function get_forms_count() { |
| 1399 | 1232 | |
| @@ -1411,13 +1244,11 @@ | ||
| 1411 | 1244 | } |
| 1412 | 1245 | |
| 1413 | 1246 | /** |
| 1414 | 1247 | * @deprecated 2.03.05 This is still referenced in a few add ons (API, locations). |
| 1415 | - * | |
| 1416 | 1248 | * @codeCoverageIgnore |
| 1417 | 1249 | * |
| 1418 | 1250 | * @param string $key |
| 1419 | - * | |
| 1420 | 1251 | * @return int form id |
| 1421 | 1252 | */ |
| 1422 | 1253 | public static function getIdByKey( $key ) { |
| 1423 | 1254 | _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_id_by_key' ); |
| @@ -1425,13 +1256,11 @@ | ||
| 1425 | 1256 | } |
| 1426 | 1257 | |
| 1427 | 1258 | /** |
| 1428 | 1259 | * @deprecated 2.03.05 This is still referenced in the API add on as of v1.13. |
| 1429 | - * | |
| 1430 | 1260 | * @codeCoverageIgnore |
| 1431 | 1261 | * |
| 1432 | 1262 | * @param int|string $id |
| 1433 | - * | |
| 1434 | 1263 | * @return string |
| 1435 | 1264 | */ |
| 1436 | 1265 | public static function getKeyById( $id ) { |
| 1437 | 1266 | _deprecated_function( __FUNCTION__, '2.03.05', 'FrmForm::get_key_by_id' ); |
