WooCommerce: как исключить повторную отправку письма при изменении статуса заказа по условиям

Диагностика проблемы: почему письма отправляются повторно

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

Основные признаки проблемы:

• Клиенты жалуются на повторные уведомления по одному и тому же статусу;
• Логи сервера и WooCommerce показывают несколько вызовов функции отправки письма на одно и то же событие;
• Автоматические системы учёта заказов фиксируют множественные изменения статусов без видимых причин.

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

1. Определение условий, при которых нужно блокировать отправку

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

2. Использование фильтра woocommerce_email_enabled_{email_id}

WooCommerce позволяет включать или отключать отправку конкретных писем через фильтры. Для письма о смене статуса заказа фильтр имеет вид woocommerce_email_enabled_customer_completed_order для статуса "завершён".

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

add_filter('woocommerce_email_enabled_customer_completed_order', function($enabled, $order) {
    // Проверяем, что это объект WC_Order
    if (!is_a($order, 'WC_Order')) {
        return $enabled;
    }

    // Получаем предыдущий статус из мета (устанавливается при смене статуса)
    $previous_status = get_post_meta($order->get_id(), '_previous_order_status', true);

    // Если предыдущий статус совпадает с текущим, блокируем отправку
    if ($previous_status === 'completed' && $order->get_status() === 'completed') {
        return false;
    }

    return $enabled;
}, 10, 2);

3. Добавление сохранения предыдущего статуса заказа

Чтобы фильтр работал корректно, нужно сохранить предыдущий статус до смены:

add_action('woocommerce_order_status_changed', function($order_id, $old_status, $new_status, $order) {
    update_post_meta($order_id, '_previous_order_status', $old_status);
}, 10, 4);

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

• Измените статус заказа на нужный и проверьте, что письмо отправляется;
• Повторите изменение того же статуса — письмо не должно отправиться;
• Проверьте логи почтового сервера или WooCommerce, чтобы убедиться в отсутствии повторных вызовов;
• Используйте инструменты отладки WooCommerce, например, плагин WP Mail Logging для мониторинга почтовых событий.

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

• Неверная передача объекта заказа в фильтр: убедитесь, что в фильтр передаётся объект WC_Order, иначе условие не сработает.
• Отсутствие сохранения предыдущего статуса: без сохранения старого статуса фильтр не сможет определить повторную отправку.
• Неправильное использование email ID: для других статусов нужно использовать соответствующие фильтры, например woocommerce_email_enabled_customer_processing_order.
• Конфликты с плагинами, которые также отправляют письма: в таких случаях может потребоваться дополнительное логирование и отладка.

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

• Не используйте постоянные запросы к базе для проверки статуса — сохраняйте данные в мета полях заказа, как показано выше.
• Избегайте отключения всех уведомлений одним фильтром — лучше настраивать логику точечно.
• Тестируйте изменения на тестовом сайте, чтобы не нарушить уведомления клиентов.
• Для массовых операций с заказами используйте WP-CLI и скрипты, которые заранее обновят метаданные.

Сравнение методов исключения повторной отправки писем