Apostrophe 4.8.0 Mobile Preview, rich text REST API improvements, UI refinements, and fixes

[BoDonkey]

Ahoy, Apostrophe Allies!

During this past release cycle, many excellent conversations with agency partners and users have helped us refine and prioritize the features on our roadmap. Today we’re excited to introduce a range of these improvements, including the new mobile preview feature. This update also brings several admin UI improvements, streamlined defaults, updates for easier content migration, and bolstered import-export capabilities.

Whether you're using ApostropheCMS for traditional or headless setups, you'll find meaningful improvements inspired by our diverse user base. Thank you for your ongoing contributions and feedback – they're the driving force behind our evolution.

Overview

apostrophecms-4.8.0.mp4

Breakpoint Preview: Responsive Design at Your Fingertips

One of the standout features in this release is the new mobile preview functionality. When enabled, this feature adds user-configurable breakpoint toggles to the admin-bar. Content managers can now preview how their content will appear across various devices and screen sizes, all without leaving the ApostropheCMS interface. This streamlines the content creation process and empowers content creators to ensure their work looks great on any device.

Enhanced HTML Import for Content Migration

For those migrating content to ApostropheCMS, we've introduced a significant improvement to the rich text widget. This new feature allows for the direct import of raw HTML when creating or updating documents via the API. Whether you're migrating content from another platform or programmatically generating HTML, you can now seamlessly incorporate it into your ApostropheCMS documents.

Smart Defaults for Schemas

A powerful improvement to schema field handling should significantly reduce development overhead. Now, when you add a new schema field, ApostropheCMS automatically applies a default value to existing documents, even if the field didn't exist in those documents before. This enhancement greatly reduces the need for migrations when adding new fields, streamlining the development process as project requirements evolve. It's another step towards making ApostropheCMS more developer-friendly and adaptable, allowing teams to focus on creating great content and user experiences rather than managing database schemas.

Ecosystem-Wide Improvements and Fixes

We've implemented a variety of enhancements and fixes across the Apostrophe ecosystem, addressing key issues and improving overall functionality. Here are some highlights:

• Fixed issues with rearranging items in selected array views and parental relationships in the page tree, thanks to reports from our Discord community
• Improved the @apostrophecms/import-export module
• Eliminated warnings related to the new nested CSS standard for core and most extensions, benefiting those working extensively on the Apostrophe UI

These updates reflect our commitment to continual improvement based on community feedback and evolving web standards. For a comprehensive list of additional fixes and improvements, please refer to the detailed release notes below.

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

Apostrophe 4.8.0

Adds

• Adds a mobile preview feature to the admin UI. The feature can be enabled using the @apostrophecms/asset module's new breakpointPreviewMode option. Once enabled, the asset build process will duplicate existing media queries as container queries. There are some limitations in the equivalence between media queries and container queries. You can refer to the CSS @container at-rule documentation for more information. You can also enable breakpointPreviewMode.debug to be notified in the console when the build encounters an unsupported media query.
• Apostrophe now automatically adds the appropriate default values for new properties in the schema, even for existing documents in the database. This is done automatically during the migration phase of startup.
• Adds focus states for media library's Uploader tile.
• Adds focus states file attachment's input UI.
• Simplified importing rich text widgets via the REST API. If you you have HTML that contains img tags pointing to existing images, you can now import them all quickly. When supplying the rich text widget object, include an import property with an html subproperty, rather than the usual content property. You can optionally provide a baseUrl subproperty as well. Any images present in html will be imported automatically and the correct figure tags will be added to the new rich text widget, along with any other markup acceptable to the widget's configuration.

Changes

• The various implementations of newInstance found in Apostrophe, e.g. for widgets, array items, relationship fields and documents themselves, have been consolidated in one implementation. The same code is now reused both on the front and the back end, ensuring the same result without the need to introduce additional back end API calls.

Fixes

• Apostrophe's migration logic is no longer executed twice on every startup and three times in the migration task. It is executed exactly once, always at the same point in the startup process. This bug did not cause significant performance issues because migrations were always only executed once, but there is a small performance improvement due to not checking for them more than once.
• The @apostrophecms/page module APIs no longer allow a page to become a child of itself. Thanks to Maarten Marx for reporting the issue.
• Uploaded SVGs now permit <use> tags granted their xlink:href property is a local reference and begins with the # character. This improves SVG support while mitgating XSS vulnerabilities.
• Default properties of object fields present in a widget now populate correctly even if never focused in the editor.
• Fixed the "choices" query builder to correctly support dynamic choices, ensuring compatibility with the piecesFilters feature when using dynamic choices.
• Fix a reordering issue for arrays when dragging and dropping items in the admin UI.
• The inline array item extract the label now using title as titleField value by default (consistent with the Slat list).

4.7.1 (2024-09-20)

Fixes

• Ensure parked fields are not modified for parked pages when not configured in _defaults.

Apostrophe modules

@apostrophecms/favicon 1.1.1

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.

Adds

• Adds AI-created and community-reviewed translation strings.

@apostrophecms/form-submission-google 1.0.2

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

