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

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

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

Як це виглядає для покупця

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

Перед переглядом плагін показує тему листа, кому він піде, копії й приховані копії з налаштувань листа, від кого й Reply-to. Якщо лист вимкнено в WooCommerce → Налаштування → Електронна пошта, ви побачите попередження: покупці його не отримують. Якщо в замовленні нема 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» на вкладці «Налаштування».