Как автоматически удалять отсутствующие вариации товаров в WooCommerce

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

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

Как определить отсутствующие вариации в WooCommerce

В WooCommerce вариации — это записи типа product_variation. Наличие на складе отслеживается через мета-поле _stock_status, которое может принимать значения instock, outofstock или onbackorder.

Для диагностики отсутствующих вариаций можно выполнить SQL-запрос или использовать WP_Query с мета-запросом:

$args = [
    'post_type' => 'product_variation',
    'meta_query' => [
        [
            'key' => '_stock_status',
            'value' => 'outofstock',
        ]
    ],
    'posts_per_page' => -1
];
$query = new WP_Query($args);
foreach ($query->posts as $variation) {
    echo 'Variation ID: ' . $variation->ID . "\n";
}

Если в выводе есть вариации с _stock_status = outofstock, это именно те, которые можно удалить автоматически.

Пошаговое решение: автоматическое удаление отсутствующих вариаций

Для удаления вариаций с отсутствующим товаром можно создать функцию, которую запускать вручную или через WP-Cron для автоматизации. Ниже пример кода для удаления всех вариаций со статусом outofstock:

function delete_outofstock_variations() {
    $args = [
        'post_type'      => 'product_variation',
        'meta_query'     => [
            [
                'key'     => '_stock_status',
                'value'   => 'outofstock',
            ],
        ],
        'posts_per_page' => -1,
        'fields'         => 'ids',
    ];

    $variations = get_posts($args);

    if (empty($variations)) {
        return 'No out of stock variations found.';
    }

    foreach ($variations as $variation_id) {
        wp_delete_post($variation_id, true); // принудительное удаление без перемещения в корзину
    }

    return count($variations) . ' out of stock variations deleted.';
}

// Запуск функции вручную
add_action('admin_post_delete_outofstock_variations', function() {
    if (!current_user_can('manage_woocommerce')) {
        wp_die('Access denied');
    }
    $result = delete_outofstock_variations();
    wp_redirect(admin_url('edit.php?post_type=product&message=' . urlencode($result)));
    exit;
});

Для автоматизации можно добавить планировщик задач WP-Cron:

if (!wp_next_scheduled('delete_outofstock_variations_daily')) {
    wp_schedule_event(time(), 'daily', 'delete_outofstock_variations_daily');
}

add_action('delete_outofstock_variations_daily', 'delete_outofstock_variations');

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

• Перейдите в админку WooCommerce — "Товары" — проверьте вариации, которые раньше были "outofstock" — они должны отсутствовать.
• Запустите функцию вручную и убедитесь, что в ответе возвращается количество удалённых вариаций.
• Проверьте, что на фронтенде отсутствуют товары с вариациями, которых нет в наличии.

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

• Ошибка: Вариации не удаляются, функция возвращает 0.
  Причина: Возможно, статус в метаданных хранится не как 'outofstock', а в другом формате или поле не обновлено.
  Решение: Проверьте метаданные через базу данных или плагин Debug Toolkit.
• Ошибка: WP-Cron не срабатывает.
  Причина: WP-Cron работает только при посещении сайта.
  Решение: Настройте системный cron на сервере для вызова wp-cron.php, либо запускайте функцию вручную.
• Ошибка: Удаление происходит, но вариации всё равно отображаются в каталоге.
  Причина: Кэширование страницы.
  Решение: Очистите кэш сайта и браузера, обновите индексы WooCommerce.

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

• Перед массовым удалением создавайте резервные копии базы данных.
• Удаляйте вариации через wp_delete_post() с параметром $force_delete=true, чтобы избежать накопления мусора в базе.
• Если у вас большой каталог, разбивайте удаление на партии по 100-200 штук, чтобы избежать таймаутов.
• Планируйте автоматическую очистку на время с минимальной нагрузкой на сервер.

Сравнение вариантов реализации удаления отсутствующих вариаций