Jentla Wiki
Jentla Wiki > Jentla 1.5 "How To" Guides > How To Set Up a Module

How To Set Up a Module

Page last modified 04:33, 20 Jul 2012 by kavitha
    Redirected from "How To" Guides/How To Set Up a Module

    To Create a New Module:

    1. Login to Site Administrator (http://<your domain>.jentla.com/manager/administrator).

    2. Go to Extensions > Module Manager. The Modlue listing page will be displayed as below:

    1. Press the New button on the upper right corner of the  toolbar to create the new module.

    To Edit an Existing Module:

    1. Login to Site Administrator (http://<your domain>.jentla.com/manager/administrator)

    2. Go to Extensions > Module Manager

    3. Click on the Module Name in the Modules listing or Mark on the Module's checkbox and press the Edit button on the top right corner toolbar.

    When you create a new Module, you will select the Module Type. This will determine what type of content this Module can display.

    If you edit an existing Module, the Module Type will already be determined. Note that you cannot change the Module Type of an existing Module.

    The following page shows the module details page, as illustrated below:

    All Modules have four sections. Please see the details for each section in below case:

    Details

    • Module Type - This displays the system name of the module. No entry is allowed

    • Title - The Title of the Module

    • Show Title - Enable if you want to show the Title of the Module

    • Enabled - Whether or not the Module is enabled. If  set to "No", the Module will not be shown on the page

    • Position - The Position on the page to show the Module. There are two types of Positions you can use. You can select a Position from the drop-down list box. The Positions in the list box are those provided by our Template. You can see the available Positions on the page by adding the letters "?tp=1" to the end of any front-end site URL. For example, if your home page is "www.jentla.com", you can type the URL "www.jentla.com?tp=1". The page will display with labeled rectangles indicating each pre-defined Position for the current Template

    • Order -. The Order that this Module will be displayed within the Position. If more than one Module is displayed at the same position, this will determine the order of display. The drop-down list box shows all Modules displaying at the current Position

    • Access Level - Who has access to this item. Current options are

      • Public: Everyone has access

      • Registered: Only registered users have access

      • Special: Only users with author status or higher have access

    • ID - The ID number. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, for example in internal links. You can not change this number

    • Description - A description of what the Module does. No entry is allowed

    Menu Assignment

    • All - shows the current Module on all Menu Items

    • None - does not show the Module on any Menu Item

    • Select Menu Item(s) from the List - allows you to select which Menu Items to show the Module on

    • Menu Selection.  If Select Menu Items(s) from the List above is selected, select individual Menu Items that will display the Module

      • Use Ctrl+Click to select multiple Menu Items

      • Use Shift+Click to select a range of Menu Items

      • If you want to select most of the Menu Items, first click "All" above under Menus and then click "Select Menu Items(s) from the List". All of the Menu Items will be selected. Then use Ctrl+Click to deselect the Menu Items you don't want to include

    Setting the Parameters

    Th Module Parameter setting is different for each and every Module Type.

    New Module Position  Creation

    The list of available positions where you can insert a module is controlled by the template you are using.

    It is possible to add new positions to a template:

    1. Open the file "../templates/rhuk_milkyway/index.php" for editing and determine where your new position will be on the page. We  can see all of the existing template locations in your browser by adding "?tp=1" to the end of your normal URL (for example, "http://www.jentla.com/?tp=1"). In our example, we will add a new location after the "breadcrumb" position called "mynewposition". To do this, insert a new line

    <jdoc:include type="modules" name="mynewposition" />

    1. Open the file "<../templates/rhuk_milkyway/templateDetails.xml" for editing and find the "<positions>" section of the file.

    <positions>

       <position>breadcrumb</position>

       <position>mynewposition</position>

    </positions>

    Now, when you look at your site with the "?tp=1" URL, you should see the new position.

    In the Module:[Edit] screen, the new position should display in the drop-down list box of available positions

    Click the Save option to save the required changes or Cancel to abort your changes.

    Powered by MindTouch Core