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

В чем проблема с импортом категорий в WooCommerce

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

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

Чтобы проверить, что проблема именно в отсутствии родительской категории, выполните следующее:

• Откройте раздел «Товары» > «Категории» в админ-панели WooCommerce.
• Найдите импортированные категории и убедитесь, что у них нет установленного родителя, хотя по структуре он должен быть.
• Проверьте импортируемый CSV или XML-файл: в колонках категорий должна быть информация о родительских категориях, обычно в формате "Родительская категория > Дочерняя категория".

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

Реализуем автоматическую проверку и добавление родительской категории при импорте через хук woocommerce_product_import_inserted_product_object, который срабатывает после создания/обновления товара.

Пример кода, который можно добавить в файл functions.php вашей темы или в кастомный плагин:

add_action('woocommerce_product_import_inserted_product_object', 'set_parent_category_automatically', 10, 2); 
function set_parent_category_automatically($product, $data) {
    if (empty($data['categories']) || !is_array($data['categories'])) {
        return;
    }
    foreach ($data['categories'] as $cat_name) {
        // Разбираем иерархию категорий через разделитель ' > '
        $categories = array_map('trim', explode(' > ', $cat_name));
        if (count($categories) < 2) {
            continue; // Нет иерархии
        }
        $parent_term = null;
        foreach ($categories as $cat) {
            $term = get_term_by('name', $cat, 'product_cat');
            if (!$term) {
                // Создаем термин, если не существует
                $term_args = array('slug' => sanitize_title($cat));
                $term = wp_insert_term($cat, 'product_cat', array('parent' => $parent_term ? $parent_term->term_id : 0));
                if (is_wp_error($term)) {
                    break;
                }
                $term = get_term($term['term_id'], 'product_cat');
            }
            $parent_term = $term;
        }
        // Привязываем товар к последнему термину (дочернему)
        if ($parent_term) {
            wp_set_object_terms($product->get_id(), array($parent_term->term_id), 'product_cat', true);
        }
    }
}

Объяснение:

• Разбиваем строку категории по разделителю " > " — это стандарт, который используют многие импортеры для обозначения иерархии.
• Проходим по каждому уровню, проверяем наличие термина категории, создаем, если отсутствует, с правильным родителем.
• В конце привязываем товар к самой глубокой категории.

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

Чтобы убедиться, что решение работает:

1. Импортируйте файл с товарами, где категории указаны с иерархией через " > ".
2. Перейдите в «Товары» -> «Категории» и проверьте, что во всех дочерних категориях есть правильные родители.
3. Откройте карточку товара — в мета-боксе категорий должны быть установлены и дочерние, и родительские категории.
4. Проверьте на фронтенде, что фильтры и навигация по категориям работают как ожидается.

Частые ошибки и как их исправить

• Ошибка: Категории не создаются, WP возвращает ошибку term_exists.
  Причина: Некорректный slug или конфликт имен.
  Решение: Используйте sanitize_title() для slug, проверяйте существование термина перед созданием.
• Ошибка: Товар не привязывается к категориям.
  Причина: В массиве категорий отсутствует нужный формат или данные.
  Решение: Убедитесь, что импортируемые данные содержат поле categories с правильными значениями.
• Ошибка: Родительские категории создаются, но не отображаются в списке.
  Причина: Кеширование или неверный параметр при создании терминов.
  Решение: Очистите кеш сайта и убедитесь, что при вызове wp_insert_term() указан правильный параметр parent.

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

• При большом объеме импорта используйте транзакции или пакетную обработку, чтобы не перегружать базу.
• Кешируйте результаты поиска терминов через get_term_by(), чтобы не делать повторных запросов.
• Проверяйте корректность данных на входе — можно добавить валидацию формата категорий перед импортом.

Сравнение способов установки иерархии категорий при импорте