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

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

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

Перед выполнением удаления проверьте, что пользователь существует и имеет заказы. Для диагностики используйте следующий код в functions.php или отдельном плагине:

function wpc_check_user_orders($user_id) {
    $orders = wc_get_orders(array(
        'customer_id' => $user_id,
        'limit' => 1
    ));
    if (!empty($orders)) {
        return true;
    } else {
        return false;
    }
}

Вызов функции wpc_check_user_orders($user_id) вернёт true, если у пользователя есть заказы, и false в противном случае.

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

1. Получение всех заказов пользователя

Для выборки всех заказов используем wc_get_orders() с параметром customer_id. Чтобы избежать проблем с памятью, лучше обрабатывать заказы пакетами.

$user_id = 123; // ID пользователя
$orders = wc_get_orders(array(
    'customer_id' => $user_id,
    'limit' => -1, // получить все
    'return' => 'ids' // только ID заказов
));

2. Удаление заказов через wp_delete_post

Заказы в WooCommerce — это кастомный тип записи shop_order. Для удаления используем wp_delete_post($order_id, true), где true означает необратимое удаление без помещения в корзину.

foreach ($orders as $order_id) {
    wp_delete_post($order_id, true);
}

3. Объединённый код для удаления всех заказов пользователя

function wpc_delete_all_user_orders($user_id) {
    $orders = wc_get_orders(array(
        'customer_id' => $user_id,
        'limit' => -1,
        'return' => 'ids'
    ));
    if (empty($orders)) {
        return 'Заказы не найдены';
    }
    foreach ($orders as $order_id) {
        wp_delete_post($order_id, true);
    }
    return 'Заказы удалены';
}

Вызовите wpc_delete_all_user_orders(123) с нужным ID пользователя.

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

• Зайдите в админку WooCommerce - > Заказы и проверьте, что заказы пользователя отсутствуют.
• Используйте SQL-запрос для проверки в базе данных, например:

SELECT ID FROM wp_posts WHERE post_type = 'shop_order' AND post_author = USER_ID;

где USER_ID — ID пользователя.

• Также можно использовать функцию wc_get_orders() для повторной выборки и убедиться, что заказов нет.

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

• Заказы не удаляются: Проверьте, что у вас достаточно прав для удаления записей. Запуск кода должен быть от администратора.
• Удаляются не все заказы: Возможно, лимит в wc_get_orders() установлен не на -1. Проверьте параметр limit.
• Удаление только отменяет заказ: Используйте wp_delete_post($order_id, true) для полного удаления, иначе заказ просто переместится в корзину.
• Ошибка памяти при большом количестве заказов: Делайте удаление пакетами, например по 100 заказов за раз.

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

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

wp post delete $(wp post list --post_type='shop_order' --author=USER_ID --format=ids) --force

• Ограничьте выполнение кода через capability check current_user_can('manage_woocommerce').
• Логируйте удалённые заказы, чтобы при необходимости восстановить информацию.
• Если заказы связаны с другими плагинами (например, подписками), учитывайте их API для правильного удаления.

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

Метод	Плюсы	Минусы	Когда использовать
Код на PHP (wp_delete_post)	Гибко, можно автоматизировать, без плагинов	Риск ошибок, требует прав, может нагрузить сервер при больших объёмах	Умеренное количество заказов, кастомные сценарии
WP-CLI	Быстро, эффективно, работает с большими объёмами	Требуются SSH-доступ и опыт работы с консолью	Большие магазины, массовые операции
Плагины удаления заказов	Простота, интерфейс	Могут не подходить под задачу, лишний вес сайта	Разовые удаления, без программирования