Installation

XMod is designed for DotNetNuke 2.x and is installed using the standard procedure for installing private assemblies (PA's). In addition to the standard installation procedure, you will need to perform a couple of additional steps. Complete installation instructions follow:

 

  1. Unzip the download package to a temporary directory. The package contains this file and other files along with "XMod_Resources.zip" and "XModXXX_Install.zip" where XXX reflects XMod's version number.

  2. Make sure you are logged in as "host" and navigate to DNN's File Manager tab.

  3. From the File Manager's Actions menu (the yellow pencil), choose Add New File(s)

  4. Select the "Custom Module" option.

  5. Browse to the directory where you unzipped the XMod download package and select "XModXXX_Install.zip" where XXX is the XMod version number.

  6. Click "Add"  and then "Upload File(s)". This will install XMod on your site. If you encounter any errors they will be highlighted in red. Please save these messages for future support calls.

  7. If you are running 2.0.4: You need to unzip and upload the contents of "XMod_Resources.zip" to XMod's directory on your sever. This should be (DNN Root)/DesktopModules/XMod/

  8. If you are running 2.1.2: The resources file should have been unzipped into the proper directory. If you find that images are missing, follow the process in step #7.

  9. NOTE: All versions: XMod contains two separate modules - the main interface which is installed by DNN, and the "Form View" interface which provides a means of creating customized feedback-type forms. The Form View is optional. To use the Form View, you'll need to manually add a Module definition (see below).

 

Adding the Form View Module Definition

 

  1. Navigate to the "Module Definitions" tab in DNN.

  2. From the Actions menu, select Add New Module Definition.

  3. Enter the following information:

    Module Name:
    XMod FormView
    Description:
    Enables the use of XMod's form-creation abilities to create custom "feedback" or input forms.
     

  4. Click "Update"

  5. In the "New Definition" field, type "XMod FormView" and click "Add Definition"

  6. Next, you'll add three controls. Click the "Add Control" link and enter the following information on the form that appears:

    Source
    : DesktopModules/XMod/XModFeedback.ascx
    Type
    : View

    You can leave the other fields as-is.
    Click the "Update" link
     

  7. Click "Add Control" again and enter the following information:

    Key
    : Forms
    Title
    : Manage Forms
    Source
    : DesktopModules/XMod/ManageForms.ascx
    Type
    : Admin

    The other fields can be left as-is.
    Click the "Update" link.
     

  8. Click "Add Control" again and enter the following information:

    Key
    : Configure
    Title
    : Configure XMod Module
    Source
    : DesktopModules/XMod/ConfigureModule.ascx
    Type
    : Admin

    The other fields can be left as-is.
    Click the "Update" link.
     

  9. Installation is complete. You should now be able to select either "XMod" or "XMod FormView" from the list of available modules and add them to a tab.