Skip to content

Commit 66ec5c7

Browse files
committed
Refine "Extension Types" documentation: fixed formatting inconsistencies, clarified descriptions, and improved section ordering in the summary.
1 parent 233af9f commit 66ec5c7

File tree

2 files changed

+46
-76
lines changed

2 files changed

+46
-76
lines changed

16/umbraco-cms/SUMMARY.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -154,35 +154,35 @@
154154
* [Extension Manifest](customizing/extending-overview/extension-registry/extension-manifest.md)
155155
* [Replace, Exclude or Unregister](customizing/extending-overview/extension-registry/replace-exclude-or-unregister.md)
156156
* [Extension Types](customizing/extending-overview/extension-types/README.md)
157-
* [Sections](customizing/extending-overview/extension-types/sections/README.md)
158-
* [Sections](customizing/extending-overview/extension-types/sections/section.md)
159-
* [Section Sidebar](customizing/extending-overview/extension-types/sections/section-sidebar.md)
160-
* [Section View](customizing/extending-overview/extension-types/sections/section-view.md)
161-
* [Workspaces](customizing/extending-overview/extension-types/workspaces/README.md)
162-
* [Workspace Actions](customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md)
163-
* [Workspace Context](customizing/extending-overview/extension-types/workspaces/workspace-context.md)
164-
* [Workspace Views](customizing/extending-overview/extension-types/workspaces/workspace-views.md)
165-
* [Menu](customizing/extending-overview/extension-types/menu.md)
166-
* [Header Apps](customizing/extending-overview/extension-types/header-apps.md)
167-
* [Icons](customizing/extending-overview/extension-types/icons.md)
168-
* [Block Custom View](customizing/extending-overview/extension-types/block-custom-view.md)
169-
* [Bundle](customizing/extending-overview/extension-types/bundle.md)
170-
* [Kind](customizing/extending-overview/extension-types/kind.md)
171157
* [App Entry Point](customizing/extending-overview/extension-types/app-entry-point.md)
172158
* [Backoffice Entry Point](customizing/extending-overview/extension-types/backoffice-entry-point.md)
173-
* [Extension Conditions](customizing/extending-overview/extension-types/condition.md)
159+
* [Block Custom View](customizing/extending-overview/extension-types/block-custom-view.md)
160+
* [Bundle](customizing/extending-overview/extension-types/bundle.md)
174161
* [Dashboards](customizing/extending-overview/extension-types/dashboard.md)
175162
* [Entity Actions](customizing/extending-overview/extension-types/entity-actions.md)
176163
* [Entity Bulk Actions](customizing/extending-overview/extension-types/entity-bulk-actions.md)
177164
* [Entity Create Option Action](customizing/extending-overview/extension-types/entity-create-option-action.md)
178-
* [Property Value Preset](customizing/extending-overview/extension-types/property-value-preset.md)
179-
* [Trees](customizing/extending-overview/extension-types/tree.md)
165+
* [Extension Conditions](customizing/extending-overview/extension-types/condition.md)
180166
* [Global Context](customizing/extending-overview/extension-types/global-context.md)
167+
* [Header Apps](customizing/extending-overview/extension-types/header-apps.md)
168+
* [Icons](customizing/extending-overview/extension-types/icons.md)
169+
* [Kinds](customizing/extending-overview/extension-types/kind.md)
181170
* [Localization](customizing/extending-overview/extension-types/localization.md)
171+
* [Menu](customizing/extending-overview/extension-types/menu.md)
182172
* [Modals](customizing/extending-overview/extension-types/modals/README.md)
183-
* [Confirm Dialog](customizing/extending-overview/extension-types/modals/confirm-dialog.md)
184-
* [Custom Modals](customizing/extending-overview/extension-types/modals/custom-modals.md)
185-
* [Modal Route Registration](customizing/extending-overview/extension-types/modals/route-registration.md)
173+
* [Confirm Dialog](customizing/extending-overview/extension-types/modals/confirm-dialog.md)
174+
* [Custom Modals](customizing/extending-overview/extension-types/modals/custom-modals.md)
175+
* [Modal Route Registration](customizing/extending-overview/extension-types/modals/route-registration.md)
176+
* [Property Value Preset](customizing/extending-overview/extension-types/property-value-preset.md)
177+
* [Sections](customizing/extending-overview/extension-types/sections/README.md)
178+
* [Sections](customizing/extending-overview/extension-types/sections/section.md)
179+
* [Section Sidebar](customizing/extending-overview/extension-types/sections/section-sidebar.md)
180+
* [Section View](customizing/extending-overview/extension-types/sections/section-view.md)
181+
* [Trees](customizing/extending-overview/extension-types/tree.md)
182+
* [Workspaces](customizing/extending-overview/extension-types/workspaces/README.md)
183+
* [Workspace Actions](customizing/extending-overview/extension-types/workspaces/workspace-editor-actions.md)
184+
* [Workspace Context](customizing/extending-overview/extension-types/workspaces/workspace-context.md)
185+
* [Workspace Views](customizing/extending-overview/extension-types/workspaces/workspace-views.md)
186186
* [Extension Kind](customizing/extending-overview/extension-kind.md)
187187
* [Extension Conditions](customizing/extending-overview/extension-conditions.md)
188188
* [Custom Extension types](customizing/extending-overview/custom-extension-type.md)

