Backoffice extensions

v 15.0.0

Backoffice extensions

With the introduction of "the new backoffice" aka. Bellissima in Umbraco v14, the way that backoffice extensions are built drastically changed.

The old AngularJS-implementation was thrown away and a new, modern, implementation using Web Components was introduced. We'll refer you to the umbraco documentation to read about the basics of setting up a development environment.

You can also use our NewsletterStudioContrib-project as a starting point - it has all the setup you need.

Newsletter Studio comes with a couple of extension points for the backoffice, here are a overview of the extension type aliases we support

  • nsEmailControlEditUi used when creating a email control.
  • nsEmailControlDisplayUi used when creating a email control.
  • nsAction - used to inject actions (like remove, duplicate, export etc) for different entities like nsRecipient, nsMailingList etc.
  • nsEmailServiceProviderSettingsUi - optionally used when building a custom Email Service Provider.

Helpful components

We ship a couple of helpful components that can be used for debugging issues during the development of a extension.

ns-validation-errors-debugging

Use this to show validation errors in the current context so understand why a form is not considered valid.

<ns-validation-errors-debug></ns-validation-errors-debug>

ns-json-debug

Used to show a nice pre-element with formatted JSON-data.

<ns-json-debug .data=${this.myModel}></ns-json-debug>