Apostrophe 3.12.0

[agilbert]

Hi everyone,

We are closing out the week with some information on the latest Apostrophe platform updates.

This week's release is more incremental in nature, as we are gearing up to release a few extensions to Apostrophe's login system in early February. Keep an eye out for those!

In the meantime, we have plenty of small fixes and enhancements to share, along with a new extension for Apostrophe Forms to allow form submissions to be saved to Google Sheets.

Additionally, there are some new docs you may find useful:

• An important update to the localization docs regarding how to register and use localization namespaces. Less config, more directories.
• The new utility module's reference has a lot of little helpful tools.
• A guide to the newly supported nested module directories feature.

As always, read on for the full release notes, and have a great weekend 🍻

Apostrophe 3.12.0

Adds

• It is now best practice to deliver namespaced i18n strings as JSON files in module-level subdirectories of i18n/ named to match the namespace, e.g. i18n/ourTeam if the namespace is ourTeam. This allows base class modules to deliver phrases to any namespace without conflicting with those introduced at project level. The i18n option is now deprecated in favor of the new i18n module format section, which is only needed if browser: true must be specified for a namespace.
• Brought back the nestedModuleSubdirs feature from A2, which allows modules to be nested in subdirectories if nestedModuleSubdirs: true is set in app.js. As in A2, module configuration (including activation) can also be grouped in a modules.js file in such subdirectories.

Fixes

• Fixes minor inline documentation comments.
• UI strings that are not registered localization keys will now display properly when they contain a colon (:). These were previously interpreted as i18next namespace/key pairs and the "namespace" portion was left out.
• Fixes a bug where changing the page type immediately after clicking "New Page" would produce a console error. In general, areas and checkboxes now correctly handle their value being changed to null by the parent schema after initial startup of the AposInputArea or AposInputCheckboxes component.
• It is now best practice to deliver namespaced i18n strings as JSON files in module-level subdirectories of i18n/ named to match the namespace, e.g. i18n/ourTeam if the namespace is ourTeam. This allows base class modules to deliver phrases to any namespace without conflicting with those introduced at project level. The i18n option is now deprecated in favor of the new i18n module format section, which is only needed if browser: true must be specified for a namespace.
• Removes the @apostrophecms/util module template helper indexBy, which was using a lodash method not included in lodash v4.
• Removes an unimplemented csrfExceptions module section cascade. Use the csrfExceptions option of any module to set an array of URLs excluded from CSRF protection. More information is forthcoming in the documentation.
• Fix [Object Object] in the console when warning A permission.can() call was made with a type that has no manager is printed.

Changes

• Temporarily removes npm audit from our automated tests because of a sub-dependency of vue-loader that doesn't actually cause a security vulnerability for apostrophe.

Apostrophe 3.x modules

cli 3.1.1

• Pinned package.json to version 1.4.0 of the colors module to ensure the liberty bug does not corrupt the display. This should not be possible when installing normally with -g since we were already shipping a package-lock.json that contains 1.4.0, however the bug did occur if a user cloned the repo and ran npm update, so in an abundance of caution we are making sure it is not possible even when doing so.

code-upgrader 1.0.0-beta

• Linter now looks for webpack.config.js and explains possible alternatives and options.

form-submission-google 1.0.0

• Initial release.

piece-type-importer 1.0.0

• Performs streaming imports to avoid excessive RAM use.

uploadfs 1.19.0

• New options noGzipContentTypes and addNoGzipContentTypes to configure content types which should not be gzipped when using the s3 storage backend. Thanks to Christian Litzlbauer.

Apostrophe 2.x modules

apostrophe-workflow 2.39.7

• Fixes the workflow batch export progress bar, not taking related documents into account to compute the percentage.