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

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

Если при создании или импорте товаров в WooCommerce у товаров неправильно присваиваются родительские категории, это приводит к ошибкам в фильтрации, навигации и отображении иерархии категорий. Часто проблема проявляется так:

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

Для диагностики проверьте следующие моменты:

• Как настроена иерархия категорий в Товары > Категории.
• Какой массив категорий передается при создании товара (через API или импорт).
• Отсутствуют ли кастомные функции, переопределяющие категории товара.
• Работают ли AJAX-фильтры и REST API запросы для категорий.

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

Самый распространенный кейс — импорт товаров с указанием только дочерних категорий, при этом родительские не устанавливаются автоматически. Чтобы исправить это, добавим хук для установки родительской категории при сохранении товара.

Добавьте следующий код в functions.php вашей темы или в кастомный плагин:

add_action('save_post_product', 'set_parent_categories_for_product', 20, 3);
function set_parent_categories_for_product($post_id, $post, $update) {
    if (wp_is_post_revision($post_id)) {
        return;
    }
    $terms = wp_get_post_terms($post_id, 'product_cat');
    $parent_ids = [];
    foreach ($terms as $term) {
        if ($term->parent) {
            $parent_ids[] = $term->parent;
        }
    }
    if (!empty($parent_ids)) {
        // Получаем текущие категории, добавляем родительские
        $all_terms = array_unique(array_merge(wp_list_pluck($terms, 'term_id'), $parent_ids));
        // Обновляем категории товара
        wp_set_post_terms($post_id, $all_terms, 'product_cat');
    }
}

Этот код автоматически добавляет родительские категории для каждого товара при сохранении, если они не были установлены.

Как проверить, что решение сработало

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

Исправление ошибки при массовом импорте товаров через WP All Import

Если используете плагины для импорта, например, WP All Import, убедитесь, что в настройках импорта вы указываете не только дочерние категории, но и их родителей. Альтернативно, можно добавить PHP-сниппет в функции импорта:

function add_parent_categories_to_imported_product($post_id) {
    $terms = wp_get_post_terms($post_id, 'product_cat');
    $parent_ids = [];
    foreach ($terms as $term) {
        if ($term->parent) {
            $parent_ids[] = $term->parent;
        }
    }
    if (!empty($parent_ids)) {
        $all_terms = array_unique(array_merge(wp_list_pluck($terms, 'term_id'), $parent_ids));
        wp_set_post_terms($post_id, $all_terms, 'product_cat');
    }
}
add_action('pmxi_saved_post', 'add_parent_categories_to_imported_product', 10, 1);

Этот код сработает после импорта каждого товара и дополнит категории родительскими.

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

• Ошибка: Родительская категория не добавляется, потому что категория не иерархична.
  Решение: Проверьте, что таксономия product_cat поддерживает иерархию (по умолчанию поддерживает).
• Ошибка: Конфликт с другими плагинами, которые изменяют категории.
  Решение: Отключите плагины по очереди, чтобы выявить конфликт. Перенесите код в кастомный плагин с приоритетом выше 10.
• Ошибка: Фильтры AJAX не обновляются после изменения категорий.
  Решение: Очистите кеш и проверьте настройки фильтра. Возможно, нужно обновить шаблоны фильтров.

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

• Создайте новый товар и выберите только дочернюю категорию. Сохраните и убедитесь, что родительская категория также присвоена.
• Импортируйте несколько товаров с дочерними категориями и проверьте, что родительские категории появились.
• Используйте инструменты разработчика браузера, чтобы проверить REST API запросы на предмет правильной иерархии категорий.
• Проверьте работу AJAX фильтров в каталоге товаров.

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

• Не перегружайте хук save_post_product тяжелыми операциями — проверяйте условия, чтобы код срабатывал только при необходимости.
• Используйте wp_is_post_revision() и wp_is_post_autosave(), чтобы избежать повторного выполнения кода на ревизиях и автосохранениях.
• При импорте большого количества товаров используйте пакетную обработку или WP CLI для повышения производительности.
• Регулярно обновляйте WooCommerce и плагины, чтобы избежать несовместимости с таксономиями и хуками.

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