WooCommerce: автоматическое удаление неоплаченных заказов с помощью хука

Проблема: накопление неоплаченных заказов в WooCommerce

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

WooCommerce не предусматривает штатного механизма автоматического удаления таких заказов по таймауту, что ведет к необходимости ручной очистки или созданию кастомных решений.

Диагностика проблемы

Чтобы убедиться, что на сайте есть неоплаченные заказы, можно выполнить SQL-запрос через phpMyAdmin или WP-CLI:

SELECT ID, post_date, post_status FROM wp_posts WHERE post_type = 'shop_order' AND post_status = 'wc-pending';

Если таких записей много и они старше нескольких дней, это признак необходимости автоматизации очистки.

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

1. Добавление функции удаления заказов

Создаем функцию, которая будет искать неоплаченные заказы (статус wc-pending) старше заданного времени и удалять их.

function wc_auto_delete_unpaid_orders() {
    $hours = 24; // Время в часах, по истечении которого заказы будут удалены
    $date = date('Y-m-d H:i:s', strtotime('-'. $hours .' hours'));

    $args = [
        'post_type'      => 'shop_order',
        'post_status'    => 'wc-pending',
        'date_query'     => [
            [
                'column' => 'post_date',
                'before' => $date,
            ],
        ],
        'posts_per_page' => -1,
        'fields'         => 'ids',
    ];

    $orders = get_posts($args);

    if (empty($orders)) {
        return;
    }

    foreach ($orders as $order_id) {
        wp_delete_post($order_id, true); // Полное удаление заказа
    }
}

2. Планирование задачи с использованием WP-Cron

Чтобы удаление происходило автоматически, добавим событие WP-Cron, которое будет запускать функцию раз в 6 часов:

if (! wp_next_scheduled('wc_auto_delete_unpaid_orders_hook')) {
    wp_schedule_event(time(), 'six_hours', 'wc_auto_delete_unpaid_orders_hook');
}

add_action('wc_auto_delete_unpaid_orders_hook', 'wc_auto_delete_unpaid_orders');

// Регистрируем интервал 6 часов
add_filter('cron_schedules', function($schedules) {
    $schedules['six_hours'] = [
        'interval' => 6 * 3600,
        'display'  => __('Каждые 6 часов'),
    ];
    return $schedules;
});

3. Добавление кода в functions.php или в кастомный плагин

Рекомендуется добавить приведенный код в файл functions.php вашей дочерней темы или оформить в отдельный плагин для удобства контроля и обновлений.

Проверка результата

Для проверки выполните следующие шаги:

• Создайте тестовый заказ со статусом wc-pending и датой создания старше 24 часов через админку или вручную в базе.
• Запустите WP-Cron вручную (например, с помощью плагина WP Crontrol или WP-CLI командой wp cron event run wc_auto_delete_unpaid_orders_hook).
• Проверьте, что заказ удалился из базы данных и списка заказов в админке.

Также можно проверить лог ошибок сервера и WP Debug для выявления возможных проблем.

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

• Функция не вызывается по расписанию
  Причина: WP-Cron не работает без захода на сайт или отключен. Решение: настроить системный cron на вызов wp-cron.php или использовать плагин WP Crontrol для тестирования.
• Заказы не удаляются
  Причина: некорректный статус заказа или неверный формат даты.
  Проверьте, что статус wc-pending действительно используется, и дата сравнивается правильно.
• Удаление заказов приводит к ошибкам
  Причина: сторонние плагины или кастомные функции, которые зависят от заказов.
  Решение: добавить резервное копирование перед автоматическим удалением и проверить совместимость.

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

• Перед внедрением автоматического удаления сделайте резервную копию базы данных.
• Не уменьшайте интервал запуска WP-Cron слишком сильно, чтобы не создавать нагрузку на сервер.
• Используйте wp_delete_post($order_id, true) для полного удаления, включая метаданные и связанные записи.
• Если на сайте очень большой объем заказов, рассмотрите обработку порциями с ограничением количества заказов за один запуск.
• Включите WP_DEBUG_LOG для отслеживания сбоев и ошибок.

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