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

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

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

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

Если вам нужно автоматизировать конкретный сценарий — например, отправку уведомления после смены статуса заказа или автоматическое обновление пользовательских полей — первым делом нужно определить событие, которое будет триггером.

Для этого полезно:

• Изучить документацию WooCommerce по хукам https://woocommerce.com/document/hooks/;
• Включить логирование хуков с помощью плагина Query Monitor или добавить временный код для отладки;
• Проверить, какие хуки вызываются при нужных действиях через do_action и apply_filters в исходниках WooCommerce.

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

Задача: после оплаты заказа автоматически добавить к заказу метку «Оплачен» и отправить кастомное уведомление администратору.

Шаг 1. Используем хук woocommerce_order_status_processing

Этот хук срабатывает при смене статуса заказа на «в обработке» (обычно после оплаты).

add_action('woocommerce_order_status_processing', 'custom_order_status_processing_action', 10, 1); 
function custom_order_status_processing_action($order_id) {
    if (!$order_id) return;
    $order = wc_get_order($order_id);
    // Добавляем метку "Оплачен"
    $order->update_meta_data('_custom_payment_label', 'Оплачен');
    $order->save();
    
    // Отправляем уведомление админу
    $admin_email = get_option('admin_email');
    wp_mail($admin_email, "Заказ #$order_id оплачен", "Заказ #$order_id был оплачен и обновлен.");
}

Шаг 2. Добавляем отображение метки в админке заказов

Чтобы видеть метку в списке заказов, используем фильтр manage_edit-shop_order_columns и экшен manage_shop_order_posts_custom_column:

add_filter('manage_edit-shop_order_columns', 'add_custom_order_label_column');
function add_custom_order_label_column($columns) {
    $columns['custom_payment_label'] = 'Метка оплаты';
    return $columns;
}

add_action('manage_shop_order_posts_custom_column', 'show_custom_order_label_column', 10, 2);
function show_custom_order_label_column($column, $post_id) {
    if ($column === 'custom_payment_label') {
        $order = wc_get_order($post_id);
        $label = $order->get_meta('_custom_payment_label');
        echo esc_html($label ? $label : '-');
    }
}

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

1. Создайте тестовый заказ и оплатите его через доступные способы.
2. Перейдите в админку WooCommerce → Заказы и убедитесь, что в списке у заказа появилась колонка «Метка оплаты» с текстом «Оплачен».
3. Проверьте почту администратора — должно прийти уведомление о смене статуса.
4. В случае проблем включите WP_DEBUG и проверьте логи ошибок.

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

• Хук не срабатывает: возможно, статус не меняется на нужный или событие происходит не в том месте. Проверьте правильность статуса и используйте отладочные инструменты.
• Письма не отправляются: убедитесь, что wp_mail настроена и сервер поддерживает отправку почты. Для теста можно использовать плагин WP Mail Logging.
• Метаданные не сохраняются: вызов $order->save() обязателен после изменения метаданных.
• Ошибка доступа к объекту $order: проверьте, что ID передается и объект создается через wc_get_order.

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

• Храните пользовательские данные в метаполях заказов с уникальными ключами, чтобы избежать конфликтов.
• Проверяйте входящие данные и используйте функции экранирования при выводе, например, esc_html().
• В тяжелых автоматизациях используйте асинхронные задачи — можно интегрировать с WP-Cron или внешними очередями, чтобы не замедлять отклик сайта.
• Для массовых операций лучше использовать специализированные сервисы интеграции с WooCommerce через REST API.

Таблица сравнения методов автоматизации заказов в WooCommerce