Apostrophe 3.63.0 Improved relationships, metadata, and fixes

[BoDonkey]

Salutations Apostrophe Universe!

In our last cycle, we released a significantly updated version of the @apostrophecms-pro/advanced-permission extension that allows for more granular user permissions and custom roles. In this cycle, we spent time improving and enhancing the integration of that extension with the Apostrophe ecosystem. Improvements were added across multiple extensions to ensure a seamless experience.

In this release, we've also made significant strides in enhancing the Apostrophe core functionality. The relationship schema field now boasts the ability to specify page types, expanding beyond the previous limitation of relating to piece types or pages in general. This refinement paves the way for more targeted and meaningful content relationships within your projects.

We have also introduced a framework for adding metadata to many schema fields, setting the stage for richer content management capabilities. This update lays the groundwork for exciting future features, but we're also keen to see how this enhancement will be adopted by the developer community. Please share your ideas in our Discord community! Your contributions and feedback are pivotal in shaping the future of Apostrophe, and we look forward to fostering a vibrant exchange of insights and innovations.

Moving forward, we're actively developing two new features for our Pro customers with plans to release them in March. Automatic Translations will make it faster for your editors to localize content by introducing AI-powered translation tools to your Apostrophe workflow. Enhancements to Document Versions will make it easier to compare two documents and filter those documents to view only the changes, a next step toward a broader document comparison toolset.

We're also in the discovery and design phase on a couple of exciting projects: a new Assembly dashboard that makes it easier to scale and area templates that allow you to save and re-use groups of widgets. As always, share your feedback via our Product Roadmap.

Remember npm update gets you the latest and greatest right in your project.

Apostrophe 3.63.0

Adds

• Adds a launder method to the slug schema field query builder to allow for use in API queries.
• Adds support for browsing specific pages in a relationship field when withType is set to a page type, like @apostrophecms/home-page, default-page, article-page...
• Add support for canCreate, canPreview & canShareDraft in context operations conditions.
• Add support for canCreate, canEdit, canArchive & canPublish in utility operations definitions.
• Add uponSubmit requirement in the @apostrophecms/login module. uponSubmit requirements are checked each time the user submit the login form. See the documentation for more information.
• Add field metadata feature, where every module can add metadata to fields via public API offered by apos.doc.setMeta(), apos.doc.getMeta(), apos.doc.getMetaPath() and apos.doc.removeMeta(). The metadata is stored in the database and can be used to store additional information about a field.
• Add new apos.schema.addFieldMetadataComponent(namespace, component) method to allow adding custom components. They have access to the server-side added field metadata and can decide to show indicators on the admin UI fields. Currently supported fields are "string", "slug", "array", "object" and "area".

Fixes

• When deleting a draft document, we remove related reverse IDs of documents having a relation to the deleted one.
• Fix publishing or moving published page after a draft page on the same tree level to work as expected.
• Check create permissions on create keyboard shortcut.
• Copy requires create and edit permission.
• Display a more informative error message when publishing a page because the parent page is not published and the current user has no permission to publish the parent page (while having permission to publish the current one).
• The content-changed event for the submit draft action now uses a complete document.
• Fix the context bar overlap on palette for non-admin users that have the permission to modify it.
• Show widget icons in the editor area context menu.

Changes

• Share Drafts modal styles made larger and it's toggle input has a larger hitbox.

Apostrophe 3.x modules

@apostrophecms/ai-helper 1.0.0-beta.6

This module enhances Apostrophe with AI-driven helpers. Currently this module offers:

• A button to generate an image from a text prompt via OpenAI.
• An insert menu option to generate rich text from a prompt via OpenAI.

See the README for more info.

• Check that the current user canCreate images before showing the Generate an image with AI button.

@apostrophecms/apostrophe-astro 1.0.5

This module integrates ApostropheCMS into your Astro application.

• Compatible with Astro's ViewTransition feature when editing, via
  a workaround. Since this workaround imposes a performance penalty
  (only for editors, not the public), the viewTransitionWorkaround
  option must be set to true to enable it.

@apostrophecms/favicon 1.0.0

This module allows users to edit the "favicon" (browser tab icon) of the site via the global settings of the site. As such, it pairs well with the Apostrophe palette and multisite modules.

• Initial release.

@apostrophecms/import-export 1.3.0

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

Changes

• Requires the create and edit permissions to use the import utility operation

@apostrophecms/login-recaptcha 1.2.0

This login verification module adds a reCAPTCHA check when any user logs into the site. It uses reCAPTCHA v3, which means that the test is invisible aside from a reCAPTCHA logo at the bottom of the screen.

Changes

• Switch from beforeSubmit phase to the new uponSubmit phase.

@apostrophecms/piece-type-importer 1.2.0

This module adds an optional import feature to all piece type modules in an Apostrophe project. This feature enables importing pieces from CSV files where it is configured.

Changes

• Import now requires the create and edit permissions.

Enterprise modules

@apostrophecms-pro/advanced-permission 2.1.0

This module provides more granular control over content permission. It allows the creation of custom groups with proscribed abilities and the ability to assign users to as few or as many groups as desired. Users and groups can also be assigned per-document and per-locale permissions allowing for fine control of who can edit and publish any document. Contact us or visit our pricing page to learn more.

Changes

• Remove empty per-doc permissions in the backend instead of blocking frontend with an unclear error.
• Document the fact that editPermission does not work with per-document permissions, and how to
  work around this by granting per-document permission to modify the document while granting the
  custom permission for use with editPermission via group membership.

@apostrophecms-pro/doc-template-library 1.1.5

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 pricing page to learn more.

Fixes

• Fix an integration test that was failing.

@apostrophecms-pro/document-versions 1.2.0

This module automatically creates versions for your published documents (pages and pieces) and allows manual restore to any previously saved document version. Contact us or visit our pricing page to learn more.

Changes

• Context menu versions now requires the user to be able to edit

@apostrophecms-pro/data-set 1.1.0

This module provides an easy avenue for low-code data presentation. It creates a data-set piece for the import of comma-separated values (CSV) files. A separate widget allows for the dynamic selection of columns, and display of the data as an HTML table, or in other templates provided by the developer. Contact us or visit our pricing page to learn more.

Changes

• Update package dependencies
• Fix linting issues

@apostrophecms-pro/multisite 3.14.0

This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Each has its own database, users, media uploads, etc. Sites can be created and managed via a dashboard site. Contact us or visit our pricing page to learn more.

Adds

• Add a new stagingSubdomain field to site pieces, giving the ability to add a custom subdomain used in staging.
  This way, multiple locales can be grouped on a single subdomain.
  Examples for a site configured with a staging subdomain set to "canada" and two locales: canada.staging.url/fr, canada.staging.url/en. Note that all but one locale must have a prefix for distinction.
  If left blank, the locale name will be used as the subdomain, outside of production: fr.staging.url, en.staging.url.

Utilities

eslint-config-apostrophe 4.3.0

An ESLint configuration for ApostropheCMS core and officials modules.

Adds

• Global macros for vue 3.

Changes

• Makes max-len a warning, updates its options.

sanitize-html 2.12.0

This module provides a simple HTML sanitizer with a clear API.

Changes

• Introduced the allowedEmptyAttributes option, enabling explicit specification of empty string values for select attributes, with the default attribute set to alt. Thanks to Na for the contribution.

• Clarified the use of SVGs with a new test and changes to documentation. Thanks to Gauav Kumar for the contribution.