Как удалить вариант товара в WooCommerce после первой продажи

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

В WooCommerce вариант товара — это отдельный товар с уникальным ID, который после первой продажи связан с заказами. Стандартными средствами удалить такой вариант невозможно без риска поломать историю заказов и отчёты. Часто при попытке удаления варианта, который уже был в заказах, вы получите ошибку или потеряете данные о продажах.

Задача: корректно удалить вариант товара, при этом не нарушив целостность базы заказов и сохранив историю.

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

1. Проверяем, был ли вариант продан

function variant_has_sales($variation_id) {
    global $wpdb;
    $query = $wpdb->prepare(
        "SELECT COUNT(*) FROM {$wpdb->prefix}woocommerce_order_items AS items
         JOIN {$wpdb->prefix}woocommerce_order_itemmeta AS itemmeta ON items.order_item_id = itemmeta.order_item_id
         JOIN {$wpdb->prefix}posts AS posts ON posts.ID = items.order_id
         WHERE posts.post_type = 'shop_order'
         AND posts.post_status IN ('wc-completed', 'wc-processing', 'wc-on-hold')
         AND itemmeta.meta_key = '_variation_id'
         AND itemmeta.meta_value = %d",
         $variation_id
    );
    return $wpdb->get_var($query) > 0;
}

Этот код проверяет, встречается ли ID варианта в заказах со статусом, означающим фактическую продажу.

2. Создаем резервную копию базы данных

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

3. Удаляем вариант из каталога, но сохраняем данные о продажах

Скрываем вариант из каталога и фронтенда, чтобы он не отображался покупателям, вместо прямого удаления:

function hide_sold_variation($query) {
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    if ( is_product_category() || is_shop() ) {
        $meta_query = $query->get('meta_query');
        if ( ! $meta_query ) {
            $meta_query = [];
        }
        $meta_query[] = [
            'key'     => '_stock_status',
            'value'   => 'outofstock',
            'compare' => '!='
        ];
        $query->set('meta_query', $meta_query);
    }
}
add_action('pre_get_posts', 'hide_sold_variation');

Также можно вручную изменить статус варианта на «черновик» или «приватный» через админку, чтобы он не показывался.

4. Если необходимо именно удалить, очищаем связи с заказами (не рекомендуется)

Удаление варианта, который уже был в заказах, требует удаления связей с заказами — это рискованно и может нарушить данные о продажах. Если уверены в необходимости, можно:

• Удалить все записи из таблиц woocommerce_order_itemmeta с _variation_id равным ID варианта.
• Удалить сам вариант через wp_delete_post($variation_id, true);

Но это уничтожит данные о продажах и не рекомендуется для живых магазинов.

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

• В админке WooCommerce в списке товаров отсутствует искомый вариант.
• История заказов с этим вариантом сохраняется и доступна для просмотра.
• При попытке найти вариант через API или SQL-запросы он не отображается в каталоге.

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

• Удаление варианта без проверки продаж: приводит к потере данных о заказах и ошибкам в отчетах.
• Прямое удаление через админку: WooCommerce не позволит удалить вариант с продажами, или удалит его, но с повреждением данных.
• Отсутствие резервной копии: потеря данных при ошибках невозможна для восстановления.
• Неочищенные связи в базе: приводит к ошибкам при генерации отчетов и отображении заказов.

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

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

Сравнение подходов удаления варианта товара

Метод	Плюсы	Минусы	Рекомендации
Скрыть вариант (изменить статус или фильтровать запросы)	Безопасно, сохраняет историю заказов	Вариант остается в БД	Рекомендуется для живых магазинов
Полное удаление варианта после очистки связей	Удаляет данные полностью	Потеря истории заказов, риск нарушить целостность данных	Только для тестовых или архивных сайтов
Удаление через админку без проверки	Просто	WooCommerce блокирует или повреждает данные	Не рекомендуется