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

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

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

Проблему можно диагностировать по следующим признакам:

• В списке вариантов товара отображаются варианты с "0" на складе;
• Эти варианты не продаются, но видны в админке и иногда на сайте;
• Ручное удаление вариантов затруднено при большом количестве товаров;
• Отмечается замедление работы админки при загрузке товаров с большим числом зависших вариантов.

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

Выполните SQL-запрос к базе данных, чтобы найти все вариации с нулевым запасом:

SELECT p.ID, p.post_title, pm.meta_value AS stock_quantity
FROM wp_posts p
INNER JOIN wp_postmeta pm ON p.ID = pm.post_id AND pm.meta_key = '_stock'
WHERE p.post_type = 'product_variation' AND pm.meta_value = '0';

Если результат содержит записи, значит есть варианты с нулевым запасом на складе.

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

Для автоматизации удаления таких вариантов создадим функцию, которая будет запускаться по Cron и удалять все вариации с запасом 0. Такой подход избавит от рутинного ручного удаления и позволит держать базу в порядке.

Шаг 1. Регистрация Cron-задачи

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

add_action('wp', function() {
    if (!wp_next_scheduled('remove_zero_stock_variations_daily')) {
        wp_schedule_event(time(), 'daily', 'remove_zero_stock_variations_daily');
    }
});

Шаг 2. Основная функция удаления

Реализуем функцию, которая найдет и удалит все вариации с нулевым запасом:

add_action('remove_zero_stock_variations_daily', function() {
    $args = [
        'post_type' => 'product_variation',
        'numberposts' => -1,
        'meta_key' => '_stock',
        'meta_value' => '0',
        'meta_compare' => '=',
        'fields' => 'ids',
    ];

    $variations = get_posts($args);

    foreach ($variations as $variation_id) {
        wp_delete_post($variation_id, true); // true — удаление без возможности восстановления
    }
});

Шаг 3. Запуск удаления вручную для проверки

Для тестирования добавьте временно вызов функции напрямую (например, в админке или через WP-CLI):

do_action('remove_zero_stock_variations_daily');

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

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

Чтобы проверить, что удаление работает:

• Запустите функцию вручную (см. шаг 3) и проверьте, что варианты с нулевым запасом исчезли из админки;
• Через phpMyAdmin или аналогичный инструмент повторите SQL-запрос из раздела диагностики — он должен вернуть пустой результат;
• Наблюдайте за сайтом в течение суток — Cron-задание сработает автоматически и поддержит базу в актуальном состоянии.

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

• Отсутствие Cron-задачи: если wp_schedule_event не срабатывает, проверьте, вызывается ли хук 'wp' и не блокирует ли сайт выполнение Cron (например, отключён WP-Cron). Временно включите WP-Cron или настройте системный Cron-задание.
• Удаление не происходит: проверьте права пользователя на удаление постов, а также корректность meta_key и meta_value в запросе.
• Удаляются не те варианты: убедитесь, что meta_value сравнивается со строкой '0', а не с числом 0 — WooCommerce хранит значение как строку.
• Потеря данных: если хотите иметь возможность восстановления, замените wp_delete_post($variation_id, true); на wp_delete_post($variation_id, false); для отправки в корзину.

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

• Добавьте логирование удалённых вариантов, чтобы отслеживать изменения, например, в файл или в системный журнал.
• Для сайтов с огромным количеством вариаций разбивайте удаление на пакеты по 50-100 штук за один запуск, чтобы избежать таймаутов.
• Ограничьте запуск скрипта Cron только для администратора или с помощью WP-CLI, чтобы предотвратить случайное удаление.
• Регулярно делайте резервные копии базы данных перед массовыми удалениями.

Сравнение вариантов удаления зависших вариантов