Add release notes for 4.5.0

source/conf.py

@@ -29,7 +29,7 @@
 # The short X.Y version.
 version = u'current'
 # The full version, including alpha/beta/rc tags.
-release = u'4.4.4'
+release = u'4.5.0'
 
 
 # -- General configuration ---------------------------------------------------

source/index.rst

@@ -1,5 +1,5 @@
 :is-up-to-date: True
-:last-updated: 4.4.7E
+:last-updated: 4.5.0
 
 ########################
 CrafterCMS Documentation
@@ -71,7 +71,7 @@ CrafterCMS is used by three main constituencies:
 =========================
 Latest CrafterCMS Release
 =========================
-The latest community version of CrafterCMS is `4.4.4 <https://craftercms.com/download>`__ and the latest
+The latest community version of CrafterCMS is `4.5.0 <https://craftercms.com/download>`__ and the latest
 enterprise version is ``4.4.7E``.
 
 Start exploring the latest version of CrafterCMS in a few minutes using Docker by simply running the following command:

source/reference/modules/studio.rst

@@ -1,5 +1,5 @@
 :is-up-to-date: True
-:last-updated: 4.4.3
+:last-updated: 4.5.0
 
 .. highlight:: xml
 
@@ -3202,7 +3202,7 @@ The following section of Studio's configuration overrides allows you to configur
     # studio.validation.regex.USERNAME: "^[a-zA-Z][\\w.\\-@+]+$"
     # studio.validation.regex.GROUP_NAME: "^[a-zA-Z][\\w.\\-]*$"
     # studio.validation.regex.ALPHANUMERIC: "^[a-zA-Z0-9]*$"
-    # studio.validation.regex.SEARCH_KEYWORDS: "^[\\w\\s\\-\\\"\\.\\*]*$"
+    # studio.validation.regex.SEARCH_KEYWORDS: "^[\\w\\s\\-\\\"\\'\\.!@#$%&\\*\\/\\(\\)\\[\\]\\p{IsLatin}]*$"
     # studio.validation.regex.CONTENT_PATH_WRITE: "^/?([\\w\\- ]+/?)*(((crafter\\-level\\-descriptor\\.level)|([\\w\\- ]))+\\.[\\w]+)?$"
     # studio.validation.regex.CONTENT_PATH_READ: "^/?([\\w\\p{IsLatin}@$%^&{}\\[\\]()+\\-=,.:~'`]+(\\s*[\\w\\p{IsLatin}/@$%^&{}\\[\\]()+\\-=,.:~'`])*(/?))*$"
     # studio.validation.regex.CONTENT_FILE_NAME_WRITE: "^((crafter\\-level\\-descriptor\\.level)|([a-z0-9_\\-])+)\\.xml$"

source/release-notes/4-5-0.rst

@@ -0,0 +1,81 @@
+.. index:: CrafterCMS version 4.5.0 Release Notes
+
+------------------------
+CrafterCMS Version 4.5.0
+------------------------
+
+Released *TBD, 2025*
+
+.. important::
+
+    Please see :ref:`Breaking changes <breaking-changes-4-x>` for breaking changes and other
+    things to consider before upgrading
+
+    For instructions on how to update your CrafterCMS install, please see :ref:`upgrading-craftercms`
+
+^^^^^^^^^^^^
+New Features
+^^^^^^^^^^^^
+* New Groovy sandbox whitelists |br|
+  See :ref:`Deployer Groovy Sandbox <deployer-groovy-sandbox-configuration>`,
+  :ref:`Engine Groovy Sandbox <groovy-sandbox-configuration>` and
+  :ref:`Studio Groovy Sandbox <studio-groovy-sandbox-configuration>` for more information on configuring the whitelists.
+
+* Improved serverless performance |enterpriseOnly| |br|
+  Improved startup and first page load speeds by using Redis/ValKey as a cache in front of S3.
+
+* `New maintenance mode to lock non-admin end users out of Studio during maintenance <https://github.com/craftercms/craftercms/issues/5652>`__ |enterpriseOnly| |br|
+  See :ref:`settings` for more information on enabling/disabling maintenance mode in Crafter Studio and
+  :ref:`author-maintenance-mode` for the screens displayed during maintenance mode.
+
+  Using the API :base_url:`Set system maintenance mode status <_static/api/studio.html#tag/system/operation/setMaintenanceMode>`
+  also allows you to enable/disable maintenance mode.
+
+^^^^^^^^^^^^
+Enhancements
+^^^^^^^^^^^^
+* `New configurable properties for search connection pool max values for total connections and connections per route <https://github.com/craftercms/craftercms/issues/8344>`__ |br|
+  See the :ref:`Deployer <deployer-search-connection-pool>`, :ref:`Engine <engine-search-connection-pool>`,
+  and :ref:`Studio <studio-search>` search configuration sections for more information.
+
+* `Improved query performance and OpenSearch caching <https://github.com/craftercms/craftercms/issues/8350>`__ |br|
+  CrafterCMS by default now excludes disabled and expired content from search results via default filters. See :ref:`engine-search-default-filters` for more 
+  information on enabling/disabling the default filters.
+
+* `Search input field is now in focus when clicking the search button <https://github.com/craftercms/craftercms/issues/8352>`__
+
+^^^^^^^^^
+Bug Fixes
+^^^^^^^^^
+* `Fixed issue with repeating group control <https://github.com/craftercms/craftercms/issues/8355>`__
+
+* `Fixed issue with deleting a renamed folder <https://github.com/craftercms/craftercms/issues/8354>`__
+
+* `Fixed issue with Studio UI breaking when searching for a user with [SA] in the name <https://github.com/craftercms/craftercms/issues/8351>`__ |br|
+  Square brackets are now allowed by default in search queries. To allow other characters not permitted by default in search queries,
+  simply modify the ``studio.validation.regex.SEARCH_KEYWORDS`` property in the Studio :ref:`Global Config <nav-menu-global-config>`.
+
+  See :ref:`studio-validations-regex` to learn more on configuring the regex for validating user names to suit your needs.
+
+* Fixed issue with the load order for BouncyCastle jars
+
+* Fixed issue with unmapped user groups during SSO login
+
+^^^^^^^^^^^^^^^^^^
+Dependency Updates
+^^^^^^^^^^^^^^^^^^
+* Noteworthy dependency updates:
+
+  - Spring security to version 6.5.7
+  - Spring Core to version 6.2.15
+  - Tomcat to version 11.0.15
+  - Mariadb4j to version 3.1.0.5
+  - OpenSearch to version 3.3 |br|
+    Please see :ref:`breaking-changes-in-craftercms-4-5-0` for some important changes in OpenSearch 3.3
+
+For a complete list of community tickets, please visit: `GitHub 4.5.0 <https://github.com/orgs/craftercms/projects/34/views/1>`_
+
+For information on upgrading 3.1.x sites, see :ref:`here <compatibility-with-3.1.x>`
+
+|hr|
+

