WooCommerce: решение сложностей с иерархией товаров и автоматическим присвоением категорий

Диагностика проблем с иерархией категорий товаров в WooCommerce

В WooCommerce часто возникают проблемы с правильным отображением иерархии категорий и присвоением родительских категорий товарам. Признаки ошибок:

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

Для диагностики используйте стандартные инструменты WordPress и WooCommerce, например, просмотр таксономии product_cat в админке, а также снифферы запросов, например, плагин Query Monitor.

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

1. Проверка текущих категорий товара

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

2. Добавление кода для автоприсвоения

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

add_action('save_post_product', 'assign_parent_category_automatically', 20, 3);
function assign_parent_category_automatically($post_id, $post, $update) {
    // Проверяем, что это не автосохранение
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    
    // Получаем все категории товара
    $terms = wp_get_post_terms($post_id, 'product_cat');
    if (empty($terms) || is_wp_error($terms)) return;

    $parent_categories = [];
    foreach ($terms as $term) {
        if ($term->parent) {
            $parent = get_term($term->parent, 'product_cat');
            if ($parent && !is_wp_error($parent)) {
                $parent_categories[] = intval($parent->term_id);
            }
        }
    }

    if (!empty($parent_categories)) {
        // Добавляем родительские категории к товару
        wp_set_post_terms($post_id, array_unique(array_merge(wp_list_pluck($terms, 'term_id'), $parent_categories)), 'product_cat');
    }
}

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

3. Обработка массового присвоения для существующих товаров

Чтобы применить логику к уже существующим товарам, используйте WP-CLI или скрипт:

$args = [
    'post_type' => 'product',
    'posts_per_page' => -1,
    'post_status' => 'publish',
];
$products = get_posts($args);
foreach ($products as $product) {
    assign_parent_category_automatically($product->ID, $product, true);
}

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

• Создайте новый товар и установите подкатегорию. После сохранения проверьте, что родительская категория автоматически добавлена в мета-данные.
• Просмотрите страницу магазина с фильтром по категориям — товар должен быть виден и в подкатегории, и в родительской.
• Используйте Query Monitor для проверки SQL-запросов к таксономии, убедитесь, что вложенность категорий учитывается.

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

• Категории не добавляются автоматически: проверьте приоритет хука и наличие DOING_AUTOSAVE проверки, чтобы не блокировать сохранение.
• Дублирование категорий: используйте array_unique для исключения повторов.
• Ошибка в иерархии категорий: убедитесь, что родительские категории существуют и корректно установлены в админке WooCommerce.
• Проблемы с кэшированием: после внесения изменений очистите кеш сайта и браузера.

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

• Не добавляйте тяжелые операции в хук save_post_product без проверки, чтобы не замедлять сохранение товара.
• Для массовых операций используйте WP-CLI или отдельные скрипты, чтобы избежать таймаутов на сервере.
• Используйте nonce и права доступа для кода, если вы расширяете функционал через AJAX.
• Поддерживайте резервные копии перед массовыми изменениями категорий.

Сравнение вариантов решения автоматического присвоения категорий