Adding/Managing Modules

Taken from http://www.dnnsoftware.com/help#Dnn.Platform/Documentation/Introduction_Online.html%3FTocPath%3D_____1

Adding a New Module (ControlBar) - manual also has for ribbon bar and icon bar

How to add a new module without content into the current page using the ControlBar. Adding a new module inserts a module. Users must be authorized to deploy a module and have the appropriate page editing permissions to add a module to a page. Important. See "Adding a Module to a Multi-Language Site" if content localization is in use on this site.

Option One - Drag and Drop Module

  1. On the Control Bar, hover over the Modules drop down menu and then select Add New Module. This loads and displays a list of all modules within All Categories, or the previously selected category.

  1. Optional. Filter the module list by selecting a module category from the drop down box that is displayed above the list of modules. The available categories are:
    • All: Modules within all categories including those that haven't been associated with a category. This is the default option.
    • Admin: Modules that are typically used for site administration rather than managing content such as the Extensions and File Management.
    • Common: Frequently used modules. Users can add or remove modules to this menu by clicking the Add to Bookmarks / Remove from Bookmarks button displayed in the top left corner of each module listed on the ControlBar when the mouse is hovered over the module. This button can be seen in the image shown below Step 4 of this tutorial. Note: The HTML module cannot be removed from the Common category.
    • Developer: Provides access to the Module Creator that enables developers to create new modules.
    • Enterprise: Modules that are only included with Evoq Content Enterprise.
    • Professional: Modules that are only included with Evoq Content.
  2. Optional. Begin entering the name of the required module if known. This is the quickest way to find modules.

  1. Locate the module to be added using the scroll bar located below the module list and then hover the mouse over the module to be added. This displays the message "Drag to add this module to the page below".

  1. Left click on the required module and then drag it down the page until the pane it will be added to is highlighted with the message "Drop Module Here".

  1. Release the mouse button. The module is now added to the page.

Option Two - Insert Module

  1. On the Control Bar, hover over the Modules drop down menu and then select Add New Module. This will load and display a list of the modules within the Common category, or the previously selected category.

  1. Optional. Filter the list of modules by selecting a category or by entering part of the module name.

  1. Locate the module to be added using the scroll bar located below the module list and then hover the mouse over the module to be added. This displays the Move icon in the top right corner of the module.
  2. Mouse over the Move icon to open the drop down menu and then select the pane where the module will be inserted.

  1. The module is now added to the page.

Adding an Existing Module (ControlBar)

How to add an existing module to the current page using the ControlBar. Module content is shared which means updating the content on one module will update the content across all other instances of the module. Note: Users cannot add an existing module to the page where it already exists. Users must be authorized to deploy a module See "Setting Permissions to Deploy a Module" and have the appropriate page editing permissions to add a module to a page. See "Setting Page Permissions" See "Setting Page Permissions"

Important. If content localization is enabled, See "Adding a Module to a Multi-Language Site"

Option One - Drag and Drop Module

  1. On the Control Bar, hover over the Modules drop down menu and select Add Existing Module.

  1. Select the site and the page where the module is located from the left drop down list.

  1. Select from these options on the center drop down list:
    • Same As Page: This sets the module as visible to all roles/users who can view this page. This is the default setting.
    • Page Editors Only: The sets the module as only visible to the roles/user who can edit this page. Choose this option to add content and configure the module settings before others can view the module.
  2. At Make a Copy, mark  the check box to create an independent copy of the module content that can be modified without affecting the original existing module - OR - unmark  the check box to use the share the same module content across both instances of the module so that updating content on one module will change the content on both modules. This is the default setting.

  1. Locate the module to be added using the scroll bar located below the module list and then hover the mouse over the module to be added. This displays the message "Drag to add this module to the page below". Left click on the required module and then drag it down the page until the pane to add it to is highlighted with the message "Drop Module Here"

  1. Release the mouse button. The module is now added to the page.

Note: When adding an existing module from another site, a warning message will be displayed advising that the module may not support module sharing. Exceptions are the HTML and Journal modules that have be developed with module sharing capabilities.

Option Two - Insert Module

  1. On the Control Bar, hover over the Modules drop down menu and then select Add Existing Module. This will load and display a list of the modules within the Common category, or the previously selected category.
  2. Optional. If the required module isn't displayed, select the category that the module belongs to from the drop down box which is displayed above the list of modules. The available categories are:
    • All: Modules within all categories including those that haven't been associated with a category. This is the default option.
    • Admin: Modules that are typically used for site administration rather than managing content such as the Extensions and File Management modules.
    • Common: Modules selected as frequently used.
  3. At Select Page, select the page that the module is located on.
  4. Select from these options on the next drop down list:
    • Same As Page: This sets the module as visible to all roles/users who can view this page. This is the default setting.
    • Page Editors Only: The sets module as only visible only to the roles/user who can edit this page. Users might choose this option to add content and configure the module settings before others can view the module.
  5. At Make a Copy, mark  the check box to create an independent copy of the module content that can be modified without affecting the original existing module - OR - unmark  the check box to use the share the same module content across both instances of the module so that updating content on one module will change the content on both modules. This is the default setting.
  6. Locate the module to be added using the scroll bar located below the module list and then hover the mouse over the module to be added. This displays the Move icon in the top right corner of the module.
  7. Mouse over the Move icon to open the drop down menu and then select the pane where the module will be added.

  1. The module is now added to the page.

Deleting a Module

How to delete a module from a page.

Tip: Deleted modules are stored in the Recycle Bin.

  1. Mouse over the Manage button on the module action menu.
  2. Select Delete Delete from drop down list and then click the Yes button to confirm.

Deleting a module

Drag and Drop Module

How to drag a module from its current location (pane) on a page to and drop it into another pane.

Prerequisite. Users must be in Edit mode and be a Page Editor for the page where the module is located.

  1. Locate the module to be moved.
  2. Hover the mouse over the section of the Module Action Bar that doesn't have any icons. This displays the message "Drag this module to a new Location".
  3. Click and hold on the mouse to select this module and then drag the module to the required location.

  1. When the module is positioned over a pane, the message "Drop Module Here" will be displayed showing the location that the module will be relocated to once the dragging module is released. When the correct pane is highlighted, release the module.

  1. The module is now displayed in the chosen location.

Configuring Basic Module Settings

How to view basic module settings and set the module title and tags. Tags allows site content to be categorized in a meaningful way in search results.

Important. In order to view the Module Title, the "Display Container?" field must be checked and the container applied to the module must include the [TITLE] skin token.

  1. Select  Manage >  Settings from the module actions menu.
  2. Select the Module Settings tab.
  3. Expand the Basic Settings section.
  4. At Module Culture, the culture associated with this module is displayed.
  5. At Module, view the name of the module. This field cannot be edited. E.g. Announcements, HTML, etc.
  6. In the Module Title text box, edit the module title.
  7. At Tags, click on the drop down list and then mark  the check box beside each tag to be associated with this module. Click off the drop down list to save the selections. Tagging is a way of categorizing content for more meaningful search results. Tags can be created by users (See "Tagging Page Content") or editors (See "Creating a Vocabulary").

  1. Click the Update button.