Skip to content

Commit ddcd2dc

Browse files
Luuk PetersLuuk Peters
authored andcommitted
Merge branch 'feature/7360_extension_registry' of https://github.com/Luuk1983/UmbracoDocs into feature/7360_extension_registry
2 parents 0af7332 + 38be4e9 commit ddcd2dc

File tree

2 files changed

+9
-9
lines changed

2 files changed

+9
-9
lines changed

16/umbraco-cms/customizing/extending-overview/extension-registry/register-extensions.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
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
44
registering an Extension via an Extension Manifest.
55
---
66

@@ -54,7 +54,7 @@ There are two additional, optional properties that can be useful:
5454
* `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.
5555

5656

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:
5858

5959
```json
6060
{
@@ -74,7 +74,7 @@ This is an example of a full umbraco-package.json that registers two localizatio
7474
},
7575
{
7676
"type": "localization",
77-
"alias": "MyCustomizations.Localize.NlNl",
77+
"alias": "MyCustomizations.Localize.DkDk",
7878
"name": "Danish",
7979
"meta": {
8080
"culture": "dk"
@@ -88,7 +88,7 @@ This is an example of a full umbraco-package.json that registers two localizatio
8888

8989
## Advanced Registration
9090
### 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).
9292

9393
### The Entry Point Approach
9494
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).

16/umbraco-cms/customizing/extending-overview/extension-registry/replace-exclude-or-unregister.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ Besides adding extensions to Umbraco, sometimes you want to change what is alrea
1010

1111

1212
## Replace
13-
You can have an extension that replaces another extension.
13+
You can replace an existing extension by another one.
1414
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.
1515

1616

1717

1818

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):
2020

2121
```typescript
2222
const manifest = {
@@ -29,7 +29,7 @@ const manifest = {
2929
```
3030

3131

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):
3333

3434
```typescript
3535
const manifest = {
@@ -46,7 +46,7 @@ If your extension has conditions, the overwritten extensions will only be hidden
4646

4747

4848
## 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.
5050

5151

5252
{% hint style="warning" %}
@@ -66,7 +66,7 @@ When and where you execute this code depends on your situation. In many cases, i
6666

6767

6868
## 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.
7070

7171
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.
7272

0 commit comments

Comments
 (0)