優化WooCommerce購物車：添加相同商品時替換現有項

本文旨在指導如何自定義WooCommerce購物車行為，實現在用戶向購物車添加已存在的同款商品時，自動替換掉原有的商品項，而非作為新的重複項添加或清空整個購物車。通過利用woocommerce_add_to_cart_validation過濾器鉤子，並結合購物車內容檢查與移除邏輯，可以精確控製商品添加流程，實現智能的商品覆蓋功能，提升用戶購物體驗。

購物車商品覆蓋機制實現

在WooCommerce中，默認情況下當用戶將同一商品多次添加到購物車時，系統會增加該商品的數量，而不是創建新的商品項。然而，在某些特定業務場景下，我們可能希望當用戶再次添加同一商品時，不是增加數量，也不是清空購物車，而是直接用新的添加操作“覆蓋”或“替換”購物車中已存在的該商品項。這意味著舊的同款商品（及其數量和任何相關元數據）將被移除，然後新的同款商品以其指定數量被加入。

要實現這種“覆蓋”行為，我們可以利用WooCommerce提供的woocommerce_add_to_cart_validation過濾器鉤子。這個鉤子在商品被添加到購物車之前執行，允許我們對添加操作進行驗證和修改。

核心邏輯

實現商品覆蓋的核心步驟如下：

1. 在商品被添加到購物車之前，檢查購物車中是否已經存在相同的商品ID。
2. 如果存在，則獲取該已存在商品的購物車項鍵（cart item key）。
3. 使用該鍵從購物車中移除舊的商品項。
4. 允許新的商品項（即當前嘗試添加的商品）正常添加到購物車。

示例代碼

將以下代碼添加到您當前活動主題的functions.php文件中，或者通過自定義插件引入：

 /**
 * 在將商品添加到購物車之前，如果購物車中已存在同款商品，則移除舊的商品項。
 *
 * @param bool $passed 是否允許商品添加到購物車。
 * @param int $product_id 正在添加的商品ID。
 * @param int $quantity 正在添加的商品數量。
 * @return bool 返回$passed，以允許或阻止商品添加。
 */
add_filter('woocommerce_add_to_cart_validation', 'remove_cart_item_before_add_to_cart', 10, 3);

function remove_cart_item_before_add_to_cart($passed, $product_id, $quantity) {
    $already_in_cart = false;
    $existing_product_key = '';

    // 遍歷購物車中的所有商品項foreach( WC()->cart->get_cart() as $key => $item ){
        // 檢查當前購物車項的商品ID是否與正在添加的商品ID相同if( $item['product_id'] == $product_id ){
            $already_in_cart = true;
            $existing_product_key = $key; // 記錄已存在商品的購物車項鍵break; // 找到即退出循環}
    }

    // 如果購物車中已存在相同的商品if( $already_in_cart ){
        // 使用其購物車項鍵移除舊的商品項WC()->cart->remove_cart_item($existing_product_key);
    }

    // 始終返回$passed，以允許當前商品繼續添加到購物車return $passed;
}

代碼解析

• add_filter('woocommerce_add_to_cart_validation', 'remove_cart_item_before_add_to_cart', 10, 3);
  • 這行代碼將我們的自定義函數remove_cart_item_before_add_to_cart 掛載到woocommerce_add_to_cart_validation 過濾器上。
  • 10 是優先級，表示函數執行的順序（數字越小越先執行）。
  • 3 表示函數接受的參數數量：$passed (布爾值，表示是否允許添加), $product_id (商品ID), $quantity (商品數量)。
• function remove_cart_item_before_add_to_cart($passed, $product_id, $quantity)
  • 這是我們的回調函數，它接收WooCommerce 傳遞的參數。
• WC()->cart->get_cart()
  • 這是一個WooCommerce的全局函數，用於獲取當前購物車中的所有商品項。它返回一個關聯數組，其中鍵是購物車項鍵，值是包含商品詳細信息的數組。
• foreach( WC()->cart->get_cart() as $key => $item )
  • 遍歷購物車中的每一個商品項。 $key 是該商品項的唯一標識符（購物車項鍵），$item 是包含商品信息的數組。
• if( $item['product_id'] == $product_id )
  • 檢查當前購物車項的商品ID ($item['product_id']) 是否與用戶嘗試添加到購物車的商品ID ($product_id) 相同。
• WC()->cart->remove_cart_item($existing_product_key);
  • 這是關鍵一步。如果找到了相同的商品，就使用remove_cart_item() 方法和之前記錄的$existing_product_key 將其從購物車中移除。
• return $passed;
  • 此行至關重要。 woocommerce_add_to_cart_validation 過濾器期望返回一個布爾值。如果返回true，則允許商品添加到購物車；如果返回false，則阻止添加。在我們的場景中，我們希望在移除舊商品後，新的商品能夠正常添加，所以我們始終返回$passed（通常為true）。

注意事項與總結

1. 代碼放置位置：建議將此代碼放置在您主題的functions.php文件末尾，或者創建一個自定義插件來管理此類功能。直接修改WooCommerce核心文件是不推薦的，因為在更新時會被覆蓋。
2. 行為差異：此實現與WooCommerce默認的“增加數量”行為不同。默認情況下，如果商品已在購物車中，再次添加會增加其數量。本教程的方法是完全替換舊的商品項。
3. 元數據處理：如果您的商品有附加的自定義元數據（例如，通過產品配置器添加的選項），請注意，此方法會移除舊的商品項及其所有關聯元數據，然後添加一個全新的商品項。新的商品項將只包含當前添加操作所指定的數量和任何新的元數據。
4. 用戶體驗：在實施此功能之前，請考慮其對用戶體驗的影響。如果用戶習慣於通過多次點擊“添加到購物車”來增加商品數量，這種“覆蓋”行為可能會讓他們感到困惑。確保您的網站設計或提示能夠清晰地傳達這種行為。
5. 變體商品：此代碼主要基於product_id進行判斷。對於變體商品（如不同顏色、尺寸的同一產品），它們的product_id通常是相同的，但variation_id不同。如果您的需求是針對特定變體進行覆蓋，則需要修改判斷邏輯，同時比較product_id和variation_id。

通過上述方法，您可以精確控制WooCommerce的購物車行為，實現當用戶再次添加同款商品時，系統自動執行覆蓋操作，從而優化特定業務場景下的購物流程。

以上是優化WooCommerce購物車：添加相同商品時替換現有項的詳細內容。更多資訊請關注PHP中文網其他相關文章！