Release Notes
This section contains release notes for CrafterCMS 4.0.x. For other release notes, please visit your release’s release notes page here: https://docs.craftercms.org
Note
CrafterCMS 4.0.x requires Java 11
CrafterCMS 4.0.2
Released October 25, 2022
This release includes fixes for issues with the release version 4.0.1
New Features
New publishing on demand option to
Publish everything
See here for more informationFor more information on the new publishing on demand option, see Publish all changes on the repo
Items in an item selector now displays the item’s path in the form control
See here for more information
Updates
Upgraded the following dependencies:
- Apache Commons Configuration to version 2.8.0
- Hazelcast to version 5.1.3
- Snakeyaml to version 1.33
- Mockito to version 4.8.0
- Jackson (and related) to version 2.13.4
- GraphQL to version 17.4
Added cache control support to proxy configuration
See here for more informationFixed issue with page URL validation check
See here for more informationFixed issue with
parentPath
macro in embedded components
See here for more informationFixed issue with Studio search filters
See here for more informationFixed issue with publishing hard and soft dependencies
See here for more informationAdded an indicator while duplicating content is in progress
See here for more informationFixed issue with
STUDIO_TOKEN_VALID_ISSUERS
env variable
See here for more informationUpdated documentation for Engine’s preview mode
See here for more informationFixed issue when duplicating pages with images
See here for more informationAdded icon at the top right section of image preview dialog for switching background modes
See here for more informationFixed issue with group checkboxes control
See here for more informationFixed issue with deployment events watcher
See here for more informationUpdated Policy Engine configuration
The Policy Engine configuration by default now replaces parenthesis with dashes. See here for more informationFor more information on project policy configuration, see here
Fixed issue with DB connection resets
See here for more informationRenamed
Drop Targets
data source toComponents
andProject Component
data source toSimple Taxonomy
Enhanced Crafter Studio clustering
Fixed issue with branding image files in upgrade scripts
Lots of other small enhancements and bug fixes :)
For a full list of tickets, please visit: GitHub 4.0.2 Milestone
For information on upgrading 3.1.x sites, see here
Important
Please see Breaking changes for breaking changes and other things to consider before upgrading
For instructions on how to update your CrafterCMS install to 4.0.0 (applies to 4.0.2), please see Upgrading CrafterCMS
When using private key SSH authentication in the init-site.sh
script, the private key path must be set explicitly.
Please see Setup Project for a Delivery Environment for more information on using the -k
option of init-site.sh
to
set the private key path
For Linux installs, the Studio upgrade requires the library libaio
which is not installed
by default in some Linux distributions. Please see the section on Linux Prerequisites
in Linux Prerequisite for instructions on how to install the library libaio
CrafterCMS 4.0.1
Released July 27, 2022
This release includes fixes for issues with the release version 4.0.0
New Features
New publisher review workflow option
See here for more informationFor more information on the new publisher review workflow option, see Requiring Peer Review for Publishing
Configurable site cookie domain as base or sub
See here for more informationFor more information on setting the
crafterSite
cookie at the base domain instead of a subdomain see: crafterSite Cookie Domain
Updates
- Added documentation on how to upgrade from ICE to XB
For more information on how to move from the 3.x ICE system to the 4.x Experience Builder (XB) system, see Upgrading In Context Editing - Upgraded the following dependencies:
- Spring to version 5.3.22
- Spring Boot to version 2.7.1
- Spring Security to version 5.7.2
- Jackson (and related) to version 2.13.3
- Tomcat to version 9.0.64
- JGit to version 6.2.0.202206071550-r
- Improved asset panel to show full path on hover or as part of card
See here for more information - Fix cache clearing issue with the deployment events watcher
See here for more information - Fixed issue with files containing parenthesis in its name
See here for more information - Fixed issue when opening the Pages sidebar cabinet in the sidebar
See here for more information - Fixed issue with XB component default value properties
See here for more information - Fixed issue when inserting a component via XB drag-drop with
&
in the default value of a field
See here for more information - Improved debug logging for token validation
See here for more information - Improved message for unsupported browsers
See here for more information - Fixed issue when dragging and dropping a component with an ampersand
See here for more information - Improved filtering by keyword using the
get_content_by_path
API
See here for more information - Added support for cookie domain in refresh token
See here for more information - Fixed issue reading environment specific configuration
See here for more information - Email notification enhancements
See here for more information - Fixed issue with deployment pipeline when create index fails
See here for more information - Fixed issue with renaming the URL of a page to an existing folder
See here for more information - Fixed issue with numeric input fields when using Firefox
See here for more information - Added support for specifying a root prefix for the AWS profile
See here for more information - Fixed issue displaying total amount of videos in Video Center blueprint
See here for more information - Fix publishing issue when publishing by commit ID for a merge commit
See here for more information
Lots of other small enhancements and bug fixes :)
For a full list of tickets, please visit: GitHub 4.0.1 Milestone
For information on upgrading 3.1.x sites, see here
Important
Please see Breaking changes for breaking changes and other things to consider before upgrading
For instructions on how to update your CrafterCMS install to 4.0.0 (applies to 4.0.1), please see Upgrading CrafterCMS
For Linux installs, the Studio upgrade requires the library libaio
which is not installed
by default in some Linux distributions. Please see the section on Linux Prerequisites
in Linux Prerequisite for instructions on how to install the library libaio
CrafterCMS 4.0.0
Released May 12, 2022
New Features
New Studio UI for Content Authors
- New Pluggable React-based UI
- Improved Sidebar
- Improved authoring search experience
- Improved user management experience
- Improved code editing
- Improved configuration management
- Improved My Projects experience
- And more…
- Experience Builder (XB) - a new In-Context Editing system:
- Edit content in-place
- Drag and drop components and assets to build and rearrange pages
- Supports projects built with FreeMarker, React, and can easily be extended to support Vue, Angular and other
UI frameworks
- Supports projects built with FreeMarker, React, and can easily be extended to support Vue, Angular and other
UI frameworks
- New Experience Builder package in the SDK here
- See Experience Builder for more information
- Edit content in-place
- New configuration mechanics of the UI that allow plugins to wire to almost every aspect of
the experience. This opens the door for having different authoring experiences per project.
- New Pluggable React-based UI
Plugins!
New plugin system allowing developers to build plugins for a project (headless or templated) that provide:
- Authoring side extensions allowing content authors new tools to build the desired experience. This includes extending Crafter Studio’s functionality with server-side code, UI widgets, third-party integration, pre-baked content model items and more. Learn all about it here
- Delivery-side extensions that provide end-user widgets, server-side code, integration with third-party providers and more. Learn about it here
- Host plugins are still supported, see here
- Plugins are starting to appear on the marketplace here
- Read the guide to building your own plugins here
Added support for a plugin to add servlet filters
See here for more informationFor more information on how to wire your plugin, see the section on a sample for a servlet filter here
Switched Crafter Studio’s authentication system to JWT
- It’s now much easier to automate work with Crafter Studio APIs by issuing secure tokens for
your automation jobs, see Working with Crafter Studio’s APIs
- Remember to replace default values for all the variables used to control the
access tokens (JWT) used for Studio’s API. See here
for more information on default values used for JWT
- It’s now much easier to automate work with Crafter Studio APIs by issuing secure tokens for
your automation jobs, see Working with Crafter Studio’s APIs
Project Content Rules and Policy
Added a project-wide policy configuration that lets site administrators control:
- File name patterns (permissioning and automatic renaming of files)
- File mime-type
- File size
See here for more information on the Project Policy configuration
New Crafter CLI
The CrafterCMS Command Line Interface (CLI) for DevContentOps, allows you to authenticate with CrafterCMS and exercise its APIs from a terminal or automation tools.
See here for more information on the Crafter CLIBetter locale support
CrafterCMS allows configuring a locale to be used for displaying dates and times in the Studio UI or, it can also be configured to respect the user’s locale settings
See Project Time Zone for more information on how to customize your project’s dates and times display
Updates
Upgraded Java to version 11
Upgraded Elasticsearch to version 7
Upgraded Tomcat to version 9
Unlock permission added and can be assigned to a role
See here for more informationAdded support for deployment mode for deployer processors
Supported modes currently arePUBLISH
andSEARCH_INDEX
. See here and here for more informationAdded support for deleting content types
See here for more informationUpdated the JavaScript SDK for in-context editing (ICE)
See https://npm.io/package/@craftercms/ice for more informationRTE improvements Added support for pasting from MS Word to RTE
Added friendly labels for content types and mime types on the search filter
See here for more informationFixed data source plugin failure when loading in content form
See here for more informationImproved visuals when search is running
See here for more informationThe entire project is now published (bulk publish) when an item is published for the very first time
See here for more informationFixed format for dates when copying
See here for more informationAdded support for regex patterns in CORS origins for Studio, Engine, Profile and Social|br|
Values in the CORS origins are split using
,
. Remember that commas inside patterns need to be escaped with a\
like:studio.cors.origins: 'http://localhost:[8000\,3000],http://*.domain1.com'
See here for more information
Lots of other small enhancements and bug fixes :)
For a full list of tickets, please visit: GitHub 4.0.0 Milestone
For information on upgrading 3.1.x sites, see here
Important
Please see Breaking changes for breaking changes and other things to consider before upgrading
For instructions on how to update your CrafterCMS install to 4.0.0, please see Upgrading CrafterCMS
For Linux installs, the Studio upgrade requires the library libaio
which is not installed
by default in some Linux distributions. Please see the section on Linux Prerequisites
in Linux Prerequisite for instructions on how to install the library libaio