Apostrophe 4.4.1 SEO Assistant, Shortcut improvements, and more

[BoDonkey]

Hola JavaScript Aficionados!

Our latest release is here with a sparkling new AI-powered SEO Assistant, better accessibility, and a bunch of fixes to keep things running smoothly. Get ready to explore the coolest updates and enhancements designed to make your content creation experience even better. Let's dive into the latest and greatest from ApostropheCMS!

The new SEO assistant

This release sees an addition to our growing family of AI-powered extensions. Joining our existing extensions that allow the generation of content and images for rich text areas on the page, plus assist in translation during page localization, the new SEO assistant extension uses AI magic to generate meta titles and descriptions for your content to make sure it gets seen!!

Digging a bit into the installation instructions for this extension you will see that it depends on the @apostrophecms-pro/automatic-translations extension. Moving forward, we are planning on making structural changes to more completely integrate AI services into Apostrophe, paving the way for even more powerful features and easier configuration in the future.

Shortcut and accessibility improvements

Those using the shortcut keys from the command menu (accessed by typing ?) might see some changes in key assignments. Some Apostrophe extensions and menu items didn't have shortcut keys assigned, occasionally leading to conflicts. These conflicts have been resolved and additional key combos have been added to make keyboard navigation a little easier. Look for more accessibility improvements in the upcoming cycles!

Content import and export

Last cycle we released the new @apostrophecms/import-export extension. In this release we have added support for adding a key column to your import CSV file, allowing you to update existing pieces. With this new feature the new extension now incorporates all the functionality offered by the individual @apostrophecms/piece-type-importer and @apostrophecms/piece-type-exporter extensions. These extensions will be deprecated, and we encourage you to switch to this new extension.

Fixes

Even with a plethora of Mocha and Cypress tests, sometimes bugs slip through the cracks. We love feedback from developers and content managers, whether on Discord, our Roadmap, or through support tickets about bugs they are experiencing. In this cycle we have tackled some issues with the rich-text-widget, duplication of slugs in the page tree, and changing values when converting to read-only fields.

Check out the release notes below for additional fixes and improvements. Remember npm update gets you the latest and greatest right in your project!

Apostrophe 4.4.1

Fixes

• Depend on stylelint-config-apostrophe properly via npm, not github.

4.4.0 (2024-06-12)

Adds

• Adds a pinia store to handle modals logic.
• Methods from the store are registered on apos.modal instead of methods from TheAposModals component.
• No more need to emit safe-close when defining an AposModal, modal is automatically resolved when closed.
• Adds field components access to the reactive document value.
• Expose AposContextMenu owned method for re-calculation of the content position.
• Field Meta components of slug and string types can now fire replace-field-value events with text value payload, which will replace the respective field value.
• AposInputString now accepts a rows prop, in effect only when field.textarea is set to true.
• Add T,S shortcut to open the Personal Settings.
• Add T,D shortcut to open the Submitted Drafts.
• Add a scrollbar to the shortcut list.
• Add breadcrumbs to search results page.
• Pages relationships have now their checkboxes disabled when max is reached.

Changes

• Improves widget tabs for the hidden entries, improves UX when validation errors are present in non-focused tabs.
• When moving a page, recognize when the slug of a new child
  already contains the new parent's slug and not double it.
  For example, given we have two pages as children of the home page, page A and page B.
  Page A and page B are siblings.
  Page A has the slug /peer and page B has the slug /peer/page.
  Now we want page B to be the child of page A.
  We will now end up with page B slug as /peer/page and not /peer/peer/page as before.
• AposSpinner now respects the colors for heavy weight mode and also accepts second, "light" color in this mode. Props JSDoc blocks are added.
• AposContextMenu now respects the menuOffset component property.
• Set G,Shift+I shortcut to open the Image Tags manager modal.
• Set G,Shift+F shortcut to open the File Tags manager modal.
• Remove slug from suggestion for images.
• Increase suggestion search image size to 50px.
• For suggestions with image, keep title on a single line and truncate title field with ... when it hits the right side.

Fixes

