Apostrophe 4.7.0 Batch processing for pages, enhanced tools for manual translations, a new REST endpoint for locales, and fixes

[BoDonkey]

Greetings from ApostropheCMS HQ!

pres-4.7.0-2.mp4

As the crisp autumn air begins to roll in, signaling a change of seasons, our team has been hard at work to bring you the latest enhancements and fixes. In this version, we've introduced powerful tools for managing larger files, enhanced localization features, and polished some key areas to make your experience even smoother. Get ready to dive into the fresh updates we’ve crafted just for you!

Batch processing comes to pages

Batch processing has long been available for pieces, and now it’s available for pages too. Out of the box, pages can be batch published, archived, and restored. With the @apostrophecms/import-export module you can also batch export pages. Just like with pieces, you can also create your own custom batch operations tailored to your specific needs.

New translation option

Announcing our new Import Export Translations extension! We've already demonstrated how we can integrate the power of AI to automate content translation workflows. At the same time, we've heard from our community how valuable it is to optimize for other methods of content translation at scale. We're solving for this by releasing a new extension that exports all string content into a JSON file, ready for use by third party translators and translations services. The file contains metadata to provide helpful context and make it easy to import translated content back into your locales. This gives you full control over localized content without sacrificing ease of use.

Locale listing API

Adding custom locale UI elements, such as selectors, used to require creating your own API endpoint. Now, there is an endpoint for that! The /api/v1/@apostrophecms/i18n/locales endpoint will return an object with details about all the configured locales.

Polish, fixes, and accessibility

As always, in addition to new features, we have been working hard to make your work easier by making the UI and UX of ApostropheCMS even better! Items added to object and array schema fields now can be rearranged in a smoother and more predictable manner. We have made tweaks to some menus so that they don't block other content, and we have fixed an error in the rich-text-widget that broke the page link UI. We have released significant improvements to our @apostrophecms/import-export module to improve the handling of attachments and images with cropping. While inline images in rich-text are currently not exported/imported, a hotfix is on the way. Images added via widgets or relationships work seamlessly.

Community translations

As an update, we have released the first batch of extensions with AI-generated translation strings curated by our amazing community. This effort is ongoing, with a new batch of pull requests recently added into our #translations Discord channel. We're on track to have all core modules and extensions translated into our six core languages.

Check out the release notes below for additional fixes and improvements. Remember npm update gets you the latest and greatest right in your project!

Apostrophe 4.7.0

Adds

• Add batch operations to pages.
• To aid debugging, when a file extension is unacceptable as an Apostrophe attachment the rejected extension is now printed as part of the error message.
• The new big-upload-client module can now be used to upload very large files to any route that uses the new big-upload-middleware.
• Add option skipReplace for apos.doc.changeDocIds method to skip the replacing of the "old" document in the database.
• The @apostrophecms/i18n module now exposes a locales HTTP GET API to aid in implementation of native apps for localized sites.
• Context menus can be supplied a menuId so that interested components can listen to their opening/closing.
• Allow to set mode in AposWidget component through props.
• Add shortcuts to pages manager.
• Add replaces (boolean, false by default) option to the context operation definition (registered via apos.doc.addContextOperation()) to allow the operation to require a replace confirmation before being executed. The user confirmation results in the Editor modal being closed and the operation being executed. The operation is not executed if the user cancels the confirmation.

Changes

• Wait for notify before navigating to a new page.
• Send also checkedTypes via the pages body toolbar operations (e.g. 'batch') to the modal.

Fixes

• Fix link to pages in rich-text not showing UI to select page during edit.
• Bumps uploadfs dependency to ensure .tar.gz, .tgz and .gz files uploaded to S3 download without double-gzipping.
  This resolves the issue for new uploads.
• Registering duplicate icon is no longer breaking the build.
• Fix widget focus state so that the in-context Add Content menu stays visible during animation
• Fix UI of areas in schemas so that their context menus are layered overtop sibling schema fields UI
• Fix unhandled promise rejections and guard against potential memory leaks, remove 3rd party debounce-async dependency
• Adds an option to center the context menu arrow on the button icon. Sets this new option on some context menus in the admin UI.
• Fixes the update function of AposSlatLists so that elements are properly reordered on drag

