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

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

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

Почему важно автоматизировать удаление пустых категорий

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

• Поддерживать чистоту каталога;
• Избегать ошибок в навигации;
• Улучшать индексацию сайта поисковиками;
• Сэкономить время администратора.

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

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

1. Добавление функции удаления пустых категорий

function wc_remove_empty_product_categories() {
    $args = array(
        'taxonomy' => 'product_cat',
        'hide_empty' => false,
    );
    $categories = get_terms($args);
    foreach ($categories as $category) {
        // Проверяем количество товаров в категории
        if ($category->count === 0) {
            // Удаляем пустую категорию
            wp_delete_term($category->term_id, 'product_cat');
        }
    }
}

2. Подключение функции к хуку импорта

Если импорт осуществляется через стандартный WooCommerce CSV импортер, можно использовать хук woocommerce_product_import_inserted_product или woocommerce_product_import_end для вызова нашей функции после завершения импорта.

add_action('woocommerce_product_import_end', 'wc_remove_empty_product_categories');

3. Альтернативный вариант: запуск вручную или по крону

Если импорт идет сторонним плагином без поддержи хука, можно добавить вызов функции в WP-Cron или запускать вручную из админки.

if (isset($_GET['remove_empty_cats'])) {
    wc_remove_empty_product_categories();
    echo 'Empty categories removed';
}

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

• После импорта товаров зайдите в WooCommerce > Категории товаров и убедитесь, что категории с нулевым количеством товаров отсутствуют.
• Проверьте в админке, нет ли ошибок выполнения функции.
• Для теста создайте категорию без товаров и запустите функцию вручную через GET-параметр или импорт, чтобы проверить удаление.

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

• Ошибка: Пустые категории не удаляются.
  Причина: Функция вызывается до завершения импорта, категории еще не обновлены.
  Решение: Используйте хук woocommerce_product_import_end для запуска после полного импорта.
• Ошибка: Удаляются нужные категории.
  Причина: Категория считается пустой, но товары в ней существуют в статусе черновика или на рассмотрении.
  Решение: Проверяйте только опубликованные товары в категории, доработайте функцию, фильтруя по статусу.
• Ошибка: Функция вызывает замедление сайта при большом количестве категорий.
  Решение: Оптимизируйте вызов, запускайте функцию по расписанию или в фоне, минимизируйте повторные запросы.

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

• Перед массовым удалением категорий сделайте резервную копию базы данных.
• Ограничьте запуск функции только для администраторов или по cron-задаче.
• Для больших магазинов с тысячами категорий используйте WP-CLI скрипт для пакетной обработки.
• Добавьте логирование действий удаления для аудита и отката.

Таблица сравнения вариантов реализации