@2sic.com/dnn-sxc-angular

dnn-sxc-angular - Connecting Angular to DNN and/or 2sxc

Connector for Angular 6 / 7) for developers who use...

1. ...the open source platform DNN 7+ (git | web)
2. ...and/or the open source CMS 2sxc 7+ (git | web)

This is a helper which

1. automatically provides all dnn-parameters (module ID, security token, etc.) to Angular
2. adds an Http Interceptor for the HttpClient which automatically applies these parameters to all requests
3. prevents the enter-key from causing DNN form submits (optional, you can override this)

It uses observables to make it happen, thereby avoiding timing / async problems common in this scenario.

Setup

It's published on npm, so the most common way is to get it using npm with npm install "@2sic.com/dnn-sxc-angular" --save.

1. Follow the quickstart guide to start using dnn-sxc-angular.
2. To develop locally using ng serve follow these instructions

Access DNN or 2sxc WebAPIs

This works automatically, because all headers etc. are automatically added by dnn-sxc-angular.

Using 2sxc Content-Items, Queries and APIs

This package contains a Data object, which provides 3 observable streams

• content$
• query$
• api$

To use them, best check out the demo app or simply work through TypeScript intelisense - we documented all the commands.

Get ModuleId, TabId, etc. and the sxc Instance

There is a Context object which provides these properties as streams (observables). Just inject Context and access it from there. Note that you almost never need this, as the HttpClient is already configured and ready to go, including the headers it needs.

• moduleId$
• tabId$
• sxc$
• etc.

Internal Notes

• read npm instructions to see how to publish a release

Todo

• enhance the content-manager to provide write commands (ATM read-only)