Apostrophe 3.60.0 Rich-text-widget enhancement, import improvement, notifications update, and fixes

[BoDonkey]

Howdy from Apostrophe Central!

You may be thinking, "Wow! I haven't heard from them in awhile. Maybe their messages went to spam." Fear not! We've simply switched to a brand-new release schedule. Now, we're rolling out updates every four weeks, giving us extra time to rigorously test our features and achieve more stability in our release schedule, ensuring only the best for you. So, less frequent, but more fantastic, updates are on the way!

The rich-text editor has gotten some love this cycle with an shiny new button for the insert menu. Previously, you could add a horizontal line (<hr/>) element by highlighting and clicking a button on the toolbar. Well, things just got simpler! Just configure your widget insert array to include horizontalRule, and voilà! Type a slash (/), pick it from the menu, and watch the magic happen. And that's not all – we've also spruced up the UX of the existing menu items. It's like giving your text editor a day at the spa – rejuvenating and refreshing!

The @apostrophecms/import-export extension just leveled up in intelligence. Now, if you import content from a different locale than your current one, the module offers a handy prompt. It asks whether you'd like to rewrite the content's locale to be the same as your current one. Think of it as a smart assistant, ensuring your content feels right at home in its new locale!

In addition to adding a new helper class, apos-notification--hidden, you can also now add custom classes to notifications from the @apostrophecms/notification module. For all the details on unleashing this new feature, dive into our freshly updated notification module reference documentation page. It's all about giving your notifications that extra flair!

In this cycle, we've also enhanced the core with updates and fixes, especially for developers exploring alternatives to the Nunjucks templating currently used in Apostrophe. These improvements are part of our commitment to refining our backend services, setting the stage for something exciting: the upcoming release of an official Astro-integration extension. Stay tuned for this game-changing addition!

Remember npm update gets you the latest and greatest right in your project.

Apostrophe 3.60.0

Adds

• Add the possibility to add custom classes to notifications. Setting the apos-notification--hidden class will hide the notification, which can be useful when we only care about the event carried by it.
• Give the possibility to add horizontal rules from the insert menu of the rich text editor with the following widget option: insert: [ 'horizontalRule' ]. Improve also the UX to focus back the editor after inserting a horizontal rule or a table.

Fixes

• The render-widget route now provides an options property on the widget, so that schema-level options of the widget are available to the external front end when rendering a newly added or edited widget in the editor. Note that when rendering a full page, this information is already available on the parent area: area.options.widgets[widget.type]
• Pages inserted directly in the published mode are now given a correct lastPublishedAt property, correcting several bugs relating to the page tree.
• A migration has been added to introduce lastPublishedAt wherever it is missing for existing pages.
• Fixed a bug that prevented page ranks from renumbering properly during "insert after" operations.
• Added a one-time migration to make existing page ranks unique among peers.
• Fix if and requiredIf fields inside array.
• Fixes conditional fields not being properly updated when switching items in array editor.
• The beforeSend event for pages and the loading of deferred widgets are now handled in renderPage with the proper timing so that areas can be annotated successfully for "external front" use.
• The external front now receives 100% of the serialization-friendly data that Nunjucks receives, including the home property etc. Note that the responsibility to avoid passing any nonserializable or excessively large data in req.data falls on the developer when choosing to use the apos-external-front feature.
• Wraps the group label in the expanded preview menu component in $t() to allow translation

Apostrophe 3.x modules

@apostrophecms/import-export 1.1.0

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

Adds

• Import now detects if the locale found in the exported docs is different from the current site one. If the site has only one locale configured, then the docs are automatically re-written with the site locale. If the site has multiple locales configured, the user is given the possibility to abort the import or re-write the docs with the site locale. Please note that this change is dependent on core changes found in 3.60.0.

Changes

• Hide "Duplicates Detected." notification.

@apostrophecms/rich-text-example-extensions 1.0.0

This extension accompanies the tutorials on creating @apostrophecms/rich-text-widget extensions. It includes three extensions, including extensions to alter content, add emojis, and provide statistics about the editor content. They can be used in a project, or used as templates for creating your own extensions.

Adds

• Initial release

Utilities

@apostrophecms/eslint-config-apostrophe 4.1.0

An ESLint configuration for ApostropheCMS core and officials modules.

Adds

• Adds max-len rule