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-registry/register-extensions.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
description: >-
3
-
Bringing new UI or additional features to the Backoffice is done by
3
+
You can bring new UI or additional features to the Backoffice by
4
4
registering an Extension via an Extension Manifest.
5
5
---
6
6
@@ -54,7 +54,7 @@ There are two additional, optional properties that can be useful:
54
54
*`version` - the version of the package that is displayed in the backoffice in the overview of installed packages. This is also used for package migrations.
55
55
56
56
57
-
This is an example of a full umbraco-package.json that registers two localization extensions:
57
+
This is an example of a full `umbraco-package.json` that registers two localization extensions:
58
58
59
59
```json
60
60
{
@@ -74,7 +74,7 @@ This is an example of a full umbraco-package.json that registers two localizatio
74
74
},
75
75
{
76
76
"type": "localization",
77
-
"alias": "MyCustomizations.Localize.NlNl",
77
+
"alias": "MyCustomizations.Localize.DkDk",
78
78
"name": "Danish",
79
79
"meta": {
80
80
"culture": "dk"
@@ -88,7 +88,7 @@ This is an example of a full umbraco-package.json that registers two localizatio
88
88
89
89
## Advanced Registration
90
90
### The Bundle Approach
91
-
Instead of registering each manifest in the `umbraco-package.json`, you can have multiple manifests and build them into a bundle. You then register this bundle in a single `bundle` extension. In larger projects with a lot of extensions, this allows you to keep your umbraco-package.json file leaner. Read more in the [bundle approach](../extension-types/bundle.md).
91
+
Instead of registering each manifest in the `umbraco-package.json`, you can have multiple manifests and build them into a bundle. You then register this bundle in a single `bundle` extension. In larger projects with a lot of extensions, this allows you to keep your `umbraco-package.json` file cleaner. Read more in the [bundle approach](../extension-types/bundle.md).
92
92
93
93
### The Entry Point Approach
94
94
The Entry Point is an extension that executes a method on startup. You can use this for different tasks, such as performing initial configuration and registering other Extension Manifests. Read more in [the entry point approach](../extension-types/backoffice-entry-point.md).
Copy file name to clipboardExpand all lines: 16/umbraco-cms/customizing/extending-overview/extension-registry/replace-exclude-or-unregister.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,13 +10,13 @@ Besides adding extensions to Umbraco, sometimes you want to change what is alrea
10
10
11
11
12
12
## Replace
13
-
You can have an extension that replaces another extension.
13
+
You can replace an existing extension by another one.
14
14
You can do this by defining the `overwrites` property in your [Extension Manifest](extension-manifest.md) with one Extension Alias. For multiple `overwrites` you can provide the Extension Aliases that need to be replaced as an array.
15
15
16
16
17
17
18
18
19
-
This example overrides the save and preview button with an external preview button (single overwrite):
19
+
This example overrides the `save and preview` button with an external "preview" button (single overwrite):
20
20
21
21
```typescript
22
22
const manifest = {
@@ -29,7 +29,7 @@ const manifest = {
29
29
```
30
30
31
31
32
-
This example overrides both the save and preview button as well as the save button with an external preview button (multiple overwrite):
32
+
This example overrides both the `save and preview` button as well as the `save` button with an external "preview" button (multiple overwrite):
33
33
34
34
```typescript
35
35
const manifest = {
@@ -46,7 +46,7 @@ If your extension has conditions, the overwritten extensions will only be hidden
46
46
47
47
48
48
## Exclude
49
-
When you exclude an extension, the extension will never be displayed. This allows you to permanently hide, for example, a menu or a button. This does not unregister the extensions, but rather flags them as excluded. This also means that no one else can register an extension with the same alias as the excluded extension.
49
+
When you exclude an extension, the extension will never be displayed. This allows you to permanently hide, for example, a menu or a button. This does not unregister the extension, but rather flags it as excluded. This also means that no one else can register an extension with the same alias as the excluded extension.
50
50
51
51
52
52
{% hint style="warning" %}
@@ -66,7 +66,7 @@ When and where you execute this code depends on your situation. In many cases, i
66
66
67
67
68
68
## Unregister
69
-
You can also choose to unregister an extension. You should only use this on extensions you registered yourself and have control over. Otherwise, you might try to remove an extension before it is registered. A use case for this is if you temporarily registered an extension and you want to remove it again.
69
+
You can also choose to unregister an extension. You should only use this on extensions you registered yourself and have control over. Otherwise, you might try to remove an extension before it is registered. A use case for this, is if you temporarily registered an extension and you want to remove it again.
70
70
71
71
In other cases, you can use the `overwrites` or `exclude` option. The difference with the `exclude` approach is that unregistering removes the extension from the Extension Registry. This allows you to re-register extensions with the same alias.
0 commit comments