Email Preview для WooCommerce — просмотр любого письма магазина на реальном заказе и тестовая копия

Email Preview для WooCommerce — плагин, который показывает любое письмо магазина на реальном заказе, прежде чем его увидит покупатель. Выберите письмо и заказ — и вы видите его именно таким, каким WooCommerce собирает его для этого заказа: настоящие товары, цены, скидки, адреса, примечания и возвраты, тема и заголовок с подставленными значениями, получатель, Cc, Bcc, от кого и Reply-to.

Без плагина проверить письмо можно лишь одним способом — оформить тестовый заказ и ждать почту, или сменить статус реального заказа и надеяться, что покупатель не получит лишнего. Email Preview ничего не отправляет, пока вы смотрите: просмотр не меняет заказ — не добавляет заметок, не ставит отметку «письмо уже отправлено» и не пишет покупателю. Когда нужно проверить саму доставку, тестовая копия уходит только на адреса, которые вы ввели.

Как это выглядит для покупателя

Никак — и в этом суть. Плагин работает только в админке: на витрине не появляется ни одного скрипта, а покупатель получает ровно те письма, что и раньше. Разница в том, что теперь вы видите эти письма заранее: как выглядит «Заказ обрабатывается» с купоном, что пишет «Частичный возврат», не пустая ли тема в письме собственного статуса, читается ли таблица товаров на телефоне.

Перед просмотром плагин показывает тему письма, кому оно уйдёт, копии и скрытые копии из настроек письма, от кого и Reply-to. Если письмо отключено в WooCommerce → Настройки → Email, вы увидите предупреждение: покупатели его не получают. Если в заказе нет e-mail, панель прямо пишет, что WooCommerce это письмо пропустит.

Что получает админ

Плагин добавляет пункт WooCommerce → «Просмотр писем» с вкладками «Просмотреть», «Журнал писем» (Pro) и «Настройки». Первое открытие сразу показывает последний заказ и то письмо, которое получил его покупатель по текущему статусу, — без всякой настройки.

• Любое письмо. Список содержит все письма заказа, зарегистрированные в WooCommerce: 13 писем самого WooCommerce 11.1, письма собственных статусов заказов и письма, которые добавили другие плагины или тема, — отдельной группой.
• Любой заказ. Последние 25 заказов в списке или любой по номеру в поле «или ID заказа». Для нового магазина без заказов — «Образец заказа» WooCommerce с выдуманными данными.
• HTML или текст. Формат «Как в настройках», HTML или текстовая версия — даже если магазин отправляет HTML.
• Компьютер или телефон. Кнопка «Телефон (375 px)» сужает письмо до ширины смартфона, «Открыть в новой вкладке» — показывает его отдельной страницей.

Справа — форма «Отправить тестовую копию»: до 5 адресов через запятую. Копию получают только они, с пометкой [Test] в теме (префикс меняется в настройках); копия и скрытая копия из настроек письма к ней не добавляются, покупатель ничего не получает, в заказе не появляется ни одной заметки. Галочка «Добавить вложения» просит у плагинов счетов их PDF — она по умолчанию выключена, потому что некоторые плагины счетов в этот момент создают настоящий счёт с номером (так делает PDF Invoices & Packing Slips — мы это проверили).

На экране самого заказа появляется бокс «Просмотр писем»: кнопка открывает письмо для текущего статуса, а «Другие письма» — любое другое письмо этого заказа. Бокс работает и с HPOS, и с классическим хранилищем заказов.

На вкладке «Настройки» — адрес по умолчанию для тестовых копий (пусто = почта вашего аккаунта), префикс темы тестовой копии, «Удалять все данные плагина при его удалении», а для Pro — лицензия, журнал и тестовый режим. Интерфейс плагина переведён на украинский и русский; письмо в просмотре на языке сайта, как его отправляет WooCommerce.

Pro: журнал, языки и тестовый режим

