Changeset 3746820 for formidable/trunk/classes/models/FrmEntryMeta.php

Timestamp:

10/14/2026 04:54:36 PM (2 weeks ago)

Author:

formidableforms

Message:

Update to version 7.0 from GitHub

File:

• formidable/trunk/classes/models/FrmEntryMeta.php (modified) (8 diffs)

formidable/trunk/classes/models/FrmEntryMeta.php

@@ -5 +5 @@
 
 class FrmEntryMeta {
+
+        /**
+         * Whether every entry meta write exposes the synchronization hooks.
+         *
+         * @since 7.0
+         *
+         * @return bool
+         */
+        public static function supports_entry_meta_change_hooks() {
+                return true;
+        }
+
+        /**
+         * Notify integrations before changing entry metadata.
+         *
+         * @since 7.0
+         *
+         * @param int $entry_id Entry ID.
+         * @param int $field_id Field ID.
+         *
+         * @return void
+         */
+        private static function before_meta_change( $entry_id, $field_id ) {
+                do_action( 'frm_before_entry_meta_change', $entry_id, $field_id );
+        }
 
         /**
@@ -34 +59 @@
 
                 self::set_value_before_save( $new_values, $field );
-                $new_values    = apply_filters( 'frm_add_entry_meta', $new_values );
+                $new_values = apply_filters( 'frm_add_entry_meta', $new_values );
+                $entry_id   = $new_values['item_id'];
+                $field_id   = $new_values['field_id'];
+                self::before_meta_change( $entry_id, $field_id );
                 $query_results = $wpdb->insert( $wpdb->prefix . 'frm_item_metas', $new_values );
 
                 if ( $query_results ) {
+                        $meta_id = $wpdb->insert_id;
                         self::clear_cache();
                         wp_cache_delete( $entry_id, 'frm_entry' );
-                        return $wpdb->insert_id;
-                }
-
+                        /**
+                         * Fires after an entry meta value is inserted, updated, or deleted.
+                         *
+                         * @since 7.0
+                         *
+                         * @param int $entry_id Entry ID.
+                         * @param int $field_id Field ID.
+                         */
+                        do_action( 'frm_after_entry_meta_change', $entry_id, $field_id );
+                        return $meta_id;
+                }
+
+                do_action( 'frm_entry_meta_write_failed', $entry_id, $field_id );
                 return 0;
         }
@@ -83 +122 @@
                 self::clear_cache();
 
-                return $wpdb->update( $wpdb->prefix . 'frm_item_metas', array( 'meta_value' => $meta_value ), $where_values );
+                self::before_meta_change( $entry_id, $field_id );
+                $result = $wpdb->update( $wpdb->prefix . 'frm_item_metas', array( 'meta_value' => $meta_value ), $where_values );
+
+                if ( false === $result ) {
+                        do_action( 'frm_entry_meta_write_failed', $entry_id, $field_id );
+                } else {
+                        do_action( 'frm_after_entry_meta_change', $entry_id, $field_id );
+                }
+
+                return $result;
         }
 
@@ -200 +248 @@
                 FrmDb::get_where_clause_and_values( $where );
 
+                foreach ( $field_ids_to_remove as $field_id ) {
+                        self::before_meta_change( $entry_id, $field_id );
+                }
+
                 // Delete any leftovers
                 $wpdb->query( $wpdb->prepare( 'DELETE FROM ' . $wpdb->prefix . 'frm_item_metas ' . $where['where'], $where['values'] ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared, SlevomatCodingStandard.Files.LineLength.LineTooLong
                 self::clear_cache();
+
+                foreach ( $field_ids_to_remove as $field_id ) {
+                        do_action( 'frm_after_entry_meta_change', $entry_id, $field_id );
+                }
         }
 
@@ -240 +296 @@
                 self::clear_cache();
 
-                return $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->prefix}frm_item_metas WHERE field_id=%d AND item_id=%d", $field_id, $entry_id ) );
+                self::before_meta_change( $entry_id, $field_id );
+                $result = $wpdb->query( $wpdb->prepare( 'DELETE FROM %i WHERE field_id = %d AND item_id = %d', $wpdb->prefix . 'frm_item_metas', $field_id, $entry_id ) );
+
+                if ( false === $result ) {
+                        do_action( 'frm_entry_meta_write_failed', $entry_id, $field_id );
+                } else {
+                        do_action( 'frm_after_entry_meta_change', $entry_id, $field_id );
+                }
+
+                return $result;
         }
 
@@ -501 +566 @@
 
         /**
+         * Get the entry status to query when a numeric is_draft value is requested.
+         *
+         * @since 7.0
+         *
+         * @param int|string $is_draft
+         *
+         * @return int
+         */
+        private static function get_numeric_draft_status( $is_draft ) {
+                $is_draft = absint( $is_draft );
+
+                if ( FrmSpamEntriesHelper::SPAM_ENTRY_STATUS === $is_draft || class_exists( 'FrmAbandonmentHooksController', false ) ) {
+                        return $is_draft;
+                }
+
+                return FrmEntriesHelper::DRAFT_ENTRY_STATUS;
+        }
+
+        /**
          * @param array|string $where
          * @param string       $order_by
@@ -544 +628 @@
                                 $where['e.is_draft'] = 0;
                         } elseif ( is_numeric( $args['is_draft'] ) ) {
-                                $where['e.is_draft'] = class_exists( 'FrmAbandonmentHooksController', false ) ? absint( $args['is_draft'] ) : 1;
-                        } elseif ( 'both' === $args['is_draft'] && class_exists( 'FrmAbandonmentHooksController', false ) ) {
-                                $where['e.is_draft'] = array( 0, 1 );
+                                $where['e.is_draft'] = self::get_numeric_draft_status( $args['is_draft'] );
+                        } elseif ( 'both' === $args['is_draft'] ) {
+                                // Submitted and draft entries. Spam is left out.
+                                $where['e.is_draft'] = array( (string) FrmEntriesHelper::SUBMITTED_ENTRY_STATUS, (string) FrmEntriesHelper::DRAFT_ENTRY_STATUS );
                         } elseif ( str_contains( $args['is_draft'], ',' ) ) {
                                 $is_draft = array_reduce(
@@ -582 +667 @@
                 if ( ! $args['is_draft'] ) {
                         $draft_where = $wpdb->prepare( ' AND e.is_draft=%d', 0 );
-                } elseif ( $args['is_draft'] == 1 ) { // phpcs:ignore Universal.Operators.StrictComparisons
-                        $draft_where = $wpdb->prepare( ' AND e.is_draft=%d', 1 );
+                } elseif ( is_numeric( $args['is_draft'] ) ) {
+                        $draft_where = $wpdb->prepare( ' AND e.is_draft=%d', self::get_numeric_draft_status( $args['is_draft'] ) );
+                } elseif ( 'both' === $args['is_draft'] ) {
+                        $draft_where = $wpdb->prepare( ' AND e.is_draft IN (%d, %d)', FrmEntriesHelper::SUBMITTED_ENTRY_STATUS, FrmEntriesHelper::DRAFT_ENTRY_STATUS );
+                } elseif ( 'all' !== $args['is_draft'] ) {
+                        $draft_where = $wpdb->prepare( ' AND ( e.is_draft!=%d OR e.is_draft IS NULL )', FrmSpamEntriesHelper::SPAM_ENTRY_STATUS );
                 }