WooCommerce短码排除产品分类后同页面其他分类筛选短码失效问题求助

你的问题出在当前代码强制覆盖了所有WooCommerce产品短码的tax_query参数，不管短码本身有没有设置分类筛选条件。

当你使用第一个短码（只需要排除custom分类）时，代码工作正常；但当你用第二个短码指定要展示某个特定分类时，你的钩子直接把短码原本的分类查询替换成了仅排除custom的规则，完全忽略了短码里的category参数，所以才会显示所有最新产品（实际是显示了除custom外的所有产品，但看起来像是没生效的“最新”列表）。

修正方案1：全局排除custom分类，但保留短码的自定义筛选 #

这个方案会让所有产品短码默认排除custom分类，同时如果短码指定了要展示的分类，会合并两个条件（显示指定分类 + 排除custom分类）：

add_action( 'woocommerce_shortcode_products_query', 'exclude_cat_shortcodes', 10, 3 );
function exclude_cat_shortcodes( $query_args, $atts, $loop_name ) {
    // 初始化tax_query（如果不存在的话）
    if ( empty( $query_args['tax_query'] ) ) {
        $query_args['tax_query'] = array();
    }

    // 添加排除custom分类的条件
    $query_args['tax_query'][] = array(
        'taxonomy' => 'product_cat',
        'field'    => 'slug',
        'terms'    => 'custom',
        'operator' => 'NOT IN',
    );

    // 确保多个分类条件是"AND"关系（即同时满足）
    $query_args['tax_query']['relation'] = 'AND';

    return $query_args;
}

修正方案2：更灵活的控制——仅给需要排除的短码添加规则 #

如果你不想全局排除，只想让特定短码应用排除规则，可以给短码加一个自定义参数，比如exclude_custom="true"，然后在函数里判断：

add_action( 'woocommerce_shortcode_products_query', 'exclude_cat_shortcodes', 10, 3 );
function exclude_cat_shortcodes( $query_args, $atts, $loop_name ) {
    // 只有当短码明确设置了exclude_custom="true"时，才应用排除规则
    if ( isset( $atts['exclude_custom'] ) && $atts['exclude_custom'] === 'true' ) {
        if ( empty( $query_args['tax_query'] ) ) {
            $query_args['tax_query'] = array();
        }

        $query_args['tax_query'][] = array(
            'taxonomy' => 'product_cat',
            'field'    => 'slug',
            'terms'    => 'custom',
            'operator' => 'NOT IN',
        );

        $query_args['tax_query']['relation'] = 'AND';
    }

    return $query_args;
}

使用方式： #

• 需要排除custom分类的短码：[products exclude_custom="true"]
• 展示特定分类的短码（不受排除规则影响）：[products category="你的目标分类别名"]

为什么原来的代码会失效？ #

你之前的代码直接赋值$query_args['tax_query'] = array(...)，这会完全覆盖短码原本的tax_query设置。比如当你用[products category="xxx"]时，WooCommerce原本会生成一个查询该分类的tax_query，但你的钩子把它替换成了仅排除custom的查询，所以短码的分类筛选就失效了。

内容的提问来源于stack exchange，提问作者ermalkonjufca