GITBOOK-19: Organize Extension Types articles

Sofie Toft Kristensen · gitbook-bot · commit daf484a67d51 · 2024-11-29T07:53:37.000Z
diff --git a/15/umbraco-cms/SUMMARY.md b/15/umbraco-cms/SUMMARY.md
@@ -173,7 +173,13 @@
     * [Extension Manifest](customizing/extending-overview/extension-registry/extension-manifest.md)
   * [Extension Types](customizing/extending-overview/extension-types/README.md)
     * [Sections](customizing/extending-overview/extension-types/sections/README.md)
+      * [Sections](customizing/extending-overview/extension-types/sections/section.md)
+      * [Section Sidebar](customizing/extending-overview/extension-types/sections/section-sidebar.md)
+      * [Section View](customizing/extending-overview/extension-types/sections/section-view.md)
     * [Workspaces](customizing/extending-overview/extension-types/workspaces/README.md)
+      * [Workspace Actions](customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md)
+      * [Workspace Context](customizing/extending-overview/extension-types/workspaces/workspace-context.md)
+      * [Workspace Views](customizing/extending-overview/extension-types/workspaces/workspace-views.md)
       * [Modals](customizing/extending-overview/extension-types/modals/README.md)
       * [Confirm Dialog](customizing/extending-overview/extension-types/modals/confirm-dialog.md)
       * [Custom Modals](customizing/extending-overview/extension-types/modals/custom-modals.md)
@@ -190,12 +196,6 @@
     * [Entity Bulk Actions](customizing/extending-overview/extension-types/entity-bulk-actions.md)
     * [Trees](customizing/extending-overview/extension-types/tree.md)
     * [Global Context](customizing/extending-overview/extension-types/global-context.md)
-    * [Section Sidebar](customizing/extending-overview/extension-types/section-sidebar.md)
-    * [Section View](customizing/extending-overview/extension-types/section-view.md)
-    * [Sections](customizing/extending-overview/extension-types/section.md)
-    * [Workspace Context](customizing/extending-overview/extension-types/workspace-context.md)
-    * [Workspace Views](customizing/extending-overview/extension-types/workspace-views.md)
-    * [Workspace Actions](customizing/extending-overview/extension-types/workspace-editor-actions.md)
     * [Localization](customizing/extending-overview/extension-types/localization.md)
   * [Extension Kind](customizing/extending-overview/extension-kind.md)
   * [Extension Conditions](customizing/extending-overview/extension-conditions.md)
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/dashboard.md b/15/umbraco-cms/customizing/extending-overview/extension-types/dashboard.md
@@ -10,7 +10,7 @@ Each section of the Umbraco backoffice has its own set of default dashboards. Yo
 
 The dashboard area of Umbraco is used to display an "editor" for the selected item in the tree. If no item is selected, then the default set of section dashboards is shown in the dashboard area.
 
-Notice that [Section Views](section-view.md) is another similar approach to append information to the root of a Section. Section views are thought mainly to be used as Secondary pages. These two approaches should ideally not be combined.
+Notice that [Section Views](sections/section-view.md) is another similar approach to append information to the root of a Section. Section views are thought mainly to be used as Secondary pages. These two approaches should ideally not be combined.
 
 ## Default Dashboards in Umbraco
 
@@ -37,7 +37,7 @@ Here is a table of the default dashboards in Umbraco and the sections they are u
 
 Even though these dashboards are useful, you might want to create your own custom dashboard to display specific information or functionality.
 
-You can try and [create a custom dashboard](../../../tutorials/creating-a-custom-dashboard/README.md) as a way on getting started on this topic.
+You can try and [create a custom dashboard](../../../tutorials/creating-a-custom-dashboard/) as a way on getting started on this topic.
 
 ## Registering your Dashboard
 
@@ -110,6 +110,9 @@ The dashboard manifest can contain the following properties:
 | Property    | Type   | Description                                                                                                                                                                                                                                                                                               |
 | Label       | string | The label shown to the user                                                                                                                                                                                                                                                                               |
 | pathname    | string | The routable URL pathname                                                                                                                                                                                                                                                                                 |
+| Property    | Type   | Description                                                                                                                                                                                                                                                                                               |
+| Label       | string | The label shown to the user                                                                                                                                                                                                                                                                               |
+| pathname    | string | The routable URL pathname                                                                                                                                                                                                                                                                                 |
 | conditions  | array  | (Optional) [Conditions](condition.md) for when the dashboard should be displayed                                                                                                                                                                                                                          |
 
 ### Full Example
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section-sidebar.md b/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section-sidebar.md
@@ -4,11 +4,11 @@
 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 %}
 
-<figure><img src="../../../.gitbook/assets/section-sidebar.svg" alt=""><figcaption><p>Section Sidebar</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-sidebar.svg" alt=""><figcaption><p>Section Sidebar</p></figcaption></figure>
 
 ## Section Sidebar Apps <a href="#section-sidebar-apps" id="section-sidebar-apps"></a>
 
