MJML email-редактор в Filament для транзакционных писем и рассылок

Используемые навыки Laravel PHP PostgreSQL

Описание

Собственный email-редактор, встроенный в админ-панель Filament, для создания и отправки писем в MJML-разметке. Используется для транзакционных уведомлений и маркетинговых рассылок на bozheslav.ru.

Решение

— $subject — зарезервированная переменная в Laravel Mailable, пришлось переименовать в $mailSubject во всех кастомных письмах
— MJML компилируется на бэкенде через CLI-обёртку, результат кэшируется
Стек: PHP 8.3, Laravel 12, Filament 3, MJML CLI, PostgreSQL 16, Yandex SMTP.

Результат

— MJML-редактор в админке с live-preview рендера в HTML
— Управление медиа для писем: отдельные таблицы email_media и email_folders — чтобы не смешивать с основной медиатекой сайта
— Универсальные пути к картинкам через storage/email-media/... — стабильно работают в Gmail, Yandex Mail, Outlook и мобильных клиентах (в отличие от динамических Curator URL, которые ломаются в почте)
— Интеграция с Yandex SMTP через smtps на порту 465 с App Password
— Шаблоны писем: сохранение готовых шаблонов с возможностью клонирования
— Поддержка plain-text версии: для cold outreach — чистый текст без HTML лучше проходит спам-фильтры