Apostrophe 3.26.0: Quicker npm installs, new documentation

[BoDonkey]

Hola Fellow Beings,

Summer has descended in the Northern hemisphere, and with it, a slight slow down in changes in this release cycle. However, one exciting change we would like to report is the elimination of built-in support for Microsoft IE11. This change significantly reduces Apostrophe's installation time. Alongside this change, we have also released an optional module for those that still want the option. Given that Microsoft has officially ended support for IE11, we feel that moving es5 support out to a separate module is an excellent trade-off for the build speed increases.

To show we still love Microsoft, we have added cookbook documentation for installing Apostrophe on Windows systems. Finally, we pushed forward on the goal of producing reference documentation for all of Apostrophe's major core modules with pages about the global and piece page type modules.

Moving forward, the team is working hard on the new enterprise advanced permission module. It should be available in the next release cycle.

Highlights:

• asset-es5 module: Installing and enabling this module turns on an ES5, Internet Explorer 11-compatible backwards compatibility build for the public-facing frontend JavaScript bundle in Apostrophe 3.x. Modern browsers will still get a modern build and will not pay a performance penalty, although there is a performance impact during development and deployment.

Apostrophe 3.26.0

Adds

• Tasks can now be registered with the afterModuleReady flag, which is more useful than afterModuleInit because it waits for the module to be more fully initialized, including all "improvements" loaded via npm. The original afterModuleInit flag is still supported in case someone was counting on its behavior.
• Add /grid POST route in permission module, in addition to the existing GET one, to improve extensibility.

Changes

• Since Microsoft has ended support for IE11 and support for ES5 builds is responsible for a significant chunk of Apostrophe's installation time, the es5: true option no longer produces an IE11 build. For backwards compatibility, developers will receive a warning, but their build will proceed without IE11 support. IE11 ES5 builds can be brought back by installing the optional @apostrophecms/asset-es5 module.

Fixes

• testModule: true works in unit tests of external Apostrophe modules again even with modern versions of mocha, thanks to Amin Shazrin.
• getObjectManager is now implemented for Object field types, fixing a bug that prevented the use of areas found in object schema fields within templates. Thanks to James R T.

Enterprise modules

@apostrophecms/assembly-cli 1.0.1

Note: This module permits developers that are using the enterprise Assembly feature with Apostrophe sites to get logs and perform other CLI functions. Contact us at hello@apostrophecms.com to learn more.

Adds

• Initial release.

Fixes

• Fixed a bug related to api key retrieval.

@apostrophecms-pro/multisite

Note: This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Contact us at hello@apostrophecms.com to learn more.

Adds

• Correctly display the locale names in the list view, rather than #1, #2, etc.

• Display an appropriate warning regarding renaming locales, which does not migrate the existing content.

Fixes

• Do not override locales for the i18n module unless the localizedSites option is enabled. This fixes a bug introduced in version 3.6.0 that could impact sites not choosing to use dashboard-driven locales, or doing so with a locales property not compatible with the schema provided by the localizedSites option.

Public modules

@apostrophecms/asset-es5 1.0.0

This module builds es5-compatible assets for the the frontend JavaScript assets located in the ui/src/index.js files of each module.

Adds

• Initial release