求助：基于产品标签自动分配产品分类的WordPress代码无法生效

原代码核心问题 #

1. 变量名错误：函数参数定义为$product_id，但内部误用未定义的$post_id，导致无法正确验证产品类型。
2. 钩子适配错误：publish_post仅针对文章触发，WooCommerce产品需使用专属保存钩子。
3. 匹配逻辑不对应：数组$tag_categories的键是标签名称，但代码用$term->slug（别名）匹配，两者格式不一致，导致无法找到对应分类。
4. 术语获取冗余：get_terms搭配object_ids不如wp_get_object_terms直接获取指定产品标签高效。
5. 错误处理缺失：get_term_by可能返回false，直接访问$cat->term_id会引发PHP警告。

修复后的完整代码 #

function auto_assign_product_category($product_id = 0) {
    if (!$product_id) return;

    // 验证当前对象为WooCommerce产品
    $post_type = get_post_type($product_id);
    if ('product' !== $post_type) return;

    // 标签名称 -> 分类名称映射（需与后台标签/分类名称完全一致）
    $tag_category_map = array(
        'Biblioteka' => 'Biblioteki',
        'Biurko' => 'Biurka',
        'Fotel' => 'Fotele',
        'Komoda' => 'Komody',
        'Konsola' => 'Konsole',
        'Kredens' => 'Kredensy',
        'Krzesło' => 'Krzesła',
        'Lustro' => 'Lustra',
        'Ława' => 'Ławy',
        'Łóżko' => 'Łóżka',
        'Regał na książki' => 'Regały na książki',
        'Sofa' => 'Sofy',
        'Stolik' => 'Stoliki',
        'Stół' => 'Stoły',
        'Stół ogrodowy' => 'Stoły ogrodowe',
        'Szafka nocna' => 'Szafki nocne',
        'Szafka RTV' => 'Szafki RTV',
        'Szafa' => 'Szafy',
        'Toaletka' => 'Toaletki',
        'Witryna' => 'Witryny',
    );

    // 获取当前产品的所有标签（按名称返回）
    $product_tags = wp_get_object_terms($product_id, 'product_tag', array('fields' => 'names'));
    if (is_wp_error($product_tags)) return;

    foreach ($product_tags as $tag_name) {
        if (isset($tag_category_map[$tag_name])) {
            // 根据分类名称获取分类对象
            $category = get_term_by('name', $tag_category_map[$tag_name], 'product_cat');
            if ($category && !is_wp_error($category)) {
                // 为产品追加分类（true表示不覆盖现有分类）
                wp_set_post_terms($product_id, $category->term_id, 'product_cat', true);
            }
        }
    }
}

// 绑定产品保存钩子（新增/编辑产品时自动触发）
add_action('woocommerce_product_saved', 'auto_assign_product_category');

// 批量处理存量产品（执行一次后可注释）
function batch_assign_categories_to_existing_products() {
    // 限制单次处理数量，避免超时
    $args = array(
        'post_type' => 'product',
        'post_status' => 'publish',
        'posts_per_page' => 50,
        'paged' => 1,
        'fields' => 'ids'
    );

    $products = new WP_Query($args);
    if ($products->have_posts()) {
        foreach ($products->posts as $product_id) {
            auto_assign_product_category($product_id);
        }
    }
    wp_reset_postdata();
}
// 取消注释此行，访问网站任意页面触发批量处理，完成后重新注释
// add_action('init', 'batch_assign_categories_to_existing_products');

使用说明 #

1. 映射表校验：确保$tag_category_map中的标签名称与后台产品标签完全一致（注意大小写、特殊字符如Ł/ł）。
2. 自动分配启用：woocommerce_product_saved钩子会在新增或更新产品时自动执行分类分配。
3. 存量产品处理：
   • 取消最后一行注释，访问网站任意页面触发批量处理（单次处理50个产品）。
   • 产品数量较多时，可多次访问页面，或调整posts_per_page的值（需考虑服务器超时限制）。
   • 处理完成后，重新注释该行，避免重复执行。

可选优化 #

• 若标签使用slug（小写无空格别名），可将$tag_category_map的键改为slug，同时修改代码中wp_get_object_terms的fields参数为'slugs'，循环中用$tag_slug匹配。
• 如需覆盖产品现有分类，将wp_set_post_terms的第四个参数改为false。

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