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

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

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

Если нужно полностью очистить товар с сохранением производительности и целостности базы, стандартного удаления недостаточно. Необходимо программно удалить все связанные записи.

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

1. Получение ID товара

Для примера предположим, что у вас есть ID товара. Если нет, используйте WP_Query или get_posts для поиска:

$args = [
    'post_type' => 'product',
    'posts_per_page' => 1,
    'title' => 'Название товара'
];
$query = new WP_Query($args);
if ($query->have_posts()) {
    $product_id = $query->posts[0]->ID;
}

2. Удаление вариаций (если товар вариативный)

Вариации — это дочерние записи типа product_variation, их нужно удалить отдельно:

$variations = wc_get_products([
    'parent' => $product_id,
    'type' => 'variation',
    'limit' => -1
]);
foreach ($variations as $variation) {
    wp_delete_post($variation->get_id(), true);
}

3. Удаление мета-данных товара

Удаляем все мета-поля:

global $wpdb;
$wpdb->delete($wpdb->postmeta, ['post_id' => $product_id]);

4. Удаление самого товара

wp_delete_post($product_id, true);

5. Очистка связей в заказах

Заказы содержат записи с ID товара в мета-данных. Их можно удалить или обновить, чтобы избежать ошибок:

$order_items = $wpdb->get_results(
    $wpdb->prepare(
        "SELECT order_item_id FROM {$wpdb->prefix}woocommerce_order_items WHERE order_item_name LIKE %s",
        '%'
    )
);
// Рекомендуется не удалять заказы, а только удалить позиции с этим товаром. Это сложнее, обычно делают через плагины или вручную.

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

• В админке WooCommerce товар должен исчезнуть.
• В базе данных таблицы wp_posts и wp_postmeta по ID товара и вариаций не должны содержать записей.
• Запрос SELECT * FROM wp_posts WHERE ID = {product_id} должен быть пустым.
• Нет ошибок в заказах, связанных с удалённым товаром.

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

• Товар не удаляется полностью — забыли удалить вариации или мета-поля.
• Ошибка при удалении мета-данных — отсутствует доступ к глобальному $wpdb или неверный запрос.
• Остатки данных в заказах — сложная ситуация, лучше использовать специализированные плагины для корректного обновления заказов.
• Удаление не в режиме "force" — используйте wp_delete_post($id, true) для полного удаления без перехода в корзину.

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

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

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