Apostrophe 4.3.0 Widget tabs, multisite UI refresh, and fixes

[BoDonkey]

Ahoy, Apostrophe Allies!

In this cycle, the team has been hard at work making some delightful UI and UX improvements to enhance your experience. First up, your custom widgets can now have tabs! In the past, if you had a complex widget with a large number of schema fields, your content editors would have to scroll through all of those fields to find the one they wanted to edit. Now, much like the schema fields for pages and pieces, you can supply a group property to organize your fields into tabs. For widgets, the tabs are organized along the top of the modal, with a handy context menu when the number of tabs overflows the modal width.

Next, let's talk about the new dashboard for the @apostrophecms-pro/multisite extension!

The new dashboard features an infinitely scrollable list, with quick links to the login and home pages of each site. We've also added a search and a new way to organize your template sites. Mark a site as a ‘Template’ in its settings to add it the Templates folder on the left. This should make it faster to find and duplicate templates when spinning up new sites. This is the first of many Assembly dashboard enhancements that will be rolling out in 2024!

As usual, we have made a number of changes and fixes to the Apostrophe core to make sure that the developer and user experience remains first-rate. We love getting feedback on how we can make Apostrophe better, whether that be a new feature or some tweaking of the workflow. Drop into our Discord or visit our Public Roadmap to make your suggestions heard!

Remember npm update gets you the latest and greatest right in your project, unless of course the latest and greatest is a major version bump! Both @apostrophecms/import-export and @apostrophecms-pro/multisite have major version bumps. If you are using the latest version of Apostrophe and have these extensions installed, you will need to manually update your package.json file before running npm update. See the changelogs below for more info.

Apostrophe 4.3.0

Adds

• Allows to disable page refresh on content changed for page types.
• Widget editor can now have tabs.
• Adds prop to AposInputMixin to disable blur emit.
• Adds throttle function in ui module utils.
• Adds a publicBundle option to @apostrophecms/asset. When set to false, the ui/src public asset bundle is not built at all in most cases except as part of the admin UI bundle which depends on it. For use with external front ends such as apostrophe-astro. Thanks to Michelin for contributing this feature.

Fixes

• npm link now works properly when developing Apostrophe admin UI modules.

Changes

• Improves debounce function to handle async properly (waiting for previous async call to finish before to trigger new one).
• Adds the copyOfId property to the edit() method while still allowing the entire copyOf object for BC

Fixes

• Autocrop image attachments for referenced documents when replacing an image in the Media Manager.
• Fixes modals in transition, as well as slider transition on overlay opacity.
• Changing the aspect ratio multiple times in the image cropper modal no longer makes the stencil smaller and smaller.

4.2.1 (2024-04-29)

Fixes

• Fixes drag and drop regression in the page tree where pages were not able to be moved between parent and child.

Apostrophe 3.65.0

Fixes

• Autocrop image attachments for referenced documents when replacing an image in the Media Manager.

Adds

• Adds a publicBundle option to @apostrophecms/asset. When set to false, the ui/src public asset bundle is not built at all in most cases except as part of the admin UI bundle which depends on it. For use with external front ends such as apostrophe-astro. Thanks to Michelin for contributing this feature.
• Backports some A4 features to make the new document-versions comparison feature compatible with A3.

Apostrophe modules

@apostrophecms/import-export 2.0.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.

Changes

• Corrects documentation of required permissions.

Adds

• Add CSV format.

Breaking changes

• This is a new major version, 2.0.0. To update to this version you must edit your package.json file and change the dependency to ^2.0.0 or similar.
• The signature of the output function from the gzip format has changed. It no longer takes the apos instance and now requires a processAttachments callback.
• import and overrideDuplicates functions now require formatLabel to be passed in req.

@apostrophecms/import-export-xlsx 1.0.0

This module improves @apostrophecms/import-export by adding the xlsx format.

Adds

• Initial release

Pro modules

@apostrophecms-pro/document-versions 2.2.0

Note: Changes were also made to the legacy version of this extension to be used with Apostrophe 3.x

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.

Fixes

• Fix side bar size when using Compare Versions
• Fix separator position when using side by side comparison
• Fix visual alignment when comparing versions

@apostrophecms-pro/multisite 4.0.0

This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Each has its own database, users, media uploads, etc. Sites can be created and managed via a dashboard site. 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.

Changes

• Move the site-base piece module logic to the new module @apostrophecms-pro/multisite-dashboard site piece. Make it work properly with the new dashboard UI provided by multisite-dashboard.
• Makes the baseUrlDomains configuration mandatory for sites.

3.17.0 (2024-05-06)

Changes

• In production, assets build tasks are now run without the need for MongoDB (in dev mode the database is still involved)
• No more need for a temporary site in the production asset build task
• Add an option publicBundle, defaults to true. Setting it to false will prevent building bundles in dev mode if APOS_DEV environment variable is not there and we already have built once the admin UI bundle. To be used with external front end approach (Astro), for which it reduces drastically the restart time in dev mode if using Docker as a development environment, where copying assets can be slow

Fixes

• Guarantee a unique shortName for temporary sites so we don't run into
  the collision detection code, potentially breaking asset builds.

@apostrophecms-pro/multisite-dashboard 1.0.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.

Utilities

@apostrophecms/stylelint-config-apostrophe 4.0.0

This module provides a stylelint configuration for the Apostrophe team and contributors.

Fixed

• Add support for vue files by using stylelint-config-html/vue.