WooCommerce: как правильно удалять товары с очисткой связанных данных

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

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

Часто пользователи замечают, что после удаления товаров в отчетах или списках заказов появляются «призраки» удалённых товаров. Это признак того, что связанные данные не очищены.

Что именно нужно удалить вместе с товаром

• Мета-данные товара из wp_postmeta
• Записи заказов, связанные с товаром (в таблицах wp_woocommerce_order_items и wp_woocommerce_order_itemmeta)
• Товарные вариации (если это вариативный товар)
• Товары в корзинах пользователей (сессионные данные)
• Связанные кэши, если используются плагины кеширования

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

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

Пример функции удаления товара с очисткой связей

function wc_delete_product_complete( $product_id ) {
    if ( ! $product_id ) {
        return false;
    }

    // Получаем объект товара
    $product = wc_get_product( $product_id );
    if ( ! $product ) {
        return false;
    }

    // Удаляем вариации, если товар вариативный
    if ( $product->is_type( 'variable' ) ) {
        $variations = $product->get_children();
        foreach ( $variations as $variation_id ) {
            wp_delete_post( $variation_id, true );
        }
    }

    // Удаляем заказы с этим товаром (аккуратно, лучше не удалять заказы полностью, а только позиции)
    global $wpdb;
    $order_items = $wpdb->get_col( $wpdb->prepare(
        "SELECT order_item_id FROM {$wpdb->prefix}woocommerce_order_items WHERE order_item_type = 'line_item'"
    ));
    foreach ( $order_items as $item_id ) {
        $product_id_in_item = $wpdb->get_var( $wpdb->prepare(
            "SELECT meta_value FROM {$wpdb->prefix}woocommerce_order_itemmeta WHERE order_item_id = %d AND meta_key = '_product_id'",
            $item_id
        ));
        if ( intval( $product_id_in_item ) === intval( $product_id ) ) {
            // Удаляем мета и сам элемент заказа
            $wpdb->delete( "{$wpdb->prefix}woocommerce_order_itemmeta", [ 'order_item_id' => $item_id ] );
            $wpdb->delete( "{$wpdb->prefix}woocommerce_order_items", [ 'order_item_id' => $item_id ] );
        }
    }

    // Удаляем товар
    wp_delete_post( $product_id, true );

    return true;
}

Вызывайте эту функцию с нужным ID товара, например:

wc_delete_product_complete(123);

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

• Проверьте в админке WooCommerce, что товар и его вариации отсутствуют.
• В базе данных убедитесь, что записи в wp_postmeta с post_id = ID удалённого товара отсутствуют.
• Проверьте таблицы wp_woocommerce_order_items и wp_woocommerce_order_itemmeta на предмет остатков позиций с удалённым товаром.
• Тестируйте отчёты WooCommerce — удалённые товары не должны появляться.

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

• Ошибка: Оставшиеся вариации товара после удаления.
  Причина: Удаление вариаций не выполнено.
  Решение: Перед удалением основного товара удаляйте все вариации через wp_delete_post.
• Ошибка: Остатки заказов с удалённым товаром вызывают ошибки в отчетах.
  Причина: Связанные позиции заказа не удалены.
  Решение: Используйте SQL запросы для удаления позиций заказа с указанным _product_id.
• Ошибка: Удалённый товар всё ещё отображается в кэше.
  Причина: Кэш плагина или браузера.
  Решение: Очистите кэш сайта и браузера, проверьте работу с отключённым кэшем.

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

• Всегда делайте резервную копию базы перед массовым удалением товаров.
• Не удаляйте полностью заказы пользователей — удаляйте только позиции товаров, чтобы не нарушать историю заказов.
• Для массового удаления товаров и связанных данных используйте WP-CLI, это безопаснее и быстрее, чем через UI.
• Если планируете частые операции удаления, рассмотрите использование плагина Clearfy Pro — он помогает автоматически чистить базу и оптимизировать данные WooCommerce.

Сравнение способов удаления товаров с очисткой связанных данных