From 0af370f4c9cecff25889867cfe0c844740202589 Mon Sep 17 00:00:00 2001 From: nikolajlauridsen Date: Mon, 7 Oct 2024 11:28:10 +0200 Subject: [PATCH 1/3] Add v15 breaking changes section --- .../setup/upgrading/version-specific/README.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md index d1f140be2a5..0aa0c41a554 100644 --- a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md +++ b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md @@ -19,6 +19,19 @@ Use the [general upgrade guide](../) to complete the upgrade of your project.
+Umbraco 15 + +* **Snapshots are removed** + +Snapshots has been removed, this means that any code that used `IPublishedSnapshot`, and by extension `IPublishedSnapshotAccessor`, must be updated. The specific changes depends on the use case of the snapshot, in most cases it can be solved by instead injecting `IPublishedContentCache` or `IPublishedMediaCache` and using those directly. + +* **Modelsbuilder models needs to be rebuilt** + +Models generated by ModelsBuilder used the `IPublishedSnapshot` interface, which has been removed. This means that the models needs to be rebuilt, the approach to this will differ on the models mode chosen: + +* InMemoryAuto - Remove the `umbraco\Data\TEMP\InMemoryAuto` folder, this will trigger a rebuild of the models. +* SourceCodeAuto and SourceCodeManual - Remove the old models, by default these are located in the `\umbraco\models` folder, and then trigger a rebuild of the models from the dashboard in the backoffice. + Umbraco 14 Read more about the release of Umbraco 14 in the [Blog Post](https://umbraco.com/blog/umbraco-14-release/). @@ -952,7 +965,7 @@ Task TryFindContent(IPublishedRequestBuilder request); [**Async tree search**](https://github.com/umbraco/Umbraco-CMS/pull/12344) ```CSharp -IEnumerable Search(string query, int pageSize, long pageIndex, out long totalFound, string? searchFrom +IEnumerable Search(string query, int pageSize, long pageIndex, out long totalFound, string? searchFrom = null) ``` @@ -996,7 +1009,7 @@ In the `_ViewImports.cshtml` of your project, remove the following lines: ``` @addTagHelper *, Smidge -@inject Smidge.SmidgeHelper SmidgeHelper +@inject Smidge.SmidgeHelper SmidgeHelper ``` Otherwise, it will cause an error on the front end. From f4f8d090e0697e613bd1b5dec15ed46acc72bb41 Mon Sep 17 00:00:00 2001 From: nikolajlauridsen Date: Mon, 7 Oct 2024 12:00:39 +0200 Subject: [PATCH 2/3] Shorten sentence --- .../fundamentals/setup/upgrading/version-specific/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md index 0aa0c41a554..536f9546de4 100644 --- a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md +++ b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md @@ -23,7 +23,7 @@ Use the [general upgrade guide](../) to complete the upgrade of your project. * **Snapshots are removed** -Snapshots has been removed, this means that any code that used `IPublishedSnapshot`, and by extension `IPublishedSnapshotAccessor`, must be updated. The specific changes depends on the use case of the snapshot, in most cases it can be solved by instead injecting `IPublishedContentCache` or `IPublishedMediaCache` and using those directly. +Snapshots has been removed, this means that any code that used `IPublishedSnapshot`, and by extension `IPublishedSnapshotAccessor`, must be updated. Inject `IPublishedContentCache` or `IPublishedMediaCache` and use those directly instead. * **Modelsbuilder models needs to be rebuilt** From 189d212c76ffe862f8f9db3133b9906dacc17127 Mon Sep 17 00:00:00 2001 From: Mole Date: Mon, 7 Oct 2024 13:03:35 +0200 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: sofietoft --- .../setup/upgrading/version-specific/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md index 536f9546de4..12539060d20 100644 --- a/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md +++ b/15/umbraco-cms/fundamentals/setup/upgrading/version-specific/README.md @@ -23,14 +23,14 @@ Use the [general upgrade guide](../) to complete the upgrade of your project. * **Snapshots are removed** -Snapshots has been removed, this means that any code that used `IPublishedSnapshot`, and by extension `IPublishedSnapshotAccessor`, must be updated. Inject `IPublishedContentCache` or `IPublishedMediaCache` and use those directly instead. +Snapshots have been removed, meaning any code using `IPublishedSnapshot`, and by extension `IPublishedSnapshotAccessor`, must be updated. Inject `IPublishedContentCache` or `IPublishedMediaCache` and use those directly instead. * **Modelsbuilder models needs to be rebuilt** -Models generated by ModelsBuilder used the `IPublishedSnapshot` interface, which has been removed. This means that the models needs to be rebuilt, the approach to this will differ on the models mode chosen: +Models generated by ModelsBuilder used the `IPublishedSnapshot` interface, which has been removed. This means that the models need to be rebuilt. The approach to this will differ depending on the mode chosen: -* InMemoryAuto - Remove the `umbraco\Data\TEMP\InMemoryAuto` folder, this will trigger a rebuild of the models. -* SourceCodeAuto and SourceCodeManual - Remove the old models, by default these are located in the `\umbraco\models` folder, and then trigger a rebuild of the models from the dashboard in the backoffice. +* InMemoryAuto - Remove the `umbraco\Data\TEMP\InMemoryAuto` folder to trigger a rebuild of the models. +* SourceCodeAuto and SourceCodeManual - Remove the old models located in the `\umbraco\models` folder by default. Trigger a rebuild of the models from the ModelsBuilder dashboard in the backoffice. Umbraco 14