• Rich Text editor properly unsets marks on heading close.
• Widget client side schema validation.
• Allow G,Shift+I shortcut style.
• Detect shortcut conflicts when using multiple shortcuts.
• Updating schema fields as read-only no longer reset the value when updating the document.
• Fixes stylelint config file, uses config from our shared configuration, fixes all lint errors.
• Removes $nextTick use to re render schema in AposArrayEditor because it was triggering weird vue error in production. Instead, makes the AposSchema for loop keys more unique using modelValue.data._id, if document changes it re-renders schema fields.
• Fixes TheAposCommandMenu modals not computing shortcuts from the current opened modal.
• Fixes select boxes of relationships, we can now check manually published relationships, and AposSlatList renders properly checked relationships.
• Fixes issues in AposInputArray on production build to be able to add, remove and edit array items after required error.
• Relationships browse button isn't disabled when max is reached.
• In media manager image checkboxes are disabled when max is reached.
• Fixes tiptap bubble menu jumping on Firefox when clicking on buttons. Also fixes the fact that double clicking on bubble menu out of buttons would prevent it from closing when unfocusing the rich text area.
• In media manager images checkboxes are disabled when max is reached.
• Makes the final fields accessible in the media manager right rail.

Apostrophe 3.67.0

Changes

• When moving a page, recognize when the slug of a new child
  already contains the new parent's slug and not double it.
  For example, given we have two pages as children of the home page, page A and page B.
  Page A and page B are siblings.
  Page A has the slug /peer and page B has the slug /peer/page.
  Now we want page B to be the child of page A.
  We will now end up with page B slug as /peer/page and not /peer/peer/page as before.

Fixes

• Updating schema fields as read-only no longer reset the value when updating the document.

Apostrophe modules

@apostrophecms/import-export 2.1.0

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

Adds

• Add the possibility to set a key column in your import CSV file in order to update existing pieces and pages.
  Thanks to this, this module reaches parity with the deprecated @apostrophecms/piece-type-importer module.

Fixes

• We can now import pieces or pages with an import file that contains just the required fields.

@apostrophecms/form 1.4.0

Allow ApostropheCMS editors to build their own forms. They can then place any form in one or more content areas across the website.

Changes

• Set keyboard shortcut to G then O.

Pro modules

@apostrophecms-pro/automatic-translation 1.1.0

This bundle allows automatic translation of documents (pages and pieces) when localizing content. It comes with two translation providers: Google Cloud Translation and DeepL, but it is also possible to configure your own providers. 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.

Adds

• Adds option enabled (true by default) to enable or disable the module.

@apostrophecms-pro/doc-template-library 2.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. 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.

Changes

• Set keyboard shortcut to T then T.
• Indicate in content type dropdown help message that missing types may be due to a permission configuration.
• Uses new methods from manager mixin to manage checked docs.

@apostrophecms-pro/document-versions 2.3.0

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.

Changes

• Updates AposDocVersions.vue to use the new pinia store to get the modals stack.

@apostrophecms-pro/palette 4.2.0

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.

Changes

• Set keyboard shortcut to T then P.

@apostrophecms-pro/multisite-dashboard 1.1.0

This extension creates the new default multisite dashboard with infinite scroll, search functionality, and the ability to save templates. This extension requires that the project also have the @apostrophecms-pro/multisite extension installed and configured. Explore our documentation to discover how this extension can enhance your project. For further details or inquiries, feel free to contact us or visit our pricing page.

Adds

• CI running lint.

Changes

• Reorganizes DOM and style to avoid resizing the create site button when resizing window.
• Hides create site button when user has no create permission for sites.
• Updates logo field aspect ratio and min size. renders logo widget from server.
• Request sites with draft mode to avoid weird bugs when getting draft images.

@apostrophecms-pro/seo-assistant 1.0.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.

Adds

• Initial release

Utilities

@apostrophecms/stylelint-config-apostrophe 4.1.0

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

Added

• Include postcss-scss to parse Scss files correctly

Changed

• Allows % unit for border-radius.
• Allows imports before $ variables in blocks.
• Allows unset for any property checked in scale-unlimited/declaration-strict-value

uploadfs 1.22.4 (2024-06-11)

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

• Use latest rimraf package, silencing a deprecation warning.