WooCommerce 购物车联动：实现赠品自动添加与移除的专业指南

/**
 * 当特定主产品添加到购物车时，自动添加赠品。
 *
 * @param string $cart_item_key 购物车项的唯一键。
 * @param int    $product_id    被添加产品的ID。
 * @param int    $quantity      被添加产品的数量。
 * @param int    $variation_id  变体产品的ID（如果适用）。
 * @param array  $variation     变体数据（如果适用）。
 * @param array  $cart_item_data 购物车项的自定义数据。
 */
function gift_add_product_to_cart_handler( $cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data ) {
    // 定义需要触发赠品的主产品ID列表
    $allowed_main_product_ids = array(38162, 38157);
    // 定义作为赠品的商品ID列表
    $gift_product_ids = array(20070, 39039);

    // 检查当前添加的产品是否是指定的主产品之一
    if ( ! in_array( $product_id, $allowed_main_product_ids ) ) {
        return; // 如果不是主产品，则不执行赠品逻辑
    }

    $cart = WC()->cart->get_cart();
    $has_gift_in_cart = false;
    $main_product_present_after_add = false;

    // 遍历购物车，检查是否已存在任何指定赠品
    foreach ( $cart as $item_values ) {
        if ( in_array( $item_values['product_id'], $gift_product_ids ) && isset( $item_values['is_free_gift'] ) && $item_values['is_free_gift'] === true ) {
            $has_gift_in_cart = true;
            break;
        }
    }

    // 遍历购物车，检查是否至少有一个指定的主产品（包括刚刚添加的）
    foreach ( $cart as $item_values ) {
        if ( in_array( $item_values['product_id'], $allowed_main_product_ids ) ) {
            $main_product_present_after_add = true;
            break;
        }
    }

    // 如果购物车中存在主产品但没有赠品，则添加赠品
    if ( $main_product_present_after_add && ! $has_gift_in_cart ) {
        // 关键步骤：在添加赠品前暂时移除此动作，以避免无限递归
        remove_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_handler', 10, 6 );

        foreach ( $gift_product_ids as $gift_id ) {
            // 添加赠品到购物车，并使用自定义元数据 'is_free_gift' 标记为免费赠品
            WC()->cart->add_to_cart( $gift_id, 1, 0, array(), array( 'is_free_gift' => true ) );
        }

        // 关键步骤：重新添加此动作
        add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_handler', 10, 6 );
    }
}
add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_handler', 10, 6 );

/**
 * 当所有关联的主产品从购物车中移除时，自动移除赠品。
 *
 * @param string $cart_item_key 被移除购物车项的唯一键。
 * @param WC_Cart $cart         WooCommerce 购物车对象。
 */
function gift_remove_product_from_cart_handler( $cart_item_key, $cart ) {
    // 定义需要触发赠品的主产品ID列表
    $allowed_main_product_ids = array(38162, 38157);
    // 定义作为赠品的商品ID列表
    $gift_product_ids