本教程旨在解决woocommerce中为管理员显示产品实际库存数量的需求，而非仅显示“有货”或“无货”状态。通过深入讲解`woocommerce_get_availability_text`过滤器，我们将演示如何检测当前用户角色，并在产品可用性文本旁动态追加具体的库存值。此方法不仅提升了管理员对库存的可见性，也保持了对普通客户友好的显示方式，是实现精细化库存管理的关键步骤。
引言：管理员库存可见性需求
在WooCommerce商店中，默认情况下，产品库存信息通常以“有货”或“无货”的形式展示给所有用户。然而，对于商店管理员或库存管理人员而言，了解产品的具体库存数量是进行库存盘点、补货决策和日常运营的关键。虽然可以通过后台查看，但在前端产品页面直接获取实际库存数据，能够显著提高工作效率。直接使用如wc_get_stock_html()这类函数通常只会输出预设的“有货”或“无货”状态，无法满足显示具体数量的需求。
解决方案：利用 woocommerce_get_availability_text 过滤器
WooCommerce提供了丰富的过滤器（Filters）和动作（Actions），允许开发者在不修改核心文件的情况下扩展和定制商店功能。针对显示库存数量的需求，woocommerce_get_availability_text 过滤器是一个理想的选择。该过滤器允许我们修改或追加WooCommerce生成的产品可用性文本。通过结合用户角色判断，我们可以有条件地为管理员追加实际库存数量。
代码实现
以下是实现此功能的PHP代码片段。请将此代码添加到您的子主题的functions.php文件中。
/**
* 为管理员和商店经理在前端显示产品实际库存数量
*
* 通过 woocommerce_get_availability_text 过滤器，
* 在产品可用性文本旁追加实际库存数量，仅对指定用户角色生效。
*/
add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_quantity_display', 10, 2 );
function custom_admin_stock_quantity_display( $availability_text, $product ) {
// 检查当前用户是否为管理员或商店经理
// 'manage_woocommerce' 权限通常授予商店经理和管理员
// 如果只想针对管理员，请使用 'administrator'
if ( current_user_can( 'manage_woocommerce' ) ) {
// 确保产品有库存管理且库存数量可用
if ( $product->managing_stock() && $product->get_stock_quantity() !== null ) {
// 在现有可用性文本后追加实际库存数量
$availability_text .= sprintf( ' ( %d )', $product->get_stock_quantity() );
}
}
return $availability_text;
}代码详解：
-
add_filter( 'woocommerce_get_availability_text', 'custom_admin_stock_quantity_display', 10, 2 );
- woocommerce_get_availability_text：这是WooCommerce提供的过滤器钩子，它在生成产品可用性文本时触发。
- custom_admin_stock_quantity_display：这是我们自定义的回调函数，用于处理和修改可用性文本。
- 10：优先级，数字越小，函数执行越早。默认优先级为10。
- 2：表示回调函数接受两个参数：$availability_text（当前的可用性文本）和$product（WC_Product 对象）。
-
function custom_admin_stock_quantity_display( $availability_text, $product ) { ... }
- 定义了处理可用性文本的函数。
-
if ( current_user_can( 'manage_woocommerce' ) ) { ... }
- current_user_can() 是WordPress的内置函数，用于检查当前登录用户是否拥有指定的能力（capability）。
- 'manage_woocommerce'：这是一个WooCommerce特定的能力，通常授予管理员和商店经理。这意味着只有具备此能力的用户才能看到实际库存数量。
- 如果您只想让管理员看到，可以将 'manage_woocommerce' 替换为 'administrator'。
-
if ( $product->managing_stock() && $product->get_stock_quantity() !== null ) { ... }
- $product->managing_stock()：检查该产品是否启用了库存管理。
- $product->get_stock_quantity()：获取产品的实际库存数量。我们还检查其是否不为null，以确保数据有效。
-
$availability_text .= sprintf( ' ( %d )', $product->get_stock_quantity() );
- sprintf() 函数用于格式化字符串。它将实际库存数量 ($product->get_stock_quantity()) 插入到格式字符串 ( %d ) 中。
- $availability_text .= ...：将格式化后的库存数量追加到现有的可用性文本之后。
-
return $availability_text;
- 过滤器函数必须返回修改后的值，以便WooCommerce继续处理。
效果演示
应用上述代码后，不同用户角色将看到不同的库存显示效果：
-
管理员或商店经理（拥有 manage_woocommerce 权限的用户）：
- 可能会看到类似：有货 ( 18 ) 或 缺货 ( 0 )
-
普通客户（不拥有 manage_woocommerce 权限的用户）：
- 将看到默认的显示：有货 或 缺货
代码放置位置
强烈建议将上述代码放置在您的 WordPress子主题的 functions.php 文件中。这样做可以确保在主题更新时，您的自定义代码不会被覆盖。如果您没有子主题，可以考虑创建一个，或者使用如 Code Snippets 这样的插件来管理自定义代码片段。
注意事项与最佳实践
- 使用子主题：这是WordPress开发中的黄金法则，确保您的站点在主题更新时保持定制功能。
- 选择合适的权限：根据您的实际需求，精确选择current_user_can()中使用的能力（例如'administrator'或'manage_woocommerce'），以确保只有授权人员才能看到敏感的库存数据。
- 性能考虑：此方法对性能影响极小，因为它只在生成可用性文本时执行，并且只针对特定用户角色进行额外处理。
- 可扩展性：如果需要，您可以进一步定制输出格式，例如添加不同的CSS样式来突出显示管理员看到的库存数量。
总结
通过利用WooCommerce的woocommerce_get_availability_text过滤器并结合WordPress的用户权限检查机制，我们能够高效且优雅地实现在前端产品页面为管理员显示实际库存数量的功能。这种方法不仅提供了精确的库存信息，满足了运营需求，同时也保持了对普通客户的简洁友好体验，是提升WooCommerce商店管理效率的实用技巧。
