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

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

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

Задача: удалить товар по его ID или другому параметру из базы данных, очистить данные мета, отзывы и связанные записи, при этом не оставлять мусор.

Как работает удаление товара в WooCommerce

Стандартная функция wp_delete_post($product_id, true) удаляет пост и все его метаданные, но не всегда очищает связанные данные, например, отзывы (комментарии) или пользовательские метаполя, созданные плагинами.

Чтобы полностью очистить товар, нужно:

• Удалить сам товар как запись типа product
• Удалить все метаданные записи
• Удалить все комментарии (отзывы) к товару
• Удалить все связи с атрибутами и терминами
• При необходимости — очистить данные заказов, если товар был в них

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

Ниже пример рабочего кода, который удаляет товар и все связанные с ним данные. Рекомендуется создавать кастомную команду в functions.php или в плагине для админской работы.

function wpmagazin_delete_product_and_data($product_id) {
    if (!current_user_can('delete_products')) {
        return 'Нет прав на удаление товаров';
    }

    $product = get_post($product_id);
    if (!$product || $product->post_type !== 'product') {
        return 'Товар не найден';
    }

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

    // Удаляем все термины категории и атрибуты товара
    wp_delete_object_term_relationships($product_id, get_object_taxonomies('product'));

    // Удаляем метаданные товара
    global $wpdb;
    $wpdb->delete($wpdb->postmeta, array('post_id' => $product_id));

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

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

Для вызова функции можно использовать AJAX-обработчик, WP-CLI либо запускать вручную через админку.

Пример вызова и проверки результата

add_action('admin_post_wpmagazin_delete_product', function() {
    if (!isset($_GET['product_id'])) {
        wp_die('Не указан ID товара');
    }
    $result = wpmagazin_delete_product_and_data(intval($_GET['product_id']));
    wp_die($result);
});

Перейдите по адресу https://ваш-сайт/wp-admin/admin-post.php?action=wpmagazin_delete_product&product_id=123, где 123 — ID удаляемого товара.

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

• В админке WooCommerce убедитесь, что товар отсутствует в списке продуктов.
• Проверьте в базе данных таблицы wp_posts и wp_postmeta, что записи с ID товара отсутствуют.
• Проверьте таблицу wp_comments на наличие отзывов с comment_post_ID = ID товара.
• Проверьте, что связи с таксономиями (категории, атрибуты) отсутствуют — через wp_term_relationships.

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

Ошибка 1: Товар не удаляется, но исчезают метаданные

Причина: функция wp_delete_post вызывается с параметром $force_delete = false, тогда товар помещается в корзину, а не удаляется полностью. Решение — указывать true вторым параметром.

Ошибка 2: Остаются отзывы после удаления товара

Причина: стандартное удаление не удаляет комментарии автоматически. Нужно явно удалить комментарии через wp_delete_comment.

Ошибка 3: Права доступа не проверяются

Без проверки прав любой пользователь может вызвать удаление. Добавьте проверку current_user_can('delete_products') или другую подходящую.

Ошибка 4: Остаточные связи с таксономиями

Используйте wp_delete_object_term_relationships, чтобы удалить все связи товара с категориями и атрибутами.

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

• Всегда проверяйте права пользователя перед удалением.
• Удаление через AJAX или WP-CLI предпочтительнее, чем вызов через GET-запросы.
• Для массового удаления используйте пакетную обработку, чтобы избежать таймаутов.
• Резервное копирование базы перед массовым удалением — обязательное правило.
• Если товар связан с заказами, учитывайте бизнес-логику — возможно, стоит только скрыть товар, а не удалять.

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