DNN (Formerly DotNetNuke) Tutorial - Part 3 (Create Custom Edit Page)

Introduction

This is used for configuring the module behavior in different pages in the same project or in different projects. The settings may be some redirected url or some procedure name etc.

Before starting with with Part three, let's go through the previous two parts,

• DNN (Formerly DotNetNuke) Tutorial - Part 1
• DNN (Formerly DotNetNuke) Tutorial - Part 2 (Adding Modules)

Create Custom Edit Page

Create new module folder in the DesktopModules and add two usercontrols.

>

For Example:

Here, I have added two usercontrols View.ascx and Edit.ascx in EditModule folder. (You can give custom names for the usercontrols, for easy understanding I've just given View and Edit as names. )

>Here the View.ascx page will be visible to the end users and the Edit.ascx only for the Admin users

• As you know all the modules should be inherited from class “PortalModuleBase”.
• Also we need to include some reference to the View page to call the action page “Edit.ascx”.

using DotNetNuke.Entities.Modules.Actions;
using DotNetNuke.Security;

A module action is used to define a specific function for a given module. Each module can define one or more actions which the portal will present to the user. These actions may be presented as a menu, a dropdown list or even a group of linkbuttons.

o Using the property ModuleActionCollection property we can add new module action to the View Page.

public ModuleAction CollectionModuleActions
{
    get
    {
        ModuleActionCollection Actions = newModuleActionCollection();
        Actions.Add(this.GetNextActionID(), "Edit", ModuleActionType.ContentOptions, "", "", this.EditUrl("EditSSO"), true, SecurityAccessLevel.Edit, true, false);
        return Actions;
    }
}

this.GetNextActionID()

It returns an integer value, the Next Action Id.

“Edit”

It will be the title of the Page.

ModuleActionType.ContentOptions

Common action types can be specified in the CommandName attribute of the ModuleAction class

SecurityAccessLevel

The SecurityAccessLevelenum is used to determine which level of access rights to assign to a specific module or module action.

In the Edit.ascx page you can apply the custom configuration and settings values for the module.

There are two different tables for the modules TabModuleSettings and ModuleSettings.

Before working with custom edit page you should learn the difference between these two.

ModuleSettings:

This Table will handle the settings that are common for the module, I mean these setting will be the ame if the module is used in different tabs.

Tabmodulesettings:

As the table name describes this table is dealing with the configurations which depend on each tab. Maybe the same modules will be used in different tabs, and some of the configurations will be different. Those kind of details will be saved in the TabModuleSettings table.

Configuration Changes

Step 1: Create New module from Host Settings. Those who are not yet created the module in DNN please click here.

Step 2: Go to Module definition Panel in the Edit Module page and click on Add Module Control Button




Step 3: Here's the configuration, click on the Update Button.



Now the Module Definition Tab will be show 2 entries in the Module Controls Grid.



Step 4:

Add module to the new page or to the existing page (You can refer to the same doc mentioned above for adding new page.)

Step 5: Go to the page and Add module and click on the Edit This Page Button from the Top.



Now you will get 3 options on the top of the module, click on the pencil image that will return the Edit page for change the configurations.



To update the custom settings we can use ModuleController.UpdateTabModuleSettingFunction. Rest of the thing you just find out and create a custom module.

If you have any queries please write it in the comment box.

Reference

• http://www.dnnsoftware.com/dnn-api/html/97fc1fe2-210a-4805-dc80-d200c087d8a8.htm
• http://www.dnnsoftware.com/dnn-api/html/21e2ff62-b776-4131-17d4-7867927f9757.htm

Read more articles on DNN: 

• DNN (Formerly DotNetNuke) Tutorial - Part 1
• DNN (Formerly DotNetNuke) Tutorial - Part 2 (Adding Modules)