如何在 WooCommerce 后台订单页为每个商品添加独立的“清空库存”按钮-php教程-PHP中文网

如何在 WooCommerce 后台订单页为每个商品添加独立的“清空库存”按钮

本文详解如何在 woocommerce 订单管理页面为每个订单商品项安全添加自定义按钮，解决多按钮共用同名隐藏字段导致库存误操作的问题，并提供可立即部署的健壮实现方案。

本文详解如何在 woocommerce 订单管理页面为每个订单商品项安全添加自定义按钮，解决多按钮共用同名隐藏字段导致库存误操作的问题，并提供可立即部署的健壮实现方案。

在 WooCommerce 后台订单详情页（/wp-admin/post.php?post=XXX&action=edit）中，为每个订单商品项动态添加“清空库存”按钮是一项常见需求。但原始代码存在严重逻辑缺陷：它在 woocommerce_after_order_itemmeta 钩子中为每个商品项重复输出同名隐藏字段 <input name="renew_order_single_product">，导致表单提交时 PHP 仅能读取其中一个值（通常为最后一个），从而对错误商品执行库存重置。

✅ 正确实现思路

核心原则是：避免多个同名 input，改用 JavaScript 动态设置唯一目标 ID。我们不再依赖表单自动提交，而是为每个按钮绑定独立点击事件，将对应商品 ID 写入一个全局隐藏字段（唯一 name），再触发表单提交。

✅ 推荐解决方案（含完整代码）

将以下代码添加至主题 functions.php 或专属插件中：

// 1. 在每个订单商品项后添加带 data-id 的按钮（无隐藏 input）
add_action('woocommerce_after_order_itemmeta', 'add_stock_reset_button_per_item', 10, 2);
function add_stock_reset_button_per_item($item_id, $item) {
    $product_id = $item->get_product_id();
    if (!$product_id) return;

    echo '<button type="button" class="button button-small stock-reset-btn" data-product-id="' . esc_attr($product_id) . '" style="background:#d32f2f; color:#fff; margin-left:8px; padding:4px 10px; font-size:12px;">
            ' . esc_html__('清空库存', 'textdomain') . '
          </button>';
}

// 2. 注入前端 JS：绑定点击事件，动态设置隐藏字段并提交
add_action('admin_footer', 'enqueue_stock_reset_script');
function enqueue_stock_reset_script() {
    global $pagenow;
    if ($pagenow !== 'post.php' || !isset($_GET['post']) || get_post_type($_GET['post']) !== 'shop_order') {
        return;
    }
    ?>
    <script>
    jQuery(document).ready(function($) {
        // 创建唯一隐藏字段（仅一次）
        if (!$('#renew_order_single_product').length) {
            $('<input>').attr({
                type: 'hidden',
                id: 'renew_order_single_product',
                name: 'renew_order_single_product'
            }).appendTo('form#post');
        }

        // 为所有重置按钮绑定点击
        $(document).on('click', '.stock-reset-btn', function(e) {
            e.preventDefault();
            const productId = $(this).data('product-id');
            $('#renew_order_single_product').val(productId);
            if (confirm('确定要将此商品库存设为 0？此操作不可撤销！')) {
                $('form#post').submit();
            }
        });
    });
    </script><?php }

// 3. 安全处理库存更新（使用 WC_Product_Data_Store 替代过时的 WC_Product 构造）
add_action('save_post_shop_order', 'handle_stock_reset_on_order_save', 10, 3);
function handle_stock_reset_on_order_save($post_id, $post, $update) {
    // 非管理员或非订单保存，退出
    if (!current_user_can('edit_shop_orders') || defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }

    // 检查是否触发了库存重置
    if (isset($_POST['renew_order_single_product']) && absint($_POST['renew_order_single_product']) > 0) {
        $product_id = absint($_POST['renew_order_single_product']);
        $product    = wc_get_product($product_id);

        if ($product && $product->is_in_stock()) {
            // 使用 WC_Product::set_stock_quantity() + save()（推荐方式）
            $product->set_stock_quantity(0);
            $product->set_stock_status('outofstock');
            $product->save();

            // 可选：添加管理通知
            add_action('admin_notices', function() use ($product) {
                echo '<div class="notice notice-success is-dismissible"><p><strong>' .
                     esc_html__('成功：') . '</strong> 商品 "' . esc_html($product->get_name()) .
                     '" 库存已设为 0 并标记为缺货。</p></div>';
            });
        }
    }
}

⚠️ 关键注意事项

绝不使用 new WC_Product($id)：该构造函数已弃用且不兼容变体商品；应始终使用 wc_get_product($id) 获取实例。
权限与安全校验：save_post_shop_order 钩子配合 current_user_can('edit_shop_orders') 确保仅授权用户可操作。
防重复提交：JS 中加入 confirm() 提示，生产环境建议增加加载状态与防抖。
库存状态同步：设 stock_quantity = 0 后，务必调用 set_stock_status('outofstock') 以保持库存状态一致性。
变体商品支持：本方案天然支持简单产品与变体（因 $item->get_product_id() 返回的是实际购买的变体 ID）。