本教程旨在指导您如何为WooCommerce商店管理员显示商品的具体库存数量，而对普通顾客仅展示商品的有货/无货状态。我们将通过利用WordPress的`woocommerce_get_availability_text`过滤器，精确控制库存信息的展示逻辑，确保敏感数据仅对授权用户可见，从而提升商店管理效率和用户体验。
控制WooCommerce产品库存显示的必要性
在管理WooCommerce在线商店时，商店管理员或经理通常需要查看商品的具体库存数量，以便进行库存盘点、补货决策或处理订单。然而，对于普通顾客而言，展示精确的库存数字可能并非最佳实践，有时甚至可能影响购买决策或暴露商业敏感信息。理想情况下，顾客只需知道商品是否有货即可。
WooCommerce默认的库存显示机制通常只提供“有货”或“无货”的文本提示，即使通过短代码或简单的函数调用，也往往难以直接获取并展示管理员所需的具体库存数字，因为这些方法通常会复用WooCommerce预设的可用性文本格式。为了实现管理员专属的精确库存显示，我们需要更深入地集成到WooCommerce的显示逻辑中。
利用 woocommerce_get_availability_text 过滤器
WooCommerce提供了一个强大的过滤器 woocommerce_get_availability_text，它允许开发者在产品可用性文本被输出到前端之前对其进行修改。这是实现我们目标的关键所在：我们可以检测当前用户的角色，如果用户是管理员或商店经理，则在默认的可用性文本后附加具体的库存数量。
实施步骤与代码示例
将以下代码片段添加到您的WordPress子主题的 functions.php 文件中。如果您没有使用子主题，或者不熟悉其操作，请考虑使用代码片段插件（如Code Snippets）来添加，以避免直接修改主题文件带来的更新覆盖问题。
/**
* 修改 WooCommerce 产品库存可用性文本，为管理员显示具体数量。
*
* 此函数通过 'woocommerce_get_availability_text' 过滤器钩子，
* 检查当前用户是否具有管理 WooCommerce 的权限（例如：管理员或商店经理），
* 如果是，则在默认的可用性文本后附加商品的具体库存数量。
*
* @param string $availability 当前的可用性文本，如“有货”或“无货”。
* @param WC_Product $product 当前的产品对象。
* @return string 修改后的可用性文本。
*/
function custom_admin_stock_availability_text( $availability, $product ) {
// 检查当前用户是否具有管理 WooCommerce 的权限。
// 'manage_woocommerce' 权限通常授予管理员和商店经理。
// 如果您只想让“管理员”角色看到具体库存，可以替换为 'administrator'。
if ( current_user_can( 'manage_woocommerce' ) ) {
// 确保产品支持库存管理且有库存数量。
// get_stock_quantity() 方法在产品没有库存管理时可能返回 null。
if ( $product->get_stock_quantity() !== null ) {
// 在现有可用性文本后附加括号包围的具体库存数量。
$availability .= sprintf( ' ( %d )', $product->get_stock_quantity() );
}
}
return $availability;
}
add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_availability_text', 10, 2 );代码解析
-
custom_admin_stock_availability_text( $availability, $product ) 函数：
- 这是我们定义的回调函数，它接收两个参数：$availability（WooCommerce生成的默认库存可用性文本，如“有货”）和 $product（当前产品对象）。
- current_user_can( 'manage_woocommerce' )：这是一个WordPress内置函数，用于检查当前登录用户是否拥有指定的权限。'manage_woocommerce' 权限通常授予商店管理员和商店经理。如果您希望只有拥有 administrator 角色的用户才能看到具体库存，可以将其更改为 'administrator'。
- $product->get_stock_quantity()：这是WooCommerce产品对象的一个方法，用于获取产品的当前库存数量。我们检查它是否不为 null，以确保产品启用了库存管理。
- sprintf( ' ( %d )', $product->get_stock_quantity() )：使用 sprintf 函数将具体库存数量格式化为 ( 18 ) 这样的字符串。
- $availability .= ...：将格式化后的库存数量字符串附加到原始的 $availability 文本之后。
- return $availability;：返回修改后的可用性文本，WooCommerce会将其显示在前端。
-
add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_availability_text', 10, 2 );：
- 这行代码将我们的自定义函数 custom_admin_stock_availability_text 挂载到 woocommerce_get_availability_text 过滤器上。
- 10 是优先级，数字越小，函数执行越早。
- 2 表示我们的回调函数接受两个参数 ($availability 和 $product)。
效果展示
应用上述代码后，不同用户将看到不同的库存信息：
-
对于管理员或商店经理（拥有 manage_woocommerce 权限的用户）：
- 如果产品有货且库存为 18，将显示为：有货 ( 18 )
- 如果产品有货且库存为 5，将显示为：有货 ( 5 )
- 如果产品无货，将显示为：无货 (因为此时 $product->get_stock_quantity() 可能为0或null，不会触发附加逻辑，或者 WooCommerce 默认的“无货”文本已足够清晰)。
-
对于普通顾客（未登录或不具备 manage_woocommerce 权限的用户）：
- 如果产品有货，将显示为：有货
- 如果产品无货，将显示为：无货
注意事项与最佳实践
- 使用子主题或代码片段插件： 强烈建议不要直接修改父主题的 functions.php 文件。这样做会导致在主题更新时您的修改被覆盖。请始终使用子主题或专门的代码片段管理插件来添加自定义代码。
- 权限管理： 根据您的团队结构和安全需求，仔细选择 current_user_can() 函数中使用的权限。'administrator' 仅限管理员，而 'manage_woocommerce' 则包括管理员和商店经理。
- 测试： 在将代码部署到生产环境之前，务必在开发或测试环境中进行充分测试，以确保其按预期工作，并且不会与其他插件或主题产生冲突。
- 缓存： 如果您的网站使用了页面缓存，请在更改代码后清除缓存，以确保新的库存显示逻辑能够立即生效。
通过以上方法，您可以有效地为WooCommerce管理员提供更详细的库存信息，同时保持顾客界面的简洁和专业，从而优化您的在线商店管理和用户体验。
