WooCommerce: решение проблемы с повторной отправкой email при изменении цены товара

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

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

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

• Проверьте логи email-уведомлений (если включен логгер, например в WP Mail Logging или через плагин SMTP).
• Определите, какие именно хуки срабатывают при изменении цены товара в заказе.
• Посмотрите, не вызывается ли повторно функция, отправляющая email, при обновлении метаданных заказа.

Пошаговое решение проблемы: ограничение повторной отправки email после изменения цены

Чтобы избежать повторной отправки писем, необходимо перехватить событие обновления заказа и добавить проверку, чтобы email отправлялся только один раз. Для этого можно использовать фильтр 'woocommerce_email_enabled_customer_processing_order' или аналогичные на уровне отправки email.

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

add_filter('woocommerce_email_enabled_customer_processing_order', 'disable_email_on_price_update', 10, 2);
function disable_email_on_price_update($enabled, $order) {
    // Проверяем, есть ли мета с флагом о том, что email уже отправлен
    if (get_post_meta($order->get_id(), '_email_sent_after_price_change', true)) {
        return false; // блокируем повторную отправку
    }
    return $enabled;
}

// Устанавливаем мета при изменении цены
add_action('woocommerce_update_order', 'mark_email_sent_flag');
function mark_email_sent_flag($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) {
        return;
    }
    // Логика определения изменения цены. Можно сравнить старую и новую цену
    // Для упрощения примера ставим флаг всегда
    update_post_meta($order_id, '_email_sent_after_price_change', 'yes');
}

Этот код добавляет флаг, который не позволяет повторно отправлять email при обновлении заказа с изменением цены.

Альтернативный подход: использовать пользовательское событие для отправки уведомлений

Если изменение цены происходит через кастомный код или API, лучше вручную контролировать отправку email через собственные функции, отключив стандартную отправку уведомлений WooCommerce.

// Отключаем стандартную отправку email при обновлении заказа
add_filter('woocommerce_email_enabled_customer_processing_order', '__return_false');

// Отправляем email вручную, когда все изменения завершены
function send_custom_order_update_email($order_id) {
    $mailer = WC()->mailer();
    $mails = $mailer->get_emails();
    if (!empty($mails)) {
        $mails['WC_Email_Customer_Processing_Order']->trigger($order_id);
    }
}

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

• Измените цену товара в существующем заказе.
• Отследите логи отправленных email (через плагин или SMTP-сервер).
• Убедитесь, что письма не отправляются повторно после изменения цены.
• Проверьте, что первоначальные уведомления отправляются корректно.

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

• Неправильное использование хуков: Некоторые разработчики пытаются отключить email через remove_action без понимания порядка вызовов, что приводит к полной блокировке уведомлений. Используйте фильтры woocommerce_email_enabled_* для избирательной блокировки.
• Отсутствие проверки на фактическое изменение цены: Если не сравнивать старую и новую цены, email может блокироваться даже если цена не менялась. Добавляйте логику сравнения значений.
• Конфликты с другими плагинами: Плагины для уведомлений или кастомизации WooCommerce могут переопределять стандартные хуки. Проверяйте конфликтные плагины и тестируйте на чистом сайте.

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

• Не используйте тяжелые функции и запросы в хуках, вызываемых при обновлении заказа — это может замедлить процесс оформления.
• Если отправляете email вручную, используйте транзакционные очереди (например, WP-Cron) для снижения нагрузки.
• Храните метаданные с префиксом, чтобы избежать конфликтов с плагинами и ядром WooCommerce.

Чек-лист по устранению проблемы повторной отправки email при изменении цены в WooCommerce

1. Включите логирование email для отладки.
2. Определите, какие хуки вызывают повторную отправку.
3. Добавьте проверку флага отправки email в фильтры woocommerce_email_enabled_*.
4. Сравните старую и новую цену, чтобы избежать ложных срабатываний.
5. Проверьте совместимость с другими плагинами.
6. Тестируйте изменения на тестовом сайте.

Таблица сравнения подходов к решению