16/umbraco-cms/customizing/extending-overview/extension-types/README.md

Lines changed: 26 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -7,139 +7,109 @@ description: >-
77

88
## General Features
99

10-
Extension Types in Umbraco allow developers to extend and customize the behavior of the backoffice. Each type provides
11-
unique functionality, such as creating custom dashboards, enhancing entity actions, or enabling localization. Learn more
12-
about the shared properties and overall structure in the
13-
[Extension Manifest](../extension-registry/extension-manifest.md) article.
10+
Extension Types in Umbraco allow developers to extend and customize the behavior of the backoffice. Each type provides unique functionality, such as creating custom dashboards, enhancing entity actions, or enabling localization. Learn more about the shared properties and overall structure in the [Extension Manifest](../extension-registry/extension-manifest.md) article.
1411

1512
## Common Extension Types
1613

17-
The **Umbraco backoffice** provides **Extension Types** designed to meet a variety of customization needs. These include
18-
extensions tailored for specific functionalities, as well as general-purpose extensions for broader use cases.
14+
The **Umbraco backoffice** provides **Extension Types** designed to meet a variety of customization needs. These include extensions tailored for specific functionalities, as well as general-purpose extensions for broader use cases.
1915

2016
### [App Entry Point](app-entry-point.md)
2117

22-
The `App Entry Point` extension type is used to execute JavaScript when Umbraco starts up. The code will run before
23-
the user has logged in or the backoffice has initialized.
18+
The `App Entry Point` extension type is used to execute JavaScript when Umbraco starts up. The code will run before the user has logged in or the backoffice has initialized.
2419

2520
### [Backoffice Entry Point](backoffice-entry-point.md)
2621

27-
The `backofficeEntryPoint` extension type is used to execute JavaScript upon initialization of the backoffice. This
28-
extension type provides lifecycle hooks (startup, teardown) for extension developers to customize backoffice behavior.
22+
The `backofficeEntryPoint` extension type is used to execute JavaScript upon initialization of the backoffice. This extension type provides lifecycle hooks (startup, teardown) for extension developers to customize backoffice behavior.
2923

3024
### [Block Custom View](block-custom-view.md)
3125

32-
The `blockEditorCustomView` extension type is used to define a custom web component for representing blocks inside the
33-
Umbraco block grid property editor.
26+
The `blockEditorCustomView` extension type is used to define a custom web component for representing blocks inside the Umbraco block grid property editor.
3427

3528
### [Bundle](bundle.md)
3629

37-
The `bundle` extension type is used to aggregate multiple extension manifests into a single entity, which will be
38-
registered at startup.
30+
The `bundle` extension type is used to aggregate multiple extension manifests into a single entity, which will be registered at startup.
3931

