Merge pull request #7531 from umbraco/merge-v16-changes-to-v17

Added changes from v16 PRs to v17

Author: eshanrnh

16/umbraco-cms/customizing/property-editors/property-actions.md

@@ -4,10 +4,6 @@ description: Guide on how to implement Property Actions for Property Editors in
 
 # Property Actions
 
-{% hint style="warning" %}
-This page is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice.
-{% endhint %}
-
 Property Actions are a built-in feature of Umbraco that allows you to add extra functionality to a Property Editor. Think of them as small, secondary actions that you can attach to a property without modifying the editor itself.
 
 Property Actions appear as a small button next to the property label, which expands to show the available actions.

16/umbraco-cms/customizing/workspaces.md

@@ -1,9 +1,5 @@
 # Workspaces
 
-{% hint style="warning" %}
-This page is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice.
-{% endhint %}
-
 Workspaces provide dedicated editing environments for specific entity types in Umbraco. They create isolated areas where users can edit content, media, members, or other entities with specialized interfaces and functionality.
 
 ## Key Concepts

16/umbraco-cms/reference/api-documentation.md

@@ -10,13 +10,13 @@ A library of API Reference documentation is auto-generated from the comments wit
 
 C# API references for the Umbraco Core, Infrastructure, Extensions and Web libraries.
 
-### [Umbraco.Cms.Core](https://apidocs.umbraco.com/v15/csharp/api/Umbraco.Cms.Core.html)
+### [Umbraco.Cms.Core](https://apidocs.umbraco.com/v16/csharp/api/Umbraco.Cms.Core.html)
 
-### [Umbraco.Cms.Infrastructure](https://apidocs.umbraco.com/v15/csharp/api/Umbraco.Cms.Infrastructure.html)
+### [Umbraco.Cms.Infrastructure](https://apidocs.umbraco.com/v16/csharp/api/Umbraco.Cms.Infrastructure.html)
 
-### [Umbraco.Cms.Web](https://apidocs.umbraco.com/v15/csharp/api/Umbraco.Cms.Web.Common.html)
+### [Umbraco.Cms.Web](https://apidocs.umbraco.com/v16/csharp/api/Umbraco.Cms.Web.Common.html)
 
-### [Umbraco.Extensions](https://apidocs.umbraco.com/v15/csharp/api/Umbraco.Extensions.html)
+### [Umbraco.Extensions](https://apidocs.umbraco.com/v16/csharp/api/Umbraco.Extensions.html)
 
 {% hint style="info" %}
 Opens a documentation browser that is different from the documentation section you're viewing now.

16/umbraco-forms/developer/ajaxforms.md

@@ -599,8 +599,9 @@ With [expanded output](https://docs.umbraco.com/umbraco-cms/reference/content-de
 }
 ```
 
-## Dynamic form injection
-For dynamic form injection on a page, such as in a modal dialog, there's a specific JavaScript event and API method. This allows reinitializing Umbraco Forms for the new content.
+## Dynamic Form Injection
+
+For dynamic Form injection on a page, such as in a modal dialog, there's a specific JavaScript event and API method. This allows reinitializing Umbraco Forms for the new content.
 
 ```javascript
 // Execute a reinitialize on dynamic injections

17/umbraco-cms/.gitbook.yaml

@@ -146,3 +146,6 @@ redirects:
     extending/backoffice-setup/extension-types: customizing/extending-overview/extension-types/README.md
     customizing/extending-overview/extension-registry/extension-registry: customizing/extending-overview/extension-registry/register-extensions.md
     fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date: fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/date-time-editor/README.md
+    customizing/extending-overview/extension-types/workspaces/workspace-action-menu-item: customizing/extending-overview/extension-types/workspaces/workspace-action-menu-items.md
+    customizing/extending-overview/extension-types/workspaces/workspace-footer-app: customizing/extending-overview/extension-types/workspaces/workspace-footer-apps.md
+    

17/umbraco-cms/.gitbook/assets/DeliveryAPIContentIndex.png

