Apostrophe 3.58.0 Document import/export, widget area field following, and fixes/improvements

[BoDonkey]

Hola JavaScript Aficionados!

We're thrilled to introduce the first iteration of a fantastic new extension for you to check out! Say hello to the @apostrophecms/import-export module, your go-to solution for effortlessly importing and exporting pages and pieces, complete with related documents like files, images, and other types. You can now perform batch exports and imports for pieces. If you're already using the doc-template-library module, you're in luck, templates can be batch-exported, as well! Currently, page exports are individual and all exports are locale-specific, but stay tuned for more exciting updates!

Just a heads-up: Make sure you're on the latest Apostrophe version (v3.58.0) to take advantage of this new extension. But you were planning to update anyway, weren't you? Of course you were!

Widgets have been freed from their box (a little) in this release! Now if your area schema field follows the value of another schema field, the widgets within that area can tap into that value. This allows more opportunities for conditional display and customization of the choices you present to your users!

Into the next cycle, we are looking at adding additional schema field conditionals and laying the groundwork for improvement of the advanced permission module. On the documentation front, get ready for an in-depth guide to building a website from scratch with Apostrophe—perfect for newcomers eager to hit the ground running!

For a complete rundown of all the updates, scroll down to our changelogs. And remember, a quick npm update keeps your project at the cutting edge until our next release!

Apostrophe 3.58.0

Fixes

• Ensure Apostrophe can make appropriate checks by always including type in the projection even if it is not explicitly listed.
• Never try to annotate a widget with permissions the way we annotate a document, even if the widget is simulating a document.
• The areas query builder now works properly when an array of area names has been specified.

Adds

• Widget schema can now follow the parent schema via the similar to introduced in the array field type syntax (< prefix). In order a parent followed field to be available to the widget schema, the area field should follow it. For example, if area follows the root schema title field via following: ['title'], any field from a widget schema inside that area can do following: ['<title'].
• The values of fields followed by an area field are now available in custom widget preview Vue components (registered with widget option options.widget = 'MyComponentPreview'). Those components will also receive additional areaField prop (the parent area field definition object).
• Allows to insert attachments with a given ID, as well as with docIds and archivedDocIds to preserve related docs.
• Adds an update method to the attachment module, which updates both the MongoDB doc and the associated file.
• Adds an option to the http remote method to allow receiving the original response from node-fetch that is a stream.

Apostrophe 3.x modules

@apostrophecms/form-submission-google 1.0.1

This module adds an additional form submission option to Apostrophe Forms in Apostrophe 3. It allows website managers to configure individual forms to submit to a specific Google Docs spreadsheet.

Adds

• File upload can now be limited in size (frontend only) by setting the max file size per file upload field.
  On the server, there are many factors that can influence this rule (for example proxies and servers used
  between Apostrophe and the end-user). That is why this rule is not enforced on the server side.
  We use the default express connect-multiparty size limits. The rule is checked before submit.
• Allow to configure file field multiple attribute. By default, file field allow the user to select multiple files.
  This can now be disabled.
• Add divider widget (<hr> tag) to form widgets.

@apostrophecms/import-export

This A3 module enables import and export of pages and pieces, with or without related documents such as files, images and other related types.

1.0.2 (2023-10-13)

Fixes

• Use uploadfs.copyOut to ensure success in more attachment export situations, such as debugging a multisite Assembly project
  on a local machine where Chrome considers subdomains of localhost to be your machine but Node.js does not.
• Minor refactoring for maintainability and performance.
• Error and warning notifications stay in place until dismissed.

1.0.1 (2023-10-12)

Fixes

Move documentation images to our own hosting.

1.0.0 (2023-10-12)

Adds

Initial release.

Pro modules

@apostrophecms-pro/cypress-tools 1.0.0-beta.11

Automated functional browser tests are an important part of quality assurance for enterprise websites and web applications. Cypress is an industry-standard, open-source library for carrying out automated functional browser tests. This module provides a collection of conveniences for testing ApostropheCMS sites and applications within Cypress. Contact us or visit our new pricing page to learn more.

Adds

• Adds support for the progress notification in findNotification.

@apostrophecms-pro/doc-template-library 1.1.0

This module solves the "blank page problem" for developers and product managers, and makes it faster for editors to create content. doc-template-library allows for the configuration of default widgets and pre-populated content on piece or page templates, and to re-use existing layouts. Contact us or visit our new pricing page to learn more.

Fixes

• Make templates importable and exportable by adding a missing checked prop and utility operation.