diff --git a/14/umbraco-cms/.gitbook.yaml b/14/umbraco-cms/.gitbook.yaml index 9540712bfb3..895e6a4f4c0 100644 --- a/14/umbraco-cms/.gitbook.yaml +++ b/14/umbraco-cms/.gitbook.yaml @@ -46,7 +46,55 @@ 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 + 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 + 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 + 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 + 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 + 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 + 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/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
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) diff --git a/14/umbraco-cms/reference/configuration/README.md b/14/umbraco-cms/reference/configuration/README.md index 23ce462647e..b991990fe59 100644 --- a/14/umbraco-cms/reference/configuration/README.md +++ b/14/umbraco-cms/reference/configuration/README.md @@ -4,10 +4,18 @@ 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. +{% 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. 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. diff --git a/14/umbraco-cms/reference/templating/macros.md b/14/umbraco-cms/reference/templating/macros.md new file mode 100644 index 00000000000..8892a2ac4c3 --- /dev/null +++ b/14/umbraco-cms/reference/templating/macros.md @@ -0,0 +1,11 @@ +# 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. + +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 %}