Installing .NET Web Controls

The instructions that follow detail the step by step process on how to install the new DNN Web Control Container and Web Controls on your site. Before you install the Web Controls, be sure to read the descriptions of each web control to get an idea of what the function is, how it is displayed on your site, and how to best utilize your control.

To get started with DNN Container and Web Controls:

1.    Log into your site as host.

2.    Navigate to the appropriate page on your site where you want to add the DNN Web Control Container (see Adding and Managing Pages for more information).

3.    In the Mode section, select the Edit radio button, as highlighted below (see Using the Personify e-Business Control Panel for more information about the functionality of the Mode radio buttons).
Edit_Radio_Button.png

4.    From the Host module, select the Add New Module radio button, as highlighted below (for more information about the functionality of the Add New Module and Add Existing Module radio buttons, see Personify e-Business Control Panel).
Add_New_Module.png

Note.pngThe Add Existing Module radio button allows you to add an existing module to the page. It copies and pastes the content of the existing module into the new page (see Using the Personify e-Business Control Panel for more information).

5.    From the Host tool bar, in the Module drop-down, select "Personify-DNN Web Control Container, as highlighted below.
Personify_DNN_Web_Control_Container.png

6.    If necessary, from the Host tool bar, in the Title text box, enter a unique title for the page.

7.    From the Host tool bar, in the Visibility drop-down, select one of the following:

a.    Same As Page: this is the default option and uses the same permissions for the page and applies them to the .NET control.

b.    Page Editors Only: this option only allows individuals who have host access to be able to view this control.

8.    From the host toolbar, in the Pane drop-down, select one of the following:

a.    TopPane

b.    ContentPane

c.    BottomPane

d.    RightPane

9.    From the Host tool bar, in the Insert drop-down, select one of the following:

a.    Top

b.    Above

c.    Below

d.    Bottom

10.  Click Add Module To Page, as highlighted below.
Add_Module_to_A_Page.png
The DNN Web Control Container Module displays on the page, as shown below.
DNN_WEB_CONTROL_CONTAINER.png

11.  Select Edit Web Control Container option from the downward arrow icon, as highlighted below (see Using the Module Options for more information on the container's settings).
Edit_Web_Control_Container_1.png
The Select A Web Control window displays, as shown below.
Select_a_web_control.png

12.  Search and select the .NET Control that you want to render for this module. This will load all the available settings for this web control. For more information about each .NET Control setting see .NET Web Controls Descriptions.

Note.pngIf you do not want the name "DNN Web Container Control" to display on your e-Business site, you need to uncheck the Display Container checkbox in the module's settings. See Using the Module Options for more information.

13.  Configure the settings of your selected web control. For more information, please see .NET Web Controls Descriptions.

14.  Click Save.
You will be taken back to your current designing page . The web control rendered will be with the control feature that you just set up.

 

Container Usage Details

The list of the compatible Personify Web Controls to be used with the container includes the Web Controls that are developed with the PersonifyWebStandAlone attribute.

 

Note.pngAll of the compatible Personify Web Controls also need to be inside an assembly with the following naming pattern: “.WebControls.*.UI.dll” (i.e., Personify.WebControls.Store.UI.dll).

Note.pngWhen you are choosing a web control for the first time, the container will load the default values for each control setting if they are available. After you have completed setup on your first control, the system will load using the previous settings that you specified. You can also click “Load Default” to get back to the initial default values.