在WooCommerce購物車中實現基於產品ID分組的累計附加費用

本教程旨在詳細講解如何在WooCommerce購物車中，為特定產品ID組動態計算並累加附加費用，同時考慮產品數量。通過構建一個靈活的配置數組和兩階段處理邏輯，我們將確保當購物車中包含多個屬於同一費用類別的產品時，附加費用能夠正確地匯總，從而避免重複顯示或計算錯誤。

概述

在WooCommerce商店運營中，經常需要根據特定產品或產品組收取額外的費用，例如服務費、包裝費或特定處理費。然而，當購物車中包含多個屬於同一費用類別的產品時，簡單地為每個產品添加固定費用可能導致費用重複計算或無法正確累加。本教程將介紹一種健壯的方法，通過自定義代碼實現購物車附加費用的智能累加，確保費用計算的準確性和靈活性。

核心問題解析

原有的問題在於嘗試使用__()函數來定義多個產品ID，這是一個常見的誤解。 __()函數在WordPress中主要用於字符串的國際化（翻譯），而非用於處理多個數據項。正確的方法是將多個產品ID作為一個數組來定義，以便在代碼中進行有效匹配和處理。此外，為了實現費用的累加，我們需要一個機制來跟踪每個費用類別的總金額。

實現購物車附加費用累加

我們將通過woocommerce_cart_calculate_fees鉤子來注入自定義邏輯，該鉤子允許我們在購物車費用計算階段添加或修改費用。

1. 定義費用設置

首先，我們需要一個清晰的結構來定義不同的附加費用類別。每個類別應包含：

• product_id: 一個產品ID數組，表示哪些產品屬於此費用類別。
• amount: 單個產品（或每單位產品）的附加費用金額。
• name: 附加費用的顯示名稱。
• total_amount: 用於累積此費用類別總金額的計數器，初始值應為0。

示例設置結構：

 // Settings (multiple settings arrays can be added/removed if desired)
$settings = array(
    array(
        'product_id' => array( 30, 813, 815 ), // 產品ID數組'amount' => 5, // 單個產品費用'name' => __( 'Additional service fee', 'woocommerce' ), // 費用名稱'total_amount' => 0, // 累加器，初始為0
    ),
    array(
        'product_id' => array( 817, 819, 820 ),
        'amount' => 25,
        'name' => __( 'Packing fee', 'woocommerce' ),
        'total_amount' => 0,
    ),
    array(
        'product_id' => array( 825 ),
        'amount' => 100,
        'name' => __( 'Another fee', 'woocommerce' ),
        'total_amount' => 0,
    ),
);

2. 遍歷購物車內容並累加費用

接下來，我們需要遍歷購物車中的每個商品項。對於每個商品，我們檢查其ID是否屬於任何已定義的費用類別。如果匹配，則根據商品的數量和設定的amount來累加到對應費用類別的total_amount中。

處理邏輯：

1. 獲取當前購物車商品的產品ID和數量。
2. 遍歷$settings數組，查找匹配的產品ID。
3. 如果找到匹配項，將amount乘以商品數量，並加到該費用類別的total_amount中。

代碼片段：

 // Loop through cart contents
foreach ( $cart->get_cart_contents() as $cart_item ) {      
    // Get product id
    $product_id = $cart_item['product_id'];

    // Get quantity
    $quantity = $cart_item['quantity']; // 考慮產品數量// Loop trough settings array (determine total amount)
    foreach ( $settings as $key => $setting ) {
        // Search for the product ID
        if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
            // Addition: amount * quantity
            $settings[$key]['total_amount'] = $setting['amount'] * $quantity;
        }
    }       
}

3. 將累加的費用添加到購物車

在所有購物車商品遍歷完成後，$settings數組中的每個費用類別的total_amount將包含其應收取的總費用。最後一步是遍歷更新後的$settings數組，並將所有大於零的total_amount作為附加費用添加到購物車中。

代碼片段：

 // Loop trough settings array (output)
foreach ( $settings as $setting ) {
    // Greater than 0
    if ( $setting['total_amount'] > 0 ) {
        // Add fee (name, amount, taxable)
        $cart->add_fee( $setting['name'], $setting['total_amount'], false );    
    }
}

完整代碼示例

