Merge branch 'main' of https://github.com/umbraco/UmbracoDocs

Author: eshanrnh

10/umbraco-cms/tutorials/custom-error-page.md

@@ -8,7 +8,7 @@ Custom error handling might make your site look more on-brand and minimize the i
 
 This article contains guides on how to create custom error pages for the following types of errors:
 
-* [404 errors ("Page not found")](custom-error-page.md#404-errors)
+* [404 errors ("Page not found")](custom-error-page.md#id-404-errors)
 * [Maintenance Page](custom-error-page.md#maintenance-page)
 
 ## In-code error page handling

13/umbraco-cms/SUMMARY.md

@@ -353,6 +353,7 @@
     * [TextService](reference/management/services/textservice.md)
     * [ContentService](reference/management/services/contentservice/README.md)
       * [Create content programmatically](reference/management/services/contentservice/create-content-programmatically.md)
+      * [Publish content programmatically](reference/management/services/contentservice/publish-content-programmatically.md)
     * [ContentTypeService](reference/management/services/contenttypeservice/README.md)
       * [Retrieving content types](reference/management/services/contenttypeservice/retrieving-content-type-containers.md)
       * [Retrieving content types](reference/management/services/contenttypeservice/retrieving-content-types.md)

13/umbraco-cms/reference/configuration/contentsettings.md

@@ -47,7 +47,8 @@ The following snippet will give an overview of the keys and values in the conten
       "PreviewBadge": "<![CDATA[<b>My HTML here</b>]]>",
       "ResolveUrlsFromTextString": false,
       "ShowDeprecatedPropertyEditors": false,
-      "ShowDomainWarnings": true
+      "ShowDomainWarnings": true,
+      "ShowUnroutableContentWarnings": true
     }
   }
 }
@@ -174,15 +175,23 @@ This setting is used for controlling whether or not the Data Types marked as obs
 
 By default this is set to `false`. To make the obsolete data types visible in the dropdown change the value to `true`.
 
-### Show Domain Warnings
+### Show domain warnings
 
 If you do not configure Domains for each language in a multilingual site then every time you publish your content you get this warning:
 
 `Content published: Domains are not configured for multilingual site, please contact an administrator, see log for more information.`
 
 If you have a use case for not setting the domains, you can set this setting **ShowDomainWarnings** to `false` to stop the warning from displaying.
 
-## ContentVersionCleanupPolicy
+### Show unroutable content warnings
+
+If your routing setup leads to more than one document having the same URL, on publish a warning will be displayed:
+
+`Content published: The document does not have a URL, possibly due to a naming collision with another document. More details can be found under Info.`
+
+To suppress these warnings, set this option to `false`.
+
+## Content version cleanup policy
 
 The global settings for the scheduled job which cleans historic content versions. These settings can be overridden per Document Type.
 
