Skip to content
48 changes: 48 additions & 0 deletions 14/umbraco-cms/.gitbook.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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
6 changes: 6 additions & 0 deletions 14/umbraco-cms/extending/ui-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="https://apidocs.umbraco.com/v14/ui/"><strong>Backoffice UI Library</strong></a></td><td>See, test, and get a feel for the familiar backoffice components built using the new UI components.</td><td><a href="https://apidocs.umbraco.com/v14/ui/">https://apidocs.umbraco.com/v14/ui/</a></td><td><a href="../.gitbook/assets/Documentations Icons_Umbraco_CMS_Fundamentals_Backoffice (1) (2).png">Documentations Icons_Umbraco_CMS_Fundamentals_Backoffice (1) (2).png</a></td></tr><tr><td><a href="https://apidocs.umbraco.com/v14/ui-api/index.html"><strong>Backoffice UI API</strong></a></td><td>See what all of the modules export, interfaces, hierarchy, code examples, and much more.</td><td><a href="https://apidocs.umbraco.com/v14/ui-api/index.html">https://apidocs.umbraco.com/v14/ui-api/index.html</a></td><td><a href="../.gitbook/assets/Documentations Icons_Umbraco_CMS_Tutorials_the_Starter_Kit (1).png">Documentations Icons_Umbraco_CMS_Tutorials_the_Starter_Kit (1).png</a></td></tr></tbody></table>
Expand Down
11 changes: 11 additions & 0 deletions 14/umbraco-cms/fundamentals/backoffice/property-editors/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
10 changes: 9 additions & 1 deletion 14/umbraco-cms/reference/configuration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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.
Expand Down
11 changes: 11 additions & 0 deletions 14/umbraco-cms/reference/templating/macros.md
Original file line number Diff line number Diff line change
@@ -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 %}