Apostrophe 3.9.0: With a new events module in beta! 📅

[agilbert]

Hi everyone,

Today we are once again excited to share the latest progress on Apostrophe with you all.

This release includes a handful of improvements across a wide range of modules, but much our work has been focused on further improvements to our A2 > A3 code upgrader tool. Included in the latest updates you will see lot of new linting methods that will help developers identify and resolve any changes needed to upgrade modules and projects for A3.

In addition to this, we are very happy to announce that the beta release of a new events module for Apostrophe 3 is now available. This work was largely driven by Gary Bailey based on an upgrade of the existing apostrophe-events module for A2. If you've been looking for a simple way to manage events as a content type, including things like built in date filters you can use on the front-end, this is a great way to add that to your project.

If you use any other modules that have been important for your projects in A2 and are curious about migrating those to A3 using our upgrader tools, please reach out! We're happy to provide guidance and support around that process.

As always, read on for the full release notes below, and have an awesome day 🙇‍♂️

Apostrophe 3.9.0

Adds

• Developers can now override any Vue component of the ApostropheCMS admin UI by providing a component of the same name in the ui/apos/components folder of their own module. This is not always the best approach, see the documentation for details.
• When running a job, we now trigger the notification before to run the job, this way the progress notification ID is available from the job and the notification can be dismissed if needed.
• Adds maxUi, maxLabel, minUi, and minLabel localization strings for array input and other UI.

Fixes

• Fully removes references to the A2 self.partial module method. It appeared only once outside of comments, but was not actually used by the UI. The self.render method should be used for simple template rendering.
• Fixes string interpolation for the confirmation modal when publishing a page that has an unpublished parent page.
• No more "cannot set headers after they are sent to the client" and "req.res.redirect not defined" messages when handling URLs with extra trailing slashes.
• The apos.util.runPlayers method is not called until all of the widgets in a particular tree of areas and sub-areas have been added to the DOM. This means a parent area widget player will see the expected markup for any sub-widgets when the "Edit" button is clicked.
• Properly activates the apostropheI18nDebugPlugin i18next debugging plugin when using the APOS_SHOW_I18N environment variable. The full set of l10n emoji indicators previously available for the UI is now available for template and server-side strings.
• Actually registers piece types for site search unless the searchable option is false.
• Fixes the methods required for the search index task.

Changes

• Adds localization keys for the password field component's min and max error messages.

Apostrophe 3.x modules

code-upgrader 1.0.0-alpha.2

• Adds a prompt before the upgrade script runs to confirm the user wants to proceed.
• Adds helpful message about using "git diff HEAD" after running the upgrade command.
• Display lint messages in source code order, even if they are for a mix of issues.
• Lint for array field schema properties that need conversion.
• Lint for joinByArray field sub-schema properties that need conversion.
• Lint for joinByOne, joinByArray, joinbyOneReverse, and joinByArrayReverse.
• Lint for widget output method overrides.
• Lint for filterOptionsForDataAttribute.
• Lint for methods that should move to the "methods" section.
• Lint for tasks that should move to the "tasks" section.
• Lint for self.route, self.apiRoute, self.htmlRoute, and self.renderRoute.

event 1.0.0

• Initial release with support for event pieces and event piece pages. Many thanks to bulldoguk for primary module development and egonzalezg9 for additional contributions.

piece-type-exporter 1.0.0-beta.1

• Renames methods to decrease potential for conflicts with other modules.

piece-type-importer 1.0.0-beta.1

• Gets the progress notification ID from the run method, uses it to dismiss the progress notification if needed (early errors).

sitemap 1.0.1

• Replaces the symlink in the tests with the testModule option.

Apostrophe 2.x modules

apostrophe-passport 2.3.0

• Support automatically returning the user to the correct hostname on sites using apostrophe-workflow to accommodate multiple locales.

Other modules

sanitize-html 2.6.1

• Fixes style filtering to retain !important when used.
• Fixed trailing text bug on transformTags options that was reported on issue #506. Thanks to Alex Rantos.

uploadfs 1.18.5

• Local storage is fully compatible with Node 16 and later, as well as earlier releases previously supported.
• Removed a stray folder.