如何调整WPGridbuilder Facet实现WooCommerce库存状态精准筛选

你的核心问题是之前的自定义字段方案仅在手动保存商品时更新，无法同步WooCommerce自动触发的库存变化（比如用户下单后库存减少）。正确的方向是使用开发者提到的wp_grid_builder_indexer_row过滤器，直接修改WPGridBuilder索引中的库存状态值，无需依赖自定义字段。

实现代码 #

将以下代码添加到你的主题functions.php文件或自定义插件中：

add_filter('wp_grid_builder_indexer_row', 'custom_wpgb_stock_status_index', 10, 2);
function custom_wpgb_stock_status_index($row, $post_id) {
    // 仅处理WooCommerce产品
    if (!wc_get_product($post_id)) {
        return $row;
    }

    $product = wc_get_product($post_id);
    $stock_status = $product->get_stock_status();
    $stock_qty = $product->get_stock_quantity();

    // 自定义库存状态判断
    if ($stock_status === 'instock') {
        // 库存大于0是正常有货，库存为0但允许预售则标记为预售
        if ($stock_qty > 0) {
            $row['stock'] = 'In Stock';
        } elseif ($product->backorders_allowed()) {
            $row['stock'] = 'On Backorder';
        }
    } elseif ($stock_status === 'outofstock') {
        $row['stock'] = 'Out of Stock';
    }

    return $row;
}

代码说明 #

1. 过滤器作用：wp_grid_builder_indexer_row会在WPGridBuilder索引每一条产品数据时触发，我们直接修改索引中的stock字段值，替代默认的WooCommerce库存状态映射。
2. 状态判断逻辑：
   • 当产品库存状态为instock时，进一步判断库存数量：大于0则标记为In Stock，库存为0且允许预售则标记为On Backorder
   • 库存状态为outofstock时直接标记为Out of Stock
3. 自动同步：WPGridBuilder的索引器会在产品数据（包括库存）发生变化时自动重新索引，所以库存状态会实时同步，不会出现滞后问题。

后续操作 #

1. 登录WordPress后台，进入WPGridBuilder的Facet管理页面
2. 创建或编辑一个Stock类型的Facet，此时筛选选项会自动显示In Stock、On Backorder、Out of Stock三个选项
3. 将该Facet添加到你的网格模板中，前端用户即可按三种状态筛选商品

为什么之前的方案失效 #

你之前使用的save_post钩子仅在手动编辑并保存商品时触发，而WooCommerce中库存自动变化的场景（如用户下单、退款、库存批量更新）不会触发这个钩子，导致自定义字段无法同步更新，最终筛选结果滞后。而直接修改索引器的库存值，完全依赖WPGridBuilder的索引机制，能覆盖所有产品数据变化的场景。

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