Apostrophe 4.13.0: Enhanced Localization, Improved Imports, and Better Document Management

[BoDonkey]

Hello Apostrophe Community!

This month we're excited to share a release that's all about scaling your digital experiences to new heights. Whether you're managing multilingual content across continents, or need to give your clients tools for moving large amounts of content between sites, Apostrophe 4.13.0 brings powerful tools to help you reach those goals with confidence.

4.13.0-presentation.mp4

Batch Operations and Localization at Scale

Managing multilingual content across hundreds of documents just got easier. Our new batch localization capabilities for both pieces and pages streamline the process of creating and maintaining content across multiple languages. This is complemented by our new report modal system, which provides clear visibility into the status and outcomes of your localization operations. And, our AI-driven Automatic Translation extension integrates with batch localization to complete the whole task! We've implemented smart retry mechanisms to ensure reliable translations when localizing at scale.

Enhanced File Handling and Upload Management

Big changes often mean big files, and we've got you covered. The Import/Export extension now supports the import of significantly larger export files, even if your proxy server would normally not handle uploads of that size, making it easier than ever to move substantial amounts of content between sites and environments. Whether you're importing entire sites or transferring large content collections, these improvements help ensure a smooth process.

To get the best features, make sure you have ApostropheCMS 4.x!

This release of the Import/Export extension also includes a major version bump to the Import/Export module, because this version requires that your project is using Apostrophe 4.x. If you are considering migrating your 3.x project to 4.x, this is the perfect time to follow our migration guide!

For those already running Apostrophe CMS 4.x: to get the newest Import/Export functionality, you just need to edit your package.json file to use the ^3.0.0 version of the @apostrophecms/import-export module and type npm install.

Smarter Document Management

We've made significant improvements to how Apostrophe handles document relationships and versions. Reverse relationships now automatically include necessary special properties, ensuring related documents are returned successfully. Document versioning has been explicitly enabled for core file and image types, providing better tracking and control over media assets. These enhancements give you more confidence when managing complex document relationships in large-scale deployments.

Pro Module Power-Ups

Our professional extensions continue to evolve with enterprise needs in mind. The Automatic Translation extension now supports Azure AI Translator and includes a robust retry mechanism for handling large translation volumes. Our Cypress Tools extension has been enhanced with new commands for testing report modals, making it easier to validate your localization workflows. The Document Versions extension now allows explicit opt-in for version control, giving you more granular control over which document types maintain historical versions.

Additional Improvements

• A new progress notification system helps track long-running operations that are driven by the front end
• Enhanced field input focus management in array modals
• Improved group operations configuration merging between modules
• Fixed admin bar widget area interactions
• Enhanced i18n manager locale detection in complex scenarios

As organizations continue to scale their digital presence globally, these improvements reflect our commitment to providing the tools needed for enterprise-grade content management. Whether you're localizing content across multiple markets or handling large content transfers between environments, Apostrophe 4.13.0 is ready to support your growth.

Ready to scale? Update your dependencies with npm update to take advantage of these new features!

Apostrophe 4.13.0

Adds

• Supports progress notification type, can be used when no job are involved. Manage progress state into the new processes entity.
• Moves global notification logic into Pinia store as well as job polling that updates processes.

Fixes

• Field inputs inside an array modal can now be focused/tabbed via keyboard
• Fixes admin bar overlapping widget area add menu.
• Fixed the checkered background for gauging color transparency.
• Fixes group.operations (batch configuration) merging between modules in the same way that group.fields are merged.
• The i18n manager detects the current locale correctly in some edge cases, like when the locale is changed per document (Editor Modal) and the localization manager is opened from a relationship manager via a document context menu.

Adds

• Add support for batch localization of pieces and pages.
• Piece types can now opt in to the document versions feature even if they have the autopublish: true setting.
• Adds type for each file uploaded by big-upload. Moves big-upload-client to apos/ui folder and makes it esm.
• When present, projections for reverse relationships now automatically include the special id and field storage properties for the relationship in question, allowing the related documents to be successfully returned.
• Introduce AposModalReport component for displaying reports in the form of a table. It's accessible via apos.report(content, options) method and it's now used in the @apostrophecms/i18n module for detailed reporting after a batch localization operation.
• If error.cause is prevent, log the property.

Changes

• The array editor's isModified method is now a computed property for consistency.
• The modal configuration property for batch operations without a group is now accepted and works as expected in the same way as for grouped operations.
• Explicitly enable document versions for the @apostrophecms/file-tag, @apostrophecms/file, @apostrophecms/image-tag and @apostrophecms/image piece types.

Pro modules

@apostrophecms-pro/automatic-translation 1.3.0

This AI-powered bundle allows automatic translation of documents (pages and pieces) when localizing content. It comes with two translation providers: Google Cloud Translation and DeepL, but it is also possible to configure your own providers. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Adds

• Adds Azure AI Translator provider.
• Adds retry mechanism for the translation requests. Introduces new options retryMaxAttempts and retryBaseDelayMs to control the retry behavior.

@apostrophecms-pro/cypress-tools 1.0.0-beta.18

Automated functional browser tests are an important part of quality assurance for enterprise websites and web applications. Cypress is an industry-standard, open-source library for carrying out automated functional browser tests. This module provides a collection of conveniences for testing ApostropheCMS sites and applications within Cypress. Contact us or visit our new pricing page to learn more.

Adds

• Add getReportModal command to select the recently added to the core report modal.

Changes

• Attempt to fix flaky tests with adding "scroll into view" before triggering the actions in widget related commands.

@apostrophecms-pro/document-versions 2.5.0

This module automatically creates versions for your published documents (pages and pieces) and allows manual restore to any previously saved document version. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Changes

• Document types now may explicitly opt into document versions with versions: true. This option takes precedence over autopublish: true.

@apostrophecms-pro/palette 4.6.0

An in-context interface for changing CSS. @apostrophecms-pro/palette is a module that provides an in-context interface for changing the values of developer-set CSS properties. The values are stored in an Apostrophe piece singleton (like @apostrophecms/global) and applied to the site whenever the stylesheet link is included in a template. Adjusting values via the palette interface renders changes to the site instantly. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Changes

• Change Palette icon.
• Remove manual autopublish logic in favor of the new versions: true setting and autopublish: true.

Fixes

• Add missing postcss-scss dependency for stylelint to run correctly, and fix errors.

Apostrophe modules

@apostrophecms/import-export 3.0.0

This module enables import and export of pages and pieces, with or without related documents such as files, images and other related types.

Changes

• Major version change, attention required: 3.0.0 because this release is compatible only with ApostropheCMS 4.x. If you have not upgraded from ApostropheCMS 3.x to ApostropheCMS 4.x, you should do so.
• For your ApostropheCMS 4.x project, make sure you change the dependency in package.json to ^3.0.0 to get this version.
• Hide the importDraftsOnly checkbox for autopublished documents.

Adds

• Adds a method to sort all exported documents, makes sure that parent pages come always first.
• Uses the new big-upload feature of apostrophe to allow very large export files to be imported, even if the proxy server’s maximum file upload size would otherwise be reached.
• Provides progress notifications when uploading the import file (as well as once the actual import process begins).