@@ -188,7 +188,9 @@
     * [Trees](customizing/extending-overview/extension-types/tree.md)
     * [Workspaces](customizing/extending-overview/extension-types/workspaces/README.md)
       * [Workspace Actions](customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md)
+      * [Workspace Action Menu Items](customizing/extending-overview/extension-types/workspaces/workspace-action-menu-items.md)
       * [Workspace Context](customizing/extending-overview/extension-types/workspaces/workspace-context.md)
+      * [Workspace Footer Apps](customizing/extending-overview/extension-types/workspaces/workspace-footer-apps.md)
       * [Workspace Views](customizing/extending-overview/extension-types/workspaces/workspace-views.md)
   * [Extension Kind](customizing/extending-overview/extension-kind.md)
   * [Extension Conditions](customizing/extending-overview/extension-conditions.md)

17/umbraco-cms/.gitbook/assets/DeliveryAPIContentIndexRebuild.png

@@ -39,6 +39,78 @@ Even though these dashboards are useful, you might want to create your own custo
 
 You can try and [create a custom dashboard](../../../tutorials/creating-a-custom-dashboard/) as a way on getting started on this topic.
 
+### Hiding or adding conditional rules to existing dashboards
+
+You might need to hide or add conditions to existing dashboards. Common use cases include hiding the Getting Started dashboard or restricting the Redirect Management dashboard to Admin users only.
+
+To do this, you will first need to [create an extension](../../../tutorials/creating-your-first-extension.md). For this example, which implements dashboard customizations, a descriptive name like `DashboardCustomization` works well:
+
+{% code title="~/App_Plugins/DashboardCustomization/umbraco-package.json" lineNumbers="true" %}
+```json
+{
+  "name": "DashboardCustomization",
+  "version": "1.0.0",
+  "extensions": [
+    {
+      "type": "backofficeEntryPoint",
+      "alias": "DashboardCustomization.EntryPoint",
+      "name": "Dashboard Customization Entry Point",
+      "js": "/App_Plugins/DashboardCustomization/dashboards-setup.js"
+    }
+  ]
+}
+```
+{% endcode %}
+
+Use the `onInit` function to configure the dashboard removal and customization. The optional `onUnload` function can clean up any customizations when the extension is disposed:
+
+{% code title="~/App_Plugins/DashboardCustomization/dashboards-setup.js" lineNumbers="true" %}
+```js
+export const onInit = (host, extensionRegistry) => {     
+  // Remove Getting Started dashboard for all users
+  extensionRegistry.exclude('Umb.Dashboard.UmbracoNews');
+    
+  // Restrict Redirect Management dashboard to Admin users only
+  extensionRegistry.appendCondition('Umb.Dashboard.RedirectManagement', {
+    alias: 'Umb.Condition.CurrentUser.IsAdmin'
+  });
+}
+
+/**
+ * Optional: Perform cleanup when the extension is unloaded
+ */
+export const onUnload = (host, extensionRegistry) => {
+  // Note: In most cases, cleanup is not necessary as the extension registry
+  // handles this automatically when the backoffice reloads
+}
+```
+{% endcode %}
+
+#### Restricting to specific user groups
+
+To allow multiple user groups (for example, Admin or a custom group), use the `Umb.Condition.CurrentUser.GroupId` condition with the `oneOf` parameter:
+
+{% code title="~/App_Plugins/DashboardCustomization/dashboards-setup.js" lineNumbers="true" %}
+```js
+export const onInit = (host, extensionRegistry) => {
+  extensionRegistry.appendCondition('Umb.Dashboard.RedirectManagement', {
+    alias: 'Umb.Condition.CurrentUser.GroupId',
+    oneOf: [
+      'CUSTOM-GROUP-GUID-1-HERE',
+      'CUSTOM-GROUP-GUID-2-HERE'
+    ]
+  });
+};
+```
+{% endcode %}
+
+You can find user group GUIDs in the **Users > User Groups** section of the backoffice.
+
+Read more about the available conditions:
+
+{% content-ref url="condition.md" %}
+[condition.md](condition.md)
+{% endcontent-ref %}
 ## Registering your Dashboard
 
 This section dives into the Dashboard Extension Manifest, shows how to register one, and append additional details.