WooCommerce: автоматическое установление родительской категории при массовом импорте товаров

Диагностика проблемы с родительскими категориями при массовом импорте

При массовом импорте товаров в WooCommerce часто возникает ситуация, когда товары получают дочерние категории без корректного присвоения родительской категории. Это приводит к ошибкам в навигации и фильтрации каталога, а также ухудшает SEO. Для диагностики важно проверить, как категории импортируются и сохраняются в базе данных.

Основные признаки проблемы:

• Товары отображаются только в дочерних категориях, родительские категории пусты.
• Фильтры по категориям работают некорректно — родительские категории не учитываются.
• В админке при просмотре товара родительская категория не отображается в списке категорий.

Проверить текущие категории товара можно через стандартный REST API WooCommerce или напрямую в базе данных в таблице wp_term_relationships и wp_term_taxonomy.

Пошаговое решение: добавление родительской категории при импорте товаров

1. Анализ структуры CSV и подготовка данных

Убедитесь, что в CSV-файле для импорта категорий товары содержат полное иерархическое имя категории, например, Одежда > Мужская > Футболки. Если иерархия задана плоско, нужно преобразовать CSV или обработать категории программно.

2. Создание функции для автоматического добавления родительских категорий

Используем хук woocommerce_product_import_inserted_product, который срабатывает после создания товара при импорте. В функции добавим родительские категории, если они отсутствуют.

add_action('woocommerce_product_import_inserted_product', 'add_parent_categories_after_import', 10, 2);
function add_parent_categories_after_import($product, $data) {
    if (empty($data['categories']) || !is_array($data['categories'])) {
        return;
    }

    $all_terms = [];

    foreach ($data['categories'] as $category_name) {
        // Разбиваем иерархию по > для получения всех уровней
        $levels = array_map('trim', explode('>', $category_name));

        // Проходим по уровням сверху вниз
        $parent_id = 0;
        foreach ($levels as $level) {
            $term = term_exists($level, 'product_cat', $parent_id);
            if (!$term) {
                $term = wp_insert_term($level, 'product_cat', ['parent' => $parent_id]);
            }
            if (!is_wp_error($term)) {
                $parent_id = is_array($term) ? $term['term_id'] : $term;
                $all_terms[$parent_id] = true;
            } else {
                break; // Ошибка при создании терма
            }
        }
    }

    if ($all_terms) {
        wp_set_object_terms($product->get_id(), array_keys($all_terms), 'product_cat');
    }
}

3. Обработка иерархии категорий в CSV

Если в CSV категории не указаны иерархично, можно добавить колонку с полной иерархией или писать скрипт для пост-обработки после импорта, используя API WooCommerce или WP CLI.

Проверка результата после внедрения

После импорта новых товаров проверьте следующие моменты:

• В админке WooCommerce у товара отображаются и дочерние, и родительские категории.
• В фронтенде каталога родительские категории отображают товары из дочерних категорий.
• Фильтры по категориям работают корректно, включая родительские категории.
• В базе данных в wp_term_relationships для товара есть связи с родительскими категориями.

Частые ошибки и способы их устранения

• Отсутствие иерархии в CSV — приводит к импортированию только дочерних категорий. Решение: добавить полную иерархию в CSV или обрабатывать категории программно.
• Ошибки при создании терминов — могут возникать при конфликте имен или проблемах с правами. Решение: проверить логи ошибок, убедиться в наличии прав на создание категорий.
• Неверное использование хуков — если хук срабатывает не в нужный момент, категории не привязываются. Решение: использовать woocommerce_product_import_inserted_product, который вызывается после создания товара.
• Кэширование — кэшированные данные могут не показывать свежие категории. Решение: очистить кэш сайта и браузера.

Практические советы по безопасности и производительности

• Не используйте прямое обновление базы данных для изменения категорий. Всегда применяйте WP API wp_set_object_terms() для сохранения связей.
• При массовом импорте отключайте дополнительные плагины, влияющие на категории, чтобы избежать конфликтов.
• Для больших импортов используйте WP CLI или специализированные плагины с поддержкой иерархии и родительских категорий.
• Регулярно создавайте резервные копии базы данных перед массовым импортом.

Сравнение вариантов решения