4032
### [Dashboards](dashboard.md)
4133

42-
The `dashboard` extension type enables extension authors to create custom informational panels that can be displayed
43-
in the Umbraco backoffice. These extensions can be added to existing Umbraco sections or to a custom section.
34+
The `dashboard` extension type enables extension authors to create custom informational panels that can be displayed in the Umbraco backoffice. These extensions can be added to existing Umbraco sections or to a custom section.
4435

4536
### [Entity Actions](entity-actions.md)
4637

47-
The `entityAction` extension type is used to create menus for operations on an entity such as a document or media item.
48-
Built-in backoffice examples include: "Trash", "Duplicate to...", "Publish" etc.
38+
The `entityAction` extension type is used to create menus for operations on an entity such as a document or media item. Built-in backoffice examples include: "Trash", "Duplicate to...", "Publish" etc.
4939

5040
### [Entity Bulk Actions](entity-bulk-actions.md)
5141

52-
The `entityBulkAction` extension type works similarly to the **Entity Actions** extension type, but with the
53-
ability to perform the actions on a selection of entities from a collection.
42+
The `entityBulkAction` extension type works similarly to the **Entity Actions** extension type, but performs the actions on a selection of entities from a collection.
5443

5544
### [Entity Create Option Action](entity-create-option-action.md)
5645

57-
The `entityCreateOptionAction` extension type is used to provide custom entity creation actions via a dedicated
58-
modal interface.
46+
The `entityCreateOptionAction` extension type is used to provide custom entity creation actions via a dedicated modal interface.
5947

6048
### [Extension Conditions](condition.md)
6149

62-
Most extension types support conditions which allow extension authors to control when and where the extension is
63-
available. This type enables extension authors to define their own conditions.
50+
Most extension types support conditions which allow extension authors to control when and where the extension is available. This type enables extension authors to define their own conditions.
6451

6552
### [Global Context](global-context.md)
6653

67-
The `globalContext` extension type creates a custom context of data and functions, accessible throughout the entire
68-
backoffice and the entirety of the session.
54+
The `globalContext` extension type creates a custom context of data and functions, accessible throughout the entire backoffice and the entirety of the session.
6955

7056
### [Header Apps](header-apps.md)
7157

72-
The `headerApp` extension type is used to place single-purpose extensions in the top-level navigation bar. These
73-
extensions appear next to the user profile.
58+
The `headerApp` extension type is used to place single-purpose extensions in the top-level navigation bar. These extensions appear next to the user profile.
7459

7560
### [Icons](icons.md)
7661

77-
The `icons` extension type is used to make custom icon extension sets available in the Umbraco backoffice and in
78-
custom Umbraco UI components. Extension authors provide SVG files and register them using this extension type.
62+
The `icons` extension type is used to make custom icon extension sets available in the Umbraco backoffice and in custom Umbraco UI components. Extension authors provide SVG files and register them using this extension type.
7963

8064
### [Kinds](kind.md)
8165

82-
The `kind` extension type is used to create custom extension configurations that can be used as the basis of, or
83-
be inherited by, other custom extension types.
66+
The `kind` extension type is used to create custom extension configurations to be used as the basis of other custom extension types. They can be inherited by other extension types.
8467

8568
### [Localization](localization.md)
8669

87-
The `localization` extension type is used to register additional languages and files of translation strings that can
88-
be used in Umbraco backoffice extensions.
70+
The `localization` extension type is used to register additional languages and files of translation strings that can be used in Umbraco backoffice extensions.
8971

9072
### [Menu](menu.md)
9173

92-
The `menu` extension type is used to create custom menus that can be placed in sidebar extensions or displayed as a
93-
fly-out from a button, header, or workspace view.
74+
The `menu` extension type is used to create custom menus. These can be placed in sidebar extensions or displayed as a fly-out from a button, header, or workspace view.
9475

9576
### [Modals](modals/README.md)
9677

