Changeset 3720581

Timestamp:

09/30/2026 07:50:27 AM (3 weeks ago)

Author:

philiasolutions

Message:

• Rebrand and change name to Legion
• Added Refund order to Data Synchronization
• Bugs fixes and improvements

Location:

philia-integration

Files:

• tags/1.18.1/readme.txt (deleted)
• tags/1.18.2/readme.txt (deleted)
• tags/1.19 (added)
• tags/1.19/assets (added)
• tags/1.19/assets/philia-api-settings.js (added)
• tags/1.19/assets/philia-api-sync.js (added)
• tags/1.19/assets/philia-login-redirect.js (added)
• tags/1.19/assets/philia-wallet.js (added)
• tags/1.19/includes (added)
• tags/1.19/includes/class-api-log.php (added)
• tags/1.19/includes/class-api-settings.php (added)
• tags/1.19/includes/class-core-api.php (added)
• tags/1.19/includes/class-event-sender.php (added)
• tags/1.19/includes/class-login-redirect.php (added)
• tags/1.19/includes/class-philia-referral.php (added)
• tags/1.19/includes/class-philia-wallet.php (added)
• tags/1.19/includes/class-webhook-sender.php (added)
• tags/1.19/includes/templates (added)
• tags/1.19/includes/templates/philia-wallet-payment.php (added)
• tags/1.19/philia-integration.php (added)
• tags/1.19/readme.txt (added)
• trunk/assets/philia-wallet.js (modified) (7 diffs)
• trunk/includes/class-api-log.php (modified) (1 diff)
• trunk/includes/class-api-settings.php (modified) (23 diffs)
• trunk/includes/class-core-api.php (modified) (7 diffs)
• trunk/includes/class-event-sender.php (modified) (15 diffs)
• trunk/includes/class-login-redirect.php (modified) (1 diff)
• trunk/includes/class-philia-referral.php (modified) (1 diff)
• trunk/includes/class-philia-wallet.php (modified) (15 diffs)
• trunk/includes/class-webhook-sender.php (modified) (4 diffs)
• trunk/includes/templates/philia-wallet-payment.php (modified) (2 diffs)
• trunk/philia-integration.php (modified) (3 diffs)
• trunk/readme.txt (modified) (7 diffs)

philia-integration/trunk/assets/philia-wallet.js

@@ -6 +6 @@
     }
 
-    var isActive = Boolean(philiaWalletParams.isActive);
+    var walletActive = Boolean(philiaWalletParams.isActive);
+    var cashbackActive = null;
+    var currentBalance = 0;
     var isToggling = false;
     var activeGateway = $('input[name="payment_method"]:checked').val() || '';
@@ -14 +16 @@
     }
 
