WooCommerce多站点环境下批量创建产品属性的跨站重复问题

问题1：属性被添加至多站点所有站点 #

原因：直接操作数据库时未保证多站点隔离，且分类法存在性判断逻辑错误。WooCommerce产品属性的分类法以pa_为前缀，属性数据存储在对应站点的{$wpdb->prefix}woocommerce_attribute_taxonomies表中，需确保操作限定在当前站点，同时优先使用官方封装函数替代直接数据库操作。

修复方式：

• 使用WooCommerce内置函数wc_create_attribute()替代直接插入数据库，该函数会自动处理多站点的站点隔离逻辑，确保属性仅创建在当前站点。
• 若需兼容旧版本WooCommerce，需明确使用当前站点的数据库前缀，且检查属性时限定当前站点范围。

问题2：页面刷新重复创建属性 #

原因：代码每次页面加载都会执行创建逻辑，未添加持久化的存在性校验，且原有的分类法存在性判断逻辑错误。

修复方式：

• 先通过官方函数wc_get_attribute()或查询当前站点属性表，确认属性是否已存在。
• 将创建逻辑放在仅执行一次的上下文（如插件激活钩子），或添加选项标记记录属性创建状态，避免重复执行。

修正后的完整代码 #

$domain = "some domain name";

if ($domain) {
    function create_product_attribute($label_name) {
        global $wpdb;
        
        $slug = sanitize_title($label_name);
        $attribute_taxonomy = 'pa_' . $slug;

        // 检查属性名称长度和保留词
        if (strlen($slug) >= 28) {
            return new WP_Error('invalid_product_attribute_slug_too_long', sprintf(__('Name "%s" is too long (28 characters max). Shorten it, please.', 'woocommerce'), $slug), array('status' => 400));
        } elseif (wc_check_if_attribute_name_is_reserved($slug)) {
            return new WP_Error('invalid_product_attribute_slug_reserved_name', sprintf(__('Name "%s" is not allowed because it is a reserved term. Change it, please.', 'woocommerce'), $slug), array('status' => 400));
        }

        // 检查当前站点是否已存在该属性
        $existing_attribute = wc_get_attribute($slug);
        if ($existing_attribute || taxonomy_exists($attribute_taxonomy)) {
            return new WP_Error('invalid_product_attribute_slug_already_exists', sprintf(__('Name "%s" is already in use. Change it, please.', 'woocommerce'), $label_name), array('status' => 400));
        }

        // 使用官方函数创建属性，自动处理多站点隔离
        $attribute_data = array(
            'name'         => $label_name,
            'slug'         => $slug,
            'type'         => 'select',
            'orderby'      => 'menu_order',
            'has_archives' => false,
        );

        $attribute_id = wc_create_attribute($attribute_data);

        if (is_wp_error($attribute_id)) {
            return new WP_Error('cannot_create_attribute', $attribute_id->get_error_message(), array('status' => 400));
        }

        // 刷新重写规则和清除缓存
        wp_schedule_single_event(time(), 'woocommerce_flush_rewrite_rules');
        delete_transient('wc_attribute_taxonomies');
        
        return $attribute_id;
    }

    // 通过选项标记确保仅执行一次创建逻辑
    if (!get_option('created_test_attribute9', false)) {
        create_product_attribute('test_attribute9');
        update_option('created_test_attribute9', true);
    }
}

关键说明 #

1. 多站点隔离：wc_create_attribute()会自动使用当前站点的数据库前缀，确保属性仅存储在当前站点的属性表中，不会跨站点创建。
2. 重复创建避免：通过wc_get_attribute()校验属性存在性，同时添加created_test_attribute9选项标记创建状态，保证代码仅执行一次。
3. 分类法前缀修正：将分类法检查改为pa_前缀的正确格式，避免误判属性不存在。

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