-<figure><img src="../../../.gitbook/assets/section-sidebar-apps.svg" alt=""><figcaption><p>Section Sidebar Apps</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-sidebar-apps.svg" alt=""><figcaption><p>Section Sidebar Apps</p></figcaption></figure>
 
 **Manifest**
 
@@ -37,7 +37,7 @@ interface UmbSectionSidebarAppElement {}
 * To register a new menu sidebar app, add the following to your manifest
 * The menu sidebar app will reference a menu that you have registered in the menu with a menu manifest
 
-<figure><img src="../../../.gitbook/assets/section-menu-sidebar-app.svg" alt=""><figcaption><p>Menu Sidebar App</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-menu-sidebar-app.svg" alt=""><figcaption><p>Menu Sidebar App</p></figcaption></figure>
 
 **Manifest**
 
@@ -70,6 +70,6 @@ interface UmbMenuSectionSidebarAppElement {}
 
 This will make it possible to compose a sidebar menu from multiple Apps:
 
-<figure><img src="../../../.gitbook/assets/section-sidebar-composed-apps.svg" alt=""><figcaption><p>Composed sidebar menu</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-sidebar-composed-apps.svg" alt=""><figcaption><p>Composed sidebar menu</p></figcaption></figure>
 
-You can read more about this in the [Menu](../../../extending/section-trees/menu/) article.
+You can read more about this in the [Menu](../../../../extending/section-trees/menu/) article.
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section-view.md b/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section-view.md
@@ -10,7 +10,7 @@ description: >-
 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 %}
 
-<figure><img src="../../../.gitbook/assets/section-views.svg" alt=""><figcaption><p>Section View</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-views.svg" alt=""><figcaption><p>Section View</p></figcaption></figure>
 
 ## Creating a custom Section View
 
@@ -21,9 +21,7 @@ In this section, you can learn how to register and create a custom Section View
 The manifest file can be created using either JSON or Typescript. Both methods are shown below.
 
 {% tabs %}
-
-{% tab title="Json" %} 
-
+{% tab title="Json" %}
 We can create the manifest using json in the `umbraco-package.json`.
 
 ```json
@@ -45,15 +43,12 @@ We can create the manifest using json in the `umbraco-package.json`.
 	]
 }
 ```
-
 {% endtab %}
 
-{% tab title="Typescript" %} 
-
-
+{% tab title="Typescript" %}
 The manifest can also be written in TypeScript.
 
-For this typescript example we used a [Backoffice Entry Point](../../extending-overview/extension-types/backoffice-entry-point) extension to register the manifests.
+For this typescript example we used a [Backoffice Entry Point](../backoffice-entry-point/) extension to register the manifests.
 
 ```typescript
 import { ManifestSectionView } from "@umbraco-cms/backoffice/extension-registry";
@@ -78,18 +73,15 @@ const sectionViews: Array<ManifestSectionView> = [
     }
 ]
 ```
-
- {% endtab %}
-
+{% endtab %}
 {% endtabs %}
 
-
 ### Lit Element
 
 Creating the Section View Element using a Lit Element.
 
-
 **my-section.element.ts:**
+
 ```typescript
 import { UmbLitElement } from "@umbraco-cms/backoffice/lit-element";
 import { css, html, customElement, property } from '@umbraco-cms/backoffice/external/lit';
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md b/15/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
@@ -14,13 +14,13 @@ For example, when you load the backoffice, you'll see the 'Content' section, 'Se
 
 You can create your own sections to extend Umbraco with room for more features.
 
-<figure><img src="../../../.gitbook/assets/section.svg" alt=""><figcaption><p>Section</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section.svg" alt=""><figcaption><p>Section</p></figcaption></figure>
 
 ## **Creating a section**
 
 ### **Manifests**
 
-When creating a new section it's recommended to use a [Entry Point](../../../customizing/extending-overview/extension-types/backoffice-entry-point.md)-extension in your [Umbraco Package Manifest](../../umbraco-package.md). This is to get better control over all the additional extensions required for the new section.
+When creating a new section it's recommended to use a [Entry Point](../backoffice-entry-point.md)-extension in your [Umbraco Package Manifest](../../../umbraco-package.md). This is to get better control over all the additional extensions required for the new section.
 
 Create a section by defining a manifest for it:
 
@@ -38,15 +38,15 @@ Create a section by defining a manifest for it:
 
 Once registered, you will be able to select this action for your User Group Permissions. Once that is permitted, you can view your section.
 
-<figure><img src="../../../.gitbook/assets/section-empty.png" alt=""><figcaption><p>Section</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/section-empty.png" alt=""><figcaption><p>Section</p></figcaption></figure>
 
 #### **Extend with Sidebar, Dashboards and more**
 
 Once a section is registered, it can be extended like any other section.
 
 Here is a list of appropriate extensions to append to your section:
 
-* [Creating a Custom Dashboard](../../../tutorials/creating-a-custom-dashboard/)
+* [Creating a Custom Dashboard](../../../../tutorials/creating-a-custom-dashboard/)
 * [Section Sidebar](section-sidebar.md)
 * [Section View](section-view.md)
 
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-context.md b/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-context.md
@@ -13,7 +13,7 @@ A Workspace context is a container for the data of a workspace. It is a wrapper
 * A workspace context knows about its entity type (for example content, media, member, etc.) and holds its unique string (for example: key).
 * Most workspace contexts hold a draft state of its entity data. It is a copy of the entity data that can be modified at runtime and sent to the server to be saved.
 
-If a workspace wants to utilize Property Editor UIs, then it must provide a variant context for the property editors. The variant-context is the generic interface between workspace and property editors.&#x20;
+If a workspace wants to utilize Property Editor UIs, then it must provide a variant context for the property editors. The variant-context is the generic interface between workspace and property editors.
 
 ```ts
 interface UmbWorkspaceContext {}
