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

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

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

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

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

1. Создаем функцию для удаления товара и связанных с ним данных

Основная задача — удалить товар (post_type = 'product'), его вариации (post_type = 'product_variation'), метаданные (_product_attributes, _price и другие), связи (cross-sells, up-sells), а также отзывы и кэш.

function wc_delete_product_completely( $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 ); // принудительное удаление
        }
    }

    // Удаляем отзывы, связанные с товаром
    $comments = get_comments( array('post_id' => $product_id) );
    foreach ( $comments as $comment ) {
        wp_delete_comment( $comment->comment_ID, true );
    }

    // Удаляем связи upsells и cross-sells
    delete_post_meta( $product_id, '_upsell_ids' );
    delete_post_meta( $product_id, '_crosssell_ids' );

    // Удаляем метаданные, кастомные поля
    $meta_keys = array(
        '_price',
        '_regular_price',
        '_sale_price',
        '_stock',
        '_stock_status',
        '_product_attributes',
        '_visibility',
        '_downloadable',
        '_virtual',
        '_sku',
        '_manage_stock',
        '_backorders',
        '_sold_individually'
    );
    foreach ( $meta_keys as $meta_key ) {
        delete_post_meta( $product_id, $meta_key );
    }

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

    return true;
}

2. Использование функции

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

$result = wc_delete_product_completely( 123 );
if ( $result ) {
    echo 'Товар и связанные данные успешно удалены';
} else {
    echo 'Ошибка удаления товара';
}

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

• Убедитесь, что товар и вариации отсутствуют в разделе «Товары» админки.
• Проверьте таблицу wp_postmeta на предмет остатков метаданных для удаленного ID товара.
• Проверьте таблицу wp_comments на отсутствие отзывов к этому товару.
• Проверьте, что на сайте не отображаются ссылки на удаленный товар.

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

• Удаление без принудительного удаления: по умолчанию wp_delete_post отправляет пост в корзину. Используйте второй параметр true для безвозвратного удаления.
• Игнорирование вариаций: переменные товары имеют дочерние посты типа product_variation, которые нужно удалять отдельно.
• Оставшиеся метаданные: необходимо явно указывать ключи метаданных для удаления, иначе они останутся в базе.
• Ошибка в ID товара: перед вызовом функции убедитесь, что ID существует и соответствует товару.

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

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

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