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

Диагностика проблемы: почему нужно удалить вариации товаров и SKU

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

Типичные симптомы:

• Невозможность изменить SKU через админку из-за конфликтов.
• Ошибки при импорте или обновлении товаров.
• Отображение старых вариаций, которые уже не нужны.

Как проверить наличие вариаций с проблемными SKU

Для начала убедимся, что вариации с нежелательными SKU есть в базе. Воспользуемся WP-CLI для быстрого поиска:

wp post meta list <product_id> --keys | grep _sku

Замените <product_id> на ID родительского вариативного товара. Если вы не используете WP-CLI, можно добавить временный код для вывода SKU всех вариаций:

function debug_variation_skus($product_id) {
    $product = wc_get_product($product_id);
    if (!$product || $product->get_type() !== 'variable') return;
    foreach ($product->get_children() as $variation_id) {
        $variation = wc_get_product($variation_id);
        echo 'Variation ID: ' . $variation_id . ' SKU: ' . $variation->get_sku() . "<br>";
    }
}
debug_variation_skus(123); // замените 123 на ID товара

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

1. Подготовка к удалению

Перед удалением создайте резервную копию базы данных. Удаление вариаций нельзя отменить.

2. Программный скрипт для удаления вариаций и очистки SKU

Ниже пример функции, которая удаляет вариации указанного вариативного товара и очищает их SKU:

function remove_product_variations_and_sku($product_id) {
    $product = wc_get_product($product_id);
    if (!$product || $product->get_type() !== 'variable') {
        return new WP_Error('invalid_product', 'Товар не является вариативным');
    }

    $variation_ids = $product->get_children();

    foreach ($variation_ids as $variation_id) {
        // Очистка SKU
        update_post_meta($variation_id, '_sku', '');
        // Удаление вариации
        wp_delete_post($variation_id, true);
    }

    // Обновим дату модификации родительского товара
    wp_update_post(['ID' => $product_id]);

    return true;
}

3. Запуск функции

Вызовите функцию в файле темы functions.php или через плагин сниппетов, заменив $product_id на нужный:

remove_product_variations_and_sku(123);

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

Чтобы убедиться, что вариации удалены и SKU очищены, используйте:

• Панель администратора WooCommerce — вариации отсутствуют.
• WP-CLI для проверки вариаций: wp post list --post_parent=123 --post_type=product_variation — должен вернуть пустой список.
• Вывод функции debug_variation_skus (см. выше) — должна быть пустая выдача.

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

• Вариации не удаляются: Проверьте, включен ли параметр force_delete в wp_delete_post. Убедитесь, что у пользователя достаточно прав.
• SKU не очищаются: Убедитесь, что используется правильный мета-ключ _sku и функция update_post_meta вызывается корректно.
• Удаление влияет на заказы: Не удаляйте вариации, если они связаны с активными заказами — это может привести к ошибкам. Проверьте связи перед удалением.

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

• Перед массовым удалением сделайте полную резервную копию, включая базу данных и файлы.
• Запускайте скрипты удаления на тестовом окружении или локально.
• Оптимизируйте базу данных после удаления: OPTIMIZE TABLE wp_postmeta; и OPTIMIZE TABLE wp_posts; для снижения фрагментации.
• Если нужно часто управлять вариациями, рассмотрите использование плагинов с функциями массового управления, чтобы избежать ошибок.

Сравнение методов удаления вариаций