WooCommerce：如何通过代码将产品变体属性设为产品分类属性项

核心问题 #

当为变体设置全局产品属性（带pa_前缀的分类属性）时，set_attributes方法需要传入术语的slug（而非术语名称），或者直接传入术语ID（整数类型）——你当前使用术语名称字符串的写法不符合WooCommerce的要求，这是代码无法生效的根本原因。

修正方案 #

1. 封装辅助函数（简化术语匹配逻辑） #

先写一个可复用的函数，根据术语名称和属性分类，获取对应的术语slug或ID：

/**
 * 根据术语名称和属性分类获取对应术语的slug或ID
 * @param string $term_name 术语名称
 * @param string $taxonomy 属性分类（如pa_format）
 * @param string $return_type 返回类型，可选'slug'或'id'
 * @return string|int|null 匹配成功则返回对应值，未找到返回null
 */
function get_woo_attribute_term_value($term_name, $taxonomy, $return_type = 'slug') {
    $terms = get_terms(array(
        'taxonomy' => $taxonomy,
        'hide_empty' => false, // 包含未被使用的术语
    ));
    
    foreach ($terms as $term) {
        // 不区分大小写匹配，避免输入大小写差异导致失败
        if (strcasecmp($term->name, $term_name) === 0) {
            return $return_type === 'id' ? $term->term_id : $term->slug;
        }
    }
    return null;
}

2. 父产品属性设置（优化原代码） #

保留原逻辑的同时，用辅助函数简化术语ID的获取：

// 初始化属性数组
$attributes = array();

// 处理Format属性
$format_term_id = get_woo_attribute_term_value($woo_product_meta['format'], 'pa_format', 'id');
if ($format_term_id) {
    $attribute = new WC_Product_Attribute();
    $attribute->set_id(wc_attribute_taxonomy_id_by_name('pa_format'));
    $attribute->set_name('pa_format');
    $attribute->set_options(array($format_term_id));
    $attribute->set_position(0);
    $attribute->set_visible(true);
    $attribute->set_variation(true);
    $attributes[] = $attribute;
}

// 处理Condition属性
$condition_term_id = get_woo_attribute_term_value($woo_product_meta['condition'], 'pa_condition', 'id');
if ($condition_term_id) {
    $attribute = new WC_Product_Attribute();
    $attribute->set_id(wc_attribute_taxonomy_id_by_name('pa_condition'));
    $attribute->set_name('pa_condition');
    $attribute->set_options(array($condition_term_id));
    $attribute->set_position(1);
    $attribute->set_visible(true);
    $attribute->set_variation(true);
    $attributes[] = $attribute;
}

// 设置父产品属性并保存
$product->set_attributes($attributes);
$product->save(); // 必须保存父产品，否则变体无法关联属性

3. 变体属性设置（关键修正） #

使用术语slug为变体绑定全局属性：

// 创建产品变体
$variation = new WC_Product_Variation();
$variation->set_parent_id($product->get_id());

// 获取对应术语的slug
$format_slug = get_woo_attribute_term_value($woo_product_meta['format'], 'pa_format');
$condition_slug = get_woo_attribute_term_value($woo_product_meta['condition'], 'pa_condition');

// 仅在获取到有效slug时设置属性
if ($format_slug && $condition_slug) {
    $variation->set_attributes(array(
        'pa_format' => $format_slug,
        'pa_condition' => $condition_slug
    ));
}

// 保存变体
$variation->save();

额外注意事项 #

• 若偏好使用术语ID而非slug，只需将变体属性设置中的get_woo_attribute_term_value的第三个参数改为'id'即可，WooCommerce也支持传入整数类型的术语ID。
• 确保表单输入的术语名称与全局属性中已存在的术语名称完全匹配（或通过不区分大小写的匹配兼容输入差异）。
• 所有产品/变体操作完成后必须调用save()方法，否则设置不会持久化到数据库。

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