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

Диагностика проблемы повторной отправки писем в WooCommerce

В WooCommerce часто возникает ситуация, когда при изменении статуса заказа клиент получает одинаковое уведомление несколько раз. Это особенно критично при интеграции с CRM или платежными системами, где статус меняется программно или через API. Повторная отправка писем приводит к раздражению клиентов и загромождению почтового ящика.

Как понять, что проблема именно в повторной отправке писем?

• Клиенты жалуются на дублирующиеся уведомления;
• В логах WooCommerce или почтового сервера видно несколько записей отправки одного и того же письма;
• При отладке кода события email отправляются несколько раз;
• При использовании сторонних плагинов для управления статусами возможна конфликтная логика.

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

WooCommerce отправляет уведомления о смене статуса через хуки woocommerce_order_status_{status}_notification. Повторная отправка может произойти, если вручную меняется статус заказа и одновременно вызывается функция уведомления.

Чтобы избежать дублирования, нужно перехватить отправку письма и контролировать её вручную. Рассмотрим пример, как отключить стандартное уведомление при смене статуса processing и отправить письмо только один раз.

add_filter('woocommerce_email_enabled_customer_processing_order', 'disable_processing_order_email', 10, 2);
function disable_processing_order_email($enabled, $order) {
    if (!$order instanceof WC_Order) {
        return $enabled;
    }
    // Логика отключения, например по метке или условию
    if (get_post_meta($order->get_id(), '_email_already_sent', true)) {
        return false; // Отключаем повторную отправку
    }
    return $enabled;
}

add_action('woocommerce_order_status_processing', 'mark_email_as_sent', 20, 1);
function mark_email_as_sent($order_id) {
    update_post_meta($order_id, '_email_already_sent', 'yes');
}

В этом коде при смене статуса processing мы сохраняем мета-данные, что письмо уже отправлено и фильтруем повторную отправку.

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

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

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

• Ошибка: Письма не отправляются вовсе.
  Причина: Фильтр woocommerce_email_enabled_customer_processing_order возвращает false всегда.
  Исправление: Проверьте условие и убедитесь, что отключение происходит только при наличии мета-данных.
• Ошибка: Письма продолжают дублироваться.
  Причина: Метка _email_already_sent не проставляется или удаляется.
  Исправление: Проверьте правильность работы хука woocommerce_order_status_processing, возможно, он вызывается раньше или позже.
• Ошибка: Конфликты с другими плагинами, которые тоже работают с отправкой почты.
  Исправление: Проверьте порядок подключения плагинов и при необходимости меняйте приоритет фильтров и действий.

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

• Для хранения мета-данных используйте уникальные и префиксированные ключи, чтобы исключить конфликт с другими плагинами.
• Не храните большие объёмы данных в мета-записях, только флаги и простые значения.
• Для логирования отправки писем используйте специализированные плагины (например, WP Mail Logging) для отладки без изменения кода.
• Оптимизируйте количество отправляемых писем, чтобы избежать блокировок на стороне почтового сервера.

Сравнение вариантов решения