Как программно удалить все вариации товара в WooCommerce

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

В WooCommerce вариативные товары могут иметь десятки и сотни вариаций. Иногда требуется массово удалить все вариации конкретного товара, например, при изменении ассортимента или для очистки базы от устаревших данных. Делать это вручную в админке неудобно и долго. Программное удаление позволяет автоматизировать процесс и избежать ошибок.

Как определить ID товара и проверить наличие вариаций

Сначала нужно получить ID родительского вариативного товара и проверить, что у него есть вариации. Для этого можно использовать следующий код, который выведет ID вариаций в лог:

function wc_debug_variations_ids($product_id) {
    $product = wc_get_product($product_id);
    if (!$product || $product->get_type() !== 'variable') {
        error_log("Товар с ID {$product_id} не вариативный или не найден");
        return;
    }
    $variation_ids = $product->get_children();
    error_log("Вариации товара {$product_id}: " . implode(', ', $variation_ids));
}

Вызовите эту функцию с ID товара из консоли WP-CLI или из шаблона, чтобы убедиться, что вариации есть и вы работаете с нужным товаром.

Пошаговое решение: удаление всех вариаций товара через PHP

Для удаления всех вариаций используйте следующий код. Он проходит по всем дочерним товарам (вариациям) и удаляет их программно с помощью функции wp_delete_post() с параметром true для полного удаления без помещения в корзину.

function wc_delete_all_variations($product_id) {
    $product = wc_get_product($product_id);
    if (!$product || $product->get_type() !== 'variable') {
        return false; // Не вариативный товар
    }
    $variation_ids = $product->get_children();
    foreach ($variation_ids as $variation_id) {
        wp_delete_post($variation_id, true); // полное удаление
    }
    return true;
}

Пример вызова функции:

wc_delete_all_variations(123); // замените 123 на ID вашего вариативного товара

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

Чтобы удостовериться, что вариации удалены, можно повторно получить список детей товара. Они должны быть пустыми:

$product = wc_get_product(123);
$variation_ids = $product->get_children();
if (empty($variation_ids)) {
    echo 'Все вариации удалены.';
} else {
    echo 'Остались вариации: ' . implode(', ', $variation_ids);
}

Также стоит проверить в админке WooCommerce, что вариации исчезли из карточки товара.

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

• Удаление не сработало, вариации остались. Возможно, ID товара указан неверно или товар не вариативный. Проверьте тип товара через $product->get_type().
• Ошибки прав доступа при удалении. Функция wp_delete_post() требует, чтобы текущий пользователь имел права на удаление. Запускайте код в контексте администратора или через WP-CLI.
• Вариации удалились, но метаданные остались. Обычно wp_delete_post() удаляет связанные метаданные. Если остались, используйте clean_post_cache($variation_id) после удаления.
• Удаление приводит к ошибкам на фронтенде. Возможно, есть кэш плагинов или CDN. Очистите кэш после удаления.

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

• Резервное копирование базы. Перед массовым удалением вариаций обязательно сделайте бэкап БД, особенно на рабочем сайте.
• Пакетное удаление. Если вариаций очень много, удаляйте их частями по 50-100 штук, чтобы избежать таймаутов.
• Используйте WP-CLI для больших объемов. WP-CLI позволяет выполнять операции без ограничений времени и памяти PHP.
• Обновление индексов и кэша. После удаления вариаций обновите пермалинки и очистите кэш сайта и браузера.

Сравнение способов удаления вариаций

Метод	Плюсы	Минусы	Применимость
Удаление вручную через админку	Просто, не требует кода	Долго при большом количестве вариаций	Мало вариаций, редкие операции
Программное удаление (код PHP)	Автоматизация, быстро при большом объеме	Требует навыков программирования, риск ошибок	Массовое удаление, интеграция в процессы
Плагины для массового удаления	Удобный интерфейс, дополнительные функции	Могут замедлять сайт, зависит от качества плагина	Пользователи без навыков кода