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

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

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

Как проверить проблему:

• В административной панели WooCommerce выберите несколько заказов.
• Измените их статус массово (например, «Обработка» → «Выполнен»).
• Проверьте почту покупателя и папку «Отправленные» на сервере.
• Если письма не приходят, значит стандартная отправка не сработала.

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

При массовом обновлении WooCommerce использует метод bulk_edit_orders, который обновляет статусы заказов в базе, но не вызывает все хуки, связанные с отправкой писем. В частности, не срабатывает woocommerce_order_status_changed в полном объеме, что и приводит к отсутствию уведомлений.

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

1. Используем хук для отслеживания массового обновления

Добавьте в файл functions.php вашей темы или в кастомный плагин следующий код:

add_action('woocommerce_order_bulk_edit_actions', 'send_emails_on_bulk_status_change', 10, 2);

function send_emails_on_bulk_status_change($order_ids, $new_status) {
    if (empty($order_ids) || !$new_status) {
        return;
    }
    foreach ($order_ids as $order_id) {
        $order = wc_get_order($order_id);
        if (!$order) continue;

        $old_status = $order->get_status();
        // Обновляем статус вручную, чтобы сработали хуки
        if ($old_status !== $new_status) {
            $order->update_status($new_status, 'Статус изменен массово, отправка письма.');
        }
    }
}

Принцип: при массовом обновлении из админки мы вручную вызываем update_status для каждого заказа, что запускает все необходимые хуки и отправляет уведомления.

2. Добавление проверки для шаблонов email

Если вы хотите отправлять только определённые письма (например, только уведомления о выполнении заказа), можно дополнительно фильтровать статусы:

function send_emails_on_bulk_status_change($order_ids, $new_status) {
    $allowed_statuses = ['completed', 'processing'];
    if (empty($order_ids) || !in_array($new_status, $allowed_statuses)) {
        return;
    }
    foreach ($order_ids as $order_id) {
        $order = wc_get_order($order_id);
        if (!$order) continue;

        $old_status = $order->get_status();
        if ($old_status !== $new_status) {
            $order->update_status($new_status, 'Статус изменен массово, отправка письма.');
        }
    }
}

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

• В админке WooCommerce выберите несколько заказов и измените их статус массово.
• Подтвердите, что письма о смене статуса приходят на почту клиентов.
• Если письма не приходят — проверьте логи сервера и WooCommerce Logs (WooCommerce → Статус → Логи).
• Проверьте правильность работы функции update_status — она триггерит стандартные email-уведомления.

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

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

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

• При массовом обновлении большого числа заказов вызов update_status может нагружать сервер и замедлять работу. Рекомендуется делать такие операции пакетами по 50-100 заказов.
• Реализуйте логирование отправленных писем для контроля и отладки.
• Используйте SMTP-сервисы с авторизацией и шифрованием для безопасной отправки почты.
• Не забывайте обрабатывать ошибки отправки почты в логах для своевременного реагирования.

Сравнение вариантов решения проблемы