-    function fetchAndDisplayBalance() {
-        $.post(philiaWalletParams.ajaxUrl, {
-            action: 'philia_get_wallet_balance',
-            nonce: philiaWalletParams.nonce
-        }).done(function (response) {
-            if (!response.success) {
-                return;
-            }
-
-            var balance = parseFloat(response.data.user_cashback) || 0;
-            $('.philia-wallet-balance').text(formatPrice(balance) + ' ' + response.data.currency);
-
-            var $toggle = $('.partial_pay_through_wallet');
-            var $container = $('.philia-wallet-checkout-container');
-
-            if (balance <= 0 && !isActive) {
-                $toggle.prop('checked', false).prop('disabled', true);
-                $container.addClass('philia-disabled');
-            } else {
-                enforceGatewayRestriction(balance);
-            }
-        });
+    function toBoolean(value) {
+        return value === true || value === 1 || value === '1' || value === 'true';
     }
 
-    function enforceGatewayRestriction(balance) {
+    function hasOwn(object, property) {
+        return object && Object.prototype.hasOwnProperty.call(object, property);
+    }
+
+    function updateToggleUI() {
+        $('.partial_pay_through_wallet').prop('checked', walletActive);
+    }
+
+    function applyWalletAvailability(suppressAutoToggle) {
         var $toggle = $('.partial_pay_through_wallet');
         var $container = $('.philia-wallet-checkout-container');
         var selected = $('input[name="payment_method"]:checked').val() || '';
 
-        if (balance <= 0 && !isActive) {
+        updateToggleUI();
+
+        if (cashbackActive !== true) {
             $toggle.prop('disabled', true);
             $container.addClass('philia-disabled');
@@ -49 +41 @@
         }
 
-        if (!selected && isActive) {
+        if (currentBalance <= 0 && !walletActive) {
+            $toggle.prop('disabled', true);
+            $container.addClass('philia-disabled');
+            return;
+        }
+
+        if (!selected && walletActive) {
             $toggle.prop('disabled', false);
             $container.removeClass('philia-disabled');
@@ -56 +54 @@
 
         if (philiaWalletParams.enabledGateways.indexOf(selected) !== -1) {
-            if (isActive) {
+            if (walletActive) {
                 activeGateway = selected;
             }
+
             $toggle.prop('disabled', false);
             $container.removeClass('philia-disabled');
-        } else {
-            if ($toggle.is(':checked')) {
-                $toggle.prop('checked', false);
-                callToggle(false);
-            }
-            $toggle.prop('disabled', true);
-            $container.addClass('philia-disabled');
+            return;
+        }
+
+        $toggle.prop('disabled', true);
+        $container.addClass('philia-disabled');
+
+        if (walletActive && !isToggling && !suppressAutoToggle) {
+            callToggle(false);
         }
     }
 
-    function updateToggleUI() {
-        $('.partial_pay_through_wallet').prop('checked', isActive);
+    function fetchAndDisplayBalance() {
+        $.post(philiaWalletParams.ajaxUrl, {
+            action: 'philia_get_wallet_balance',
+            nonce: philiaWalletParams.nonce
+        }).done(function (response) {
+            if (!response.success || !response.data) {
+                cashbackActive = false;
+                applyWalletAvailability(true);
+                return;
+            }
+
+            currentBalance = parseFloat(response.data.user_cashback) || 0;
+            cashbackActive = toBoolean(response.data.is_active);
+
+            if (hasOwn(response.data, 'wallet_active')) {
+                walletActive = toBoolean(response.data.wallet_active);
+            }
+
+            $('.philia-wallet-balance').text(
+                formatPrice(currentBalance) + ' ' + response.data.currency
+            );
+
+            applyWalletAvailability(false);
+        }).fail(function () {
+            cashbackActive = false;
+            applyWalletAvailability(true);
+        });
     }
 
     function callToggle(enabled) {
         if (isToggling) {
+            updateToggleUI();
             return;
         }
@@ -82 +108 @@
         isToggling = true;
 
+        var previousActive = walletActive;
+        var stateChanged = false;
+        var requestFailed = false;
         var $orderReview = $('.woocommerce-checkout-review-order-table');
+
+        $('.partial_pay_through_wallet').prop('disabled', true);
+
         if ($.isFunction($orderReview.block)) {
             $orderReview.block({
@@ -96 +128 @@
             payment_method: $('input[name="payment_method"]:checked').val() || activeGateway || ''
         }).done(function (response) {
+            var data = response && response.data ? response.data : {};
+
+            if (hasOwn(data, 'wallet_active')) {
+                walletActive = toBoolean(data.wallet_active);
+            } else if (response.success) {
+                walletActive = enabled;
+            } else {
+                walletActive = previousActive;
+            }
+
+            if (hasOwn(data, 'cashback_active')) {
+                cashbackActive = toBoolean(data.cashback_active);
+            }
+
+            stateChanged = walletActive !== previousActive;
+            requestFailed = !response.success;
+            updateToggleUI();
+
             if (response.success) {
-                isActive = enabled;
-                activeGateway = enabled
+                activeGateway = walletActive
                     ? ($('input[name="payment_method"]:checked').val() || activeGateway || '')
                     : '';
+            }
+
+            if (response.success || stateChanged) {
                 $(document.body).trigger('update_checkout');
-                fetchAndDisplayBalance();
             } else {
-                isActive = false;
-                updateToggleUI();
-                fetchAndDisplayBalance();
+                applyWalletAvailability(true);
             }
+        }).fail(function () {
+            requestFailed = true;
+            walletActive = previousActive;
+            updateToggleUI();
+            applyWalletAvailability(true);
         }).always(function () {
             isToggling = false;
+
             if ($.isFunction($orderReview.unblock)) {
                 $orderReview.unblock();
             }
+
+            applyWalletAvailability(requestFailed);
         });
     }
@@ -126 +183 @@
 
     updateToggleUI();
+    applyWalletAvailability(true);
     fetchAndDisplayBalance();
 }(jQuery));

philia-integration/trunk/includes/class-api-log.php

@@ -1 +1 @@
 <?php
 /**
- * Philia API Log
- * The class responsible for handling logging in the Philia API plugin.
+ * Legion API Log
+ * The class responsible for handling logging in the Legion API plugin.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 

philia-integration/trunk/includes/class-api-settings.php

@@ -1 +1 @@
 <?php
 /**
- * Philia API Settings
- * The class responsible for managing the Philia API settings in WordPress.
+ * Legion API Settings
+ * The class responsible for managing the Legion API settings in WordPress.
  * 
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 
@@ -81 +81 @@
         add_submenu_page(
             'philia-api-settings',
-            __('Philia API Settings', 'philia-integration'), // Page title
+            __('Legion API Settings', 'philia-integration'), // Page title
             __('Settings', 'philia-integration'), // Menu title
             'manage_options', // Capability
@@ -167 +167 @@
         );
 
+        // Wallet display title
+        add_settings_field(
+            'wallet_title',
+            __('Wallet Title', 'philia-integration'),
+            array($this, 'wallet_title_field_callback'),
+            'philia-api-settings',
+            'philia_api_settings_section'
+        );
+
         // Wallet Enabled Payment Gateways
         add_settings_field(
@@ -179 +188 @@
         add_settings_field(
             'philia_product_id_fill_mode',
-            __('Auto-fill Philia Product ID', 'philia-integration'),
+            __('Auto-fill Legion Product ID', 'philia-integration'),
             array($this, 'philia_product_id_fill_mode_field_callback'),
             'philia-api-settings',
@@ -198 +207 @@
             <div class="notice">
                 <p>
-                    <?php esc_attr_e('Click the "Test Connection" button to check the connection to Philia.', 'philia-integration'); ?>
+                    <?php esc_attr_e('Click the "Test Connection" button to check the connection to Legion.', 'philia-integration'); ?>
                     <button id="test-philia-connection" class="button"><?php echo esc_attr__('Test Connection','philia-integration'); ?></button>
                 </p>
@@ -210 +219 @@
                 {
                     $res = self::create_and_send_woocommerce_api_key( $settings['api_url'] , $settings['api_key'], $settings['phone_meta'], $settings['data_sync'], $settings['order_sync_status'], $settings['philia_product_id_fill_mode'] );
-                    error_log("RESPONSE FROM SAVE SETTINGS : " . print_r($res, true ) );
                     if( wp_remote_retrieve_response_code( $res ) == 200 )
                     {
                         ?>
                         <div class="notice notice-success is-dismissible">
-                            <p><?php esc_html_e('The Synchronization with Philia has been successfully configured.', 'philia-integration'); ?></p>
+                            <p><?php esc_html_e('The Synchronization with Legion has been successfully configured.', 'philia-integration'); ?></p>
                         </div>
                         <?php
@@ -231 +239 @@
             <hr>
             <h1><?php echo esc_attr__('Shortcodes', 'philia-integration'); ?></h1>
-            <p><?php echo esc_html__('Use the following shortcodes to display Philia features on your pages.', 'philia-integration'); ?></p>
+            <p><?php echo esc_html__('Use the following shortcodes to display Legion features on your pages.', 'philia-integration'); ?></p>
             <table class="form-table">
                 <tbody>
@@ -291 +299 @@
         ?>
         <input type="text" name="philia_api_settings[api_key]" value="<?php echo esc_attr( $settings['api_key'] ?? ''); ?>" size="50" />
-        <p class="description"><?php echo esc_attr__('Please enter the access key for the Philia web service.', 'philia-integration'); ?></p>
+        <p class="description"><?php echo esc_attr__('Please enter the access key for the Legion web service.', 'philia-integration'); ?></p>
         <?php
     }
@@ -317 +325 @@
             ?>
         </select>
-        <p class="description"><?php echo esc_attr__('The meta key of the phone is required for syncing users with Philia. If not selected, the synchronization process will not take place.', 'philia-integration'); ?></p>
+        <p class="description"><?php echo esc_attr__('The meta key of the phone is required for syncing users with Legion. If not selected, the synchronization process will not take place.', 'philia-integration'); ?></p>
         <?php
     }
 
     /**
-     * Outputs the dropdown for order status synchronization.
+     * Outputs the order statuses available for synchronization.
      * 
      * @return void
@@ -329 +337 @@
     {
         $settings = get_option('philia_api_settings');
-        
-        // Get the selected order status, default to 'completed'
-        $selected_status = isset($settings['order_sync_status']) ? $settings['order_sync_status'] : 'completed';
+
+        $selected_status = self::normalize_order_sync_status(
+            isset( $settings['order_sync_status'] ) ? $settings['order_sync_status'] : 'completed'
+        );
 
         if ( ! function_exists( 'wc_get_order_statuses' ) ) {
@@ -338 +347 @@
         }
 
-        // Get all available WooCommerce order statuses
         $order_statuses = wc_get_order_statuses();
-        
-        echo '<select name="philia_api_settings[order_sync_status]" id="philia-order-sync-status">';
-        foreach ($order_statuses as $status_key => $status_label) {
-            // Remove 'wc-' prefix from status key
-            $status_value = str_replace('wc-', '', $status_key);
-            $selected = selected($selected_status, $status_value, false);
-            echo '<option value="' . esc_attr($status_value) . '" ' . $selected . '>' . esc_html($status_label) . '</option>';
+
+        echo '<select id="philia-order-sync-status" name="philia_api_settings[order_sync_status]">';
+        foreach ( $order_statuses as $status_key => $status_label ) {
+            $status_value = 0 === strpos( $status_key, 'wc-' ) ? substr( $status_key, 3 ) : $status_key;
+            echo '<option value="' . esc_attr( $status_value ) . '" ' . selected( $selected_status, $status_value, false ) . '>' . esc_html( $status_label ) . '</option>';
         }
         echo '</select>';
         ?>
-        <p class="description"><?php echo esc_attr__('Select which order status should trigger synchronization with Philia. Only orders with this status will be sent.', 'philia-integration'); ?></p>
+        <p class="description"><?php echo esc_html__('Orders are synchronized with Legion only when they reach the selected status.', 'philia-integration'); ?></p>
         <?php
     }
@@ -394 +400 @@
             __('Customer', 'philia-integration')            => '4',
             __('Engagement Events', 'philia-integration')   => '5',
+            __('Refunded Order', 'philia-integration')      => '6',
         ];
 
@@ -423 +430 @@
         echo '</fieldset>';
         ?>
-        <p class="description"><?php echo esc_attr__('Select the data types you want to sync with Philia.', 'philia-integration'); ?></p>
+        <p class="description"><?php echo esc_attr__('Select the data types you want to sync with Legion.', 'philia-integration'); ?></p>
+        <?php
+    }
+
+    /**
+     * Outputs the wallet title used on WooCommerce orders and invoices.
+     *
+     * @return void
+     */
+    public function wallet_title_field_callback()
+    {
+        ?>
+        <input type='text' id='philia-wallet-title' name='philia_api_settings[wallet_title]' value='<?php echo esc_attr( self::get_wallet_title() ); ?>' class='regular-text' />
+        <p class='description'><?php echo esc_html__( 'This title is displayed for wallet payments on orders and invoices.', 'philia-integration' ); ?></p>
         <?php
     }
@@ -486 +506 @@
         }
         echo '</select>';
-        echo '<p class="description">' . esc_html__('Determines how the philia product id is auto-filled when a new product is saved and the field is empty.', 'philia-integration') . '</p>';
+        echo '<p class="description">' . esc_html__('Determines how the legion product id is auto-filled when a new product is saved and the field is empty.', 'philia-integration') . '</p>';
     }
 
@@ -495 +515 @@
      */
     public function philia_api_settings_section_callback() {
-        echo '<p>' . esc_attr__('Configure the Philia API settings below.', 'philia-integration') . '</p>';
+        echo '<p>' . esc_attr__('Configure the Legion API settings below.', 'philia-integration') . '</p>';
     }
 
@@ -548 +568 @@
         }
 
-        // Sanitize order sync status
-        if (isset($input['order_sync_status'])) {
-            $sanitized_input['order_sync_status'] = sanitize_text_field($input['order_sync_status']);
+        if ( isset( $input['wallet_title'] ) ) {
+            $wallet_title = sanitize_text_field( $input['wallet_title'] );
+            $sanitized_input['wallet_title'] = $wallet_title !== '' ? $wallet_title : self::get_default_wallet_title();
         } else {
-            // Default to 'completed' if not set
-            $sanitized_input['order_sync_status'] = 'completed';
-        }
+            $sanitized_input['wallet_title'] = self::get_default_wallet_title();
+        }
+
+        // Only one registered WooCommerce order status may trigger synchronization.
+        $sanitized_input['order_sync_status'] = self::normalize_order_sync_status(
+            isset( $input['order_sync_status'] ) ? $input['order_sync_status'] : 'completed'
+        );
 
         // Sanitize product ID fill mode
@@ -654 +678 @@
             'version'           => $version,
             'plugin_version'    => PHILIA_PLUGIN_VERSION,
-            'order_sync_status' => ( isset( $order_sync_status ) && ! is_null( $order_sync_status ) ) ? sanitize_text_field( $order_sync_status ) : 'completed',
+            'order_sync_status' => self::normalize_order_sync_status( $order_sync_status ),
             'rest_prefix'       => $rest_prefix, // Include the current REST API prefix,
             'data_sync'         => $philia_data_sync,
@@ -760 +784 @@
      */
     public function add_bulk_action_fill_philia_product_id($bulk_actions) {
-        $bulk_actions['fill_philia_product_id'] = __('Fill Philia Product ID', 'philia-integration');
+        $bulk_actions['fill_philia_product_id'] = __('Fill Legion Product ID', 'philia-integration');
         return $bulk_actions;
     }
@@ -845 +869 @@
         printf(
             /* translators: %1$d: number of filled products, %2$d: number of skipped products */
-            esc_html__('Philia Product ID filled for %1$d product(s). %2$d product(s) skipped (already filled, no SKU available, or mode is Custom).', 'philia-integration'),
+            esc_html__('Legion Product ID filled for %1$d product(s). %2$d product(s) skipped (already filled, no SKU available, or mode is Custom).', 'philia-integration'),
             $filled,
             $skipped
@@ -1071 +1095 @@
      * Checks if a specific data sync option is enabled.
      *
-     * @param string $key_to_check The value to check for (e.g., '1', '2', '3', '4','5').
+     * @param string $key_to_check The value to check for (e.g., '1', '2', '3', '4', '5', '6').
      * @return bool True if the key is in the data_sync array, false otherwise.
      */
@@ -1111 +1135 @@
 
     /**
+     * Get the default wallet display title.
+     *
+     * @return string
+     */
+    public static function get_default_wallet_title()
+    {
+        return __('Legion Wallet', 'philia-integration');
+    }
+
+    /**
+     * Get the configured wallet display title.
+     *
+     * @return string
+     */
+    public static function get_wallet_title()
+    {
+        $settings = get_option( 'philia_api_settings' );
+        $title = isset( $settings['wallet_title'] ) ? sanitize_text_field( $settings['wallet_title'] ) : '';
+
+        return $title !== '' ? $title : self::get_default_wallet_title();
+    }
+
+    /**
      * Get the payment gateways where Philia wallet partial payment is enabled.
      *
@@ -1183 +1230 @@
 
     /**
-     * Get the order status that should trigger synchronization.
-     *
-     * @return string The order status slug (e.g., 'completed', 'processing')
+     * Get the order statuses that should trigger synchronization.
+     *
+     * @return string The selected order status slug.
      */
     public static function get_order_sync_status()
@@ -1192 +1239 @@
         $settings = get_option( 'philia_api_settings' );
 
-        // Return the saved status or default to 'completed'
-        return isset( $settings['order_sync_status'] ) ? $settings['order_sync_status'] : 'completed';
+        return self::normalize_order_sync_status(
+            isset( $settings['order_sync_status'] ) ? $settings['order_sync_status'] : 'completed'
+        );
+    }
+
+    /**
+     * Normalizes the selected order status and limits it to registered WooCommerce values.
+     *
+     * Completed is used as the fallback when the value is missing or invalid.
+     *
+     * @param string|array|null $status Selected order status. Arrays are accepted for legacy settings.
+     * @return string
+     */
+    private static function normalize_order_sync_status( $status )
+    {
+        if ( is_array( $status ) ) {
+            $status = reset( $status );
+        }
+
+        $status = is_scalar( $status ) ? sanitize_key( (string) $status ) : '';
+        $status = 0 === strpos( $status, 'wc-' ) ? substr( $status, 3 ) : $status;
+
+        if ( function_exists( 'wc_get_order_statuses' ) ) {
+            foreach ( array_keys( wc_get_order_statuses() ) as $status_key ) {
+                $allowed_status = 0 === strpos( $status_key, 'wc-' ) ? substr( $status_key, 3 ) : $status_key;
+                if ( $status === $allowed_status ) {
+                    return $status;
+                }
+            }
+        }
+
+        return 'completed';
     }
 

philia-integration/trunk/includes/class-core-api.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Core API
- * This class handles API requests to the configured Philia API endpoint.
+ * Legion Core API
+ * This class handles API requests to the configured Legion API endpoint.
  * 
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 
@@ -26 +26 @@
 
     /**
-     * Endpoint used to exchange a Philia API key for a JWT access token.
+     * Endpoint used to exchange a Legion API key for a JWT access token.
      *
      * @var string
@@ -85 +85 @@
         if (!empty( $settings ) && empty($settings['api_url'])) {
             //error_log("API URL is not configured in the settings.");
-            // throw new \Exception(__('API URL is not configured. Please set it in the Philia API settings.', 'philia-integration'));
+            // throw new \Exception(__('API URL is not configured. Please set it in the Legion API settings.', 'philia-integration'));
         }
     }
@@ -168 +168 @@
 
         if ($api_key === '') {
-            return new \WP_Error('philia_api_key_missing', 'The Philia API key is not set.');
+            return new \WP_Error('philia_api_key_missing', 'The Legion API key is not set.');
         }
 
@@ -201 +201 @@
             return new \WP_Error(
                 'philia_jwt_request_failed',
-                'Failed to retrieve a Philia access token.',
+                'Failed to retrieve a Legion access token.',
                 array('status' => $status_code, 'response' => $response_body)
             );
@@ -213 +213 @@
             return new \WP_Error(
                 'philia_jwt_invalid_response',
-                'The Philia token response did not contain an access token.',
+                'The Legion token response did not contain an access token.',
                 array('status' => $status_code, 'response' => $response_body)
             );
@@ -241 +241 @@
 
         if (empty($settings['api_key'])) {
-            error_log("Error occurred: The API key is not set. Please configure the API key in the Philia API settings.");
+            error_log("Error occurred: The API key is not set. Please configure the API key in the Legion API settings.");
             return;
         }

philia-integration/trunk/includes/class-event-sender.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Event Sender
- * Sends engagement events to Philia independently from data-sync webhooks.
+ * Legion Event Sender
+ * Sends engagement events to Legion independently from data-sync webhooks.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 
@@ -18 +18 @@
     private const EVENT_ID = 44;
     private const FORM_EVENT_ID = 3;
+    private const ADD_TO_CART_EVENT_ID = 43;
+    private const REFUNDED_ORDER_EVENT_ID = 45;
 
     /** @var Philia_Event_Sender|null */
@@ -87 +89 @@
 
     /**
-     * Registers all engagement hooks controlled by data-sync setting 5.
+     * Registers event hooks controlled by their respective data-sync settings.
      *
      * @return void
@@ -102 +104 @@
 
         try {
-            $enabled = (bool) Philia_API_Settings::is_philia_data_sync_enabled( '5' );
+            $engagement_enabled = (bool) Philia_API_Settings::is_philia_data_sync_enabled( '5' );
+            $refunds_enabled    = (bool) Philia_API_Settings::is_philia_data_sync_enabled( '6' );
         } catch ( \Throwable $exception ) {
-            error_log( 'Philia_Event_Sender: Failed checking engagement sync setting: ' . $exception->getMessage() );
+            error_log( 'Philia_Event_Sender: Failed checking event sync settings: ' . $exception->getMessage() );
             return;
         }
 
         $this->event_actions_registered = true;
-        if ( ! $enabled ) {
-            return;
-        }
-
-        $actions = array(
-            'philia_viewed',
-            'comment_post',
-            'transition_comment_status',
-            'spammed_comment',
-            'deleted_comment',
-            'woocommerce_add_to_cart',
-        );
-
-        foreach ( $actions as $action ) {
-            add_action( $action, array( $this, 'queue_event_callback' ), 10, 99 );
-        }
-
-        // Optional integrations; the hooks are harmless when these plugins are inactive.
-        add_action( 'gform_after_submission', array( $this, 'handle_gravity_forms_submission' ), 10, 2 );
-        add_action( 'wpcf7_mail_sent', array( $this, 'handle_contact_form_7_submission' ), 10, 1 );
-        add_action( 'wpforms_process_complete', array( $this, 'handle_wpforms_submission' ), 10, 4 );
+        if ( $engagement_enabled ) {
+            $actions = array(
+                'philia_viewed',
+                'comment_post',
+                'transition_comment_status',
+                'spammed_comment',
+                'deleted_comment',
+                'woocommerce_add_to_cart',
+            );
+
+            foreach ( $actions as $action ) {
+                add_action( $action, array( $this, 'queue_event_callback' ), 10, 99 );
+            }
+
+            // Optional integrations; the hooks are harmless when these plugins are inactive.
+            add_action( 'gform_after_submission', array( $this, 'handle_gravity_forms_submission' ), 10, 2 );
+            add_action( 'wpcf7_mail_sent', array( $this, 'handle_contact_form_7_submission' ), 10, 1 );
+            add_action( 'wpforms_process_complete', array( $this, 'handle_wpforms_submission' ), 10, 4 );
+        }
+
+        if ( $refunds_enabled ) {
+            add_action( 'woocommerce_order_refunded', array( $this, 'queue_event_callback' ), 10, 2 );
+        }
     }
 
@@ -144 +149 @@
         }
 
-        // Capture request-bound moderator, timestamp and deleted-comment data now.
-        if ( in_array( $current_action, array( 'transition_comment_status', 'spammed_comment', 'deleted_comment' ), true ) ) {
+        // Cart events are tracked only for authenticated customers.
+        if ( 'woocommerce_add_to_cart' === $current_action && ! is_user_logged_in() ) {
+            return;
+        }
+
+        // Capture request-bound moderation and cart data before the event enters the queue.
+        if ( in_array( $current_action, array( 'transition_comment_status', 'spammed_comment', 'deleted_comment', 'woocommerce_add_to_cart', 'woocommerce_order_refunded' ), true ) ) {
             $args = $this->normalize_hook_arguments( $current_action, $args );
         }
@@ -300 +310 @@
         }
 
-        $timestamp = current_time( 'mysql' );
+        $timestamp = date('Y-m-d H:i:s');
         if ( is_callable( array( $submission, 'get_meta' ) ) ) {
             $submitted_at = $submission->get_meta( 'timestamp' );
@@ -611 +621 @@
                     $already_normalized && isset( $args[3] )
                         ? sanitize_text_field( (string) $args[3] )
-                        : gmdate( 'Y-m-d\TH:i:s\Z' ),
+                        : current_time( 'mysql' ),
                 );
+
+            case 'woocommerce_add_to_cart':
+                if ( isset( $args[0] ) && is_array( $args[0] ) && isset( $args[0]['products'] ) ) {
+                    return array( $this->normalize_queue_value( $args[0] ) );
+                }
+
+                $payload = $this->build_add_to_cart_payload( $args );
+                return empty( $payload ) ? array() : array( $payload );
+
+            case 'woocommerce_order_refunded':
+                if ( isset( $args[0] ) && is_array( $args[0] ) && isset( $args[0]['refund_id'] ) ) {
+                    return array( $this->normalize_queue_value( $args[0] ) );
+                }
+
+                $payload = $this->build_refunded_order_payload( $args );
+                return empty( $payload ) ? array() : array( $payload );
 
             case 'deleted_comment':
@@ -661 +687 @@
                         'comment_text'   => $content,
                         'comment_length' => $length,
-                        'timestamp'      => gmdate( 'Y-m-d\TH:i:s\Z' ),
+                        'timestamp'      => current_time( 'mysql' ),
                     ),
                 );
@@ -667 +693 @@
 
         return $this->normalize_queue_value( $args );
+    }
+
+    /**
+     * Captures the complete cart state while the WooCommerce request is active.
+     *
+     * @param array $args Raw woocommerce_add_to_cart hook arguments.
+     * @return array
+     */
+    private function build_add_to_cart_payload( array $args ) {
+        $woocommerce = function_exists( 'WC' ) ? WC() : null;
+        if ( ! $woocommerce || ! $woocommerce->cart ) {
+            return array();
+        }
+
+        $cart_items          = $woocommerce->cart->get_cart();
+        $products            = array();
+        $included_categories = array();
+        $cart_total_price    = 0.0;
+
+        foreach ( $cart_items as $cart_item ) {
+            if ( ! is_array( $cart_item ) ) {
+                continue;
+            }
+
+            $product_id = isset( $cart_item['product_id'] ) ? absint( $cart_item['product_id'] ) : 0;
+            $quantity   = isset( $cart_item['quantity'] ) ? max( 0, (float) $cart_item['quantity'] ) : 0.0;
+            if ( ! $product_id ) {
+                continue;
+            }
+
+            $products[] = $product_id;
+
+            $term_ids = wp_get_post_terms( $product_id, 'product_cat', array( 'fields' => 'ids' ) );
+            if ( ! is_wp_error( $term_ids ) ) {
+                $included_categories = array_merge( $included_categories, array_map( 'absint', $term_ids ) );
+            }
+
+            $product = isset( $cart_item['data'] ) && is_object( $cart_item['data'] )
+                ? $cart_item['data']
+                : wc_get_product( $product_id );
+
+            if ( $product && is_callable( array( $product, 'get_price' ) ) ) {
+                $cart_total_price += (float) $product->get_price() * $quantity;
+            }
+        }
+
+        $products            = array_values( array_unique( array_filter( array_map( 'absint', $products ) ) ) );
+        $included_categories = array_values( array_unique( array_filter( array_map( 'absint', $included_categories ) ) ) );
+
+        if ( empty( $products ) ) {
+            $added_product_id = isset( $args[1] ) ? absint( $args[1] ) : 0;
+            if ( ! $added_product_id || ! wc_get_product( $added_product_id ) ) {
+                return array();
+            }
+            $products[] = $added_product_id;
+        }
+
+        $user_id    = get_current_user_id();
+        $session_id = '';
+        if ( $woocommerce->session && is_callable( array( $woocommerce->session, 'get_customer_id' ) ) ) {
+            $session_id = sanitize_text_field( (string) $woocommerce->session->get_customer_id() );
+        }
+
+        $cart_item_key = isset( $args[0] ) ? sanitize_text_field( (string) $args[0] ) : '';
+        $cart_id       = is_callable( array( $woocommerce->cart, 'get_cart_hash' ) )
+            ? sanitize_text_field( (string) $woocommerce->cart->get_cart_hash() )
+            : $cart_item_key;
+
+        $payload = array(
+            'username'            => $user_id ? (string) Philia_API_Settings::get_user_mobile( $user_id ) : '',
+            'timestamp'           => date('Y-m-d H:i:s'),
+            'anonymous_id'        => '',
+            'uid'                 => $user_id ? (string) $user_id : '',
+            'cart_id'             => $cart_id ?: $cart_item_key,
+            'device_id'           => $session_id,
+            'session_id'          => $session_id,
+            'cart_total_price'    => (float) $cart_total_price,
+            'currency'            => function_exists( 'get_woocommerce_currency' ) ? (string) get_woocommerce_currency() : '',
+            'products'            => $products,
+            'included_categories' => $included_categories,
+            'purchase_channel'    => 'web',
+            'branch'              => '',
+        );
+
+        return $payload;
+    }
+
+    /**
+     * Captures a WooCommerce refund as a serializable event payload.
+     *
+     * @param array $args Raw woocommerce_order_refunded hook arguments.
+     * @return array
+     */
+    private function build_refunded_order_payload( array $args ) {
+        $order_id  = isset( $args[0] ) ? absint( $args[0] ) : 0;
+        $refund_id = isset( $args[1] ) ? absint( $args[1] ) : 0;
+
+        if ( ! $order_id || ! $refund_id || ! function_exists( 'wc_get_order' ) ) {
+            return array();
+        }
+
+        $order  = wc_get_order( $order_id );
+        $refund = wc_get_order( $refund_id );
+        if ( ! $order || ! $refund || ! is_a( $refund, 'WC_Order_Refund' ) ) {
+            return array();
+        }
+
+        $user_id = absint( $order->get_customer_id() );
+        $mobile  = sanitize_text_field( (string) $order->get_billing_phone() );
+        $mobile  = (string) preg_replace( '/^(?:\+98|0098|98|0)/', '', $mobile );
+        if ( '' === $mobile && $user_id ) {
+            $mobile = (string) Philia_API_Settings::get_user_mobile( $user_id );
+        }
+
+        $products = array();
+        foreach ( $refund->get_items( 'line_item' ) as $item ) {
+            if ( ! is_object( $item ) ) {
+                continue;
+            }
+
+            $variation_id = is_callable( array( $item, 'get_variation_id' ) ) ? absint( $item->get_variation_id() ) : 0;
+            $product_id   = $variation_id ?: ( is_callable( array( $item, 'get_product_id' ) ) ? absint( $item->get_product_id() ) : 0 );
+            $quantity     = is_callable( array( $item, 'get_quantity' ) ) ? abs( (float) $item->get_quantity() ) : 0;
+            if ( ! $product_id || 0 >= $quantity ) {
+                continue;
+            }
+
+            $products[] = array(
+                'id'       => (string) $product_id,
+                'quantity' => floor( $quantity ) === $quantity ? (int) $quantity : $quantity,
+            );
+        }
+
+        $created_at = $refund->get_date_created();
+        $timestamp  = $created_at && is_callable( array( $created_at, 'date' ) )
+            ? $created_at->date( 'Y-m-d H:i:s' )
+            : current_time( 'mysql' );
+
+        $anonymous_id   = (string) apply_filters( 'philia_refunded_order_anonymous_id', '', $order, $refund );
+        $refund_channel = (string) apply_filters( 'philia_refunded_order_channel', '', $order, $refund );
+
+        $payload = array(
+            'username'           => $mobile,
+            'first_name'         => sanitize_text_field( (string) $order->get_billing_first_name() ),
+            'last_name'          => sanitize_text_field( (string) $order->get_billing_last_name() ),
+            'mobile'             => $mobile,
+            'email'              => sanitize_email( (string) $order->get_billing_email() ),
+            'timestamp'          => $timestamp,
+            'order_id'           => $order_id,
+            'refund_id'          => $refund_id,
+            'anonymous_id'       => sanitize_text_field( $anonymous_id ),
+            'uid'                => $user_id,
+            'currency'           => sanitize_text_field( (string) $order->get_currency() ),
+            'refund_total_price' => abs( (float) $refund->get_amount() ),
+            'refund_reason'      => sanitize_textarea_field( (string) $refund->get_reason() ),
+            'refund_channel'     => sanitize_text_field( $refund_channel ),
+            'products'           => $products,
+        );
+
+        return (array) apply_filters( 'philia_refunded_order_payload', $payload, $order, $refund );
     }
 
@@ -712 +898 @@
     private function send_event( $current_action, array $args ) {
         if ( empty( $this->app_secret ) ) {
+            return;
+        }
+
+        // Re-check at dispatch time so disabling refund sync also cancels queued refund events.
+        if (
+            'woocommerce_order_refunded' === $current_action
+            && ! Philia_API_Settings::is_philia_data_sync_enabled( '6' )
+        ) {
             return;
         }
@@ -847 +1041 @@
 
                 $view_payload = array(
-                    'timestamp'   => $timestamp ?: current_time( 'mysql' ),
+                    'timestamp'   => $timestamp ?: date('Y-m-d H:i:s'),
                     'action'      => 'view',
                     'object_type' => 'view',
@@ -959 +1153 @@
 
                 $deleted_payload = array(
-                    'timestamp'      => isset( $deleted['timestamp'] ) ? sanitize_text_field( (string) $deleted['timestamp'] ) : gmdate( 'Y-m-d\TH:i:s\Z' ),
+                    'timestamp'      => isset( $deleted['timestamp'] ) ? sanitize_text_field( (string) $deleted['timestamp'] ) : date('Y-m-d H:i:s'),
                     'action'         => 'delete',
                     'object_type'    => 'comment',
@@ -1007 +1201 @@
                     'target_type' => $target_type,
                     'target_id'   => $target_type . '_' . absint( $comment->comment_post_ID ),
-                    'timestamp'   => $timestamp ?: current_time( 'mysql' ),
+                    'timestamp'   => $timestamp ?: date('Y-m-d H:i:s'),
                 );
 
@@ -1038 +1232 @@
                     'object_type' => 'comment',
                     'object_id'   => 'comment_' . $comment_id,
-                    'timestamp'   => $timestamp ?: gmdate( 'Y-m-d\TH:i:s\Z' ),
+                    'timestamp'   => $timestamp ?: date('Y-m-d H:i:s'),
                 );
                 if ( $moderator_id ) {
@@ -1051 +1245 @@
 
             case 'woocommerce_add_to_cart':
-                if ( ! is_user_logged_in() ) {
-                    return array();
-                }
-
-                $product_id = isset( $args[1] ) ? absint( $args[1] ) : 0;
-                if ( $product_id && class_exists( 'WC_Product' ) && wc_get_product( $product_id ) ) {
+                $payload = isset( $args[0] ) && is_array( $args[0] ) ? $args[0] : array();
+                if ( ! empty( $payload ) && isset( $payload['products'] ) ) {
                     $data = array(
-                        'product_id'   => $product_id,
-                        'quantity'     => isset( $args[2] ) ? absint( $args[2] ) : 0,
-                        'variation_id' => isset( $args[3] ) ? absint( $args[3] ) : 0,
+                        'event_id' => self::ADD_TO_CART_EVENT_ID,
+                        'payload'  => $payload,
+                    );
+                }
+                break;
+
+            case 'woocommerce_order_refunded':
+                $payload = isset( $args[0] ) && is_array( $args[0] ) ? $args[0] : array();
+                if ( ! empty( $payload ) && ! empty( $payload['order_id'] ) && ! empty( $payload['refund_id'] ) ) {
+                    $data = array(
+                        'event_id' => self::REFUNDED_ORDER_EVENT_ID,
+                        'payload'  => $payload,
                     );
                 }

philia-integration/trunk/includes/class-login-redirect.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Login Redirect
- * Manages user login to Philia using redirect from WooCommerce user account.
+ * Legion Login Redirect
+ * Manages user login to Legion using redirect from WooCommerce user account.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 

philia-integration/trunk/includes/class-philia-referral.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Referral System
+ * Legion Referral System
  * Manages referral tracking and user registration with referral codes.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 

philia-integration/trunk/includes/class-philia-wallet.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Wallet
- * Manages Philia cashback wallet integration on the WooCommerce checkout page.
+ * Legion Wallet
+ * Manages Legion cashback wallet integration on the WooCommerce checkout page.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 
@@ -46 +46 @@
     
     /**
-     * Translatable label used both as the order's payment-method title
-     * and as the name of the wallet fee line (kept in sync so detection
-     * logic in get_wallet_amount_for_order() always matches).
+     * Display label used as the order's payment-method title and wallet fee name.
      *
      * @return string
      */
     public static function get_payment_method_title() {
-        return __( 'Philia Wallet', 'philia-integration' );
+        if ( class_exists( 'Philia_API\Philia_API_Settings' ) ) {
+            return Philia_API_Settings::get_wallet_title();
+        }
+
+        return __('Legion Wallet', 'philia-integration');
     }
 
@@ -175 +177 @@
      */
     public function fetch_balance( $phone ) {
-        $result = [];
-
         $response = Philia_Core_API::send_request('integration/cashback/user/balance/?phone_number=' . urlencode( $phone ), 'GET', []);
 
-        if ( is_wp_error( $response ) ) {
+        if ( is_wp_error( $response ) || ! is_array( $response ) ) {
             error_log("Error in 'integration/cashback/user/balance/' for get user wallet balance");
-            $result = [ 'user_cashback' => 0, 'currency' => $this->get_currency_symbol() ];
-            return $result;
-        }
-
-        $result = [ 'user_cashback' => json_decode( wp_remote_retrieve_body( $response ), true )['data']['user_cashback'], 'currency' => $this->get_currency_symbol() ];
-
-        return $result;
+            return false;
+        }
+
+        $status_code   = (int) wp_remote_retrieve_response_code( $response );
+        $response_body = json_decode( wp_remote_retrieve_body( $response ), true );
+        if (
+            $status_code < 200
+            || $status_code >= 300
+            || ! is_array( $response_body )
+            || empty( $response_body['success'] )
+            || ! isset( $response_body['data'] )
+            || ! is_array( $response_body['data'] )
+            || ! isset( $response_body['data']['user_cashback'] )
+        ) {
+            error_log( "Philia wallet balance request failed with HTTP status {$status_code}." );
+            return false;
+        }
+
+        return array(
+            'user_cashback' => (float) $response_body['data']['user_cashback'],
+            'is_active'     => isset( $response_body['data']['is_active'] )
+                ? filter_var( $response_body['data']['is_active'], FILTER_VALIDATE_BOOLEAN )
+                : false,
+            'currency'      => $this->get_currency_symbol(),
+        );
     }
 
@@ -211 +229 @@
         $response = Philia_Core_API::send_request( 'integration/cashback/user/balance/adjust/', 'POST', $body );
 
-        if ( is_wp_error( $response ) ) {
+        if ( is_wp_error( $response ) || ! is_array( $response ) ) {
             error_log("Error in 'integration/cashback/user/balance/adjust/' for adjust user wallet balance");
             return false;
         }
 
-        return json_decode( wp_remote_retrieve_body( $response ), true );
+        $status_code   = (int) wp_remote_retrieve_response_code( $response );
+        $response_body = json_decode( wp_remote_retrieve_body( $response ), true );
+        if (
+            $status_code < 200
+            || $status_code >= 300
+            || ! is_array( $response_body )
+            || empty( $response_body['success'] )
+        ) {
+            error_log( "Philia wallet balance adjustment failed with HTTP status {$status_code}." );
+            return false;
+        }
+
+        return $response_body;
     }
 
@@ -244 +274 @@
         }
 
+        $woocommerce = self::get_woocommerce_instance();
+        $data['wallet_active'] = (bool) (
+            $woocommerce
+            && $woocommerce->session
+            && $woocommerce->session->get( self::SESSION_ACTIVE, false )
+        );
+
         wp_send_json_success( $data );
     }
@@ -250 +287 @@
      * AJAX: Toggle wallet usage on / off.
      *
-     * ON  (checked=true)  → action='add'      + add negative fee → update_checkout
-     * OFF (checked=false) → action='decrease' + remove fee       → update_checkout
+     * ON  (checked=true)  → action='decrease' + add negative fee → update_checkout
+     * OFF (checked=false) → action='add'      + remove fee       → update_checkout
      */
     public function ajax_toggle_wallet() {
@@ -265 +302 @@
             );
         }
-        
-        $user_id = get_current_user_id();
-        $enabled = filter_var( $_POST['checked'] ?? 'false', FILTER_VALIDATE_BOOLEAN );
-        $phone   = $this->get_user_phone( $user_id );
-
-        $prev_active = $woocommerce->session->get( self::SESSION_ACTIVE, false );
+
+        $user_id    = get_current_user_id();
+        $enabled    = filter_var( $_POST['checked'] ?? 'false', FILTER_VALIDATE_BOOLEAN );
+        $phone      = $this->get_user_phone( $user_id );
+        $prev_active = (bool) $woocommerce->session->get( self::SESSION_ACTIVE, false );
         $prev_amount = floatval( $woocommerce->session->get( self::SESSION_AMOUNT, 0 ) );
+
+        if ( ! $user_id || empty( $phone ) ) {
+            wp_send_json_error(
+                array(
+                    'code'          => 'no_phone',
+                    'message'       => __( 'A valid phone number is required to use the wallet.', 'philia-integration' ),
+                    'wallet_active' => $prev_active,
+                )
+            );
+        }
 
         if ( $enabled ) {
@@ -281 +327 @@
             if ( class_exists( 'Philia_API\Philia_API_Settings' ) && ! Philia_API_Settings::is_wallet_enabled_for_gateway( $chosen_gateway ) ) {
                 if ( $prev_active && $prev_amount > 0 ) {
-                    $this->adjust_balance( $phone, $prev_amount, 'add', $user_id, 'Checkout Gateway Restriction' );
+                    $adjusted = $this->adjust_balance( $phone, $prev_amount, 'add', $user_id, 'Checkout Gateway Restriction' );
+                    if ( false === $adjusted ) {
+                        wp_send_json_error(
+                            array(
+                                'code'          => 'wallet_refund_failed',
+                                'message'       => __( 'The wallet credit could not be restored. Wallet usage remains active.', 'philia-integration' ),
+                                'wallet_active' => true,
+                            )
+                        );
+                    }
                 }
 
                 $woocommerce->session->set( self::SESSION_ACTIVE, false );
                 $woocommerce->session->set( self::SESSION_AMOUNT, 0 );
+                $woocommerce->cart->calculate_fees();
+
                 wp_send_json_error(
                     array(
-                        'message' => __( 'Philia wallet is not enabled for the selected payment method.', 'philia-integration' ),
+                        'code'          => 'gateway_not_allowed',
+                        'message'       => __( 'Legion wallet is not enabled for the selected payment method.', 'philia-integration' ),
+                        'wallet_active' => false,
                     )
                 );
             }
 
-            // Activate: deduct the amount from the wallet and store it in the cart session.
+            // Activate only after the cashback service and balance adjustment both succeed.
             $balance_data = $this->fetch_balance( $phone );
-            $balance      = isset( $balance_data['user_cashback'] ) ? floatval( $balance_data['user_cashback'] ) : 0;
-            
+            if ( false === $balance_data ) {
+                wp_send_json_error(
+                    array(
+                        'code'          => 'balance_unavailable',
+                        'message'       => __( 'The wallet balance could not be retrieved.', 'philia-integration' ),
+                        'wallet_active' => $prev_active,
+                    )
+                );
+            }
+
+            if ( empty( $balance_data['is_active'] ) ) {
+                wp_send_json_error(
+                    array(
+                        'code'            => 'cashback_inactive',
+                        'message'         => __( 'Cashback is currently inactive.', 'philia-integration' ),
+                        'wallet_active'   => $prev_active,
+                        'cashback_active' => false,
+                    )
+                );
+            }
+
+            $balance = isset( $balance_data['user_cashback'] ) ? floatval( $balance_data['user_cashback'] ) : 0;
+
             // Calculate the cart total without the current wallet discount.
             $current_total = floatval( $woocommerce->cart->get_total('edit') );
             $wallet_to_use = min( $balance, $current_total + $prev_amount );
 
-            if ( $wallet_to_use > 0 ) {
-                $this->adjust_balance( $phone, $wallet_to_use, 'decrease', $user_id, 'Checkout Activation' );
-                $woocommerce->session->set( self::SESSION_ACTIVE, true );
-                $woocommerce->session->set( self::SESSION_AMOUNT, $wallet_to_use );
-            }
+            if ( $wallet_to_use <= 0 ) {
+                wp_send_json_error(
+                    array(
+                        'code'            => 'insufficient_wallet_balance',
+                        'message'         => __( 'There is no wallet balance available to use.', 'philia-integration' ),
+                        'wallet_active'   => $prev_active,
+                        'cashback_active' => true,
+                    )
+                );
+            }
+
+            $adjusted = $this->adjust_balance( $phone, $wallet_to_use, 'decrease', $user_id, 'Checkout Activation' );
+            if ( false === $adjusted ) {
+                wp_send_json_error(
+                    array(
+                        'code'            => 'wallet_decrease_failed',
+                        'message'         => __( 'The wallet balance could not be deducted.', 'philia-integration' ),
+                        'wallet_active'   => $prev_active,
+                        'cashback_active' => true,
+                    )
+                );
+            }
+
+            $woocommerce->session->set( self::SESSION_ACTIVE, true );
+            $woocommerce->session->set( self::SESSION_AMOUNT, $wallet_to_use );
         } else {
-            // Deactivate: return the amount to the wallet and clear the session.
+            // Deactivate only after the reserved amount is restored successfully.
             if ( $prev_active && $prev_amount > 0 ) {
-                $this->adjust_balance( $phone, $prev_amount, 'add', $user_id, 'Checkout Deactivation' );
-            }
+                $adjusted = $this->adjust_balance( $phone, $prev_amount, 'add', $user_id, 'Checkout Deactivation' );
+                if ( false === $adjusted ) {
+                    wp_send_json_error(
+                        array(
+                            'code'          => 'wallet_refund_failed',
+                            'message'       => __( 'The wallet credit could not be restored. Wallet usage remains active.', 'philia-integration' ),
+                            'wallet_active' => true,
+                        )
+                    );
+                }
+            }
+
             $woocommerce->session->set( self::SESSION_ACTIVE, false );
             $woocommerce->session->set( self::SESSION_AMOUNT, 0 );
@@ -316 +426 @@
 
         $woocommerce->cart->calculate_fees();
-        wp_send_json_success();
+        wp_send_json_success(
+            array(
+                'wallet_active' => (bool) $woocommerce->session->get( self::SESSION_ACTIVE, false ),
+            )
+        );
     }
 
@@ -341 +455 @@
         if ( $active && $amount > 0 ) {
             $cart->add_fee(
-                __( 'Philia Wallet', 'philia-integration' ),
+                self::get_payment_method_title(),
                 -$amount,
                 false   // not taxable
@@ -425 +539 @@
             $order->payment_complete();
             $order->add_order_note(
-                __( 'The order was fully paid using the Philia wallet.', 'philia-integration' )
+                __( 'The order was fully paid using the Legion wallet.', 'philia-integration' )
             );
         }
@@ -457 +571 @@
         }
 
-        $this->adjust_balance(
+        $adjusted = $this->adjust_balance(
             $phone,
             $wallet_amount,
@@ -468 +582 @@
             )
         );
+
+        if ( false === $adjusted ) {
+            $order->add_order_note(
+                __( 'Legion wallet credit could not be restored because the cashback service rejected the request.', 'philia-integration' )
+            );
+            error_log( "Philia wallet refund failed for cancelled order ID {$order_id}." );
+        }
     }
 
@@ -523 +644 @@
         // ── 2. Philia wallet fee line fallback ───────────────────────────────
         $philia_fee = 0.0;
+        $recognized_fee_titles = array(
+            self::get_payment_method_title(),
+            __( 'Legion Wallet', 'philia-integration' ),
+        );
         foreach ( $order->get_items( 'fee' ) as $fee_item ) {
             /** @var \WC_Order_Item_Fee $fee_item */
-            if ( $fee_item->get_name() === self::get_payment_method_title() ) {
+            if ( in_array( $fee_item->get_name(), $recognized_fee_titles, true ) ) {
                 $philia_fee += abs( (float) $fee_item->get_total() );
             }
@@ -571 +696 @@
         $this->enqueue_wallet_script();
 
-        $atts  = shortcode_atts( [ 'title' => '' ], $atts, 'philia-wallet' );
-        $title = esc_html( $atts['title'] );
+        $atts = shortcode_atts( [ 'title' => '' ], $atts, 'philia-wallet' );
+        $shortcode_title = trim( sanitize_text_field( $atts['title'] ) );
+        $title = esc_html( $shortcode_title !== '' ? $shortcode_title : self::get_payment_method_title() );
 
         ob_start();

philia-integration/trunk/includes/class-webhook-sender.php

@@ -1 +1 @@
 <?php
 /**
- * Philia Webhook Sender
+ * Legion Webhook Sender
  * The class responsible for sending webhook notifications for various WordPress/WooCommerce events.
  *
- * Package: Philia
- * Author: Philia
+ * Package: Legion
+ * Author: Legion
  */
 
@@ -936 +936 @@
                     $order = wc_get_order($order_id);
                     if ($order) {
-                        // Get the configured order status for synchronization (default: 'completed')
+                        // Get the configured order status for synchronization (default: 'completed').
                         $settings_class = __NAMESPACE__ . '\\Philia_API_Settings';
                         $sync_status = ( class_exists( $settings_class ) && is_callable( array( $settings_class, 'get_order_sync_status' ) ) )
                             ? call_user_func( array( $settings_class, 'get_order_sync_status' ) )
                             : 'completed';
-                        
-                        // ONLY proceed if the order status matches the configured sync status
-                        if ($order->get_status() !== $sync_status) {
-                            error_log("Philia_Webhook_Sender: Order ID {$order_id} status is '{$order->get_status()}', not '{$sync_status}'. Skipping webhook send.");
+                        $order_status = $order->get_status();
+
+                        // ONLY proceed if the order has the configured synchronization status.
+                        if ( $order_status !== $sync_status ) {
+                            error_log( "Philia_Webhook_Sender: Order ID {$order_id} status is '{$order_status}', not the configured status '{$sync_status}'. Skipping webhook send." );
                             return []; // Return empty data to prevent sending webhook
                         }
@@ -1201 +1202 @@
             array(
                 'id'          => '_philia_product_id',
-                'label'       => __( 'Philia Product ID', 'philia-integration' ),
+                'label'       => __( 'Legion Product ID', 'philia-integration' ),
                 'desc_tip'    => true,
-                'description' => __( 'This ID is used for syncing with the philia club.', 'philia-integration' ),
+                'description' => __( 'This ID is used for syncing with the legion club.', 'philia-integration' ),
                 'value'       => get_post_meta( $post->ID, '_philia_product_id', true ),
             )
@@ -1219 +1220 @@
             'name'          => '_philia_product_id[' . $variation->ID . ']',
             'value'         => get_post_meta( $variation->ID, '_philia_product_id', true ),
-            'label'         => __( 'Philia Product ID', 'philia-integration' ),
+            'label'         => __( 'Legion Product ID', 'philia-integration' ),
             'desc_tip'      => true,
-            'description'   => __( 'Enter the Philia Product ID for this variation.', 'philia-integration' ),
+            'description'   => __( 'Enter the Legion Product ID for this variation.', 'philia-integration' ),
             'wrapper_class' => 'form-row form-row-full',
         ) );

philia-integration/trunk/includes/templates/philia-wallet-payment.php

@@ -15 +15 @@
 
 $philia_wallet_allowed = true;
+$philia_wallet_title   = __( 'Legion Wallet', 'philia-integration' );
 if ( class_exists( 'Philia_API\Philia_API_Settings' ) ) {
+    $philia_wallet_title   = \Philia_API\Philia_API_Settings::get_wallet_title();
     $philia_chosen_gateway = $philia_session ? $philia_session->get( 'chosen_payment_method' ) : '';
     if ( ! empty( $philia_chosen_gateway ) ) {
@@ -31 +33 @@
             </span>
             <div class="philia-wallet-text">
-                <span class="philia-wallet-label"><?php esc_html_e( 'Pay with Philia Wallet', 'philia-integration' ); ?></span>
+                <span class="philia-wallet-label">
+                    <?php
+                    /* translators: %s: configured wallet title. */
+                    printf( esc_html__( 'Pay with %s', 'philia-integration' ), esc_html( $philia_wallet_title ) );
+                    ?>
+                </span>
                 <span class="philia-wallet-balance-wrap">(<?php esc_html_e( 'Balance:', 'philia-integration' ); ?> <span class="philia-wallet-balance"><?php esc_html_e( 'Loading...', 'philia-integration' ); ?></span>)</span>
             </div>

philia-integration/trunk/philia-integration.php

@@ -1 +1 @@
 <?php
 /**
- * Plugin Name: Philia Integration with WooCommerce
- * Description: Sending Users, Products, Categories and invoices from WooCommerce to Philia and Receive Coupons and Cashback from Philia
- * Version: 1.18.2
- * Author: Philia
- * Author URI: https://fa.philia.vip
+ * Plugin Name: Legion Integration with WooCommerce
+ * Description: Sending Users, Products, Categories and invoices from WooCommerce to Legion and Receive Coupons and Cashback from Legion
+ * Version: 1.19
+ * Author: Legion
+ * Author URI: https://legion.tools
  * License: GPL-2.0+
  * License URI: http://www.gnu.org/licenses/gpl-2.0.html
@@ -17 +17 @@
 
 // Define constants for plugin directory, URL, and table prefix.
-define('PHILIA_PLUGIN_VERSION', '1.18.2');
+define('PHILIA_PLUGIN_VERSION', '1.19');
 define('PHILIA_PLUGIN_DIR', plugin_dir_path(__FILE__));
 define('PHILIA_PLUGIN_URL', plugin_dir_url(__FILE__));
@@ -44 +44 @@
 function philia_api_add_menu_page() {
     add_menu_page(
-        __('Philia API Settings', 'philia-integration'), // Page title
-        __('Philia', 'philia-integration'), // Menu title
+        __('Legion API Settings', 'philia-integration'), // Page title
+        __('Legion', 'philia-integration'), // Menu title
         'manage_options', // Capability
         'philia-api-settings', // Menu slug

philia-integration/trunk/readme.txt

@@ -1 @@
-=== Philia Integration with WooCommerce ===
+=== Legion Integration with WooCommerce ===
 Contributors: philiasolutions
 Tags: philia, loyalty program, events & attributes
 Requires at least: 6.0
 Tested up to: 7.1
-Stable tag: 1.18.2
+Stable tag: 1.19
 License: GPL-2.0+
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
-Send Users, Products, Categories and invoices from WooCommerce to Philia and Receive Coupons and Cashback from Philia
+Send Users, Products, Categories and invoices from WooCommerce to Legion and Receive Coupons and Cashback from Legion
 
 == Description ==
 
-Philia Sync Plugin For WooCommerce is a product developed by the <a href="https://fa.philia.vip">Philia</a> company. Philia is a Customer Loyalty Program platform that offers services such as Defining Loyalty Roadmaps and programs for each business, in any industry and more. This plugin is a sync and integration solution for sending trackable data to philia for progressing loyalty missions, sending required events and etc within the WooCommerce platform. Using this plugin, businesses can integrate their WooCommerce store with Philia.
-This plugin automatically transfers users, products, categories, orders and other required events. It also uses WooWallet plugin to integrate philia's cashback to WooCommerce. 
-It's important to note that the plugin connects to philia via a web service, and we have designed this web service to be secure. We attach great importance to user rights and data, and we recommend that you read the <a href="https://philia.vip/terms-of-service/" target="_blank">Terms of Service</a> of philia and our plugin.
+Legion Sync Plugin For WooCommerce is a product developed by the <a href="https://legion.tools">Legion</a> company. Legion is a Customer Loyalty Program platform that offers services such as Defining Loyalty Roadmaps and programs for each business, in any industry and more. This plugin is a sync and integration solution for sending trackable data to legion for progressing loyalty missions, sending required events and etc within the WooCommerce platform. Using this plugin, businesses can integrate their WooCommerce store with Legion.
+This plugin automatically transfers users, products, categories, orders and other required events. It also uses WooWallet plugin to integrate legion's cashback to WooCommerce. 
+It's important to note that the plugin connects to legion via a web service, and we have designed this web service to be secure. We attach great importance to user rights and data, and we recommend that you read the <a href="https://legion.tools/terms-of-service/" target="_blank">Terms of Service</a> of legion and our plugin.
 
 Key features of the plugin:
 
-- Integrate WooCommerce users and Philia
-- Integrate WooCommerce products and Philia
-- Integrate WooCommerce categories and Philia
-- Integrate WooCommerce orders and Philia
-- Integrate Philia Coupon Codes and WooCommerce
-- Integrate Philia Wallet (Cashback)
+- Integrate WooCommerce users and Legion
+- Integrate WooCommerce products and Legion
+- Integrate WooCommerce categories and Legion
+- Integrate WooCommerce orders and Legion
+- Integrate Legion Coupon Codes and WooCommerce
+- Integrate Legion Wallet (Cashback)
 
 == Installation ==
@@ -34 +34 @@
 = This plugin is free =
 
-Yes, the Philia Integration is a free plugin.
+Yes, the Legion Integration is a free plugin.
 
 = Is this plugin compatible with WooCommerce? =
@@ -42 +42 @@
 = How does this plugin work? =
 
-You first need to purchase the one of Philia Subscription plans. Then, you need to obtain the web service key and enter it in the plugin settings section of the WooCommerce configuration. Once this is done, the plugin will be connected to the your philia panel.
+You first need to purchase the one of Legion Subscription plans. Then, you need to obtain the web service key and enter it in the plugin settings section of the WooCommerce configuration. Once this is done, the plugin will be connected to the your philia panel.
 
 == Changelog ==
+
+= 1.19 =
+* Rebrand and change name to Legion
+* Added Refund order to Data Synchronization
+* Bugs fixes and improvements
 
 = 1.18.2 =
@@ -68 +73 @@
 = 1.16 =
 * Compatible with WP 7
-* Added Philia Wallet & Cashback
+* Added Legion Wallet & Cashback
 * Bugs fixes and improvements
 
@@ -76 +81 @@
 
 = 1.14 =
-* Added Fill mode field for Philia Product ID
+* Added Fill mode field for Legion Product ID
 * Bugs fixes and improvements
 
@@ -86 +91 @@
 
 = 1.12 =
-* Added custom field for better syncing with philia
+* Added custom field for better syncing with legion
 * Fixed login to club bug and optimize the speed of login
 * Bugs fixes and improvements
@@ -101 +106 @@
 
 = 1.10 =
-* Added Selective data for syncing with philia
+* Added Selective data for syncing with legion
 * Bugs fixes and improvements