9778
The `modal` extension type is used to configure and present dialogs and sidebars within the Umbraco backoffice.
9879

9980
### [Property Level UI Permissions](../../property-level-ui-permissions.md)
10081

101-
Umbraco allows system administrators to define read and write permissions on an individual property basis.
102-
`Property Level UI Permissions` can be created to define customized rules to fit any use case.
82+
Umbraco allows system administrators to define read and write permissions on an individual property basis. `Property Level UI Permissions` can be created to define customized rules to fit any use case.
10383

10484
### [Property Value Preset](property-value-preset.md)
10585

106-
The `propertyValuePreset` extension type is used to customize the default value of a property editor and allow for
107-
dynamic behavior through hooks.
86+
The `propertyValuePreset` extension type is used to customize the default value of a property editor and allow for dynamic behavior through hooks.
10887

10988
### [Sections](sections/README.md)
11089

111-
The `section` extension type is used to place top-level navigation items within the Umbraco backoffice. Custom
112-
Section extensions appear alongside Content, Media, Settings, and others, as seen in the purple navigation bar.
90+
The `section` extension type is used to place top-level navigation items within the Umbraco backoffice. Custom Section extensions appear alongside Content, Media, Settings, and others, as seen in the purple navigation bar.
11391

11492
### [Tip-Tap Extensions](../../../fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/extensions.md)
11593

116-
The Tip-Tap editor is the newest and default text editor in Umbraco. Tip-Tap can be extended with either native
117-
extensions or toolbar extensions.
94+
The Tip-Tap editor is the default text editor in Umbraco. Tip-Tap can be extended with either native
11895

11996
### [Trees](tree.md)
12097

121-
The `tree` extension type is used to create a hierarchical structure composed of nodes, such as documents or media
98+
The `tree` extension type is used to create a hierarchical structure composed of nodes, such as documents or media extensions or toolbar extensions.
12299
items.
123100

124101
### [Umbraco Flavored Markup Components](../../../reference/umbraco-flavored-markdown.md)
125102

126-
`Umbraco Flavored Markup (UFM) Components`, are used to create descriptions and labels for entities across the
127-
backoffice. These replace the previous "Label Property Configuration" feature. Extension authors can create custom
128-
components that go beyond textual labels, including creating hooks that allow for imperative programming tasks and
129-
custom markup.
103+
`Umbraco Flavored Markup (UFM) Components`, are used to create descriptions and labels for entities across the backoffice. These replace the previous "Label Property Configuration" feature. Extension authors can create custom components that go beyond textual labels, including creating hooks that allow for imperative programming tasks and custom markup.
130104

131105
### [Workspaces](workspaces/README.md)
132106

133-
The `workspace` extension type provides functionality that operates within specific workspace environments, such as
134-
document editing, media management, or member editing.
107+
The `workspace` extension type provides functionality that operates within specific workspace environments, such as document editing, media management, or member editing.
135108

136109
## Even More Extension Types
137110

138-
Umbraco provides a number of additional extension types that can be used to extend the backoffice. The backoffice
139-
contains an interactive browser for exploring all available extension types. This feature also allows users to confirm
140-
that their own backoffice extensions are found and loaded by the backoffice.
111+
Umbraco provides a number of additional extension types that can be used to extend the backoffice. The backoffice contains an interactive browser for exploring all available extension types. This feature also allows users to confirm that their own backoffice extensions are found and loaded by the backoffice.
141112

142-
To use the Extension Insights browser, navigate to the **Settings** section of the backoffice and select
143-
**Extension Insights** from the sidebar. A comprehensive list of available types can be found in the dropdown menu.
113+
To use the Extension Insights browser, navigate to the **Settings** section of the backoffice and select **Extension Insights** from the sidebar. A comprehensive list of available types can be found in the dropdown menu.
144114

145115
<figure><img src="../../../.gitbook/assets/extension-types-backoffice-browser.png" alt=""><figcaption><p>Backoffice extension browser</p></figcaption></figure>

0 commit comments

Comments
 (0)