Как использовать WooCommerce хуки для автоматизации обработки заказов

Диагностика задачи: зачем автоматизировать обработку заказов в WooCommerce

При большом числе заказов ручная обработка становится узким местом в работе интернет-магазина. Типичные задачи — автоматическая смена статуса заказа, отправка уведомлений, интеграция с внешними сервисами и управление складом. Для решения этих задач WooCommerce предоставляет систему хуков, позволяющих подцепиться к событиям и выполнять код автоматически.

Основные хуки WooCommerce для обработки заказов

WooCommerce включает несколько важных хуков, связанных с заказами:

• woocommerce_thankyou — срабатывает после оформления заказа (ID заказа передается в параметре).
• woocommerce_order_status_changed — вызывается при изменении статуса заказа.
• woocommerce_payment_complete — срабатывает, когда платеж по заказу успешно завершен.
• woocommerce_new_order — появляется при создании нового заказа.

Правильное использование этих хуков позволяет автоматизировать бизнес-процессы.

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

Добавим в functions.php тему или в отдельный плагин следующий код:

add_action('woocommerce_payment_complete', 'auto_change_order_status_to_processing');
function auto_change_order_status_to_processing($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    if ($order->get_status() === 'pending') {
        $order->update_status('processing', 'Автоматический переход в статус processing после оплаты');
    }
}

Пошаговое решение: автоматизация уведомления в Telegram при новом заказе

Допустим, нужно отправлять уведомления в Telegram сразу после создания нового заказа без использования плагинов.

1. Создайте Telegram-бота через @BotFather и получите токен.
2. Определите ID чата, куда будут приходить уведомления.
3. Добавьте в functions.php следующий код:

function send_telegram_notification_new_order($order_id) {
    $bot_token = 'ВАШ_ТОКЕН';
    $chat_id = 'ВАШ_CHAT_ID';
    $order = wc_get_order($order_id);
    $message = "Новый заказ №{$order->get_order_number()}\n";
    $message .= "Сумма: {$order->get_formatted_order_total()}\n";
    $message .= "Покупатель: {$order->get_billing_first_name()} {$order->get_billing_last_name()}\n";
    $url = "https://api.telegram.org/bot{$bot_token}/sendMessage?chat_id={$chat_id}&text=" . urlencode($message);
    wp_remote_get($url);
}
add_action('woocommerce_new_order', 'send_telegram_notification_new_order');

Этот код отправит простое уведомление в Telegram при создании заказа.

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

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

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

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

• Хуки не срабатывают: убедитесь, что код подключен в активной теме или плагине, и что нет синтаксических ошибок.
• Неверный ID заказа в функции: проверяйте, что в хук передается корректный $order_id.
• Проблемы с Telegram API: проверьте правильность токена и ID чата, используйте wp_remote_get без блокировок на сервере.
• Статус заказа не меняется: некоторые статусы могут быть недоступны для прямого перехода, проверяйте логи и права пользователя.

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

• Не выполняйте тяжелые операции напрямую в хуках — используйте очередь задач или WP-Cron.
• Для интеграции с внешними API используйте wp_remote_get с таймаутом и обработкой ошибок.
• Ограничьте права на редактирование кода, чтобы избежать случайных изменений.
• Кэшируйте данные, если используете повторяющиеся запросы к API.
• Для сложных интеграций рассмотрите создание отдельного плагина, чтобы не терять код при смене темы.

Сравнение способов автоматизации обработки заказов