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

Что такое хуки WooCommerce и зачем они нужны для автоматизации

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

Диагностика: почему важно правильно использовать хуки для управления заказами

Часто автоматизация на основе хуков реализуется с ошибками: например, код вызывается несколько раз, запускается слишком рано или поздно, или изменяет данные неправильно. Это приводит к дублированным письмам, неверным статусам заказов и другим проблемам. Чтобы избежать этого, нужно чётко понимать, какой хук за что отвечает и как его правильно использовать.

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

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

• woocommerce_order_status_changed — вызывается при смене статуса заказа;
• woocommerce_thankyou — срабатывает после оформления заказа (успешной оплаты);
• woocommerce_checkout_update_order_meta — позволяет добавить или изменить метаданные заказа после оформления;
• woocommerce_order_status_completed — срабатывает при переводе заказа в статус "завершён";
• woocommerce_email_order_details — позволяет изменить содержимое email уведомлений;
• woocommerce_before_order_object_save — позволяет вмешаться перед сохранением объекта заказа.

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

Задача: при переходе заказа в статус processing автоматически менять статус на on-hold при определённом условии (например, если в заказе есть товар из категории "предзаказ"), а также отправлять кастомное уведомление менеджеру.

Шаг 1. Подключаем функцию к хуку woocommerce_order_status_changed

add_action('woocommerce_order_status_changed', 'custom_change_order_status_and_notify', 10, 4);
function custom_change_order_status_and_notify($order_id, $old_status, $new_status, $order) {
    // Проверяем переход в статус processing
    if ($new_status !== 'processing') {
        return;
    }

    // Проверяем наличие товаров из категории 'preorder'
    $has_preorder = false;
    foreach ($order->get_items() as $item) {
        $product_id = $item->get_product_id();
        if (has_term('preorder', 'product_cat', $product_id)) {
            $has_preorder = true;
            break;
        }
    }

    if ($has_preorder) {
        // Меняем статус на on-hold
        $order->update_status('on-hold', 'Автоматическая смена статуса из-за предзаказа.');

        // Отправляем уведомление менеджеру
        $to = 'manager@example.com';
        $subject = 'Заказ #' . $order_id . ' переведен в статус On-Hold';
        $message = 'Заказ с предзаказом автоматически переведен в статус On-Hold. Проверьте детали заказа: ' . $order->get_edit_order_url();
        wp_mail($to, $subject, $message);
    }
}

Шаг 2. Добавляем функцию в файл functions.php темы или в собственный плагин

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

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

• Создайте тестовый заказ и добавьте в него товар из категории "предзаказ";
• Оплатите заказ (можно использовать режим тестовых платежей);
• Проверьте, что заказ сменил статус на on-hold сразу после перехода в processing;
• Убедитесь, что письмо уведомления отправлено и получено менеджером;
• Проверьте логи ошибок сервера и WooCommerce на предмет сбоев.

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

• Ошибка: Статус заказа меняется бесконечно (цикл).
  Причина: В функции смены статуса не проверяется текущий статус, и обновление вызывает повторный хук.
  Решение: Добавить проверку, чтобы не менять статус, если он уже нужный.
• Ошибка: Уведомления не отправляются.
  Причина: Функция wp_mail не настроена или заблокирована хостингом.
  Решение: Настроить SMTP через плагин (например, WP Mail SMTP) и проверить логи.
• Ошибка: Функция не срабатывает.
  Причина: Неправильно указаны параметры хука или ошибка в коде.
  Решение: Проверить правильность подключения функции, включить WP_DEBUG для отладки.

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

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

Таблица сравнения: использование кода vs плагины для автоматизации заказов WooCommerce