WooCommerce：在特定分类中显示缺货商品的实战教程-php教程-PHP中文网

WooCommerce：在特定分类中显示缺货商品的实战教程

DDD

发布： 2025-11-17 13:01:16

原创

624人浏览过

WooCommerce：在特定分类中显示缺货商品的实战教程

本教程详细介绍了如何在woocommerce中，通过使用wordpress的过滤器，覆盖全局的“隐藏缺货商品”设置。这使得网站管理员能够实现在特定商品分类页面中依然显示库存为零的商品，从而为用户提供更灵活的商品浏览体验，同时保持对其他分类的全局隐藏规则。

理解WooCommerce缺货商品显示机制

WooCommerce提供了一个非常实用的库存管理功能，允许网站管理员全局设置是否在商店页面和分类列表中隐藏缺货商品。这个设置通常位于“WooCommerce” -youjiankuohaophpcn “设置” -> “产品” -> “库存”选项卡下，名为“隐藏缺货商品”。当此选项被勾选时，所有库存为零的商品将不会出现在网站的任何产品列表页面，包括分类页面、商店页面和搜索结果中。

然而，在某些业务场景下，您可能希望在特定的分类页面中，即使商品缺货，也依然能够显示它们。例如，您可能有一个“预售商品”或“即将补货”的分类，希望用户能够看到这些商品，并了解它们目前的状态，而不是完全隐藏它们。在这种情况下，我们需要一种方法来局部覆盖全局的隐藏设置。

解决方案：利用WordPress过滤器

WordPress和WooCommerce的强大之处在于其丰富的钩子（hooks）系统，包括动作（actions）和过滤器（filters）。我们可以利用特定的过滤器来修改WooCommerce在决定是否隐藏缺货商品时的行为。

本教程将使用 pre_option_woocommerce_hide_out_of_stock_items 过滤器。这个过滤器在WooCommerce读取“隐藏缺货商品”设置之前触发，允许我们动态地改变这个选项的值。通过检测当前访问的页面是否为我们指定的分类页面，我们可以选择性地关闭隐藏功能。

实现步骤与代码示例

要实现这一功能，您需要将以下代码添加到您的WordPress主题的 functions.php 文件中，或者更推荐的做法是，将其添加到您自定义的插件中。

步骤1：添加代码到您的网站

打开您的主题（推荐使用子主题）的 functions.php 文件，并将以下代码复制粘贴到文件末尾。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

查看详情

/**
 * 针对特定WooCommerce分类，覆盖全局的“隐藏缺货商品”设置
 *
 * 当访问指定分类页面时，即使全局设置了隐藏缺货商品，
 * 也会强制显示这些商品。
 *
 * @param string $hide 当前“隐藏缺货商品”设置的值 ('yes' 或 'no')。
 * @return string 修改后的设置值。
 */
add_filter( 'pre_option_woocommerce_hide_out_of_stock_items', 'bbloomer_hide_out_of_stock_exception_category' );

function bbloomer_hide_out_of_stock_exception_category( $hide ) {
    // 替换 'specific-category' 为您希望显示缺货商品的分类的slug。
    // 如果是多个分类，可以使用数组：if ( is_product_category( array( 'category-one', 'category-two' ) ) )
    if ( is_product_category( 'specific-category' ) ) {
        $hide = 'no'; // 将隐藏设置改为 'no'，即不隐藏缺货商品
    }   
    return $hide;
}

登录后复制

步骤2：自定义分类Slug

在上面的代码中，请务必将 'specific-category' 替换为您实际希望显示缺货商品的分类的slug。分类的slug是其在URL中显示的短名称，通常在“产品” -> “分类”编辑页面中可以找到。

例如，如果您的分类URL是 yourdomain.com/product-category/pre-order/，那么其slug就是 pre-order。

如果您需要对多个分类应用此规则，可以将 is_product_category() 函数的参数改为一个数组，例如：

if ( is_product_category( array( 'pre-order', 'clearance-items', 'limited-edition' ) ) ) {
    $hide = 'no';
}

登录后复制

代码解析

add_filter( 'pre_option_woocommerce_hide_out_of_stock_items', 'bbloomer_hide_out_of_stock_exception_category' );
- 这行代码将我们的自定义函数 bbloomer_hide_out_of_stock_exception_category 挂载到 pre_option_woocommerce_hide_out_of_stock_items 过滤器上。这意味着每当WooCommerce尝试获取“隐藏缺货商品”的全局设置时，都会先执行我们的函数。
function bbloomer_hide_out_of_stock_exception_category( $hide ) { ... }
- 这是我们的自定义函数，它接收一个参数 $hide，该参数代表了WooCommerce全局设置中“隐藏缺货商品”的当前值（'yes' 或 'no'）。
if ( is_product_category( 'specific-category' ) ) { ... }
- is_product_category() 是一个条件标签，用于检测当前页面是否为指定的WooCommerce产品分类页面。
- 如果当前页面是我们指定的分类页面，条件为真。
$hide = 'no';
- 当条件为真时，我们将 $hide 的值设置为 'no'。这意味着，对于当前这个特定的分类页面，WooCommerce将不会隐藏缺货商品，即使全局设置是隐藏的。
return $hide;
- 函数最后返回 $hide 的值。这个值将作为最终的“隐藏缺货商品”设置被WooCommerce使用。