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

Диагностика проблемы с вариациями и SKU в WooCommerce

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

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

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

• В админке WooCommerce перейти в раздел «Товары» и отфильтровать по типу «Вариация» – если вариаций слишком много, ручное удаление не вариант.
• В базе данных проверить таблицу wp_postmeta на наличие мета-ключей _sku для вариаций, а также мета-ключей _variation_id или аналогичных.
• При работе с SKU проверить, что они уникальны и не остаются у удалённых вариаций.

Пошаговое решение: программное удаление вариаций и связанных SKU

Используем WP_Query для выборки всех вариаций конкретного товара и удалим их программно через функцию wp_delete_post(). Этот метод корректно очистит все связанные данные.

function delete_product_variations_by_parent_id($parent_product_id) {
    $args = [
        'post_parent' => $parent_product_id,
        'post_type'   => 'product_variation',
        'numberposts' => -1,
        'post_status' => 'any',
    ];

    $variations = get_posts($args);

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

// Пример вызова для товара с ID 123
// delete_product_variations_by_parent_id(123);

Если нужно удалить все вариации по всему каталогу, можно перебрать все родительские товары с вариациями:

function delete_all_product_variations() {
    $args = [
        'post_type'      => 'product',
        'posts_per_page' => -1,
        'post_status'    => 'publish',
    ];

    $products = get_posts($args);

    foreach ($products as $product) {
        delete_product_variations_by_parent_id($product->ID);
    }
}

// delete_all_product_variations();

Удаление SKU, связанных с вариациями

SKU хранятся в мета-данных вариаций под ключом _sku. При удалении вариаций через wp_delete_post() эти метаданные удаляются автоматически. Если же данные остались, можно очистить их так:

global $wpdb;
$wpdb->query("DELETE pm FROM {$wpdb->postmeta} pm
JOIN {$wpdb->posts} p ON pm.post_id = p.ID
WHERE p.post_type = 'product_variation' AND pm.meta_key = '_sku'");

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

• В админке WooCommerce проверить, что вариации выбранных товаров больше не отображаются.
• В базе данных убедиться, что в таблице wp_posts нет записей с post_type = 'product_variation' для удалённых товаров.
• Проверить в таблице wp_postmeta, что связанные с вариациями _sku и прочие метаданные удалены.
• Протестировать оформление заказа с товаром без вариаций, чтобы исключить ошибки.

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

1. Вариации не удаляются полностью

Причина: используется wp_trash_post() вместо wp_delete_post($id, true). В этом случае записи попадают в корзину и остаются в базе.

Решение: всегда вызывать wp_delete_post($id, true) для полного удаления.

2. Остаточные метаданные в базе

Причина: прямое удаление записей из таблицы wp_posts без удаления метаданных.

Решение: использовать встроенные функции WordPress для удаления, либо вручную чистить wp_postmeta, как показано выше.

3. Удаление вариаций не влияет на родительский товар

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

update_post_meta($parent_product_id, '_product_attributes', []);
// Можно добавить дополнительную логику для обновления статусов

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

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

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