WooCommerce管理员专属库存数量显示教程
在WooCommerce搭建的电商网站中，默认的商品库存数量会展示给所有访客，但很多时候我们只希望管理员能看到具体库存，普通用户看不到库存信息，避免造成不必要的库存压力或者影响用户购买决策。下面我们就一步步实现这个功能。
实现思路
核心逻辑是通过WordPress的当前用户权限判断，区分管理员和普通用户：如果是管理员角色，就正常显示库存数量；如果是普通用户，就隐藏库存相关的展示内容。主要会用到WooCommerce的库存显示钩子，以及WordPress的用户能力判断函数。
具体实现步骤
1. 准备functions.php文件
首先找到你当前使用主题的根目录，打开里面的functions.php文件，所有自定义功能代码都会添加到这个文件中。如果你使用的是子主题，建议在子主题的functions.php里添加，避免主题更新后代码丢失。
2. 添加权限判断函数
我们先写一个辅助函数，用来判断当前登录用户是不是管理员，方便后续多处调用。代码如下：
<?php
/**
* 判断当前用户是否为管理员
* @return bool 是管理员返回true，否则返回false
*/
function is_shop_admin() {
// 获取当前登录用户对象
$current_user = wp_get_current_user();
// 判断用户是否有管理员能力，或者属于管理员角色
if (in_array('administrator', $current_user->roles) || current_user_can('manage_options')) {
return true;
}
return false;
}
?>3. 修改商品详情页库存显示
商品详情页的库存是通过woocommerce_get_stock_html钩子来输出的，我们可以过滤这个钩子的返回值，根据用户权限决定是否显示库存。添加以下代码到functions.php：
<?php
/**
* 过滤商品详情页的库存HTML，仅管理员可见
* @param string $html 原始库存HTML
* @param WC_Product $product 商品对象
* @return string 处理后的库存HTML
*/
function filter_product_stock_display($html, $product) {
// 如果不是管理员，返回空字符串，不显示库存
if (!is_shop_admin()) {
return '';
}
// 管理员正常返回原始库存HTML
return $html;
}
// 挂载钩子，优先级10，接收2个参数
add_filter('woocommerce_get_stock_html', 'filter_product_stock_display', 10, 2);
?>4. 修改商品列表页库存显示
商品列表页（比如商店页、分类页）的库存显示通常是用woocommerce_after_shop_loop_item钩子输出的，我们同样可以过滤这个部分的内容。添加以下代码：
<?php
/**
* 过滤商品列表页的库存显示，仅管理员可见
*/
function filter_shop_loop_stock_display() {
global $product;
// 如果商品不存在或者不是管理员，直接返回
if (!$product || !is_shop_admin()) {
return;
}
// 获取商品库存数量
$stock_quantity = $product->get_stock_quantity();
// 如果库存不为空，输出库存信息
if (!is_null($stock_quantity)) {
echo '<p class="product-stock">库存：' . esc_html($stock_quantity) . '</p>';
}
}
// 移除WooCommerce默认的列表页库存显示（如果主题有自带的话可以先移除再添加我们的）
remove_action('woocommerce_after_shop_loop_item', 'woocommerce_template_loop_stock', 10);
// 挂载我们自定义的库存显示函数
add_action('woocommerce_after_shop_loop_item', 'filter_shop_loop_stock_display', 10);
?>5. 修改后台订单页面的库存提示（可选）
如果你还想在后台订单页面也做对应的权限控制，可以添加以下代码，确保只有管理员能在订单相关位置看到库存信息：
<?php
/**
* 过滤后台订单商品的库存提示，仅管理员可见
* @param string $stock_html 库存提示HTML
* @param WC_Product $product 商品对象
* @param int $item_id 订单项ID
* @return string 处理后的库存提示HTML
*/
function filter_admin_order_stock_display($stock_html, $product, $item_id) {
// 如果不是管理员，返回空
if (!is_shop_admin()) {
return '';
}
return $stock_html;
}
add_filter('woocommerce_admin_order_item_stock_html', 'filter_admin_order_stock_display', 10, 3);
?>效果验证
代码添加完成后，你可以按以下步骤验证效果：
- 用管理员账号登录网站，访问任意商品详情页或商品列表页，能看到完整的库存数量
- 退出管理员账号，以普通用户身份访问同样的页面，看不到任何库存相关的展示内容
- 如果网站有缓存插件，记得先清除缓存再测试，避免缓存导致效果不生效
注意事项
如果你的主题对库存显示做了自定义修改，可能需要调整对应的钩子优先级或者找到主题自定义的库存输出位置，再做对应的过滤处理。另外如果后续更新了WooCommerce版本，建议先测试功能是否正常，避免版本更新导致钩子失效。