From 27b21ab920c979213caf78597bf693723e9b10f5 Mon Sep 17 00:00:00 2001 From: Matt Brailsford Date: Thu, 22 Aug 2024 13:38:29 +0100 Subject: [PATCH 01/30] v14 release notes --- 14/umbraco-commerce/release-notes/README.md | 7 + 14/umbraco-commerce/release-notes/v14.0.0.md | 126 ++++++++++++++++++ .../packages/checkout/release-notes.md | 10 ++ .../packages/deploy/release-notes.md | 6 +- .../shipping-providers/dhl/release-notes.md | 10 ++ .../easypost/release-notes.md | 10 ++ .../shipmondo/release-notes.md | 10 ++ 7 files changed, 178 insertions(+), 1 deletion(-) create mode 100644 14/umbraco-commerce/release-notes/v14.0.0.md diff --git a/14/umbraco-commerce/release-notes/README.md b/14/umbraco-commerce/release-notes/README.md index f01e0a6e3fa..aa0c252fd08 100644 --- a/14/umbraco-commerce/release-notes/README.md +++ b/14/umbraco-commerce/release-notes/README.md @@ -17,6 +17,13 @@ If you are upgrading to a new major version, check the breaking changes in the [ This section contains the release notes for Umbraco Commerce 14 including all changes for this version. +#### 14.0.0 (23rd August 2024) + +Read the [v14.0.0 release post](./v14.0.0.md) for further background on this release. + +* Added "No results" messages to collection views +* Upgraded Umbraco CMS dependency to 14.2.0 + #### 14.0.0-rc3 (12th August 2024) * Added warning on store dashboard/analytics section if the store has multiple currencies when no currency exchange rate service is configured. diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md new file mode 100644 index 00000000000..30620a800cc --- /dev/null +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -0,0 +1,126 @@ +--- +description: >- + Umbraco Commerce v14.0.0 release notes. +--- + +# Umbraco Commerce v14.0.0 + +Umbraco Commerce v14.0.0 is the final release of Umbraco Commerce for Umbraco CMS v14. This release marks the v14 build of Umbraco Commerce now feature complete and ready for developers to start using it. + +## Key Takeaways + +* [New backoffice UI](#new-backoffice-ui) build with web-components. +* Some [breaking changes](#breaking-changes) to be expected. +* Brand new [Management API](#management-api). +* New more flexible [UI extension points](#ui-extension-points) added. +* New [Management API](#management-api) added. +* [Localization](#localization) support added (in progress). + +## New Backoffice UI + +As with everything v14, this is a complete rebuild of the backoffice UI using web-components. This ensures Umbraco Commerce is set for the future and creates a solid foundtion to develop new features and functionality. + +![Umbraco Commerce v14 Order Editor](../media/v14/order-editor.png) + +![Umbraco Commerce v14 Settings Section](../media/v14/store-settings.png) + +## Breaking Changes + +With the new backoffice UI, there has inevitably been the need to change some functionalities and use such breaking changes couldn't be avoided. These have tried to be minimized as much as possible, whilst also ensuring we embrace the new front end architecture to it's fullest. + +The key breaking changes to expect are: + +* **UI Config Files Removed** + + In previous versions of Umbraco Commerce it was possible to configure the back office order list view, order editor and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. See the [UI Extension Points](#ui-extension-points) section bellow for more details. + + In addition to this, the UI Config Files were also used in the backoffice to extract key order properties for things like extracting the shipping address in order to calculate shipping rates. This functionality has now been split such that this mapping functionality has now moved to a new server based configuration API. + + ``` + builder.WithOrderPropertyConfigs() + .Add("myStoreAlias", b => b + .For(x => x.Customer.FirstName).MapFrom("firstName") + .For(x => x.Customer.LastName).MapFrom("lastName") + ... + ); + ``` + +* **Web Notification Events Removed** + + The following notifications are no longer being fired. + + * `AnalyticsDashboardConfigParsingNotification` + * `CartEditorConfigParsingNotification` + * `OrderEditorConfigParsingNotification` + * `StoreActionsRenderingNotification` + * `ActivityLogEntriesRenderingNotification` + +* **Web Controllers / Models Removed** + + With the new Management API this does mean any controllers / models that previously lived in the `Umbraco.Commerce.Cms.Web` will now have been removed. Please use the Management API instead. + + The only exception to this is the `PaymentController` which is used as a callback for payment gateways. This is currently kept at the same URL to prevent breakages for any existing transaction communications, however all new integrations should communicate with a new Payments API. + +## UI Extension Points + +With the new backoffice comes a new extensions system for the UI and we have tried to use this to the maximum. These means converting the old UI configs system to using the new manifests system. + +With the new extension points it is possible to: + +* Change the properties used by the order editor. +* Add properties to the order line properties editor. +* Add properties to the Notes, Additional Info and Customer Details modals. +* Add properties to the order collection view. +* Add analytics widgets (still in progress) +* Define custom views for properties to control value rendering. + +Here is an example of how you would configure such properties + +```javascript +export const manifests : Array = [ + { + type: 'ucOrderLineProperty', + alias: 'Uc.OrderLineProperty.Color', + name: 'Order Line Color', + weight: 100, + meta: { + propertyAlias: 'color', + editorUiAlias: 'Umb.PropertyEditorUi.EyeDropper', + labelElementName: 'uc-mini-color-swatch' + } + }, + { + type: 'ucOrderLineProperty', + alias: 'Uc.OrderLineProperty.GiftMessage', + name: 'Order Line Gift Message', + weight: 100, + meta: { + propertyAlias: 'giftMessage', + editorUiAlias: 'Umb.PropertyEditorUi.TextArea', + summaryStyle: 'table' + } + } +]; +``` + +With these extension points, the Umbraco Commerce order editor is now more flexible than it has ever been before. + +{% hint style="info" %} +We are yet to launch an Umbraco Commerce NPM module so these points are not yet currently available to use externally but we wanted to give you a heads up of what is coming so you can prepare. +{% endhint %} + +## Management API + +As with the CMS, with the new UI comes a whole new API layer. + +![Umbraco Commerce Management API](../media/v14/management-api.png) + +With the Umbraco Commerce API we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible. + +A key thought whilst developing this API has been to ensure external developers might use this to build other UI's for Umbraco Commerce such as a dedicated mobile app and so we've tried to ensure there are no "special" endpoints just for the Umbraco CMS UI. + +## Localization + +One of the things that has been on the Umbraco Commerce TODO list for a while is to add backoffice localization support. Given the fresh start it was only logical that we take the time to ensure that everything we built fully supported localization so this will be included in this release. + +With this update, we have also made some changes to things like payment and shipping providers, and other CSharp extension points where we define properties. These will no longer require hard coded labels / descriptions and instead will look these values up from the localization file. diff --git a/commerce-add-ons/packages/checkout/release-notes.md b/commerce-add-ons/packages/checkout/release-notes.md index da3970a731b..6e7c54ea1e2 100644 --- a/commerce-add-ons/packages/checkout/release-notes.md +++ b/commerce-add-ons/packages/checkout/release-notes.md @@ -14,6 +14,16 @@ In this section, you can find the release notes for each version of Checkout pac
+Version 14 + +#### 14.0.0 (August 23rd 2024) + +* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. + +
+ +
+ Version 13 **13.1.0 (February 21st 2024)** diff --git a/commerce-add-ons/packages/deploy/release-notes.md b/commerce-add-ons/packages/deploy/release-notes.md index 78e345f8c74..8069a0ece6b 100644 --- a/commerce-add-ons/packages/deploy/release-notes.md +++ b/commerce-add-ons/packages/deploy/release-notes.md @@ -26,9 +26,13 @@ In this section, you can find the release notes for each version of Deploy packa Version 14 +#### 14.0.0 (August 23rd 2024) + +* Final release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. + #### 14.0.0-rc1 (August 5th 2024) -* Initial conversion for Umbraco v14 and Umbraco Commerce v14 support. +* Initial conversion for Umbraco v14.0.0 and Umbraco Commerce v14.0.0 support.
diff --git a/commerce-add-ons/shipping-providers/dhl/release-notes.md b/commerce-add-ons/shipping-providers/dhl/release-notes.md index d89adc0851f..d876ff5ba08 100644 --- a/commerce-add-ons/shipping-providers/dhl/release-notes.md +++ b/commerce-add-ons/shipping-providers/dhl/release-notes.md @@ -10,6 +10,16 @@ In this section, you can find the release notes for each version of DHL Shipping
+Version 14 + +#### 14.0.0 (August 23rd 2024) + +* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. + +
+ +
+ Version 13 #### 13.0.0 (February 21st 2024) diff --git a/commerce-add-ons/shipping-providers/easypost/release-notes.md b/commerce-add-ons/shipping-providers/easypost/release-notes.md index 9a641ae786f..c9a5e572200 100644 --- a/commerce-add-ons/shipping-providers/easypost/release-notes.md +++ b/commerce-add-ons/shipping-providers/easypost/release-notes.md @@ -10,6 +10,16 @@ In this section, you can find the release notes for each version of EasyPost Shi
+Version 14 + +#### 14.0.0 (August 23rd 2024) + +* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. + +
+ +
+ Version 13 #### 13.0.0 (February 21st 2024) diff --git a/commerce-add-ons/shipping-providers/shipmondo/release-notes.md b/commerce-add-ons/shipping-providers/shipmondo/release-notes.md index e9cc65d65de..5ca03123453 100644 --- a/commerce-add-ons/shipping-providers/shipmondo/release-notes.md +++ b/commerce-add-ons/shipping-providers/shipmondo/release-notes.md @@ -10,6 +10,16 @@ In this section, you can find the release notes for each version of Shipmondo Sh
+Version 14 + +#### 14.0.0 (August 23rd 2024) + +* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. + +
+ +
+ Version 13 #### 13.0.0 (February 21st 2024) From 4faa3df44bff7dcce781d39545c651751f62a1da Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:27:33 +0200 Subject: [PATCH 02/30] Update 14/umbraco-commerce/release-notes/README.md --- 14/umbraco-commerce/release-notes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/README.md b/14/umbraco-commerce/release-notes/README.md index aa0c252fd08..2e69ffbe5c4 100644 --- a/14/umbraco-commerce/release-notes/README.md +++ b/14/umbraco-commerce/release-notes/README.md @@ -22,7 +22,7 @@ This section contains the release notes for Umbraco Commerce 14 including all ch Read the [v14.0.0 release post](./v14.0.0.md) for further background on this release. * Added "No results" messages to collection views -* Upgraded Umbraco CMS dependency to 14.2.0 +* Upgraded Umbraco CMS dependency to v14.2.0 #### 14.0.0-rc3 (12th August 2024) From 81691effc7413cbef12d3a2c2fb3eba81362a36a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:27:43 +0200 Subject: [PATCH 03/30] Update 14/umbraco-commerce/release-notes/README.md --- 14/umbraco-commerce/release-notes/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/README.md b/14/umbraco-commerce/release-notes/README.md index 2e69ffbe5c4..bd3423fdac2 100644 --- a/14/umbraco-commerce/release-notes/README.md +++ b/14/umbraco-commerce/release-notes/README.md @@ -19,7 +19,7 @@ This section contains the release notes for Umbraco Commerce 14 including all ch #### 14.0.0 (23rd August 2024) -Read the [v14.0.0 release post](./v14.0.0.md) for further background on this release. +Read the [v14.0.0 release post](./v14.0.0.md) for more information about this release. * Added "No results" messages to collection views * Upgraded Umbraco CMS dependency to v14.2.0 From 209c745e85e25fe614948f17b0251a0c875473e3 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:27:53 +0200 Subject: [PATCH 04/30] Update commerce-add-ons/packages/deploy/release-notes.md --- commerce-add-ons/packages/deploy/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/commerce-add-ons/packages/deploy/release-notes.md b/commerce-add-ons/packages/deploy/release-notes.md index 8069a0ece6b..1bc2bbce6b0 100644 --- a/commerce-add-ons/packages/deploy/release-notes.md +++ b/commerce-add-ons/packages/deploy/release-notes.md @@ -28,7 +28,7 @@ In this section, you can find the release notes for each version of Deploy packa #### 14.0.0 (August 23rd 2024) -* Final release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. +* Release for Umbraco v14.2.0 and Umbraco Commerce v14.0.0 support. #### 14.0.0-rc1 (August 5th 2024) From f4d7a790369dd5295540dad33b525fff9d801c28 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:28:04 +0200 Subject: [PATCH 05/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 30620a800cc..a19bd346b20 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -5,7 +5,7 @@ description: >- # Umbraco Commerce v14.0.0 -Umbraco Commerce v14.0.0 is the final release of Umbraco Commerce for Umbraco CMS v14. This release marks the v14 build of Umbraco Commerce now feature complete and ready for developers to start using it. +This release marks the v14 build of Umbraco Commerce, now feature complete and ready for developers to start using it. ## Key Takeaways From b6362f4024801218a1e6ebd8f58647d622b97534 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:28:17 +0200 Subject: [PATCH 06/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index a19bd346b20..27a80dd96d7 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -18,7 +18,7 @@ This release marks the v14 build of Umbraco Commerce, now feature complete and r ## New Backoffice UI -As with everything v14, this is a complete rebuild of the backoffice UI using web-components. This ensures Umbraco Commerce is set for the future and creates a solid foundtion to develop new features and functionality. +As with everything v14, this is a complete rebuild of the backoffice UI using web components. This ensures Umbraco Commerce is set for the future and creates a solid foundation to develop new features and functionality. ![Umbraco Commerce v14 Order Editor](../media/v14/order-editor.png) From 88131db7631632c84ca533ff873b06edf26b937c Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:28:31 +0200 Subject: [PATCH 07/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 27a80dd96d7..72982774d06 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -26,7 +26,7 @@ As with everything v14, this is a complete rebuild of the backoffice UI using we ## Breaking Changes -With the new backoffice UI, there has inevitably been the need to change some functionalities and use such breaking changes couldn't be avoided. These have tried to be minimized as much as possible, whilst also ensuring we embrace the new front end architecture to it's fullest. +With the new backoffice UI, there has inevitably been the need to change some functionalities, and as such breaking changes could not be avoided. These have tried to be minimized as much as possible, whilst also ensuring we embrace the new front-end architecture to its fullest. The key breaking changes to expect are: From e13435a9bf33cf3f4c778fb0034ca8414419e54b Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:28:45 +0200 Subject: [PATCH 08/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 72982774d06..bf7078a8d2b 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -32,7 +32,7 @@ The key breaking changes to expect are: * **UI Config Files Removed** - In previous versions of Umbraco Commerce it was possible to configure the back office order list view, order editor and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. See the [UI Extension Points](#ui-extension-points) section bellow for more details. +Previously, in Umbraco Commerce, it was possible to configure the backoffice order list view, order editor, and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. For more details, see the [UI Extension Points](#ui-extension-points) section below. In addition to this, the UI Config Files were also used in the backoffice to extract key order properties for things like extracting the shipping address in order to calculate shipping rates. This functionality has now been split such that this mapping functionality has now moved to a new server based configuration API. From b247609b407483141cfd76e1fa78d40a548861f9 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:29:02 +0200 Subject: [PATCH 09/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index bf7078a8d2b..1f7b70b9e26 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -34,7 +34,7 @@ The key breaking changes to expect are: Previously, in Umbraco Commerce, it was possible to configure the backoffice order list view, order editor, and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. For more details, see the [UI Extension Points](#ui-extension-points) section below. - In addition to this, the UI Config Files were also used in the backoffice to extract key order properties for things like extracting the shipping address in order to calculate shipping rates. This functionality has now been split such that this mapping functionality has now moved to a new server based configuration API. +In addition to this, the UI config files were also used in the backoffice to extract key order properties. For example, extracting the shipping address in order to calculate shipping rates. This functionality has now been split, and the mapping functionality has been moved to a new server-based configuration API. ``` builder.WithOrderPropertyConfigs() From fccc0828df12714903d344c2355120c5e3b7a2a1 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:29:13 +0200 Subject: [PATCH 10/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 1f7b70b9e26..ce5a4a1687d 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -55,7 +55,7 @@ In addition to this, the UI config files were also used in the backoffice to ext * `StoreActionsRenderingNotification` * `ActivityLogEntriesRenderingNotification` -* **Web Controllers / Models Removed** +* **Web Controllers/Models Removed** With the new Management API this does mean any controllers / models that previously lived in the `Umbraco.Commerce.Cms.Web` will now have been removed. Please use the Management API instead. From 3344b78f37cfad4e9e7dfaa47de98c14fd4bcf9f Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:29:25 +0200 Subject: [PATCH 11/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index ce5a4a1687d..2f1e99eb84f 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -57,7 +57,7 @@ In addition to this, the UI config files were also used in the backoffice to ext * **Web Controllers/Models Removed** - With the new Management API this does mean any controllers / models that previously lived in the `Umbraco.Commerce.Cms.Web` will now have been removed. Please use the Management API instead. + With the new Management API, any controllers or models previously located in `Umbraco.Commerce.Cms.Web` have been removed. Please use the **Management API** instead. The only exception to this is the `PaymentController` which is used as a callback for payment gateways. This is currently kept at the same URL to prevent breakages for any existing transaction communications, however all new integrations should communicate with a new Payments API. From 4763419a02d6f4335d4ff9d11afed1d063c54e4a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:29:39 +0200 Subject: [PATCH 12/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 2f1e99eb84f..d3ff46728ce 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -59,7 +59,7 @@ In addition to this, the UI config files were also used in the backoffice to ext With the new Management API, any controllers or models previously located in `Umbraco.Commerce.Cms.Web` have been removed. Please use the **Management API** instead. - The only exception to this is the `PaymentController` which is used as a callback for payment gateways. This is currently kept at the same URL to prevent breakages for any existing transaction communications, however all new integrations should communicate with a new Payments API. +The only exception to this rule is the `PaymentController`, which serves as a callback for payment gateways. It is currently located at the same URL to avoid disrupting existing transaction communications. However, all new integrations should communicate with a new Payments API. ## UI Extension Points From ff3c8f8f9eee4eda54745926b53d31a77eac1d92 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:29:51 +0200 Subject: [PATCH 13/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index d3ff46728ce..b8888145f24 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -47,7 +47,7 @@ In addition to this, the UI config files were also used in the backoffice to ext * **Web Notification Events Removed** - The following notifications are no longer being fired. + The following notifications are no longer being fired: * `AnalyticsDashboardConfigParsingNotification` * `CartEditorConfigParsingNotification` From d359f3865880d69ad4cf8e3fd56f570130010048 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:30:18 +0200 Subject: [PATCH 14/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index b8888145f24..6b41709b03a 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -63,7 +63,7 @@ The only exception to this rule is the `PaymentController`, which serves as a ca ## UI Extension Points -With the new backoffice comes a new extensions system for the UI and we have tried to use this to the maximum. These means converting the old UI configs system to using the new manifests system. +With the new backoffice comes a new extensions system for the UI, and we have tried to maximize its use. This means converting the old UI configs system to use the new manifests system. With the new extension points it is possible to: From 3deee9184e275035b59155d956c7fedbc1e8fab2 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:30:37 +0200 Subject: [PATCH 15/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 6b41709b03a..7cd738160c2 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -69,7 +69,7 @@ With the new extension points it is possible to: * Change the properties used by the order editor. * Add properties to the order line properties editor. -* Add properties to the Notes, Additional Info and Customer Details modals. +* Add properties to the Notes, Additional Info, and Customer Details modals. * Add properties to the order collection view. * Add analytics widgets (still in progress) * Define custom views for properties to control value rendering. From dcbcd69952c8159601a058b9334c85e377e796dd Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:30:47 +0200 Subject: [PATCH 16/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 7cd738160c2..0aff34a3f14 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -74,7 +74,7 @@ With the new extension points it is possible to: * Add analytics widgets (still in progress) * Define custom views for properties to control value rendering. -Here is an example of how you would configure such properties +Here is an example of how you would configure these properties: ```javascript export const manifests : Array = [ From f97a654c25dab60c85ee309e959ce1285058d9d8 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:31:02 +0200 Subject: [PATCH 17/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 0aff34a3f14..47c4f04143b 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -106,7 +106,7 @@ export const manifests : Array = [ With these extension points, the Umbraco Commerce order editor is now more flexible than it has ever been before. {% hint style="info" %} -We are yet to launch an Umbraco Commerce NPM module so these points are not yet currently available to use externally but we wanted to give you a heads up of what is coming so you can prepare. +We are yet to launch an Umbraco Commerce NPM module, so these functionalities are not currently available for external use. However, we wanted to give you a heads up about what is coming so you can prepare. {% endhint %} ## Management API From d8ebade015dc60791799c13cdb028eadbbfad097 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:31:14 +0200 Subject: [PATCH 18/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 47c4f04143b..7131de9a29c 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -111,7 +111,7 @@ We are yet to launch an Umbraco Commerce NPM module, so these functionalities ar ## Management API -As with the CMS, with the new UI comes a whole new API layer. +With the new UI, a completely new API layer is also introduced, similar to the CMS. ![Umbraco Commerce Management API](../media/v14/management-api.png) From ce2760c7e1373588061ad4d0daa6850dfdb0d6eb Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:31:24 +0200 Subject: [PATCH 19/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 7131de9a29c..1c33fd3939d 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -115,7 +115,7 @@ With the new UI, a completely new API layer is also introduced, similar to the C ![Umbraco Commerce Management API](../media/v14/management-api.png) -With the Umbraco Commerce API we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible. +With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible. A key thought whilst developing this API has been to ensure external developers might use this to build other UI's for Umbraco Commerce such as a dedicated mobile app and so we've tried to ensure there are no "special" endpoints just for the Umbraco CMS UI. From aa1b1d9200d56141cc4caf52bcc58c6c877f0739 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:31:36 +0200 Subject: [PATCH 20/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 1c33fd3939d..d4040c6de2d 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -117,7 +117,7 @@ With the new UI, a completely new API layer is also introduced, similar to the C With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible. -A key thought whilst developing this API has been to ensure external developers might use this to build other UI's for Umbraco Commerce such as a dedicated mobile app and so we've tried to ensure there are no "special" endpoints just for the Umbraco CMS UI. +We have developed this API with the idea that external developers can use it to create different UIs for Umbraco Commerce, like a dedicated mobile app. We have made sure that there are no "special" endpoints exclusively for the Umbraco CMS UI. ## Localization From ae2cf06804e73837ab983a517a4ff0d9425d7d92 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:31:48 +0200 Subject: [PATCH 21/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index d4040c6de2d..5fc0c87262f 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -121,6 +121,6 @@ We have developed this API with the idea that external developers can use it to ## Localization -One of the things that has been on the Umbraco Commerce TODO list for a while is to add backoffice localization support. Given the fresh start it was only logical that we take the time to ensure that everything we built fully supported localization so this will be included in this release. +Given the fresh start, we made sure that everything we built fully supports localization, so this will be included in this release. With this update, we have also made some changes to things like payment and shipping providers, and other CSharp extension points where we define properties. These will no longer require hard coded labels / descriptions and instead will look these values up from the localization file. From e57d12d859a27466770d9e81981d7862e07b24d1 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:32:03 +0200 Subject: [PATCH 22/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 5fc0c87262f..330e80fdad2 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -123,4 +123,4 @@ We have developed this API with the idea that external developers can use it to Given the fresh start, we made sure that everything we built fully supports localization, so this will be included in this release. -With this update, we have also made some changes to things like payment and shipping providers, and other CSharp extension points where we define properties. These will no longer require hard coded labels / descriptions and instead will look these values up from the localization file. +In this update, we have made some changes to payment and shipping providers, as well as other CSharp extension points where properties are defined. These changes mean that labels and descriptions will no longer be hard coded; instead, the values will be looked up from the localization file. From 76cd505e7933f23511c7824682f236320cb4a800 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:33:38 +0200 Subject: [PATCH 23/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 330e80fdad2..e9218c6b207 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -111,7 +111,7 @@ We are yet to launch an Umbraco Commerce NPM module, so these functionalities ar ## Management API -With the new UI, a completely new API layer is also introduced, similar to the CMS. +With the new UI, a new API layer is also introduced, similar to the CMS. ![Umbraco Commerce Management API](../media/v14/management-api.png) From e28c35215ceba74708610fe274aee3ade8ec4e7c Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:38:06 +0200 Subject: [PATCH 24/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index e9218c6b207..e4194459ca4 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -34,7 +34,7 @@ The key breaking changes to expect are: Previously, in Umbraco Commerce, it was possible to configure the backoffice order list view, order editor, and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. For more details, see the [UI Extension Points](#ui-extension-points) section below. -In addition to this, the UI config files were also used in the backoffice to extract key order properties. For example, extracting the shipping address in order to calculate shipping rates. This functionality has now been split, and the mapping functionality has been moved to a new server-based configuration API. +In addition to this, the UI config files were also used in the backoffice to extract key order properties. For example, extracting the shipping address to calculate shipping rates. This functionality has now been split, and the mapping functionality has been moved to a new server-based configuration API. ``` builder.WithOrderPropertyConfigs() From 19400969db58b6a52a013c26cc347956882bd49a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:38:11 +0200 Subject: [PATCH 25/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index e4194459ca4..19711178cb0 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -106,7 +106,7 @@ export const manifests : Array = [ With these extension points, the Umbraco Commerce order editor is now more flexible than it has ever been before. {% hint style="info" %} -We are yet to launch an Umbraco Commerce NPM module, so these functionalities are not currently available for external use. However, we wanted to give you a heads up about what is coming so you can prepare. +We are yet to launch an Umbraco Commerce NPM module, so these functionalities are not currently available for external use. However, we wanted to give you a heads-up about what is coming so you can prepare. {% endhint %} ## Management API From e4fa70bf6135ccc6d6b9d38e56b5ca67c0633c27 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:38:16 +0200 Subject: [PATCH 26/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 19711178cb0..59942890c75 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -115,7 +115,7 @@ With the new UI, a new API layer is also introduced, similar to the CMS. ![Umbraco Commerce Management API](../media/v14/management-api.png) -With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible. +With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering and expansion where possible. We have developed this API with the idea that external developers can use it to create different UIs for Umbraco Commerce, like a dedicated mobile app. We have made sure that there are no "special" endpoints exclusively for the Umbraco CMS UI. From a34ce0c092f69c6ac03a61d5385b28830c4cdd0a Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:38:22 +0200 Subject: [PATCH 27/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 59942890c75..0d60442774f 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -123,4 +123,4 @@ We have developed this API with the idea that external developers can use it to Given the fresh start, we made sure that everything we built fully supports localization, so this will be included in this release. -In this update, we have made some changes to payment and shipping providers, as well as other CSharp extension points where properties are defined. These changes mean that labels and descriptions will no longer be hard coded; instead, the values will be looked up from the localization file. +In this update, we have made some changes to payment and shipping providers, as well as other CSharp extension points where properties are defined. These changes mean that labels and descriptions will no longer be hard-coded; instead, the values will be looked up from the localization file. From c3aca8cc2957683e8aa816b6bcc0dd00595413ea Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Mon, 26 Aug 2024 11:41:57 +0200 Subject: [PATCH 28/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 0d60442774f..1b3f7b2d55a 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -117,7 +117,7 @@ With the new UI, a new API layer is also introduced, similar to the CMS. With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering and expansion where possible. -We have developed this API with the idea that external developers can use it to create different UIs for Umbraco Commerce, like a dedicated mobile app. We have made sure that there are no "special" endpoints exclusively for the Umbraco CMS UI. +We developed this API for external developers who can use it to create different UIs for Umbraco Commerce, such as a dedicated mobile app. We have made sure that there are no "special" endpoints exclusively for the Umbraco CMS UI. ## Localization From a9a0528ccfe4bd8d8eab148c8f5ca12ba25f65a3 Mon Sep 17 00:00:00 2001 From: Matt Brailsford Date: Tue, 27 Aug 2024 08:05:57 +0100 Subject: [PATCH 29/30] Add 14.0.0 release notes to nav --- 14/umbraco-commerce/SUMMARY.md | 1 + 1 file changed, 1 insertion(+) diff --git a/14/umbraco-commerce/SUMMARY.md b/14/umbraco-commerce/SUMMARY.md index c61f16c457e..ab50399d603 100644 --- a/14/umbraco-commerce/SUMMARY.md +++ b/14/umbraco-commerce/SUMMARY.md @@ -2,6 +2,7 @@ * [Umbraco Commerce 14 (Alpha) Documentation](README.md) * [Release Notes](release-notes/README.md) + * [v14.0.0](release-notes/v14.0.0.md) * [v14.0.0-Alpha](release-notes/v14.0.0-alpha.md) ## Commerce Products From 79f74356ae705c2b52ed4bb2f3326f1078c6a057 Mon Sep 17 00:00:00 2001 From: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> Date: Tue, 27 Aug 2024 09:10:45 +0200 Subject: [PATCH 30/30] Update 14/umbraco-commerce/release-notes/v14.0.0.md --- 14/umbraco-commerce/release-notes/v14.0.0.md | 1 - 1 file changed, 1 deletion(-) diff --git a/14/umbraco-commerce/release-notes/v14.0.0.md b/14/umbraco-commerce/release-notes/v14.0.0.md index 1b3f7b2d55a..786314c3ef4 100644 --- a/14/umbraco-commerce/release-notes/v14.0.0.md +++ b/14/umbraco-commerce/release-notes/v14.0.0.md @@ -11,7 +11,6 @@ This release marks the v14 build of Umbraco Commerce, now feature complete and r * [New backoffice UI](#new-backoffice-ui) build with web-components. * Some [breaking changes](#breaking-changes) to be expected. -* Brand new [Management API](#management-api). * New more flexible [UI extension points](#ui-extension-points) added. * New [Management API](#management-api) added. * [Localization](#localization) support added (in progress).