WooCommerce中[recent_products]短代码如何排除指定分类产品

原生WooCommerce当前版本的[recent_products]短代码不支持category、cat_operator参数，你写的过滤参数不会被程序识别，这是分类排除不生效的根本原因。
很多使用者会混淆[recent_products]和[products]两个短代码的参数范围：[recent_products]属于功能简化的快捷短代码，仅支持per_page、columns、order、orderby几个基础参数，没有分类过滤的相关能力。你用到的category、cat_operator是[products]短代码的专属参数，直接套在[recent_products]上不会生效。

方案1：替换为功能完整的[products]短代码（推荐） #

[recent_products]的本质是「按发布时间倒序拉取商品」的快捷写法，完全可以用参数更全的[products]短代码等价替代，直接支持分类排除，正确写法如下：

[products limit="4" orderby="date" order="DESC" category="-instore" visibility="catalog"]

参数说明：

• limit="4" 对应原短代码的per_page="4"，控制输出商品数量
• orderby="date" order="DESC" 等价于原短代码按最新发布排序的逻辑
• category="-instore" 是WooCommerce短代码排除分类的原生写法：分类slug前加负号-即代表排除该分类，不需要额外写cat_operator参数
• visibility="catalog" 保证仅输出前台正常可见的商品，和你现有插件隐藏线下商品的逻辑兼容

方案2：全局给[recent_products]追加分类过滤规则（适合已大量部署短代码不想逐个修改的场景） #

如果你的站点已经在很多页面用了[recent_products]，不想逐个替换短代码，可以通过WooCommerce提供的过滤器统一追加排除规则。将下面的代码片段添加到当前主题的functions.php文件，或者通过代码片段管理插件插入即可：

add_filter( 'woocommerce_shortcode_products_query', 'exclude_instore_from_recent_products', 10, 3 );
function exclude_instore_from_recent_products( $query_args, $atts, $loop_name ) {
    // 仅针对recent_products短代码生效
    if ( $loop_name !== 'recent_products' ) {
        return $query_args;
    }
    // 追加分类排除规则
    $tax_query = ! empty( $query_args['tax_query'] ) ? $query_args['tax_query'] : [];
    $tax_query[] = [
        'taxonomy' => 'product_cat',
        'field'    => 'slug',
        'terms'    => [ 'instore' ],
        'operator' => 'NOT IN',
    ];
    $query_args['tax_query'] = $tax_query;
    return $query_args;
}

添加后所有位置的[recent_products]输出都会自动排除slug为instore的分类下商品，不需要修改现有页面内容。

补充说明 #

你之前使用的cat_operator、category参数，是WooCommerce 3.2版本之前[recent_products]短暂支持过的参数，后续版本重构产品短代码逻辑后就已经移除，所以当前版本下这两个参数不会触发任何过滤逻辑，才会导致线下专属商品正常显示。

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