From 62665b4dec2d5c9cebf3878344493d3a08347e90 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 12:45:28 +0200 Subject: [PATCH 1/9] Redirects for Angular docs incl note on the ui-documentation landing page --- 14/umbraco-cms/.gitbook.yaml | 9 +++++++++ 14/umbraco-cms/extending/ui-documentation.md | 6 ++++++ 2 files changed, 15 insertions(+) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index 9540712bfb3..d7284625b22 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -50,3 +50,12 @@ redirects: reference/management/services/retrieving-content-types: reference/management/using-services/contenttypeservice.md reference/management/services/retrieving-languages: reference/management/using-services/localizationservice.md reference/management/services/managing-users: reference/management/using-services/userservice.md + reference/angular: extending/ui-documentation.md + reference/angular/directives: extending/ui-documentation.md + reference/angular/directives/umbproperty: extending/ui-documentation.md + reference/angular/directives/umbloadindicator: extending/ui-documentation.md + reference/angular/directives/umblayoutselector: extending/ui-documentation.md + reference/angular/services: extending/ui-documentation.md + reference/angular/services/editorservice: extending/ui-documentation.md + reference/angular/services/eventsservice: extending/ui-documentation.md + reference/angular/services/eventsservice/changetitle: extending/ui-documentation.md diff --git a/14/umbraco-cms/extending/ui-documentation.md b/14/umbraco-cms/extending/ui-documentation.md index a6c3e211f2b..9c3a461c889 100644 --- a/14/umbraco-cms/extending/ui-documentation.md +++ b/14/umbraco-cms/extending/ui-documentation.md @@ -8,6 +8,12 @@ description: Find out more about Umbraco UI Library, UI API and Storybook. With the UI Library, you get a collection of visual building blocks that consists of pieces to build any UI in Umbraco. Each component is a building block updating its display according to the data passed to it. +{% hint style="info" %} +**Are you looking for the AngularJS documentation?** + +With Umbraco 14 the Umbraco backoffice has been rebuilt using Vite, Lit and Typescript. This means that AngularJS is no longer being used in Umbraco CMS, hence the removal of the corresponding documentation. +{% endhint %} + With the UI API, you get a set of collections related to modules export, interfaces, and hierarchy. This includes code examples and much more that you can use to extend the backoffice.
Backoffice UI LibrarySee, test, and get a feel for the familiar backoffice components built using the new UI components.https://apidocs.umbraco.com/v14/ui/Documentations Icons_Umbraco_CMS_Fundamentals_Backoffice (1) (2).png
Backoffice UI APISee what all of the modules export, interfaces, hierarchy, code examples, and much more.https://apidocs.umbraco.com/v14/ui-api/index.htmlDocumentations Icons_Umbraco_CMS_Tutorials_the_Starter_Kit (1).png
From 947a861c8341dad7d26be63144dfab5250b2ae0d Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 12:54:12 +0200 Subject: [PATCH 2/9] More redirects --- 14/umbraco-cms/.gitbook.yaml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index d7284625b22..c26e53f2b80 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -46,10 +46,14 @@ redirects: reference/management/services/consentservice: reference/management/using-services/consentservice.md reference/management/services/mediaservice: reference/management/using-services/mediaservice.md reference/management/services/relationservice: reference/management/using-services/relationservice.md + reference/management/services/contentservice/create-content-programmatically: reference/management/using-services/contentservice.md reference/management/services/create-content-programmatically: reference/management/using-services/contentservice.md + reference/management/services/contenttypeservice/retrieving-content-types: reference/management/using-services/contenttypeservice.md reference/management/services/retrieving-content-types: reference/management/using-services/contenttypeservice.md + reference/management/services/localizationservice/retrieving-languages: reference/management/using-services/localizationservice.md reference/management/services/retrieving-languages: reference/management/using-services/localizationservice.md reference/management/services/managing-users: reference/management/using-services/userservice.md + reference/management/services/userservice/create-a-new-user: reference/management/using-services/userservice.md reference/angular: extending/ui-documentation.md reference/angular/directives: extending/ui-documentation.md reference/angular/directives/umbproperty: extending/ui-documentation.md @@ -59,3 +63,10 @@ redirects: reference/angular/services/editorservice: extending/ui-documentation.md reference/angular/services/eventsservice: extending/ui-documentation.md reference/angular/services/eventsservice/changetitle: extending/ui-documentation.md + extending/content-apps: fundamentals/backoffice/document-blueprints.md + extending-backoffice/localization: extending/language-files/ui-localization.md + extending/ui-library: extending/ui-documentation.md + extending/backoffice-ui-api-documentation: extending/ui-documentation.md + reference/configuration/richtexteditorsettings: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/configuration.md + extending/section-trees/trees/tree-actions: extending/section-trees/trees/entity-actions + From f341d71d3ae1cecbbc5794fa1aaa48291b3deb62 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:07:11 +0200 Subject: [PATCH 3/9] Redirects for macros incl a new macros article with a note about the removal --- 14/umbraco-cms/.gitbook.yaml | 6 +++++- 14/umbraco-cms/reference/templating/macros.md | 9 +++++++++ 2 files changed, 14 insertions(+), 1 deletion(-) create mode 100644 14/umbraco-cms/reference/templating/macros.md diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index c26e53f2b80..268d158e938 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -69,4 +69,8 @@ redirects: extending/backoffice-ui-api-documentation: extending/ui-documentation.md reference/configuration/richtexteditorsettings: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/configuration.md extending/section-trees/trees/tree-actions: extending/section-trees/trees/entity-actions - + extending/macro-parameter-editors: reference/templating/macros.md + extending/health-check/guides/macroerrors: reference/templating/macros.md + fundamentals/design/partial-view-macro-files: reference/templating/macros.md + reference/templating/macros/managing-macros: reference/templating/macros.md + reference/templating/macros/partial-view-macros: reference/templating/macros.md diff --git a/14/umbraco-cms/reference/templating/macros.md b/14/umbraco-cms/reference/templating/macros.md new file mode 100644 index 00000000000..338320dc553 --- /dev/null +++ b/14/umbraco-cms/reference/templating/macros.md @@ -0,0 +1,9 @@ +# Macros and Partial View Macros + +{% hint style="warning" %} +**Are you looking for documentation about Macros and/or Partial View Macros? + +Macros and Partial View Macros have been removed with the release of Umbraco 14. + +We recommend using using [Partial Views](../../fundamentals/design/partial-views.md) or [Blocks in the Rich Text Editor](../../fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/rte-blocks.md) as a replacement. +{% endhint %} From 12eb69ff30091180145501f60ad36e31ac3a40df Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:16:45 +0200 Subject: [PATCH 4/9] Redirects for removed property editors incl note on property editor landing page --- 14/umbraco-cms/.gitbook.yaml | 13 +++++++++++++ .../backoffice/property-editors/README.md | 11 +++++++++++ 2 files changed, 24 insertions(+) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index 268d158e938..bbe4dc294b6 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -74,3 +74,16 @@ redirects: fundamentals/design/partial-view-macro-files: reference/templating/macros.md reference/templating/macros/managing-macros: reference/templating/macros.md reference/templating/macros/partial-view-macros: reference/templating/macros.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/nested-content: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/build-your-own-editor: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/add-value-programmatically: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/configuring-the-grid-layout-datatype: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/settings-and-styles: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/build-your-own-editor: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/render-grid-in-template: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/grid-layout-best-practices: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/what-are-grid-layouts: fundamentals/backoffice/property-editors/README.md + fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md + diff --git a/14/umbraco-cms/fundamentals/backoffice/property-editors/README.md b/14/umbraco-cms/fundamentals/backoffice/property-editors/README.md index 495d44bd40c..899b8e09a00 100644 --- a/14/umbraco-cms/fundamentals/backoffice/property-editors/README.md +++ b/14/umbraco-cms/fundamentals/backoffice/property-editors/README.md @@ -8,6 +8,17 @@ description: >- A Property Editor is the editor that a Data Type references. A Data Type is defined by a user in the Umbraco backoffice and references a Property Editor. In Umbraco a Property Editor is defined in a JSON manifest file and associated JavaScript files. +{% hint style="info" %} +**Are you looking for the Grid Layout or Nested Content?** + +The following Property Editors have been removed with the release of Umbraco 14: + +* Grid Layout +* Nested content + +We recommend using the [Block Editor](built-in-umbraco-property-editors/block-editor/README.md) or the [Rich Text Editor Blocks](built-in-umbraco-property-editors/rich-text-editor/rte-blocks.md) instead. +{% endhint %} + When creating a Data Type, specify the property editor for the Data Type to use by selecting from the "Property editor" list (as shown below). ![Data Type Definition](/14/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/images/Media-picker-dataType.png) From e9ed4734fae38cb5c5e1dee4d13891c491cf7c7a Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:20:47 +0200 Subject: [PATCH 5/9] Add announcement link to macros note --- 14/umbraco-cms/reference/templating/macros.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/14/umbraco-cms/reference/templating/macros.md b/14/umbraco-cms/reference/templating/macros.md index 338320dc553..8892a2ac4c3 100644 --- a/14/umbraco-cms/reference/templating/macros.md +++ b/14/umbraco-cms/reference/templating/macros.md @@ -6,4 +6,6 @@ Macros and Partial View Macros have been removed with the release of Umbraco 14. We recommend using using [Partial Views](../../fundamentals/design/partial-views.md) or [Blocks in the Rich Text Editor](../../fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/rte-blocks.md) as a replacement. + +Learn more about the decision for remove Macros in the official announcement: [Breaking change: Macros will be removed in Umbraco 14](https://github.com/umbraco/Announcements/issues/14). {% endhint %} From 3931af95284187f4e4e04cfb868b496a11da4237 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:23:24 +0200 Subject: [PATCH 6/9] Redirects for removed notifications articles --- 14/umbraco-cms/.gitbook.yaml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index bbe4dc294b6..fcbfda36773 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -86,4 +86,10 @@ redirects: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/grid-layout-best-practices: fundamentals/backoffice/property-editors/README.md fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/grid-layout/grid-editors/what-are-grid-layouts: fundamentals/backoffice/property-editors/README.md fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/media-picker-3.md - + reference/notifications/contentypeservice-notifications: reference/notifications/README.md + reference/notifications/datatypeservice-notifications: reference/notifications/README.md + reference/notifications/fileservice-notifications: reference/notifications/README.md + reference/notifications/localizationservice-notifications: reference/notifications/README.md + reference/notifications/mediatypeservice-notifications: reference/notifications/README.md + reference/notifications/membertypeservice-notifications: reference/notifications/README.md + reference/notifications/relationservice-notifications: reference/notifications/README.md From 8cc758d4c1a103ed42e58cc9361793b80ae7ef3a Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:41:28 +0200 Subject: [PATCH 7/9] Updated note in config landing page that still referenced v9 --- 14/umbraco-cms/.gitbook.yaml | 5 ++++- 14/umbraco-cms/reference/configuration/README.md | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index fcbfda36773..870885e57ef 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -63,7 +63,7 @@ redirects: reference/angular/services/editorservice: extending/ui-documentation.md reference/angular/services/eventsservice: extending/ui-documentation.md reference/angular/services/eventsservice/changetitle: extending/ui-documentation.md - extending/content-apps: fundamentals/backoffice/document-blueprints.md + extending/content-apps: extending/workspaces/workspace-editor-views.md extending-backoffice/localization: extending/language-files/ui-localization.md extending/ui-library: extending/ui-documentation.md extending/backoffice-ui-api-documentation: extending/ui-documentation.md @@ -93,3 +93,6 @@ redirects: reference/notifications/mediatypeservice-notifications: reference/notifications/README.md reference/notifications/membertypeservice-notifications: reference/notifications/README.md reference/notifications/relationservice-notifications: reference/notifications/README.md + tutorials/editors-manual/working-with-content/rich-text-editor: tutorials/editors-manual/working-with-content.md + fundamentals/backoffice/content-templates: fundamentals/backoffice/document-blueprints.md + reference/configuration/runtimeminificationsettings: reference/configuration/README.md diff --git a/14/umbraco-cms/reference/configuration/README.md b/14/umbraco-cms/reference/configuration/README.md index 23ce462647e..fd7a7c7e2d9 100644 --- a/14/umbraco-cms/reference/configuration/README.md +++ b/14/umbraco-cms/reference/configuration/README.md @@ -4,7 +4,7 @@ description: Information on configuring Umbraco # Configuration -In Umbraco 9+, we have moved away from the previous configuration using `.config` files, to instead using the .NET built-in configuration pattern. This means that there is no longer separate files for different configuration, the configuration is now primarily done using `IConfiguration` with diffent sources. E.g. The `appsettings.json` file. +Umbraco uses the .NET built-in configuration pattern. This means that the configuration is handled in the `appsettings.json` file and primarily done using `IConfiguration` with diffent sources. For more in depth information on the configuration pattern see Microsofts [Configuration in ASP.NET Core](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-6.0) article. From 58d11e900d19f39b8a16198a1d2027970c1245d8 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Mon, 24 Jun 2024 13:45:18 +0200 Subject: [PATCH 8/9] Adding note about removed smidge --- 14/umbraco-cms/reference/configuration/README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/14/umbraco-cms/reference/configuration/README.md b/14/umbraco-cms/reference/configuration/README.md index fd7a7c7e2d9..b991990fe59 100644 --- a/14/umbraco-cms/reference/configuration/README.md +++ b/14/umbraco-cms/reference/configuration/README.md @@ -8,6 +8,14 @@ Umbraco uses the .NET built-in configuration pattern. This means that the config For more in depth information on the configuration pattern see Microsofts [Configuration in ASP.NET Core](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-6.0) article. +{% hint style="info" %} +**Are you looking for the RuntimeMinificationSettings?** + +Smidge, which held the RuntimeMinificationSettings configuration, was removed with the release of Umbraco 14. + +You can install the Smidge package separately if needed. Learn more and see how to get started in [the official Smidge documentation](https://github.com/Shazwazza/Smidge). +{% endhint %} + ## Managing Configuration You might not always want to have the configuration stored in the `appsettings.json` file, for instance, you might not want to have the admin password in the file if using the unattended feature. You might also want to use a specific set of configurations when developing your solution. To achieve this, the `IConfiguration` pattern can be used for this. From 1bf14d130c3d37ca1cc3c53748e8bb2f1c21cc51 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Tue, 25 Jun 2024 08:13:30 +0200 Subject: [PATCH 9/9] Redirects for api-controller articles incl moving a note --- 14/umbraco-cms/.gitbook.yaml | 2 ++ .../routing/umbraco-api-controllers/README.md | 12 ++++++------ 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index 870885e57ef..895e6a4f4c0 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -96,3 +96,5 @@ redirects: tutorials/editors-manual/working-with-content/rich-text-editor: tutorials/editors-manual/working-with-content.md fundamentals/backoffice/content-templates: fundamentals/backoffice/document-blueprints.md reference/configuration/runtimeminificationsettings: reference/configuration/README.md + reference/routing/umbraco-api-controllers/authorization: reference/routing/umbraco-api-controllers/README.md + reference/routing/umbraco-api-controllers/routing: reference/routing/umbraco-api-controllers/README.md diff --git a/14/umbraco-cms/reference/routing/umbraco-api-controllers/README.md b/14/umbraco-cms/reference/routing/umbraco-api-controllers/README.md index d424cf46d0d..bff31a3a215 100644 --- a/14/umbraco-cms/reference/routing/umbraco-api-controllers/README.md +++ b/14/umbraco-cms/reference/routing/umbraco-api-controllers/README.md @@ -6,6 +6,12 @@ description: A guide to implementing APIs in Umbraco projects This article describes how to work with API Controllers in Umbraco to create REST services. +{% hint style="warning" %} +In Umbraco 13 and below, the recommended approach was to base API controllers on the `UmbracoApiController` class. However, `UmbracoApiController` is obsolete in Umbraco 14 and will be removed in Umbraco 15. + +Read the article [Porting old Umbraco APIs](porting-old-umbraco-apis.md) for more details. +{% endhint %} + ## What is an API? The Microsoft ASP.NET Core API documentation is a great place to familiarize yourself with API concepts. It can be found on the [official ASP.NET Core site](https://dotnet.microsoft.com/en-us/apps/aspnet/apis). @@ -30,12 +36,6 @@ public class ProductsController : Controller ``` {% endcode %} -{% hint style="warning" %} -In Umbraco 13 and below, the recommended approach was to base API controllers on the `UmbracoApiController` class. However, `UmbracoApiController` is obsolete in Umbraco 14 and will be removed in Umbraco 15. - -Read the article [Porting old Umbraco APIs](porting-old-umbraco-apis.md) for more details. -{% endhint %} - ## Adding member protection to public APIs To protect your APIs based on front-end membership, you can annotate your API controllers with the `[UmbracoMemberAuthorize]` attribute.