You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 16/umbraco-cms/customizing/extending-overview/extension-types/sections/section-sidebar.md
+2-6Lines changed: 2 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,9 +20,7 @@ Section Sidebar extensions can be composed of **one or more** section sidebar ap
20
20
21
21
### Custom Sidebar App Example
22
22
23
-
Section Sidebar extension authors can place any custom web component into the sidebar. Extension authors will need to
24
-
supply the `element` property with the path of their custom web component. Specify the full path, starting from the
25
-
Umbraco project root.
23
+
Section Sidebar extension authors can place any custom web component into the sidebar. Extension authors will need to supply the `element` property with the path of their custom web component. Specify the full path, starting from the Umbraco project root.
26
24
27
25
Sidebar Section extension authors may specify where the Section Sidebar app appears using
28
26
[extension conditions](../condition.md).
@@ -94,9 +92,7 @@ For more information, see the documentation for the [menus](../menu.md) extensio
94
92
95
93
#### Coordinating subviews with menu items
96
94
97
-
Menu sidebar apps can coordinate navigation between subviews in the section extension by referencing
98
-
[workspace extensions](../workspaces/workspace.md). Modify the menu item extension to include the `meta:entityType`
99
-
property, and assign it the same value as a workspace view extensions' own `meta:entityType` property.
95
+
Menu sidebar apps can coordinate navigation between subviews in the section extension by referencing [workspace extensions](../workspaces/workspace.md). Modify the menu item extension to include the `meta:entityType` property, and assign it the same value as a workspace view extensions' own `meta:entityType` property.
Copy file name to clipboardExpand all lines: 16/umbraco-cms/customizing/extending-overview/extension-types/sections/section-view.md
+6-12Lines changed: 6 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,8 +11,7 @@ Section View extensions are containers for custom Umbraco packages or other back
11
11
12
12
## Creating a custom Section View
13
13
14
-
Custom Section View extensions are straightforward to create. Extension authors register the Section View extension and
15
-
subsequently implement the content or interface they desire to display within the Section View.
14
+
Custom Section View extensions are straightforward to create. Extension authors register the Section View extension and subsequently implement the content or interface they desire to display within the Section View.
16
15
17
16
### Registering Section View extensions
18
17
@@ -51,8 +50,7 @@ Extensions authors can register the Section View extension using a JSON declarat
51
50
```
52
51
{% endcode %}
53
52
54
-
Tip: Use the absolute path, starting from the root of your Umbraco project, in the `element` property for
55
-
JSON declarations. TypeScript declarations are capable of employing relative paths.
53
+
Tip: Use the absolute path, starting from the root of your Umbraco project, in the `element` property for JSON declarations. TypeScript declarations are capable of employing relative paths.
56
54
57
55
{% endtab %}
58
56
@@ -133,13 +131,11 @@ declare global {
133
131
134
132
## Adding Section Views to your own package
135
133
136
-
When developing a Section View extension for their own package, an extension author must create a Section extension to
137
-
host the Section View extension.
134
+
When developing a Section View extension for their own package, an extension author must create a Section extension to host the Section View extension.
138
135
139
136
Guidelines on creating Section extensions can be found at [this link](./section.md).
140
137
141
-
To link a Section View with a Section, set the `match` property in the condition to the same value as the Section's `alias`. In the
142
-
provided example, this value is `NetworkServices.Section`.
138
+
To link a Section View with a Section, set the `match` property in the condition to the same value as the Section's `alias`. In the provided example, this value is `NetworkServices.Section`.
143
139
144
140
{% code title="umbraco-package.json" %}
145
141
```json
@@ -178,11 +174,9 @@ provided example, this value is `NetworkServices.Section`.
178
174
179
175
The Umbraco backoffice architecture places a strong emphasis on composing. Authors can extend existing sections, including core ones like Content, Media, and Settings, with Section View extensions.
180
176
181
-
After an author has completed their Section View extension, they can control the placement of the extension using
182
-
conditions in the manifest definition.
177
+
After an author has completed their Section View extension, they can control the placement of the extension using conditions in the manifest definition.
183
178
184
-
The `match` property demonstrates how an extension author can incorporate a custom Section View within the Content
185
-
section.
179
+
The `match` property demonstrates how an extension author can incorporate a custom Section View within the Content section.
Copy file name to clipboardExpand all lines: 16/umbraco-cms/customizing/extending-overview/extension-types/sections/section.md
+7-16Lines changed: 7 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,11 +4,9 @@ description: Introducing Section extensions, a home for custom content and funct
4
4
5
5
# Section
6
6
7
-
Umbraco extension authors can place their extension in the top-level navigation of the backoffice using Sections. The
8
-
extension will be placed among the default options such as Content, Media, Settings, etc.
7
+
Umbraco extension authors can place their extension in the top-level navigation of the backoffice using Sections. The extension will be placed among the default options such as Content, Media, Settings, etc.
9
8
10
-
Within the section, authors can add menus, section views, workspace views, or any other content or interface they
11
-
desire.
9
+
Within the section, authors can add menus, section views, workspace views, or any other content or interface they desire.
@@ -34,14 +32,11 @@ Sections can be created by adding a definition in the extension's manifest file.
34
32
35
33
### **Group permissions**
36
34
37
-
To enable custom sections for backoffice users, site administrators must first assign permissions to those users. This
38
-
involves configuring the permission for a user group and assigning users to that group.
35
+
To enable custom sections for backoffice users, site administrators must first assign permissions to those users. This involves configuring the permission for a user group and assigning users to that group.
39
36
40
-
To grant access to the custom section, open the Umbraco backoffice, navigate to the **Users** section, and select the
41
-
**User groups** menu item. Site administrators can create a new user group or modify an existing one.
37
+
To grant access to the custom section, open the Umbraco backoffice, navigate to the **Users** section, and select the **User groups** menu item. Site administrators can create a new user group or modify an existing one.
42
38
43
-
Once the user group is open, click the **Choose** button under the Sections section. Select the custom section from the
44
-
slide-out modal to enable access.
39
+
Once the user group is open, click the **Choose** button under the Sections section. Select the custom section from the slide-out modal to enable access.
45
40
46
41
<figure><imgsrc="../../../../.gitbook/assets/sections-assigning.png"alt=""><figcaption><p>Enabling new Sections</p></figcaption></figure>
47
42
@@ -51,15 +46,11 @@ After assigning permission, users may need to reload the backoffice for the chan
51
46
52
47
### **Entry points**
53
48
54
-
When creating a new section, create an [Entry Point](../backoffice-entry-point.md) extension in the
55
-
[Umbraco Package Manifest](../../../umbraco-package.md) to complement it. Entry Point extensions add initialization and
56
-
teardown lifecycle events that may be helpful in coordinating behavior inside the section.
49
+
When creating a new section, create an [Entry Point](../backoffice-entry-point.md) extension in the [Umbraco Package Manifest](../../../umbraco-package.md) to complement it. Entry Point extensions add initialization and teardown lifecycle events that may be helpful in coordinating behavior inside the section.
57
50
58
51
## **Extend with Sidebar, Dashboards, and more**
59
52
60
-
Sections serve as blank canvases within the Umbraco backoffice. Extension authors can integrate other Umbraco extensions
61
-
into sections, including [custom dashboards](../../../../tutorials/creating-a-custom-dashboard/),
62
-
[sidebars](section-sidebar.md), and [section views](section-view.md).
53
+
Sections serve as blank canvases within the Umbraco backoffice. Extension authors can integrate other Umbraco extensions into sections, including [custom dashboards](../../../../tutorials/creating-a-custom-dashboard/), [sidebars](section-sidebar.md), and [section views](section-view.md).
63
54
64
55
Section authors can also skip Umbraco backoffice components and build a fully custom view by creating an empty element.
0 commit comments