如何用自定义字段调整WooCommerce库存，实现低库存禁下单？

现有代码的问题 #

1. 错误修改真实库存：你的代码直接将实际库存减去阈值后更新_stock字段，这会篡改真实库存数据，违背你“保留实际库存，仅通过阈值限制购买”的需求。
2. 钩子使用混乱：woocommerce_process_product_meta是旧版钩子，新版应统一使用woocommerce_admin_process_product_object。
3. 逻辑错误：第二个函数中$post_id在赋值前就被调用，且重复执行自定义字段更新操作，属于无效代码。

正确实现方案 #

核心思路是保留真实库存，通过自定义阈值判断购买权限，而非修改库存数值。此时确实需要用到woocommerce_get_availability这类钩子，配合其他钩子完成状态修改、权限控制和按钮隐藏。

1. 后台添加自定义阈值字段 #

先在产品编辑页面的库存选项卡下添加自定义阈值输入框：

// 在产品库存设置区添加自定义阈值字段
add_action('woocommerce_product_options_inventory_product_data', 'add_custom_stock_threshold_field');
function add_custom_stock_threshold_field() {
    woocommerce_wp_text_input([
        'id' => '_stock_threshold',
        'label' => __('库存限制阈值', 'woocommerce'),
        'description' => __('当实际库存减去该值后≤0时，禁止购买', 'woocommerce'),
        'type' => 'number',
        'custom_attributes' => ['min' => '0'],
        'desc_tip' => true
    ]);
}

// 保存自定义阈值到产品元数据
add_action('woocommerce_admin_process_product_object', 'save_custom_stock_threshold_field');
function save_custom_stock_threshold_field($product) {
    if (isset($_POST['_stock_threshold'])) {
        $threshold = intval($_POST['_stock_threshold']);
        $product->update_meta_data('_stock_threshold', $threshold);
        $product->save();
    }
}

2. 控制产品可用性与购买权限 #

通过钩子修改产品库存状态提示，同时限制购买权限：

// 修改产品可用性状态提示
add_filter('woocommerce_get_availability', 'custom_stock_threshold_availability', 10, 2);
function custom_stock_threshold_availability($availability, $product) {
    // 仅对开启库存管理的产品生效
    if (!$product->managing_stock()) {
        return $availability;
    }

    $threshold = intval($product->get_meta('_stock_threshold'));
    $current_stock = intval($product->get_stock_quantity());
    $available_stock = $current_stock - $threshold;

    if ($available_stock <= 0) {
        $availability['availability'] = __('库存不足，无法购买', 'woocommerce');
        $availability['class'] = 'out-of-stock';
    }

    return $availability;
}

// 全局控制产品是否可购买
add_filter('woocommerce_is_purchasable', 'custom_stock_threshold_purchasable', 10, 2);
function custom_stock_threshold_purchasable($purchasable, $product) {
    if (!$product->managing_stock()) {
        return $purchasable;
    }

    $threshold = intval($product->get_meta('_stock_threshold'));
    $current_stock = intval($product->get_stock_quantity());
    $available_stock = $current_stock - $threshold;

    return $available_stock > 0;
}

// 变体产品单独控制（若使用产品变体）
add_filter('woocommerce_variation_is_purchasable', 'custom_variation_stock_threshold_purchasable', 10, 2);
function custom_variation_stock_threshold_purchasable($purchasable, $variation) {
    if (!$variation->managing_stock()) {
        return $purchasable;
    }

    $threshold = intval($variation->get_meta('_stock_threshold'));
    $current_stock = intval($variation->get_stock_quantity());
    $available_stock = $current_stock - $threshold;

    return $available_stock > 0;
}

3. 移除加购按钮（可选） #

如果需要直接隐藏不可购买产品的加购按钮，添加以下代码：

// 移除产品详情页加购按钮
add_action('woocommerce_single_product_summary', 'remove_single_add_to_cart_button', 1);
function remove_single_add_to_cart_button() {
    global $product;
    if (!$product->is_purchasable()) {
        remove_action('woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30);
    }
}

// 移除商城列表页加购按钮
add_action('woocommerce_after_shop_loop_item', 'remove_loop_add_to_cart_button', 1);
function remove_loop_add_to_cart_button() {
    global $product;
    if (!$product->is_purchasable()) {
        remove_action('woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10);
    }
}

关键说明 #

• 禁止修改真实库存：直接修改_stock会导致库存数据混乱，你的需求是基于真实库存+阈值控制购买，而非改变库存数量。
• 必须使用woocommerce_get_availability：该钩子负责修改产品的库存状态提示，让用户明确无法购买的原因。
• woocommerce_is_purchasable是核心：该钩子控制产品是否允许加入购物车，确保阈值条件触发时无法下单。

内容的提问来源于stack exchange，提问作者user2589071