本教程详细指导如何在WooCommerce单品页面为管理员显示商品的实际库存数量，而普通用户仅看到“有货”或“缺货”状态。通过利用`woocommerce_get_availability_text`过滤器，结合用户权限判断，实现精确的库存信息展示，提升后台管理效率。
在WooCommerce商店运营中，管理员或商店经理常常需要快速查看商品的实际库存数量，以便进行库存管理、补货决策或客户咨询。然而，默认情况下，WooCommerce在商品详情页通常只显示“有货”或“缺货”等通用状态，这对于需要精确数字的管理者来说并不足够。本文将详细介绍如何通过自定义代码，实现在不影响普通客户浏览体验的前提下，为特定用户角色（如管理员）显示商品的具体库存数值。
核心实现原理：利用woocommerce_get_availability_text过滤器
WooCommerce提供了丰富的过滤器（Filters）和动作（Actions），允许开发者在不修改核心代码的情况下扩展或修改其功能。要实现为管理员显示实际库存数量，最有效的方法是利用woocommerce_get_availability_text过滤器。
这个过滤器在WooCommerce生成商品库存可用性文本时触发，允许我们截获并修改最终显示的文本。通过在此过滤器中加入逻辑判断，我们可以：
- 判断当前访问页面的用户是否具有特定权限（例如管理员或商店经理）。
- 如果用户具备相应权限，则获取商品的实际库存数量。
- 将实际库存数量附加到原有的可用性文本之后。
- 将修改后的文本返回，从而在前端显示。
实现步骤与代码示例
将以下代码添加到您的WordPress子主题的functions.php文件中。强烈建议使用子主题，以避免在主题更新时丢失您的自定义更改。
<?php
/**
* 为WooCommerce管理员和商店经理显示商品实际库存数量
*
* 通过woocommerce_get_availability_text过滤器，在库存状态后附加实际库存数值。
*
* @param string $availability 默认的库存可用性文本。
* @param WC_Product $product 产品对象。
* @return string 调整后的库存可用性文本。
*/
add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_display', 10, 2 );
function custom_admin_stock_display( $availability, $product ) {
// 检查当前用户是否为管理员或商店经理
// 'manage_woocommerce' 权限通常授予商店经理和管理员
// 如果只希望管理员可见，可以改为 'administrator'
if ( current_user_can( 'manage_woocommerce' ) ) {
// 确保产品正在管理库存，并且有库存数量
if ( $product->managing_stock() && $product->get_stock_quantity() !== null ) {
// 获取实际库存数量
$stock_quantity = $product->get_stock_quantity();
// 如果有库存数量，则附加到可用性文本后
if ( is_numeric( $stock_quantity ) ) {
$availability .= sprintf( ' ( %d )', $stock_quantity );
}
}
}
return $availability;
}
?>代码解析：
- add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_display', 10, 2 );：
- 这是WordPress中用于挂载过滤器的函数。
- 'woocommerce_get_availability_text' 是我们想要修改的过滤器标签。
- 'custom_admin_stock_display' 是我们将要定义的回调函数名称。
- 10 是优先级，数字越小，函数执行越早。
- 2 表示回调函数接受两个参数：$availability（当前的可用性文本）和$product（产品对象）。
- function custom_admin_stock_display( $availability, $product ) { ... }：
- 这是实际执行逻辑的回调函数。
- current_user_can( 'manage_woocommerce' )：这是一个关键的权限检查。'manage_woocommerce'权限通常授予WooCommerce的商店经理和管理员角色。如果您只想让“管理员”角色看到库存数量，可以将其更改为'administrator'。
- $product->managing_stock()：检查当前产品是否启用了库存管理。只有启用了库存管理的产品才会有实际的库存数量。
- $product->get_stock_quantity()：获取产品的实际库存数量。
- sprintf( ' ( %d )', $stock_quantity )：使用sprintf函数将实际库存数量格式化为( 数量 )的形式，并附加到现有的$availability文本之后。
- return $availability;：将修改后的可用性文本返回，WooCommerce会将其显示在前端。
效果展示
应用上述代码后，当管理员或具有manage_woocommerce权限的用户访问商品单页时，他们将看到类似如下的库存信息：
Availability: In stock ( 18 )
而普通客户访问同一商品页面时，将只看到默认的库存状态：
Availability: In stock
注意事项
- 使用子主题：务必将代码放置在您的WordPress子主题的functions.php文件中。直接修改父主题的文件会在主题更新时被覆盖，导致您的自定义功能丢失。
-
权限选择：根据您的具体需求，仔细选择current_user_can()函数中的权限字符串。
- 'administrator'：仅限管理员角色。
- 'manage_woocommerce'：管理员和商店经理角色。
- 您也可以定义更细致的自定义角色和权限。
- 代码健壮性：示例代码中加入了$product->managing_stock()判断，确保只有在管理库存的产品上才尝试获取库存数量，避免不必要的错误。同时，is_numeric($stock_quantity)确保了输出的稳定性。
- 缓存问题：如果您使用了页面缓存插件或服务器端缓存，可能需要清除缓存才能看到更改生效。
- 前端样式：如果您希望对显示的库存数量文本进行样式调整，可以通过CSS针对生成的HTML结构进行修改。例如，如果库存数量被包裹在一个特定的HTML元素中，您可以为其添加自定义样式。
总结
通过上述教程，您可以轻松地为WooCommerce商店的管理员和商店经理提供更详细、更直观的商品实际库存数量信息。这种方法既提升了后台管理的效率，又保持了对普通客户友好的简洁界面，是优化WooCommerce商店管理体验的一个有效实践。