source/release-notes/4-x-breaking-changes.rst

@@ -1,5 +1,5 @@
 :is-up-to-date: True
-:last-updated: 4.4.4
+:last-updated: 4.5.0
 :orphan:
 
 .. _breaking-changes-4-x:
@@ -23,6 +23,41 @@ before upgrading. Please review the following and apply changes as required:
 
 |hr|
 
+.. _breaking-changes-in-craftercms-4-5-0:
+
+------------------------------------
+Breaking Changes in CrafterCMS 4.5.0
+------------------------------------
+- OpenSearch 3 has removed the **_toQuery()** method from the ``QueryVariant`` interface. ``QueryVariant`` is the base for
+  Query variants, e.g.: BoolQuery, FuzzyQuery, MatchQuery, etc.
+
+  Search-related Groovy scripts might need to be updated to use **toQuery()** instead. Below is an example of a query
+  that will need to be updated:
+
+  .. code-block:: groovy
+      :caption: *Sample OpenSearch 2.x _toQuery() method that needs to be updated*
+      :emphasize-lines: 2
+
+      SearchRequest request = SearchRequest.of(r -> r
+			.query(query.build()._toQuery())
+			.from(start)
+			.size(rows)
+			.highlight(highlighter.build())
+		)
+
+  Here's the updated query:
+
+  .. code-block:: groovy
+      :caption: *Updated query with OpenSearch 3.x toQuery() method*
+      :emphasize-lines: 2
+
+      SearchRequest request = SearchRequest.of(r -> r
+			.query(query.build().toQuery())
+			.from(start)
+			.size(rows)
+			.highlight(highlighter.build())
+		)
+
 .. _breaking-changes-in-craftercms-4-4-3:
 
 ------------------------------------
@@ -31,6 +66,8 @@ Breaking Changes in CrafterCMS 4.4.3
 CrafterCMS version 4.4.3 works with JavaScript SDK version 5.0.0 and later. See :ref:`compatibility-with-craftercms-version`
 for more information.
 
+|hr|
+
 .. _breaking-changes-in-craftercms-4-4-0:
 
 ------------------------------------

source/release-notes/index.rst

@@ -1,5 +1,5 @@
 :is-up-to-date: True
-:last-updated: 4.4.7E
+:last-updated: 4.5.0
 
 .. _release-notes:
 
@@ -11,6 +11,7 @@ version release's release notes page :ref:`below <other-release-notes>`
 
 .. note:: CrafterCMS requires Java 21
 
+.. include:: /release-notes/4-5-0.rst
 .. include:: /release-notes/4-4-7e.rst
 .. include:: /release-notes/4-4-6e.rst
 .. include:: /release-notes/4-4-5e.rst

source/support.rst

@@ -1,5 +1,5 @@
 :is-up-to-date: True
-:last-updated: 4.4.7E
+:last-updated: 4.5.0
 
 .. index:: Support
 
@@ -21,7 +21,12 @@ What's Supported?
       - Commercial Support
       - Latest
 
-    * - `4.4 <https://craftercms.com/download>`__
+    * - `4.5 <https://craftercms.com/download>`__
+      - TBD, 2025
+      - :green:`Active`
+      - :green:`Active`
+      - 4.5.0 (TBD, 2025)
+    * - 4.4
       - June 13, 2025
       - :green:`Active`
       - :green:`Active`