Products

Solutions

Learn More

Partners

Community

Blog

About

DNN Community Blog

The Community Blog is a personal opinion of community members and by no means the official standpoint of DNN Corp or DNN Platform. This is a place to express personal thoughts about DNNPlatform, the community and its ecosystem. Do you have useful information that you would like to share with the DNN Community in a featured article or blog? If so, please contact .

The use of the Community Blog is covered by our Community Blog Guidelines - please read before commenting or posting.


How To Create Links Which Run CMS Commands (new 2sxc 8.6)

Sometimes you want to have edit-buttons or "change-layout" buttons which don't look like 2sxc-toolbars. For example in tables showing many items, on JavaScript SPAs or when creating a dashboard-style interface which is simply different. This is now easy (requires 2sxc 8.6)...

Understanding Commands

The first thing you must know is that each CMS action performed by 2sxc - be it "edit item 27" or "open layout-switcher" or even "show table of all BlogPost items" is internally handled by a command. You can find a technical explanation and a full list of commands in the 2sxc wiki: Commands.

A in-page toolbar is technically just a list of links, calling these commands. So you too can create links which call these commands. 

Running Commands

To run a command, a few things must be known:

  1. The context - because running a "show layout-switcher" or "edit the query" requires the system to know which module we're currently clicking on. 
  2. The action (aka command-name)
  3. The parameters needed by this action
  4. The click-event (optional)

Getting the context when clicking a link is easy, because all you need to do is write $2sxc(this), which gives you a 2sxc-controller for the module you are on. Providing the action is done by you, simply by telling the manager to run the action name, like this:

$2sxc(this).manage.run("layout")

Additional parameters are then added as an additional object, like this:

$2sxc(this).manage.run("new", { contentType: "BlogPost" })

And since we're usually in a click-event, it helps to pass the event into the call, just in case the command could use it for something, like this: 

$2sxc(this).manage.run("new", { contentType: "BlogPost" }, event)

An Real Example

Imagine you had a table showing many items (using Razor) and you want to create a text-link just to edit it. Here's how:

<a onclick='$2sxc(this).manage.run({"action": "edit", "entityId": @Content.EntityId})'>edit [email protected]</a>

As you can see, this example passes the EntityId from Razor to the generated line, the rest is all simple Html and JavaScript.

More Examples in Tutorial App

We created an App showing more examples. 

Enjoy!

Daniel and the 2sic-team


Daniel Mettler grew up in the jungles of Indonesia and is founder and CEO of 2sic internet solutions in Switzerland and Liechtenstein, an 20-head web specialist with over 800 DNN projects since 1999. He is also chief architect of 2sxc (see forge), an open source module for creating attractive content and DNN Apps.



Read more posts by Daniel Mettler

Comments

There are currently no comments, be the first to post one.

Comment Form

Only registered users may post comments.

NewsArchives


2sic Daniel Mettler (133)
Aderson Oliveira (15)
Alec Whittington (11)
Alex Shirley (10)
Andrew Nurse (30)
Anthony Glenwright (5)
Antonio Chagoury (28)
Ash Prasad (25)
Ben Schmidt (1)
Benjamin Hermann (25)
Benoit Sarton (9)
Beth Firebaugh (12)
Bill Walker (36)
Bob Kruger (5)
Brian Dukes (2)
Brice Snow (1)
Bruce Chapman (20)
Bryan Andrews (1)
cathal connolly (55)
Charles Nurse (163)
Chris Hammond (203)
Chris Paterra (55)
Clinton Patterson (28)
Cuong Dang (21)
Daniel Bartholomew (2)
Dave Buckner (2)
David Poindexter (3)
David Rodriguez (2)
Doug Howell (11)
Erik van Ballegoij (30)
Ernst Peter Tamminga (74)
Geoff Barlow (7)
Gifford Watkins (3)
Gilles Le Pigocher (3)
Ian Robinson (7)
Israel Martinez (17)
Jan Blomquist (2)
Jan Jonas (3)
Jaspreet Bhatia (1)
Jenni Merrifield (6)
Joe Brinkman (270)
John Mitchell (1)
Jon Henning (14)
Jonathan Sheely (4)
Jordan Coopersmith (1)
Joseph Craig (2)
Kan Ma (1)
Keivan Beigi (3)
Ken Grierson (10)
Kevin Schreiner (6)
Leigh Pointer (31)
Lorraine Young (60)
Malik Khan (1)
Matthias Schlomann (15)
Mauricio Márquez (5)
Michael Doxsey (7)
Michael Tobisch (3)
Michael Washington (202)
Mike Horton (19)
Mitchel Sellers (28)
Nathan Rover (3)
Navin V Nagiah (14)
Néstor Sánchez (31)
Nik Kalyani (14)
Peter Donker (52)
Philip Beadle (135)
Philipp Becker (4)
Richard Dumas (22)
Robert J Collins (5)
Roger Selwyn (8)
Ruben Lopez (1)
Ryan Martinez (1)
Salar Golestanian (4)
Sanjay Mehrotra (9)
Scott McCulloch (1)
Scott S (11)
Scott Wilkinson (3)
Scott Willhite (97)
Sebastian Leupold (80)
Shaun Walker (237)
Shawn Mehaffie (17)
Stefan Cullmann (12)
Stefan Kamphuis (12)
Steve Fabian (31)
Timo Breumelhof (24)
Tony Henrich (3)
Torsten Weggen (2)
Vicenç Masanas (27)
Vincent Nguyen (3)
Vitaly Kozadayev (6)
Will Morgenweck (37)
Will Strohl (164)
William Severance (5)
DNN Launch Webinar
REGISTER NOW
DNN Launch Webinar
REGISTER NOW
DNN Launch Webinar
REGISTER NOW