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

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

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

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

1. Определяем ключевые хуки для обработки заказов

Основные хуки для работы с заказами в WooCommerce — это экшены, реагирующие на смену статуса заказа:

• woocommerce_order_status_changed — вызывается при изменении статуса заказа;
• woocommerce_new_order — при создании нового заказа;
• woocommerce_order_status_completed — при переходе заказа в статус «завершён»;
• woocommerce_order_status_processing — при переходе в статус «обработка».

Выбирайте хук, исходя из этапа, на котором хотите запускать автоматизацию.

2. Пример: автоматическая смена статуса заказа и добавление заметки

Например, чтобы после оплаты автоматически менять статус заказа с processing на completed и добавить внутреннюю заметку, используйте следующий код в functions.php темы или в кастомном плагине:

add_action('woocommerce_order_status_processing', 'auto_complete_order_and_add_note');
function auto_complete_order_and_add_note($order_id) {
    if (!$order_id) return;

    $order = wc_get_order($order_id);
    // Меняем статус заказа на 'completed'
    $order->update_status('completed', 'Автоматическое завершение заказа после обработки.');
}

3. Отправка кастомного email при смене статуса

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

add_action('woocommerce_order_status_completed', 'send_custom_email_on_complete');
function send_custom_email_on_complete($order_id) {
    $order = wc_get_order($order_id);
    $to = $order->get_billing_email();
    $subject = 'Ваш заказ завершён';
    $message = 'Спасибо за покупку! Ваш заказ #'.$order_id.' успешно завершён.';
    wp_mail($to, $subject, $message);
}

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

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

• Создайте тестовый заказ с оплатой через тестовый шлюз.
• Проверьте, что статус заказа меняется автоматически как в коде.
• Просмотрите заметки к заказу в админке WooCommerce — должна появиться ваша автоматическая заметка.
• Проверьте почту, указанную в заказе, — должно прийти кастомное уведомление.
• Для отладки используйте записи в логи WordPress (error_log()) или плагин Query Monitor.

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

• Хук не срабатывает: Убедитесь, что код добавлен в правильное место и активен. Проверьте, что статус заказа действительно меняется на тот, на который подписан хук.
• Письма не отправляются: Проверьте настройки SMTP, используйте плагины для SMTP (например, WP Mail SMTP). Убедитесь, что wp_mail() работает в вашем окружении.
• Не обновляется статус заказа: Метод update_status() должен вызываться на объекте заказа, убедитесь, что объект корректно получен через wc_get_order().
• Код вызывает ошибки PHP: Включите WP_DEBUG для поиска и устранения синтаксических ошибок.

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

• Не используйте тяжелые запросы или сторонние API в хуках, которые вызываются часто — это может замедлить работу сайта и страницы оформления заказа.
• Кэшируйте результаты, если делаете запросы к внешним сервисам.
• Используйте nonce и проверяйте права пользователя, если автоматизация связана с действиями, инициируемыми пользователями.
• Делайте бэкапы перед внесением изменений в код.
• По возможности внедряйте код через дочернюю тему или отдельный плагин, чтобы избежать потери изменений при обновлении.

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