WooCommerce教程：针对特定商品分类显示缺货商品-php教程-PHP中文网

WooCommerce教程：针对特定商品分类显示缺货商品

霞舞

发布： 2025-11-05 12:56:18

原创

927人浏览过

WooCommerce教程：针对特定商品分类显示缺货商品

本教程详细介绍了如何在woocommerce中，即使全局设置了隐藏缺货商品，也能在特定的商品分类页面中显示这些商品。通过利用wordpress的`pre_option_woocommerce_hide_out_of_stock_items`过滤器，开发者可以精确控制哪些分类应忽略全局的缺货隐藏规则，从而实现更灵活的库存展示策略。

在WooCommerce商店运营中，一个常见的需求是管理缺货商品的显示。WooCommerce在“设置”-youjiankuohaophpcn“产品”->“库存”菜单中提供了一个全局选项，允许商家选择是否在目录列表中隐藏缺货商品。然而，在某些特定场景下，例如推广即将补货的商品、展示历史商品或在特定促销活动中，商家可能希望在某些特定的商品分类页面中显示这些缺货商品，即使全局设置是隐藏的。本文将详细指导您如何通过代码实现这一高级定制功能。

核心解决方案：利用WordPress过滤器

WooCommerce和WordPress提供了强大的过滤器（Filters）机制，允许开发者在核心功能执行的不同阶段修改数据或行为。针对本文的需求，我们将使用pre_option_woocommerce_hide_out_of_stock_items过滤器。这个过滤器在WooCommerce读取“隐藏缺货商品”的全局设置之前触发，允许我们根据当前页面上下文（例如是否在特定商品分类页面）动态地修改这个设置。

代码实现

以下是实现这一功能的代码片段：

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

function custom_display_out_of_stock_in_category( $hide ) {
    // 替换 'your-specific-category-slug' 为您希望显示缺货商品的分类的实际slug
    // 如果是多个分类，可以使用数组：if ( is_product_category( array( 'category-slug-1', 'category-slug-2' ) ) )
    if ( is_product_category( 'your-specific-category-slug' ) ) {
        // 如果当前页面是指定分类，则强制设置为“不隐藏”（即显示）
        $hide = 'no';
    }   
    return $hide;
}

登录后复制

代码解读

add_filter( 'pre_option_woocommerce_hide_out_of_stock_items', 'custom_display_out_of_stock_in_category' );
- add_filter() 是WordPress用于挂载过滤器的函数。
- 'pre_option_woocommerce_hide_out_of_stock_items' 是我们监听的特定过滤器钩子。它会在WooCommerce尝试获取woocommerce_hide_out_of_stock_items这个选项（即全局的“隐藏缺货商品”设置）的值之前执行。
- 'custom_display_out_of_stock_in_category' 是当过滤器触发时，将被调用的自定义函数。
function custom_display_out_of_stock_in_category( $hide ) { ... }
- 这是我们的自定义回调函数，它接收一个参数 $hide，这个参数代表了WooCommerce当前读取到的全局“隐藏缺货商品”设置（'yes'表示隐藏，'no'表示不隐藏）。
if ( is_product_category( 'your-specific-category-slug' ) ) { ... }

商汤商量
商汤科技研发的AI对话工具，商量商量，都能解决。

36

查看详情
- is_product_category() 是WooCommerce提供的一个条件标签，用于检查当前页面是否为指定的商品分类页面。
- 您需要将 'your-specific-category-slug' 替换为您希望显示缺货商品的实际分类的slug。分类slug是分类的URL友好名称，通常在编辑分类时可以看到。
- 如果您需要针对多个分类应用此规则，可以将分类slugs作为数组传递，例如 is_product_category( array( 'category-slug-1', 'category-slug-2' ) )。
$hide = 'no';
- 如果条件判断为真（即当前页面是目标分类页面），我们将 $hide 变量的值修改为 'no'。这意味着我们告诉WooCommerce，对于这个特定的页面，不要隐藏缺货商品。
return $hide;
- 函数最后返回 $hide 的值。无论是原始的全局设置，还是我们修改后的设置，这个值都将被WooCommerce用于决定是否显示缺货商品。

如何应用代码

将上述代码添加到您的WordPress网站有以下几种推荐方式：

主题的 functions.php 文件： 这是最直接的方式，将代码粘贴到您当前活动主题的 functions.php 文件的末尾。
- 优点： 简单快捷。
- 缺点： 如果主题更新，您的修改可能会被覆盖。不推荐在父主题中直接修改，而应在子主题中进行。
自定义插件： 创建一个简单的自定义插件来存放您的定制代码。
- 优点： 您的代码与主题分离，主题更新不会影响您的定制。这是最佳实践。
- 缺点： 需要一些基本的插件开发知识。

注意事项

替换分类Slug： 务必将代码中的 'your-specific-category-slug' 替换为您目标分类的实际slug。错误的slug将导致代码无法正常工作。
多分类处理： 如果您希望在多个分类中显示缺货商品，请使用 is_product_category( array( 'slug-1', 'slug-2', 'slug-3' ) ) 这样的数组形式。
缓存： 如果您的网站使用了缓存插件或服务器级缓存，在应用代码后可能需要清除缓存才能看到效果。
测试： 在生产环境中使用此代码之前，请务必在开发或测试环境中进行充分测试，确保其按预期工作，并且没有引入其他意外问题。
性能： 这种类型的过滤器通常对网站性能影响很小，因为它只在WooCommerce读取特定选项时执行，并且 is_product_category() 函数的性能开销也相对较低。