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

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

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

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

Стандартный WooCommerce не умеет автоматически менять статус заказа при получении email. Для реализации такой логики нужно связать почтовый сервер с WooCommerce. Основные сложности:

• Получение и обработка email на сервере;
• Определение соответствия email конкретному заказу;
• Изменение статуса заказа программно с безопасным доступом.

Пошаговое решение: интеграция почтового обработчика с WooCommerce

1. Настройка получения email с помощью PHP IMAP

Для обработки входящих писем можно использовать расширение PHP IMAP. Пример кода для подключения и чтения почты:

$mailbox = imap_open('{imap.yourmailserver.com:993/imap/ssl}INBOX', 'user@example.com', 'password');
if (!$mailbox) {
    die('Ошибка подключения к почте: ' . imap_last_error());
}
$emails = imap_search($mailbox, 'UNSEEN');
if ($emails) {
    foreach ($emails as $email_number) {
        $overview = imap_fetch_overview($mailbox, $email_number, 0);
        $message = imap_fetchbody($mailbox, $email_number, 1);
        // Обработка $overview и $message
    }
}
imap_close($mailbox);

2. Определение заказа по email

Предположим, что в теме письма или теле письма есть номер заказа, например, #1234. Нужно извлечь его регулярным выражением:

if (preg_match('/#(\d+)/', $overview[0]->subject, $matches)) {
    $order_id = intval($matches[1]);
}

Если номер заказа найден, далее проверяем, существует ли такой заказ:

$order = wc_get_order($order_id);
if (!$order) {
    // Логируем ошибку или пропускаем
}

3. Изменение статуса заказа

Для изменения статуса используйте метод $order->update_status():

$order->update_status('processing', 'Статус изменён автоматически после получения письма от покупателя.');

4. Запуск скрипта по cron или из внешнего сервиса

Чтобы периодически проверять новые письма, добавьте cron-задачу на сервер, которая будет запускать PHP-скрипт с этим кодом.

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

• Отправьте на настроенный почтовый ящик письмо с темой, содержащей номер существующего заказа (например, "Вопрос по заказу #1234").
• Запустите скрипт или дождитесь запуска cron.
• Проверьте в админке WooCommerce, что статус заказа #1234 изменён на нужный (например, processing).
• Проверьте логи или сообщения об ошибках для подтверждения успешной работы.

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

• Ошибка подключения к почте: проверьте правильность настроек IMAP, логин и пароль, а также наличие расширения PHP IMAP.
• Номер заказа не найден в письме: проверьте регулярное выражение и формат темы письма.
• Заказ не существует: убедитесь, что используете правильный ID заказа из WooCommerce.
• Права доступа: скрипт должен иметь доступ к WordPress, для этого запускайте его из wp-load.php или создайте WP CLI команду.

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

• Не храните пароли в открытом виде – используйте переменные окружения или защищённые конфигурационные файлы.
• Обрабатывайте только новые (UNSEEN) письма, чтобы не менять статус по одному заказу несколько раз.
• Добавьте логирование успешных и неуспешных операций для отладки и мониторинга.
• Используйте nonce или другие методы проверки, если скрипт вызывается через веб для защиты от несанкционированного доступа.

Сравнение вариантов реализации автоматического изменения статуса заказа