使用WC_Product_Variable创建可变商品却生成简单商品的问题

问题描述 #

我尝试通过代码在WooCommerce中创建可变商品，代码如下：

$currentProduct = new WC_Product_Variable();

$currentProduct->set_name( $product['Title'] );
$currentProduct->set_sku( time() );
$currentProduct->set_stock_quantity( -1 );
$currentProduct->set_description($product['Body (HTML)'] );

$imageId = download_image($product['Image Src']);

$currentProduct->set_image_id( $imageId );
$currentProduct->set_regular_price( 500.00 );

$category_ids = [$categories[$product['Type']]];
var_dump($category_ids);

foreach($tags as $tag) {
    array_push($category_ids , $categories[trim($tag)]);
}

$currentProduct->set_category_ids( $category_ids );
$currentProduct->save();

$variation = new WC_Product_Variation();

$variation->set_parent_id( $currentProduct->get_id() );

$variation->set_attributes( array( 'type' => $product['Option1 Value'] ) );
$variation->set_regular_price( $product['Variant Price'] );
$variation->save();

但最终创建出的是简单商品而非可变商品，参考官方文档编写代码未找到有效解答，疑惑代码是否符合规范。

核心原因及解决方法 #

主要问题：未正确配置可变属性 #

WooCommerce的可变商品要求必须关联已注册且标记为“用于变体”的属性，你当前的代码只给变体设置了type属性，但父商品没有关联该属性，且该属性未在系统中注册为可变属性，导致系统无法识别这是一个可变商品，自动降级为简单商品。

修正步骤 #

1. 注册/获取可变属性：确保type属性在WooCommerce系统中存在，并设置为可用于变体

// 检查"type"属性是否已存在，不存在则创建
$attribute_id = wc_get_attribute_id_by_name('type');
if ( !$attribute_id ) {
    $attribute_data = [
        'name'         => 'type',
        'slug'         => 'type',
        'type'         => 'select',
        'order_by'     => 'menu_order',
        'has_archives' => false,
    ];
    $attribute_id = wc_create_attribute($attribute_data);
}

// 准备商品属性数组，标记该属性用于变体
$product_attributes = [
    wc_attribute_taxonomy_name('type') => [
        'name'         => wc_attribute_taxonomy_name('type'),
        'value'        => $product['Option1 Value'],
        'position'     => 0,
        'is_visible'   => true,
        'is_variation' => true,
        'is_taxonomy'  => true,
    ]
];

// 将属性关联到父可变商品
$currentProduct->set_attributes($product_attributes);

2. 调整代码顺序：将上述代码放在$currentProduct->save();之前，确保父商品保存时已经关联了可变属性。

其他注意事项 #

• 父商品的regular_price可以留空，因为可变商品的价格通常由变体设置，不过这不是导致商品类型错误的直接原因。
• 确认download_image函数返回的是有效的WordPress附件ID，无效ID不会改变商品类型，但会影响商品图片显示。

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