Как автоматизировать изменение статусов заказов WooCommerce с помощью кода

Диагностика задачи: зачем нужна автоматизация изменения статусов заказов

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

Пошаговое решение: автоматизация через хук и WP Cron

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

Создадим функцию, которая будет менять статусы заказов по определенному условию. Например, переведем все заказы со статусом processing, созданные более 7 дней назад, в статус completed:

function wpguest_auto_complete_orders() {
    $args = array(
        'limit' => -1,
        'status' => 'processing',
        'date_created' => '<' . (new WC_DateTime('-7 days'))->format('Y-m-d H:i:s'),
    );

    $orders = wc_get_orders($args);

    foreach ($orders as $order) {
        $order->update_status('completed', 'Заказ автоматически завершен спустя 7 дней.');
    }
}

2. Запуск функции по расписанию с помощью WP Cron

Чтобы функция выполнялась регулярно, добавим событие WP Cron. Для этого зарегистрируем задачу при активации темы или плагина:

function wpguest_schedule_order_status_update() {
    if (!wp_next_scheduled('wpguest_daily_order_status_update')) {
        wp_schedule_event(time(), 'daily', 'wpguest_daily_order_status_update');
    }
}
add_action('wp', 'wpguest_schedule_order_status_update');

add_action('wpguest_daily_order_status_update', 'wpguest_auto_complete_orders');

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

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

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

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

• Проверьте, что задача добавилась в WP Cron: можно использовать плагин WP Crontrol для просмотра и управления задачами.
• Создайте тестовый заказ со статусом processing и датой создания более 7 дней назад (для теста можно вручную изменить дату в базе или подкорректировать условие).
• Запустите cron задачу вручную через WP Crontrol или дождитесь следующего запуска.
• Убедитесь, что статус заказа изменился на completed и в истории заказа появилась запись с вашим комментарием.

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

• Отсутствие WP Cron запуска: На некоторых хостингах WP Cron не запускается автоматически. Проверьте доступность cron, настроив реальный системный cron или запуск WP Cron вручную.
• Неправильный формат даты в запросе: В аргументе date_created необходимо использовать формат Y-m-d H:i:s и правильный синтаксис. Ошибка приведет к тому, что запрос не вернет заказов.
• Отсутствие разрешений у функции update_status: Убедитесь, что функция вызывается в контексте с нужными правами, обычно это не проблема в WP Cron.
• Задача WP Cron дублируется: Проверяйте наличие расписания с помощью wp_next_scheduled чтобы не создавать дубликаты.

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

• Не запускайте тяжелые операции на каждом запросе, используйте WP Cron для распределения нагрузки.
• В запросах к заказам используйте лимиты и фильтры, чтобы не обрабатывать слишком много записей за раз.
• Для более сложной логики используйте статусы и метаданные заказов, чтобы избежать повторной обработки одних и тех же заказов.
• Если сайт большой, рассмотрите запуск WP Cron через системный cron, чтобы не зависеть от посещаемости сайта.

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