將上述邏輯整合到一個WooCommerce鉤子函數中，通常放置在主題的functions.php文件或自定義插件中。

 /**
 * 在WooCommerce購物車中為特定產品ID組累加附加費用。
 *
 * @param WC_Cart $cart WooCommerce購物車對象。
 */
function action_woocommerce_cart_calculate_fees( $cart ) {
    // 僅在前端或AJAX請求時執行，避免後台管理界面衝突if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 費用設置：每個數組定義一個費用類別// 'product_id' 包含該費用類別下的所有產品ID（數組形式）
    // 'amount' 是單個產品（或每單位）的費用// 'name' 是在購物車中顯示的費用名稱// 'total_amount' 是一個累加器，用於計算該費用類別的總金額，初始值為0
    $settings = array(
        array(
            'product_id' => array( 30, 813, 815 ), // 例如：產品ID 30, 813, 815 屬於“附加服務費”
            'amount' => 5,
            'name' => __( 'Additional service fee', 'woocommerce' ),
            'total_amount' => 0,
        ),
        array(
            'product_id' => array( 817, 819, 820 ), // 例如：產品ID 817, 819, 820 屬於“包裝費”
            'amount' => 25,
            'name' => __( 'Packing fee', 'woocommerce' ),
            'total_amount' => 0,
        ),
        array(
            'product_id' => array( 825 ), // 例如：產品ID 825 屬於“其他費用”
            'amount' => 100,
            'name' => __( 'Another fee', 'woocommerce' ),
            'total_amount' => 0,
        ),
    );

    // 階段1: 遍歷購物車內容，累積每個費用類別的總金額foreach ( $cart->get_cart_contents() as $cart_item ) {      
        $product_id = $cart_item['product_id']; // 獲取購物車商品的產品ID
        $quantity = $cart_item['quantity']; // 獲取購物車商品的數量// 遍歷所有費用設置，檢查當前購物車商品是否屬於某個費用類別foreach ( $settings as $key => $setting ) {
            // 如果當前購物車商品的產品ID在某個費用類別的product_id 數組中if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
                // 將該費用類別的總金額累加，考慮產品數量$settings[$key]['total_amount'] = $setting['amount'] * $quantity;
            }
        }       
    }

    // 階段2: 遍歷更新後的費用設置，將累積的總費用添加到購物車foreach ( $settings as $setting ) {
        // 只有當該費用類別的總金額大於0時才添加if ( $setting['total_amount'] > 0 ) {
            // 使用add_fee 方法將費用添加到購物車// 參數：費用名稱，費用金額，是否應稅(false 表示不應稅)
            $cart->add_fee( $setting['name'], $setting['total_amount'], false );    
        }
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );

注意事項與最佳實踐

1. 代碼放置位置：建議將此代碼添加到子主題的functions.php文件或通過自定義插件實現。直接修改父主題文件可能在主題更新時丟失更改。
2. total_amount的作用： total_amount字段在$settings數組中至關重要，它充當一個累加器，用於在遍歷購物車時跟踪每個費用類別的總金額。切勿修改其初始值以外的其他用途。
3. 產品數量的考慮：提供的代碼已將產品數量考慮在內($setting['amount'] * $quantity;)。如果您的附加費用不應受產品數量影響（即無論購買多少個，費用只收一次），請將$quantity = $cart_item['quantity']; 行刪除，並將$setting['amount'] * $quantity; 更改為$setting['amount'];。
4. 可維護性：將費用設置集中管理，方便未來添加、修改或刪除費用類別。
5. 稅收設置： add_fee()函數的第三個參數控制費用是否應稅。在示例中設置為false，表示不應稅。根據您的業務需求進行調整。
6. 錯誤處理與調試：在開發環境中，可以使用error_log()或var_dump()來調試變量，確保邏輯正確。

總結

通過上述教程，您現在應該能夠靈活地在WooCommerce購物車中實現基於產品ID分組的累計附加費用。這種方法不僅解決了多個產品屬於同一費用類別時費用累加的問題，還提供了考慮產品數量的選項，極大地增強了WooCommerce商店的費用管理能力。遵循這些步驟和最佳實踐，可以確保您的自定義費用邏輯穩定且易於維護。

以上是在WooCommerce購物車中實現基於產品ID分組的累計附加費用的詳細內容。更多資訊請關注PHP中文網其他相關文章！