WooCommerce产品类别转产品属性的代码实现问题咨询

我来帮你完善这段代码，实现将WooCommerce产品的父/子类别映射为产品属性的功能——父类别作为属性名称，子类别作为对应的属性值。下面分单产品处理和批量处理两种场景，同时覆盖关键的边界情况：

这段代码可以放在单个产品的模板文件中，或者封装成函数针对特定产品执行：

// 获取当前产品的所有产品类别（包含完整字段）
$all_categories = wp_get_post_terms( get_the_ID(), 'product_cat', array('fields' => 'all') );
$product_id = get_the_ID();

foreach ($all_categories as $_term) {
    // 跳过顶级类别（无父类的类别），如果需要处理顶级类别可删除此判断
    if ( $_term->parent === 0 ) {
        continue;
    }

    // 获取当前类别的父类别
    $parent_term = get_term_by( 'id', $_term->parent, 'product_cat' );
    if ( !$parent_term || is_wp_error($parent_term) ) {
        continue; // 父类别不存在则跳过
    }

    // 1. 确保全局产品属性存在，不存在则创建
    $attribute_slug = sanitize_title( $parent_term->name );
    $attribute_taxonomy = 'pa_' . $attribute_slug; // WooCommerce属性的分类法前缀固定为pa_

    if ( !taxonomy_exists( $attribute_taxonomy ) ) {
        // 创建全局属性
        $attribute_id = wc_create_attribute(array(
            'name'         => $parent_term->name,
            'slug'         => $attribute_slug,
            'type'         => 'select', // 可选：multiselect（多选）、text（文本）等
            'order_by'     => 'menu_order',
            'has_archives' => false, // 是否启用属性归档页面
        ));
        // 立即注册新属性的分类法，确保后续代码能正常调用
        register_taxonomy(
            $attribute_taxonomy,
            'product',
            wc_get_attribute_taxonomy_args( $attribute_slug )
        );
    }

    // 2. 确保属性值（术语）存在，不存在则创建
    $value_slug = sanitize_title( $_term->name );
    $value_term = get_term_by( 'slug', $value_slug, $attribute_taxonomy );

    if ( !$value_term || is_wp_error($value_term) ) {
        $term_insert = wp_insert_term(
            $_term->name,
            $attribute_taxonomy,
            array('slug' => $value_slug)
        );
        if ( is_wp_error($term_insert) ) {
            continue; // 创建属性值失败则跳过
        }
        $value_term = get_term( $term_insert['term_id'], $attribute_taxonomy );
    }

    // 3. 将属性关联到当前产品
    // 获取产品已有的属性配置
    $product_attributes = get_post_meta( $product_id, '_product_attributes', true );
    if ( !is_array($product_attributes) ) {
        $product_attributes = array();
    }

    // 添加/更新当前属性的配置
    $product_attributes[ $attribute_taxonomy ] = array(
        'name'         => $attribute_taxonomy,
        'value'        => $value_term->term_id,
        'position'     => count($product_attributes), // 自动设置排序位置
        'is_visible'   => 1, // 前端产品页面是否显示该属性
        'is_variation' => 0, // 是否用作产品变体属性（是则改为1）
        'is_taxonomy'  => 1, // 标记为全局属性（而非自定义文本属性）
    );

    // 保存产品属性配置
    update_post_meta( $product_id, '_product_attributes', $product_attributes );

    // 可选：将属性值关联到产品（用于前端筛选、归档等功能）
    wp_set_post_terms( $product_id, $value_term->term_id, $attribute_taxonomy, true );
}

如果需要一次性将所有产品的类别转换为属性，可以使用下面的批量处理函数：

function batch_convert_categories_to_attributes() {
    // 验证权限，仅管理员可执行
    if ( !current_user_can('manage_options') ) {
        wp_die('无权限执行此操作');
    }

    // 获取所有已发布的产品ID
    $products = get_posts(array(
        'post_type'      => 'product',
        'post_status'    => 'publish',
        'posts_per_page' => -1,
        'fields'         => 'ids',
    ));

    foreach ( $products as $product_id ) {
        $all_categories = wp_get_post_terms( $product_id, 'product_cat', array('fields' => 'all') );
        
        foreach ($all_categories as $_term) {
            if ( $_term->parent === 0 ) {
                continue;
            }

            $parent_term = get_term_by( 'id', $_term->parent, 'product_cat' );
            if ( !$parent_term || is_wp_error($parent_term) ) {
                continue;
            }

            $attribute_slug = sanitize_title( $parent_term->name );
            $attribute_taxonomy = 'pa_' . $attribute_slug;

            if ( !taxonomy_exists( $attribute_taxonomy ) ) {
                wc_create_attribute(array(
                    'name'         => $parent_term->name,
                    'slug'         => $attribute_slug,
                    'type'         => 'select',
                    'order_by'     => 'menu_order',
                    'has_archives' => false,
                ));
                register_taxonomy(
                    $attribute_taxonomy,
                    'product',
                    wc_get_attribute_taxonomy_args( $attribute_slug )
                );
            }

            $value_slug = sanitize_title( $_term->name );
            $value_term = get_term_by( 'slug', $value_slug, $attribute_taxonomy );

            if ( !$value_term || is_wp_error($value_term) ) {
                $term_insert = wp_insert_term(
                    $_term->name,
                    $attribute_taxonomy,
                    array('slug' => $value_slug)
                );
                if ( is_wp_error($term_insert) ) {
                    continue;
                }
                $value_term = get_term( $term_insert['term_id'], $attribute_taxonomy );
            }

            $product_attributes = get_post_meta( $product_id, '_product_attributes', true );
            if ( !is_array($product_attributes) ) {
                $product_attributes = array();
            }

            $product_attributes[ $attribute_taxonomy ] = array(
                'name'         => $attribute_taxonomy,
                'value'        => $value_term->term_id,
                'position'     => count($product_attributes),
                'is_visible'   => 1,
                'is_variation' => 0,
                'is_taxonomy'  => 1,
            );

            update_post_meta( $product_id, '_product_attributes', $product_attributes );
            wp_set_post_terms( $product_id, $value_term->term_id, $attribute_taxonomy, true );
        }
    }

    echo '批量转换完成！';
    exit;
}

// 触发方式：访问你的站点域名/?run_batch_convert（仅管理员可访问）
if ( isset($_GET['run_batch_convert']) ) {
    batch_convert_categories_to_attributes();
}

• 数据备份：执行批量操作前务必备份数据库，避免操作失误导致数据丢失。
• 性能优化：如果产品数量超过500个，建议分批次处理（比如修改posts_per_page为50，多次执行），或者使用WP-CLI执行以避免超时。
• 顶级类别处理：如果需要将顶级类别也转换为属性，可以删除if ( $_term->parent === 0 ) continue;的判断，调整逻辑将顶级类别作为属性名，值设为类别本身或自定义内容。
• 多选属性支持：如果需要一个产品对应多个同属性值，将属性创建时的type改为multiselect，并确保wp_set_post_terms的第四个参数为true（追加模式）。
• 变体属性配置：如果要将属性用作产品变体，需将is_variation设为1，同时确保产品类型为“可变产品”（Variable Product）。

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