Журнал писем. Pro записывает каждое письмо WooCommerce, которое отправляет магазин: когда, какое письмо, заказ, получатель, тема и статус. Если почта не ушла, строка отмечена «Ошибка» вместе с текстом ошибки — например, «SMTP Error: Could not connect to SMTP host». Фильтры по номеру заказа, типу письма и статусу. Каждую строку можно просмотреть или отправить ещё раз. Журнал хранится 30 дней (настраивается).

«Отправить ещё раз» — это настоящее письмо, а не тестовая копия: его отправляет WooCommerce, поэтому письмо получат и копии из настроек, а WooCommerce 10.9+ запишет в заказ свою заметку об отправке. Так и задумано — это повтор реального письма.

На любом языке. Pro показывает письмо и отправляет тестовую копию на любом языке, установленном на сайте, — например, письмо на украинском при английской админке. Язык заказа из WPML или Polylang плагин автоматически не подхватывает — его выбирают вручную.

Все письма заказа одним кликом. Кнопка «Отправить все письма этого заказа» отправляет по одной тестовой копии каждого письма заказа (в том числе отключённых) на введённые адреса — полная проверка в одном ящике. В тесте это 13 копий и ни одной заметки в заказе.

Тестовый режим. Для копии рабочего магазина или тестового прогона чекаута: все письма WooCommerce идут на один адрес, а исходный получатель стоит в теме. Пока режим включён, на каждом экране админки висит предупреждение, чтобы вы не забыли его выключить. Режим перенаправляет только письма WooCommerce — письма WordPress и других плагинов идут как обычно.

Как это работает — шаг за шагом

1. Вы выбираете письмо и заказ (или образец) на вкладке «Просмотреть» или в боксе на экране заказа.
2. Плагин берёт сам объект письма WooCommerce и готовит его так же, как это делает WooCommerce перед отправкой: заказ, получатель, значения для тем и заголовков, примечание покупателю, данные возврата.
3. Собственная функция отправки письма при этом не вызывается — именно она в WooCommerce ставит отметку «уже отправлено» и пишет заметки. Поэтому заказ остаётся неизменным.
4. Письмо собирается теми же методами WooCommerce, что и при настоящей отправке: тема, содержимое (в том числе из блочного редактора писем), встроенные стили и фильтры контента письма.
5. Вы видите результат в изолированном фрейме без скриптов — на ширине компьютера или телефона — с темой и всеми получателями рядом.
6. Тестовая копия идёт через wp_mail() только на введённые адреса: Cc и Bcc вырезаются, в теме — префикс [Test].

Что под капотом

• Без trigger(). Собственный метод отправки письма WooCommerce не вызывается: в ядре он ставит отметку «письмо о новом заказе отправлено», а с WooCommerce 10.9 каждая отправка пишет заметку в заказ. Клон письма готовится вручную и рендерится публичными методами WooCommerce.
• Безопасный просмотр. Письмо показывается во фрейме sandbox без разрешения на скрипты, отдельная вкладка отдаётся с CSP script-src 'none'. Страница доступна только тем, кто может управлять WooCommerce.
• Сторонние письма. Хук catcode_emp_prepare_email даёт разработчикам заполнить поля, которые их письмо заполняет только в собственной отправке.
• Образец заказа берёт встроенный класс превью WooCommerce. Если WooCommerce когда-нибудь его изменит, образец покажет ошибку, а реальные заказы продолжат работать.
• Журнал Pro — отдельная таблица с автоочисткой по крону.
• Удаление с галочкой «Удалять все данные плагина» убирает таблицу, настройки и крон. Через WP-CLI данные удаляет wp plugin uninstall, а не wp plugin delete.

Как установить

1. Скачайте архив catcode-email-preview-for-woocommerce-1.0.0.zip кнопкой вверху страницы: Плагины → Добавить новый → Загрузить плагин → Установить → Активировать. Pro включается в том же плагине ключом или триалом.
2. Откройте WooCommerce → «Просмотр писем» — вы сразу увидите последний заказ и его письмо.
3. Выберите другое письмо или заказ и нажмите «Просмотреть». Чтобы проверить доставку, введите свой адрес и нажмите «Отправить тестовую копию».
4. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» в разделе «Лицензия Pro» на вкладке «Настройки».