• Edits README and package description. No code changes.

• Adds AI-created and community-reviewed translation strings.

@apostrophecms/import-export 2.4.1

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

Fixes

• Fixes SASS warnings.
• Fixes a bug where related documents were not exported if they were only in one (draft or published) mode.
• Fixes a bug where additional crops of an image were not imported properly when the image was already present on the receiving site.
• Clean up timers on instance destroy.

Changes

• Update devDependencies.

@apostrophecms/login-hcaptcha 1.2.1

This login verification module adds a hCaptcha check when any user logs into the site.

Adds

• Adds AI-created and community-reviewed translation strings.

@apostrophecms/passport-bridge 1.2.1

apostrophe-passport works together with passport-google-oauth20, passport-gitlab2 and similar passport strategy modules to let users log in to Apostrophe CMS sites via Google, Gitlab and other identity providers. This feature is often called federation or single sign-on.

Adds

• Adds AI-created and community-reviewed translation strings.

@apostrophecms/redirect 1.4.2

Manages site redirects for Apostrophe.

Adds

• Adds AI-created and community-reviewed translation strings.

Pro modules

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

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.

Changes

• Updates useAction to wait a bit (before clicking the menu trigger) to prevent errors.

@apostrophecms-pro/data-set 2.0.1

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.

Fixes

• Fixes SASS warnings and lint issues.

Changes

• Update devDependencies.

@apostrophecms-pro/doc-template-library 2.2.1

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. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Fixes

• Fixes SASS warnings and lint issues.

Changes

• Update devDependencies.

@apostrophecms-pro/document-versions 2.3.1

This module automatically creates versions for your published documents (pages and pieces) and allows manual restore to any previously saved document version. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Fixes

• Fixes SASS warnings.

Changes

• Update devDependencies.

@apostrophecms-pro/import-export-translation 1.0.3

The purpose of this module is to create a specialized JSON file containing the text of the site, which can be downloaded and manually edited into a different language before being imported into a new locale. Upon import, pages from the default locale will be localized into the new locale substituting the translated text.

Changes

• Bump stylelint-config-apostrophe in order to prevent having mixed-decls warnings from Sass.

1.0.2 (2024-09-20)

Fixes

• Doc template library templates are not exported anymore. The task of this module is to facilitate one pass of human translation when content has been published.
• Sends correct req.mode when importing to not confuse the core localize module. This fixes notfound errors in some edge cases.

1.0.1 (2024-09-16)

Fixes

• Fixes skipping documents when they are missing the archived prop.

@apostrophecms-pro/palette 4.3.1

An in-context interface for changing CSS. @apostrophecms-pro/palette is a module that provides an in-context interface for changing the values of developer-set CSS properties. The values are stored in an Apostrophe piece singleton (like @apostrophecms/global) and applied to the site whenever the stylesheet link is included in a template. Adjusting values via the palette interface renders changes to the site instantly. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Fixes

• Fixes SASS warnings and lint issues.
• Fix unhandled rejection (Vue) when login as a guest.
• Fix color picker partially hidden.

Changes

• Update devDependencies.

@apostrophecms-pro/seo-assistant 1.1.0

The SEO Assistant module generates SEO page metadata automatically through the use of AI. It comes configured for use with the OpenAI models. It is also possible to configure your own providers, see related section. This extension requires that the project also have th @apostrophecms-pro/automatic-translation and apostrophecms/seo extensions installed. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Fixes

• Fixes the method that determines the locale for the system prompt to not always default to en.

Changes

• Bump stylelint-config-apostrophe in order to prevent having mixed-decls warnings from Sass.

@apostrophecms-pro/signup 2.0.1

A seamless solution that empowers users to easily create accounts on your website. Users can sign up in a few simple steps, complete with email verification and pre-determined user role and access level. Explore our documentation to discover how this extension can enhance your project. Then, effortlessly integrate it through our new Apostrophe Workspaces. For further details or inquiries, feel free to contact us or visit our pricing page.

Fixes

• Fixes SASS warnings.

Changes

• Update devDependencies.

Utilities

sanitize-html 2.13.1

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

Fixes

• Fix to allow regex in allowedClasses wildcard whitelist. Thanks to anak-dev.

@apostrophecms/stylelint-config-apostrophe 4.2.0 (2024-09-24)

This module provides a stylelint configuration for the Apostrophe team and contributors.

Changed

• Replace deprecated at-import-partial-extension with load-partial-extension.
• Add "custom/require-nested-after-include" rule to enforce the new Sass "Mixed Declarations" rule (see https://sass-lang.com/documentation/breaking-changes/mixed-decls/).

uploadfs 1.22.7 (2024-09-24)

uploadfs copies files to a web-accessible location and provides a consistent way to get the URLs that correspond to those files. uploadfs can also resize, crop and autorotate uploaded images. uploadfs includes S3-based, Azure-based, GCS-based and local filesystem-based backends and you may supply others.

Changes

• .mp3 does not benefit from gzip encoding and the transfer encoding header fails to be sent, so do not use it.