@@ -80,4 +80,4 @@ export const UMB_APP_CONTEXT = new UmbContextToken<MyContextCounterApi>(
 );
 ```
 
-We recommend using `UmbWorkspaceContext` as the Context Alias for your Context Token. This will ensure that the requester only retrieves this Context if it's present at their nearest Workspace Context. Use the Extension Manifest Alias as the API Alias for your Context Token. For more information, see the [Context API](../../../customizing/foundation/working-with-data/context-api.md) article.
+We recommend using `UmbWorkspaceContext` as the Context Alias for your Context Token. This will ensure that the requester only retrieves this Context if it's present at their nearest Workspace Context. Use the Extension Manifest Alias as the API Alias for your Context Token. For more information, see the [Context API](../../../foundation/working-with-data/context-api.md) article.
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md b/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md
@@ -8,7 +8,7 @@ Workspace actions are a set of functionalities or operations that can be perform
 
 Workspace action relates to a workspace alias (Umb.Workspace.Document) and has Access to the workspace context.
 
-<figure><img src="../../../.gitbook/assets/workspace-actions.svg" alt=""><figcaption><p>Workspace Actions</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/workspace-actions.svg" alt=""><figcaption><p>Workspace Actions</p></figcaption></figure>
 
 **JavaScript Manifest example**
 
diff --git a/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-views.md b/15/umbraco-cms/customizing/extending-overview/extension-types/workspaces/workspace-views.md
@@ -14,7 +14,7 @@ Workspace Views was previously called Content Apps.
 
 Workspace Views are customizable companion **tabs** with the ability to take place in any workspace.
 
-<figure><img src="../../../.gitbook/assets/workspace-views.svg" alt=""><figcaption><p>Workspace Views</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/workspace-views.svg" alt=""><figcaption><p>Workspace Views</p></figcaption></figure>
 
 **In Content Section**
 
@@ -24,7 +24,7 @@ The default workspace view is **'Info'** - displaying Links, History and Status
 
 ## Example of a Workspace View
 
-1. Follow the [Vite Package Setup](../../../customizing/development-flow/vite-package-setup.md) by creating a new project folder called "`workspaceview`" in `App_Plugins`.
+1. Follow the [Vite Package Setup](../../../development-flow/vite-package-setup.md) by creating a new project folder called "`workspaceview`" in `App_Plugins`.
 2. Create a manifest file named `umbraco-package.json` at the root of the `welcome-dashboard` folder. Here we define and configure our dashboard.
 3. Add the following code to `umbraco-package.json`:
 
@@ -93,7 +93,7 @@ declare global {
 
 In the `workspaceview` folder run `npm run build` and then run the project. Then in the content section of the Backoffice you will see our new Workspace View:
 
-<figure><img src="../../../.gitbook/assets/workspace-view-example.png" alt=""><figcaption><p>Workspace View Example</p></figcaption></figure>
+<figure><img src="../../../../.gitbook/assets/workspace-view-example.png" alt=""><figcaption><p>Workspace View Example</p></figcaption></figure>
 
 {% hint style="info" %}
 To see the Workspace View that we have created in the content section, first you will need to have some content created.
diff --git a/15/umbraco-cms/customizing/section-trees.md b/15/umbraco-cms/customizing/section-trees.md
@@ -16,7 +16,7 @@ For example, when you load the backoffice, you'll see that the 'Content' section
 
 You can create your own sections and trees to extend Umbraco.
 
-## [Sections](extending-overview/extension-types/section.md)
+## [Sections](extending-overview/extension-types/sections/section.md)
 
 Describes Umbraco Sections, configuration, and APIs.
 
diff --git a/15/umbraco-cms/customizing/umbraco-package.md b/15/umbraco-cms/customizing/umbraco-package.md
diff --git a/15/umbraco-cms/customizing/workspaces.md b/15/umbraco-cms/customizing/workspaces.md
diff --git a/15/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md b/15/umbraco-cms/fundamentals/setup/install/install-umbraco-with-templates.md
