Skip to content

CHANGELOG.md

Latest commit

 

History

History
195 lines (109 loc) · 7.54 KB

CHANGELOG.md

File metadata and controls

195 lines (109 loc) · 7.54 KB
Raw

Changelog

1.13.0 (2026-06-10)

Fixes

  • Adding or removing an area field from a schema no longer breaks documents on an external front such as Astro.
  • AposArea now renders only schema-backed areas. A missing area no longer throws, and an area orphaned by removing its field from the schema (while its content remains in the document) renders nothing instead of breaking sibling areas in edit mode. Logged-in editors get a diagnostic message in place of an orphaned area; anonymous visitors see nothing.
  • Editable documents sent to an external front now materialize empty area objects for schema area fields added after the document was created, so they can be edited in context.
  • apos.util.getManagerOf accepts a { log } option to suppress its error log when probing objects that may not have a manager.

1.12.0

Adds

  • Editors can now control the layout-widget gap through the styles system, both site-wide via a global layoutGap preset and per widget via a gap styles field. New Layout widget option className allows for additional CSS class names to be added to the widget Grid container.
  • Log aposResponse errors server side in the Astro process. Thanks to Harouna Traore.

1.11.0 (2026-04-15)

Adds

  • The writeAttachments step now supports per-entry base URL resolution, correctly downloading and writing pretty URL files to the appropriate output directory (e.g. dist/files/). A new attachmentFilter option ('all' or 'prettyOnly') lets you skip regular uploadfs attachments when those are served by a CDN while still including backend-served pretty URL files in the static output. Configurable via the staticBuild.attachmentFilter integration option or the APOS_ATTACHMENT_FILTER environment variable.

Changes

  • Refactor after core changes done to the internal layout data.

1.10.0 (2026-03-19)

Adds

  • Adds support for static builds. Introduces relevant helpers.

1.9.0 (2026-02-18)

Adds

  • Add RTL support for Astro applications

Fixes

  • Handle correctly HEAD page requests

1.9.0-alpha.1

Adds

  • Add RTL support for Astro applications

1.8.0

Adds

  • Add global styles and widget styles support
  • Adds onBeforeWidgetRender hook

1.7.1 (2025-11-25)

  • Add support for sluggo options in the slugify util helper and stripAccents option to remove accents from characters.

1.7.0 (2025-10-30)

Adds

  • Refactor AposArea to accept custom style, class, and attributes, but also a widgetComponent prop. The latter is allowing for custom widget rendering components to be used. This is particularly useful for complex widgets like the Layout widget that need to render the output in particular order/way.
  • Introduce LayoutWidget.astro and LayoutColumnWidget.astro components to be used in the project level widget mapping.
  • Adds new AposRenderAreaForAstro component, specifically designed to be used to implement the new /api/apos-external-frontend/render-area route. This allows section template library previews to work in Astro projects and also enables calling the ApostropheCMS REST APIs with ?render-area when using Astro on the front end. See the documentation for more information on adding this route to existing projects.

1.6.0 (2025-10-01)

Adds

  • Adds additional handling for the @apostrophecms/anchors module to the AposWidget.astro component
  • Adds handling for project-level widget options, as well as actually passing per-area options to widgets. Can be accessed through the options prop in the widget components.
  • Add support for prependMain and appendMain in the aposData object, allowing for custom HTML to be injected into the <main> sections of the layout.

Fixes

  • Verify that Host header is correctly formatted.

1.5.2 (2025-09-09)

Fixes

  • Corrected the link to the astro apollo pro starter kit in the documentation.

1.5.1 (2025-09-08)

Changes

  • Guide developers to our actively supported starter kits.

1.5.0 (2025-08-06)

Adds

  • Add support for prependHead, appendHead, prependBody, and appendBody in the aposData object, allowing for custom HTML to be injected into the <head> and <body> sections of the layout.

Fixes

  • Handle deep schema validation errors when rendering widgets, so that a message is displayed in the widget preview instead of a crash.

1.4.0 (2025-06-11)

Adds

  • Add util (currently containing only slugify) and attachment helpers to mimic Apostrophe's Nunjucks helpers.

Fixes

  • Fix duplicate function that breaks project builds.

1.3.1 (2025-05-23)

Fixes

  • Fix a bug when the Astro app can crash due to live widget preview in some cases.

1.3.0 (2025-04-16)

Adds

  • Add support for decoding the response body needed for some hosting added to the aposResponse.js.

1.2.1 (2025-03-19)

Fixes

  • The lang attribute of the <html> tag now respects localization.

1.2.0 (2025-01-27)

Changes

  • The configuration array for headers passed from Apostrophe to the browser has been changed from forwardHeaders to includeResponseHeaders with BC maintained.
  • A new configuration option excludeRequestHeaders has been added to allow exclusion of headers like host being sent from the browser to Apostrophe.
  • The README.MD has been updated with the new configuration options.
  • Clearer error messages have been added to indicate that either the backend server has not been started, or that the APOS_EXTERNAL_FRONT_KEY strings don't match.

1.1.0 (2024-11-20)

Adds

  • Add support for automated bundles injection in Edit (apos) mode, required for supporting the new core "manifest" builds (when available).

1.0.9 (2024-10-23)

  • Prevent the Connection: Upgrade header from breaking Astro's fetch calls to Apostrophe when hosted in an environment that permits websocket upgrades of existing connections.
  • Refactored redundant code for building requests with the external front key, etc.

1.0.8 (2024-07-02)

  • The renderWidget route will no longer crash if there was an issue getting the render-widget route from Apostrophe (like a mandatory field missing), it will respond with a 500 only, with a log message in the console. Thanks to Michelin for contributing this fix.

1.0.7 (2024-03-28)

  • Visiting the /login page when already logged in no longer results in an undesired direct response from Apostrophe. Redirects within api routes like the login issued on the Apostrophe side are now sending a redirect response as per Astro endpoints documentation.
  • Page refreshes no longer alternate between displaying the admin UI and not displaying it with each refresh in certain configurations.
  • Thanks to Michelin for collaborating on the solution.

1.0.6 (2024-03-26)

  • Change the way we fetch from Apostrophe by using undici request method, so as all headers are correctly forwarded. As on latest Node.js versions, headers like Host are no more forwarded by the regular fetch global method.

1.0.5 (2024-02-07)

  • 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.

1.0.4 (2024-01-22)

  • Documentation fixes only.

1.0.3 (2023-12-27)

  • Documentation typo that impacts Linux and other case sensitive systems fixed.

1.0.2 (2023-12-22)

  • Fix bug causing pages to crash after refresh if widget grouping is used.

1.0.1 (2023-12-21)

  • Fix bug impacting two-column widgets.

1.0.0 (2023-12-21)

  • Initial release.