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_safely( $cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data ) {
    // 定义赠品ID和触发赠品添加的主商品ID
    $free_product_ids = array( 20070, 39039 ); // 赠品商品ID列表
    $trigger_product_ids = array( 38162, 38157 ); // 触发赠品添加的主商品ID列表

    $cart = WC()->cart->get_cart();
    $has_trigger_product = false;
    $has_free_gift = false;

    // 遍历购物车，检查是否存在触发商品和已添加的赠品
    foreach ( $cart as $item_key => $item_values ) {
        // 检查购物车中是否存在任何触发商品
        if ( in_array( $item_values['product_id'], $trigger_product_ids ) ) {
            $has_trigger_product = true;
        }
        // 检查是否已经存在我们通过自定义meta标识的赠品
        if ( in_array( $item_values['product_id'], $free_product_ids ) && isset( $item_values['free_gift_meta'] ) && $item_values['free_gift_meta'] === 'yes' ) {
            $has_free_gift = true;
        }
    }

    // 如果购物车中存在触发商品，但尚未添加赠品
    if ( $has_trigger_product && ! $has_free_gift ) {
        // 临时移除当前钩子，防止 add_to_cart 递归调用导致无限循环
        remove_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );

        // 遍历并添加所有定义的赠品
        foreach ( $free_product_ids as $free_id ) {
            // 添加赠品到购物车，并附加自定义元数据 'free_gift_meta'
            WC()->cart->add_to_cart( $free_id, 1, 0, array(), array( 'free_gift_meta' => 'yes' ) );
        }

        // 重新添加此钩子，确保后续的 add_to_cart 操作仍能触发此逻辑
        add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );
    }
}
add_action( 'woocommerce_add_to_cart', 'gift_add_product_to_cart_safely', 10, 6 );