@@ -200,19 +209,19 @@ See [Content Version Cleanup](../../fundamentals/data/content-version-cleanup.md
 
 To retain only the current draft and published version, set both the "keep" settings values to 0. The next time the scheduled job runs (hourly) all non-current versions (except those marked "prevent cleanup") will be removed.
 
-### EnableCleanup
+### Enable cleanup
 
 When set to `true`, a scheduled job will delete historic content versions that are not retained according to the policy every hour.
 
 When set to `false`, the scheduled job will not delete any content versions, regardless of any overridden settings for a Document Type.
 
 The dotnet new template provides an `appsettings.json` file with the default value set to `true` for all sites.
 
-### KeepAllVersionsNewerThanDays
+### Keep all versions newer than days
 
 All versions that fall in this period will be kept.
 
-### KeepLatestVersionPerDayForDays
+### Keep latest version per day for days
 
 For content versions that fall in this period, the most recent version for each day is kept. All previous versions for that day are removed unless marked as preventCleanup.
 
@@ -237,11 +246,11 @@ This section is used for managing how Umbraco handles images, allowed attributes
 
 Let's break it down.
 
-### ImageFileTypes
+### Image file types
 
 This is a separated list of accepted image formats
 
-### AutoFillImageProperties
+### Auto fill image properties
 
 You can define what properties should be automatically updated when an image is being uploaded. This means that if you decide to rename the default **umbracoWidth** and **umbracoHeight** properties the values in **`"WidthFieldAlias"`** and **`"HeightFieldAlias"`** need to be updated. This needs to happen in order to automatically populate the values when the image is being uploaded.
 

13/umbraco-cms/reference/management/services/contentservice/publish-content-programmatically.md

@@ -0,0 +1,35 @@
+# Publishing content programmatically
+
+The ContentService is also used for publishing operations.
+
+The following example shows a page being published with all descendants.
+
+```csharp
+using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.Core.Services;
+
+namespace Umbraco.Cms.Web.UI.Custom;
+
+public class PublishContentDemo
+{
+    private readonly IContentService _contentService;
+
+    public PublishContentDemo(IContentService contentService) => _contentService = contentService;
+
+    public void Publish(Guid key)
+    {
+        IContent? content = _contentService.GetById(key)
+            ?? throw new InvalidOperationException($"Could not find content with key: {key}.");
+
+        _contentService.SaveAndPublishBranch(content, PublishBranchFilter.Default);
+    }
+}
+```
+
+The `PublishBranchFilter` option can include one or more of the following flags:
+
+- `Default` - publishes existing published content with pending changes.
+- `IncludeUnpublished` - publishes unpublished content and existing published content with pending changes.
+- `ForceRepublish` - publishes existing published content with or without pending changes.
+- `All` - combines `IncludeUnpublished` and `ForceRepublish`.
+

13/umbraco-cms/tutorials/custom-error-page.md

@@ -8,8 +8,8 @@ Custom error handling might make your site look more on-brand and minimize the i
 
 This article contains guides on how to create custom error pages for the following types of errors:
 
-* [404 errors ("Page not found")](custom-error-page.md#404-errors)
-* [500 errors ("Internal Server Error")](custom-error-page.md#500-errors)
+* [404 errors ("Page not found")](custom-error-page.md#id-404-errors)
+* [500 errors ("Internal Server Error")](custom-error-page.md#id-500-errors)
 * [Maintenance Page](custom-error-page.md#maintenance-page)
 
 ## In-code error page handling

13/umbraco-cms/tutorials/editors-manual/getting-started-with-umbraco/creating-saving-and-publishing-content.md

@@ -65,8 +65,7 @@ To publish the node with descendants, follow these steps:
 3.  Select **Publish with descendants**.
 
     ![Publish with descendants](../../../../../10/umbraco-cms/tutorials/editors-manual/getting-started-with-umbraco/images/Publish-with-descendants-v9.png)
-4.  Toggle the option to **Include unpublished content items** if you wish to. This option includes all unpublished content items for the selected page and the available linked pages.
-
+4.  Toggle the option to **Include unpublished content items** if you wish to. This option includes all unpublished content items for the selected page and the descendant pages.
     ![Publish with descendants](../../../../../10/umbraco-cms/tutorials/editors-manual/getting-started-with-umbraco/images/Publish-with-descendants2-v9.png)
 
 #### 3: Unpublish

13/umbraco-engage/tutorials/marketing-resources/generic-popup-template.md

@@ -222,7 +222,7 @@ function checkCookie() {
 };
 
 function sendEvent(eventvalue) {
-    umEngage("send", "event", "Popup", eventvalue, popupName);
+    umbEngage("send", "event", "Popup", eventvalue, popupName);
 };
 
 function hideModel() {

13/umbraco-ui-builder/SUMMARY.md

@@ -46,6 +46,7 @@
   * [Child Collection Groups](collections/child-collection-groups.md)
   * [Retrieve Child Collections](collections/retrieve-child-collections.md)
 * [Related Collections](collections/related-collections.md)
+* [Entity Identifier Converters](collections/entity-identifier-converters.md)
 
 ## Searching
 

13/umbraco-ui-builder/collections/entity-identifier-converters.md

@@ -0,0 +1,36 @@
+---
+description: Using Umbraco entities as reference with an UI Builder collection
+---
+
+# Entity Identifier Converters
+
+Umbraco stores identifiers in UDI format for most Umbraco object types.
+
+You can read more about them in the [UDI Identifiers](../../umbraco-cms/reference/querying/udi-identifiers.md) section of the documentation.
+
+If you want to reference an Umbraco object in your model and retrieve its `Integer` or `Guid` value, you must convert the `UDI` value.
+
+Use one of UI Builder's converters - `EntityIdentifierToIntTypeConverter` or `EntityIdentifierToGuidTypeConverter`. Add it as a `[TypeConverterAttribute]` to your model's foreign key property.
+
+An entity that references an Umbraco object would look like this:
+
+```csharp
+    [TableName(TableName)]
+    [PrimaryKey("Id")]
+    public class MemberReview
+    {
+        public const string TableName = "MemberReview";
+
+        [PrimaryKeyColumn]
+        public int Id { get; set; }
+
+        public string Title { get; set; }
+
+        public string Content { get; set; }
+
+        [TypeConverter(typeof(EntityIdentifierToIntTypeConverter))]
+        public int MemberId { get; set; }
+    }
+```
+
+You can also create a custom type converter. UI Builder will handle data persistence automatically.

13/umbraco-ui-builder/release-notes.md

@@ -18,6 +18,10 @@ If you are upgrading to a new major version, check the breaking changes in the [
 
 This section contains the release notes for Umbraco UI Builder 13 including all changes for this version.
 
+#### [**13.2.3**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.2.3) **(April 4th 2025)**
+
+* Removed global registration of `UDI` converters [#144](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/144) and introduced new [Entity Identifier Converters](./collections/entity-identifier-converters.md).
+
 #### [**13.2.2**](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F13.2.2) **(March 21st 2025)**
 
 * Fixed an issue for bulk actions that disabled the actions row on cancel [#130](https://github.com/umbraco/Umbraco.UIBuilder.Issues/issues/130)