📦 NEW: Added clwc_insert_loyalty_log_entry helper function

Author: robertdevore

includes/clwc-helper-functions.php

@@ -283,3 +283,34 @@ function clwc_earning_points_money_spent() {
 
     return apply_filters( 'clwc_earning_points_money_spent', $money_spent );
 }
+
+/**
+ * Insert a loyalty log entry into the database.
+ *
+ * @since 2.0.0
+ *
+ * @param int    $user_id  The user ID.
+ * @param string $name     The customer's name.
+ * @param string $email    The customer's email.
+ * @param int    $points   The number of points for the action.
+ * @param string $details  Details about the action (e.g., "Points redeemed for discount").
+ * @return bool|int        The inserted row ID on success, or false on failure.
+ */
+function clwc_insert_loyalty_log_entry( $user_id, $name, $email, $points, $details ) {
+    global $wpdb;
+
+    $table_name = $wpdb->prefix . 'clwc_loyalty_log';
+
+    // Prepare data and sanitize for database insertion.
+    $data = [
+        'user_id'  => absint( $user_id ),
+        'name'     => sanitize_text_field( $name ),
+        'email'    => sanitize_email( $email ),
+        'points'   => intval( $points ),
+        'details'  => sanitize_textarea_field( $details ),
+        'date'     => current_time( 'mysql' ),
+    ];
+
+    // Insert the data into the table.
+    return $wpdb->insert( $table_name, $data );
+}