WooCommerce: автоматическое отслеживание и изменение статуса заказов

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

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

Проблемы, с которыми сталкиваются разработчики:

• Статусы заказов не обновляются автоматически, что приводит к задержкам в обработке.
• Отсутствие гибкости настройки условий смены статуса.
• Нагрузка на базу данных при массовом обновлении заказов.
• Конфликты с плагинами, которые тоже меняют статусы.

Пошаговое решение: автоматическое изменение статуса заказов через wp_cron и хуки WooCommerce

1. Создание пользовательской функции для проверки и обновления статусов

Для примера, создадим функцию, которая будет менять статус заказов со статусом processing на completed через 3 дня после оплаты.

function wc_auto_complete_orders() {
    $args = array(
        'status' => 'processing',
        'date_modified' => '<=' . ( time() - 3 * DAY_IN_SECONDS ),
        'limit' => -1,
    );
    $orders = wc_get_orders( $args );
    foreach ( $orders as $order ) {
        $order->update_status( 'completed', 'Автоматическое изменение статуса после 3 дней обработки.' );
    }
}

2. Регистрация задания в wp_cron для периодического запуска

Добавим событие, которое будет запускать нашу функцию каждый час.

if ( ! wp_next_scheduled( 'wc_auto_complete_orders_event' ) ) {
    wp_schedule_event( time(), 'hourly', 'wc_auto_complete_orders_event' );
}

add_action( 'wc_auto_complete_orders_event', 'wc_auto_complete_orders' );

3. Очистка расписания при деактивации плагина или темы

Чтобы избежать мусора в cron, удаляем задачу при деактивации.

function wc_auto_complete_orders_deactivation() {
    $timestamp = wp_next_scheduled( 'wc_auto_complete_orders_event' );
    if ( $timestamp ) {
        wp_unschedule_event( $timestamp, 'wc_auto_complete_orders_event' );
    }
}
register_deactivation_hook( __FILE__, 'wc_auto_complete_orders_deactivation' );

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

Для проверки, что функция работает:

• Создайте тестовый заказ со статусом processing и датой оплаты более 3 дней назад.
• Запустите вручную функцию wc_auto_complete_orders() из консоли wp-cli или с помощью временного вызова.
• Проверьте, изменился ли статус заказа на completed и появилось ли соответствующее примечание.
• Просмотрите журнал Cron (например, с помощью плагина WP Crontrol), чтобы убедиться, что задача запускается.

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

• Функция не меняет статус: Проверьте, что дата оплаты в заказе корректно задана и сравнивается с текущим временем. Используйте get_date_paid(), а не date_modified, если нужно точнее.
  Пример обновления фильтра:

$args = array(
    'status' => 'processing',
    'limit' => -1,
);
$orders = wc_get_orders( $args );
foreach( $orders as $order ) {
    if ( $order->get_date_paid() && $order->get_date_paid()->getTimestamp() <= time() - 3 * DAY_IN_SECONDS ) {
        $order->update_status( 'completed', 'Автоматическое изменение статуса после 3 дней оплаты.' );
    }
}

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

• Используйте фильтры и условия для минимизации количества обрабатываемых заказов за один запуск (например, лимитируйте выборку).
• Добавьте логи для отслеживания работы функции (например, через error_log или отдельные таблицы).
• Проверяйте права пользователя, если функция вызывается в интерфейсе.
• Для больших магазинов используйте асинхронные задачи (например, WP Background Processing) для избежания таймаутов.

Сравнение способов реализации автоматического обновления статуса заказов