payload-plugin-newsletter 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,3 +1,59 @@
+## [0.12.0] - 2025-07-20
+
+### Added
+- Email preview feature for broadcasts with inline preview component
+- React Email integration for reliable email template rendering
+- Custom email template support
+- Desktop and mobile preview modes
+
+### Changed
+- Broadcast collection now includes inline email preview below content editor
+
+## [0.11.0] - 2025-07-20
+
+### Added
+- Enhanced rich text editor for broadcast emails with:
+  - Fixed toolbar showing available formatting options
+  - Inline toolbar for text selection
+  - Image upload support with Media collection integration
+  - Custom email blocks (Button and Divider)
+  - Enhanced link feature with "open in new tab" option
+- Email preview feature for broadcasts:
+  - Live preview with manual update button
+  - Desktop and mobile responsive views
+  - React Email template rendering
+  - Custom template support via `email-templates/broadcast-template.tsx`
+  - Inline preview below content editor
+- Comprehensive image handling in email HTML conversion:
+  - Responsive images with proper email-safe HTML
+  - Support for captions and alt text
+  - Automatic media URL handling for different storage backends
+- New utilities and components:
+  - `contentTransformer` for preview content processing
+  - `templateLoader` for custom template discovery
+  - `DefaultBroadcastTemplate` bundled email template
+  - `BroadcastInlinePreview` component
+- Documentation:
+  - Media collection setup guide (`docs/guides/media-collection-setup.md`)
+  - Email preview feature guide (`docs/features/email-preview.md`)
+  - Prerequisites section in README mentioning Media collection requirement
+
+### Changed
+- Removed 'name' field from Broadcasts collection (now uses 'subject' as title)
+- Updated Broadcast collection admin UI:
+  - Uses subject as the display title
+  - Shows recipientCount in default columns instead of name
+- Enhanced `convertToEmailSafeHtml` utility to handle:
+  - Upload nodes for images
+  - Custom block nodes (button and divider)
+  - Media URL configuration
+  - Improved link handling with target attribute support
+- Broadcast API sync now uses subject as the name field
+
+### Fixed
+- Broadcast hooks now properly handle the absence of name field
+- Email preview components updated to work without channel references
+
 ## [0.10.0] - 2025-07-20
 
 ### Changed

package/README.md

@@ -22,6 +22,11 @@ A complete newsletter management plugin for [Payload CMS](https://github.com/pay
 - ✅ **Email Validation** - Built-in validation for email client compatibility (v0.9.0+)
 - 📝 **Email-Safe Editor** - Rich text editor limited to email-compatible features (v0.9.0+)
 
+## Prerequisites
+
+- Payload CMS v3.0.0 or higher
+- A Media collection configured in your Payload project (required for image support in broadcasts)
+
 ## Quick Start
 
 ### 1. Install the plugin