如何在WooCommerce 3.3中为产品短代码使用自定义分类法？

嘿，我刚搞定过几乎一模一样的需求，给你一套直接能用的方案：

因为WooCommerce默认的[products]短代码并不支持自定义分类法的筛选，所以我们需要通过代码扩展它的参数，让它能识别你用CPT UI创建的brand分类法。

第一步：确认分类法关联正确 #

先去CPT UI的「编辑分类法」页面，找到你创建的Brand分类法，检查「关联的Post类型」里是否勾选了product（WooCommerce产品的post类型）。如果没选，勾选后保存，这样产品才能分配到对应的品牌分类下。

第二步：添加代码扩展短代码 #

把下面的代码添加到你的主题functions.php文件，或者用代码片段插件（更推荐，避免主题更新丢失代码）：

/**
 * 扩展WooCommerce Products短代码，支持自定义Brand分类筛选
 */
add_filter( 'woocommerce_shortcode_products_query', 'custom_products_shortcode_brand_filter', 10, 3 );
function custom_products_shortcode_brand_filter( $query_args, $atts, $loop_name ) {
    // 检测短代码是否传入brand参数
    if ( isset( $atts['brand'] ) && ! empty( $atts['brand'] ) ) {
        // 处理多品牌逗号分隔的情况
        $brands = explode( ',', $atts['brand'] );
        $query_args['tax_query'][] = array(
            'taxonomy' => 'brand', // 这里要和你创建的分类法slug完全一致
            'field'    => 'slug',
            'terms'    => $brands,
            'operator' => isset( $atts['brand_operator'] ) ? $atts['brand_operator'] : 'IN',
        );
    }
    return $query_args;
}

/**
 * 注册brand和brand_operator短代码参数
 */
add_filter( 'woocommerce_shortcode_products_atts', 'custom_products_shortcode_brand_atts', 10, 1 );
function custom_products_shortcode_brand_atts( $atts ) {
    $atts['brand'] = isset( $atts['brand'] ) ? $atts['brand'] : '';
    $atts['brand_operator'] = isset( $atts['brand_operator'] ) ? $atts['brand_operator'] : 'IN';
    return $atts;
}

代码说明： #

• 第一个函数负责拦截短代码的查询逻辑，当检测到brand参数时，自动添加对应的分类筛选条件
• 第二个函数用来注册新的短代码参数，让WooCommerce能识别brand和brand_operator这两个参数

第三步：使用短代码展示品牌产品 #

现在你就可以完全按照你预想的方式使用短代码了：

• 第一行Apple产品（8个，4列）：
  [products limit="8" columns="4" brand="apple"]

• 第二行Samsung产品：
  [products limit="8" columns="4" brand="samsung"]

• 第三行HTC产品：
  [products limit="8" columns="4" brand="htc"]

额外用法： #

如果需要同时展示多个品牌，用逗号分隔即可：
[products limit="12" columns="4" brand="apple,samsung" brand_operator="IN"]

如果要排除某个品牌，用NOT IN操作符：
[products limit="12" columns="4" brand="htc" brand_operator="NOT IN"]

调试小提示 #

如果短代码没生效，检查这几点：

• 确认你的品牌分类法slug确实是brand（去CPT UI的分类法编辑页面看「分类法Slug」）
• 确认目标产品已经正确分配到对应的品牌分类下
• 清除网站缓存，有时候缓存会阻碍新代码生效

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