WooCommerce创建产品属性后无法在属性板块显示问题求助

我在WooCommerce中创建产品及其对应属性，代码执行无异常，但新增的属性无法在后台「属性」板块中显示。以下是我使用的代码：

function create_product() {
$product = new WC_Product_Simple();

$product->set_name( 'Название товара' );
$product->set_regular_price( '100' );

// Добавляем атрибуты "бренд" и "цвет" к товару
$attributes = array(
    'Бренд' => 'Ямаха',
    'Цвет' => 'Красный'
);
$wc_attributes = array();
foreach ( $attributes as $attribute_name => $attribute_value ) {
    $attribute = new WC_Product_Attribute();
    $attribute->set_id( 0 );
    $attribute->set_name( $attribute_name );
    
    $attribute->set_options( array( $attribute_value ) );
    $attribute->set_visible( true );
    $attribute->set_variation( false );
    $wc_attributes[] = $attribute;

}
$product->set_attributes( $wc_attributes );
// Сохраняем новый товар
$product->save();

return $product->get_id();
}

问题原因 #

当前代码只是给单个产品添加了产品级自定义属性，这类属性仅属于该产品，不会同步到WooCommerce后台的全局「属性」板块。全局属性需要先注册为WooCommerce的属性分类（taxonomy），才能在后台显示并被多个产品复用。

修正步骤及代码 #

要让属性显示在后台「属性」板块，需要先创建全局属性，再将产品属性关联到这些全局属性：

function create_product() {
    // 1. 创建或获取全局属性（品牌和颜色）
    $attributes_meta = array(
        'Бренд' => 'brand',
        'Цвет' => 'color'
    );
    
    $global_attr_ids = array();
    foreach ($attributes_meta as $attr_label => $attr_slug) {
        // 检查属性是否已存在
        $existing_attr_id = wc_get_attribute_id_by_name($attr_label);
        if (!$existing_attr_id) {
            // 创建新的全局属性
            $attr_id = wc_create_attribute(array(
                'name'         => $attr_label,
                'slug'         => $attr_slug,
                'type'         => 'select', // 可选类型：select/text/color/date等
                'order_by'     => 'menu_order',
                'has_archives' => false
            ));
            $global_attr_ids[$attr_slug] = $attr_id;
        } else {
            $global_attr_ids[$attr_slug] = $existing_attr_id;
        }
    }

    // 2. 创建产品
    $product = new WC_Product_Simple();
    $product->set_name('Название товара');
    $product->set_regular_price('100');

    // 3. 关联产品属性到全局属性分类
    $product_attributes = array();

    // 处理品牌属性
    $brand_attr = new WC_Product_Attribute();
    $brand_attr->set_id($global_attr_ids['brand']);
    $brand_attr->set_name('pa_' . 'brand'); // 全局属性taxonomy前缀为pa_
    $brand_attr->set_options(array('Ямаха'));
    $brand_attr->set_visible(true);
    $brand_attr->set_variation(false);
    $brand_attr->set_is_taxonomy(true); // 标记为关联全局属性
    $product_attributes[] = $brand_attr;

    // 处理颜色属性
    $color_attr = new WC_Product_Attribute();
    $color_attr->set_id($global_attr_ids['color']);
    $color_attr->set_name('pa_' . 'color');
    $color_attr->set_options(array('Красный'));
    $color_attr->set_visible(true);
    $color_attr->set_variation(false);
    $color_attr->set_is_taxonomy(true);
    $product_attributes[] = $color_attr;

    $product->set_attributes($product_attributes);
    $product->save();

    return $product->get_id();
}

关键说明 #

• 全局属性的taxonomy名称固定以pa_为前缀，比如slug为brand，对应的taxonomy是pa_brand
• 使用wc_create_attribute()创建的属性会直接显示在后台「属性」板块
• set_is_taxonomy(true)是核心：告诉WooCommerce该属性关联到全局属性分类，而非仅属于当前产品

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