Apostrophe 3.37.0 Improvements to widget placeholders, webpack, and dynamic choices

[BoDonkey]

Salutations Apostrophe Universe!

This first release of the New Year comes with a crop of improvements and fixes to the Apostrophe core. The image placeholders are now a little easier to customize in your project. Check out the updated documentation for more information.

The configuration of webpack has been improved to support fine-tuning of relevant loaders. Look for a tutorial on this in the near future!

Finally, the dynamic population of choices in a number of field schemas (like, select) can be a little more dynamic! Now the parameters passed to the method in your module used to populate these fields will also have the docId, allowing you to examine the existing document server-side if you wish. Keep in mind there is no such document yet if a brand new document is being created.

In this upcoming release cycle, our developers will be working on speed improvements through database sharding options. If you have any ideas for new features or just want to give some feedback, join our Discord server or check out the Product Roadmap.

Thanks for reading and helping us keep this vibrant community moving forward!

Apostrophe 3.37.0

Adds

• Dynamic choice functions in schemas now also receive a data object with their original doc id for further inspection by your function.
• Use mergeWithCustomize when merging extended source Webpack configuration. Introduce overideable asset module methods srcCustomizeArray and srcCustomizeObject, with reasonable default behavior, for fine tuning Webpack config arrays and objects merging. More info - the Webpack mergeWithCustomize docs
• The image widget now accepts a placeholderImage option that works like previewImage (just specify a file extension, like placeholderImage: 'jpg', and provide the file public/placeholder.jpg in the module). The placeholderUrl option is still available for backwards compatibility.

Fixes

• docId is now properly passed through array and object fields and into their child schemas.
• Remove module @apostrophecms/polymorphic-type name alias @apostrophecms/polymorphic. It was causing warnings
  e.g. A permission.can() call was made with a type that has no manager: @apostrophecms/polymorphic-type.
• The module webpack.extensions configuration is not applied to the core Admin UI build anymore. This is the correct and intended behavior as explained in the relevant documentation.
• The previewImage option now works properly for widget modules loaded from npm and those that subclass them. Specifically, the preview image may be provided in the public/ subdirectory of the original module, the project-level configuration of it, or a subclass.

Apostrophe 2.x modules

@apostrophecms/content-upgrader 3.0.0-beta.7

This module is a tool to help migrate your content from Apostrophe 2.x to Apostrophe 3.x by creating a new A3-compatible database and copying over your uploaded media. It does not upgrade your source code.

Adds

• Support for migrating rich text permalinks.

Utilities

random-words 1.2.1

This module generates random words for use as sample text. We use it to generate random blog posts when testing Apostrophe.

Fixes

• Fixes misspelling of separator in typings. Thanks to Andrei Gec for the correction.