Apostrophe 3.67.3

Fixes

• Registering duplicate icon is no longer breaking the build.

Apostrophe 2.227.9 (2024-08-19)

• Update CKEDITOR combo styles to target all combos in the toolbar.

Apostrophe modules

@apostrophecms/ai-helper 1.0.0-beta.9

This module enhances Apostrophe with AI-driven helpers. Currently this module offers:

• A button to generate an image from a text prompt via OpenAI.
• An insert menu option to generate rich text from a prompt via OpenAI.

See the extension page for more info.

Adds

• Add AI and community-reviewed translation strings

@apostrophecms/event 1.0.2

This module bundle helps developers quickly add event content to Apostrophe 3 websites. It provides the event piece type (@apostrophecms/event) as well as a special page type (@apostrophecms/event-page) for editors to create an event listing.

Adds

• Add AI and community-reviewed translation strings

@apostrophecms/import-export 2.4.0

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

Adds

• Singletons can now be imported through contextOperations since they have no manager modal and thus, no utilityOperation available.
• Pages can be exported via an Export batch operation.

Fixes

• Fixes relating to importing parked pages.
• Exported related documents now contain the entire document and not only the projected fields.
• More informative messaging around the related types that are exported/skipped/etc.
• Many fixes relating to importing multiple pages while preserving page tree relationships.
• Fixes relating to cropping.
• Fixes relating to handling attachments without needlessly re-importing the originals, existing scaled versions, etc.

@apostrophecms/open-graph 1.2.2

Open Graph for ApostropheCMS.

Adds

• Updates the documentation and package description. No code changes.
• Add AI and community-reviewed translation strings.

@apostrophecms/scheduled-publishing 1.0.5

This module allows you to schedule publishing of your pieces (which includes pages) on specific dates.

Adds

• Add AI and community-reviewed translation strings.

@apostrophecms/seo 1.2.3

Add useful meta fields to all pages and pieces.

Adds

• Add AI and community-reviewed translation strings.

Pro modules

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

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

• dbFind and dbUpdate tasks to interact with the database.

Fixes

• Unfortunately localhost often resolves to both ip4 and ip6 and mongodb connect gives up if the first one it tries is not accepting connections. Tolerate this situation by using the first successful connection of the two. Fix borrowed from apostrophe core.
• Fixes useSchemaGroup to not fail when the schema group is already selected.

@apostrophecms-pro/import-export-translation 1.0.0

The purpose of this module is to create a specialized JSON file containing the text of the site, which can be downloaded and manually edited into a different language before being imported into a new locale. Upon import, pages from the default locale will be localized into the new locale substituting the translated text.

Adds

• initial stable release

@apostrophecms-pro/multisite-dashboard 1.3.0

This extension creates the new default multisite dashboard with infinite scroll, search functionality, and the ability to save templates. This extension requires that the project also have the @apostrophecms-pro/multisite extension installed and configured. Explore our documentation to discover how this extension can enhance your project. For further details or inquiries, feel free to contact us or visit our pricing page.

Adds

• Users with the guest role within the dashboard can now access the dashboard purely as a site launcher. They cannot create sites or edit site settings via the dashboard. For that, consider the editor role.

Fixes

• Sites with no logo no longer cause errors in the dashboard. This is particularly important for existing sites when migrating to this module.
• The privateDashboard option is properly supported and documented as it was before the release of this module.

Utilities

uploadfs 1.22.6 (2024-09-03)

uploadfs copies files to a web-accessible location and provides a consistent way to get the URLs that correspond to those files. uploadfs can also resize, crop and autorotate uploaded images. uploadfs includes S3-based, Azure-based, GCS-based and local filesystem-based backends and you may supply others.

Changes

• .gz files now receive the correct content type in S3.
• .gz files are now exempt from gzip transfer encoding because they are already gzipped.
• s3.js tests now use environment variables rather than
  a git-excluded local file.