Apostrophe 4.18.0 continues our commitment to improving the editorial experience with more options for conditional fields, easy image linking, and expanded rich text editing tools and styles.
Advanced Conditional Fields with Enhanced Query Capabilities
This release introduces enhancements to conditional field logic, giving developers more precise control over when fields appear in editing interfaces. Conditional fields now support following, enabling fields to be conditionally displayed based on values within deeply nested objects or arrays.
Additionally, conditional fields now support dot notation for conditionals like array length and MongoDB-like query operators including $gt, $gte, $lt, and $lte. This enhancement applies to all conditional fields, allowing developers to create more focused editing interfaces throughout the platform.
Unified Image Linking Experience
We've enhanced how editors work with images by introducing linking capabilities that work consistently whether images are added through the rich text editor or the image widget.
Images are now added as figure elements with caption support, providing better semantic structure and styling opportunities. This structure also enables captions and linking functionality. By default, the widgets allow you to add links to URLs or internal pages. The linkWithType option allows you to add links to any piece-type show page.
Important Styling Note: Developers should review and update their CSS to ensure proper styling of figure-based images. An inline margin: 0 style is added by default, but can be disabled by setting inlineStyles: false in widget configuration.
Streamlined Rich Text Editing
We've expanded the default toolbar and styling options available in the rich text widget, reducing setup work for new projects. Common formatting options that previously required explicit configuration are now available by default, allowing content teams to start creating formatted content immediately.
These enhancements reduce friction in the content creation process while maintaining the flexibility developers need to create customized editorial experiences. To take advantage of these new default settings in an existing project, just remove any project-level rich text widget toolbar options.
Enterprise Contributions: Zero-Downtime Site Management
We're proud to highlight a significant contribution from Michelin to our multisite capabilities. The multisite extension now supports zero-downtime site reloads and proactive site prewarming, enabling enterprise customers to manage large-scale deployments more efficiently. When site configurations change, the system serves requests with existing instances while new instances start in the background, ensuring seamless transitions and improved performance.
Quality of Life Improvements
This release includes several refinements that improve the overall editorial experience:
- Media library download links now work as expected, immediately downloading files rather than navigating away from the current page
- Error pages now include proper cache headers to prevent serving stale error content
- API key permissions have been corrected to provide appropriate access levels for different user roles
These improvements are ready for you to explore! Update your projects with npm update and let us know what you think on our roadmap. Your feedback helps us refine and enhance ApostropheCMS to meet your needs.
🚀 Happy coding!