Jack McDade представив Mailables Viewer - новий безплатний аддон для Statamic, який виявляє всі Laravel-mailables у додатку та робить їх доступними в розділі Utilities → Mailables у Control Panel.
Проблема, яку вирішує аддон
Розробники зазвичай стикаються з необхідністю створювати тимчасові preview-роути на кшталт /preview-email/{email} у файлі web.php, які закоментовують до наступного використання. Такі роути створюють новий екземпляр mailable (наприклад, WelcomeEmail) з купою тестових даних, виводять HTML і дають можливість переглянути результат у браузері під час внесення змін.
Інший підхід - просто відправляти лист собі знову і знову, поки інструменти на кшталт Herd Pro або Mailtrap не почнуть вас засуджувати. Jack McDade втомився від таких методів і створив Mailables Viewer.
Основні можливості
Аддон рендерить HTML кожного mailable без потреби в окремих preview-роутах чи конфігурації. Він автоматично генерує тестові дані для конструктора, дозволяє редагувати скалярні значення та спостерігати, як оновлюються preview та envelope у реальному часі.
Mailables Viewer надає три види відображення: desktop, tablet та mobile. Це дозволяє перевірити, як виглядатиме лист на різних пристроях без додаткових інструментів.
Інспектування та тестування
Ви можете детально інспектувати:
- subject листа
- відправника (sender)
- вкладення (attachments)
- використовуваний template
- статус черги (queue status)
- посилання на mailable у кодовій базі
Аддон дозволяє скопіювати відрендерений HTML або відправити тестовий лист методом sendNow(), навіть якщо mailable зазвичай використовує чергу.
Робота з даними
Об'єкти та масиви залишаються в режимі read-only, тоді як рядки, числа, булеві значення та дати можна змінювати у редакторі даних. Це дає гнучкість у тестуванні різних варіантів контенту без зміни коду.
Якщо ваші mailables знаходяться поза стандартною директорією app/Mail, їх можна зареєструвати через фасад аддону.
Права доступу
Super users отримують доступ автоматично. Іншим ролям можна надати дозвіл access mailables utility для використання функціоналу.
Детальний огляд зі скріншотами доступний у анонсі McDade на офіційному сайті Statamic.
