WooCommerce中如何按产品类别差异化设置商品数量输入参数

实现逻辑 #

在现有钩子的处理链路中增加分类判断分支：抽出可维护的规则配置表，匹配到对应分类的商品就应用专属数量参数，未匹配的商品保留原有全站默认配置；同时修正原有变体处理逻辑的参数接收缺陷，保证变量商品的变体规则也能随分类自动生效。

可直接替换的完整代码 #

将原有代码全部替换为以下内容，后续只需要在规则配置数组中补充对应分类的参数即可：

// 公共规则获取函数：统一返回当前商品匹配的数量规则，避免重复维护
function jk_get_product_qty_rules( $product_id ) {
    // 全站通用默认规则（即原有硬编码配置）
    $default_rules = [
        'input_value' => 100,
        'max_value'   => 10000,
        'min_value'   => 100,
        'step'        => 50
    ];
    // 自定义分类专属规则：键为分类Slug，值为该分类下需要覆盖的参数
    $category_rules = [
        // 示例：大包装分类的专属规则
        'bulk-pack' => [
            'input_value' => 50,
            'max_value'   => 5000,
            'min_value'   => 20,
            'step'        => 10
        ],
        // 示例：礼品分类的专属规则
        'gift-item' => [
            'input_value' => 1,
            'max_value'   => 20,
            'min_value'   => 1,
            'step'        => 1
        ]
    ];
    // 匹配商品所属分类
    foreach( $category_rules as $cat_identifier => $rule ) {
        if ( has_term( $cat_identifier, 'product_cat', $product_id ) ) {
            // 用分类专属规则覆盖默认规则，未覆盖的参数仍沿用默认值
            return array_merge( $default_rules, $rule );
        }
    }
    // 未匹配到特殊分类，返回默认规则
    return $default_rules;
}

// 处理普通商品的数量输入参数
add_filter( 'woocommerce_quantity_input_args', 'jk_woocommerce_quantity_input_args', 10, 2 );
function jk_woocommerce_quantity_input_args( $args, $product ) {
    $matched_rule = jk_get_product_qty_rules( $product->get_id() );
    // 仅产品页设置默认输入值，购物车页保持原有逻辑
    if ( is_singular( 'product' ) ) {
        $args['input_value'] = $matched_rule['input_value'];
    }
    $args['max_value'] = $matched_rule['max_value'];
    $args['min_value'] = $matched_rule['min_value'];
    $args['step']      = $matched_rule['step'];
    return $args;
}

// 处理变量商品的变体数量参数（修正原有钩子的参数接收缺陷，支持获取商品对象判断分类）
add_filter( 'woocommerce_available_variation', 'jk_woocommerce_available_variation', 10, 3 );
function jk_woocommerce_available_variation( $args, $product, $variation ) {
    // 变体自动继承父级变量商品的分类规则
    $matched_rule = jk_get_product_qty_rules( $product->get_id() );
    $args['max_qty'] = $matched_rule['max_value'];
    $args['min_qty'] = $matched_rule['min_value'];
    return $args;
}

注意事项 #

• 自定义规则中的分类标识支持Slug、分类ID、分类名称三种格式，推荐使用Slug，避免后续修改分类名称导致规则匹配失效。
• 如果一个商品同时归属多个分类，规则会按照$category_rules数组从上到下的顺序匹配，哪个规则排在前面就优先应用哪个，调整数组顺序即可修改优先级。
• 分类专属规则只需要填写需要覆盖的参数即可，未填写的参数会自动沿用全站默认规则，不需要重复写全所有参数。
• 变体商品的数量规则会自动继承所属变量商品的分类配置，不需要单独为变体设置匹配逻辑。
• 分类判断时使用的产品分类法名固定为product_cat，不要随意修改，否则会导致匹配失效。

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