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

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

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

Проверить проблему можно так:

• Перейдите в админку WooCommerce → Заказы.
• Откройте отменённый заказ и убедитесь, что товары в нём по-прежнему присутствуют.
• Проверьте остатки товаров в каталоге — если они не изменились после отмены заказа, значит автоматического выкупа или удаления товара не произошло.

Пошаговое решение: автоматическое удаление товаров из отменённого заказа

Для автоматического удаления позиций из заказа при смене его статуса на "отменён" используйте хук woocommerce_order_status_cancelled. Ниже пример кода, который удаляет все товары из заказа при отмене:

add_action('woocommerce_order_status_cancelled', 'wpcompany_remove_products_on_cancelled_order', 10, 1);
function wpcompany_remove_products_on_cancelled_order($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if (!$order) return;

    // Перебираем все товары в заказе
    foreach ($order->get_items() as $item_id => $item) {
        // Удаляем товар из заказа
        $order->remove_item($item_id);
    }
    $order->save();
}

Объяснение:

• Хук срабатывает при смене статуса заказа на cancel (отменён).
• Функция получает объект заказа по ID.
• Удаляет все позиции из заказа с помощью remove_item.
• Сохраняет изменения методом save().

Альтернатива: удалять только определённые товары

Если нужно удалить не все товары, а только определённые (например, с определённой категорией или мета-данными), добавьте проверку внутри цикла:

foreach ($order->get_items() as $item_id => $item) {
    $product = $item->get_product();
    if ($product && has_term('my-category', 'product_cat', $product->get_id())) {
        $order->remove_item($item_id);
    }
}

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

• Создайте тестовый заказ с несколькими товарами.
• Переведите его в статус "отменён" вручную в админке WooCommerce.
• Откройте заказ и убедитесь, что товары удалены (список товаров пуст).
• Проверьте отчёты и остатки на складе, чтобы удостовериться, что данные обновились корректно.

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

• Код не срабатывает при смене статуса: проверьте, что код добавлен в файл functions.php активной темы или в плагин и что нет ошибок PHP.
• Товары не удаляются, но статус меняется: убедитесь, что используете правильный хук woocommerce_order_status_cancelled без опечаток.
• Ошибка «Call to undefined method»: обновите WooCommerce до актуальной версии, так как remove_item и save() существуют в последних версиях.
• Нарушение логики складских остатков: после удаления товаров из заказа проверьте, учитывается ли возврат остатков — по умолчанию WooCommerce управляет этим отдельно.

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

• Перед внесением изменений сделайте резервную копию сайта и базы данных.
• Тестируйте код на staging-сервере, чтобы избежать сбоев на рабочем сайте.
• Используйте кеширование и оптимизируйте запросы, если заказы обрабатываются массово, чтобы не вызвать нагрузку на сервер.
• Отслеживайте логи ошибок PHP для быстрого выявления проблем.

Сравнение подходов удаления товаров из отменённых заказов

Метод	Плюсы	Минусы
Удаление через хук (код)	Гибкость, автоматизация, контроль над логикой	Требует навыков программирования, риск ошибочной логики
Ручное удаление в админке	Простота, не требует кода	Трудоёмко, ошибка человека, не подходит для большого количества заказов
Плагины управления заказами	Интерфейс, дополнительные функции	Могут замедлять сайт, не всегда подходят под специфичные задачи