1.5 Template Project

The Joomla! Documentation Working Group is running a project to develop detailed reference and tutorial material on Joomla! 1.5 templates.  There is a project page on the documentation wiki where you can see the work in progress and help us by contributing your knowledge.

Who's Online

We have 3 guests online

Help Site License

The Joomla! Help Site content is copyright © 2005 - 2008 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution NonCommercial ShareAlike 2.5. Some parts of this website may be subject to other licenses.
Home arrow Help Screens arrow Help Screens :: Installers arrow Site Module: Edit [ Template Chooser ]

Site Module: Edit [ Template Chooser ] PDF Print E-mail



com_modules /editA


menu=>Modules=>Site Modules=>Module Manager=>Main Menu->edit

User Level:

 Administrator; Super Administrator.


module_template-chooser_ss template_chooser_display_ss
Site Module: Edit [ Template Chooser]

Template Chooser Module Display


Module Type: mod_templatechooser

The Template Chooser Module displays an image gallery style presentation of the different templates that are installed for use in the Front-end and selectable by the User. The User can preview the different Templates by selecting the Template name from the drop down list. If the User finds a particular Template that they wish to use then they simply need to click upon the Select button.

warning_711_small Caution needs to be exercised when using this Module as not all Templates allow the same Module Positions and the web site may well be seriously affected by allowing an incompatible Template to be selected.

The Module does have one significant advantage and that is as Template downloads previewer on a Template developers web site. This allows a potential customer/downloader to quickly view all the available Templates rather than have to open each one in their browser.



Preview: To check the appearance of the current Module in a browser-style window, click the Preview icon. A pop-up display page will appear. Close the pop-up by clicking anywhere upon it.

Save: Click Save to save any changes made during the current editing session, and return to the Module Manager screen.

Apply: Click Apply to save any changes made so far in the current session, but remain in the Module screen to continue editing. Once the editing session is complete click Save as above.

Close: Click Close at any point to end the current editing session and return to the Module Manager screen. Any changes made since the session commenced, or since the last time Apply was clicked, will be lost.

Help: Click the Help icon at any time to view this Help Screen.


Title: Enter a name for the Module being created. This will be displayed at the top of the Module display page - if the option to Show is selected below. The Page Title is also used by the Module Manager to identify it in its display list.

Show title: Select the No or Yes radio button to set whether the Title, entered above, will be displayed or not in the Front-end of the web site.

Position: Select the position in which this Module will be displayed, from the drop down list of all available Positions. These positions are determined by the Template in use and the menu=>Site=>Templates=>Module Positions screen.

Module Order: This option allows the place for this Module in the order of all Modules that are assigned to this Position in the Template to be set, and therefore its place in the Front-end display of the Template.

Access Level: Identify which User Group level can view this Module. Select from Public, Registered, or Special. See User Access Levels for further details on these.

ID: The unique Module Identification Number that Joomla! (MySQL) has assigned to the Module.

Published: Check this check box to Publish the Module. If there is no check mark in the check box, then the Category is Unpublished.

Description: Enter a description of the Module that explains its function in the open text field. The text will be displayed within the Administrator Back-end only and is for future reference purposes.


Max Name Length: Enter the maximum number of letters that are permitted to be used for the Template display name. The default is 20. Be aware that allowing an excessive number of letters may disrupt the display within the Module or of the Module itself.

Show Preview: Select Hide or Show to set whether the display preview image of the Template is shown or not. This function depends on there being an image thumbnail preview included with the Template files - check for an image titled template_thumbnail.png . This Module is unaffected by the setting in the Template Manager which Permits Template Previews.

Width: Enter the maximum width permitted for the preview image. The default size is 140 pixels (px). If the original image within the Template file is different to this it may create undesired effects and distort the image available to Users. If this happens either adjust the setting until it fits the Module, create a new image or scale resize and replace the current version in the Template folder.

Height: Enter the maximum height permitted for the preview image. The default size is 90 pixels (px). If the original image within the Template file is different to this it may create undesired effects and distort the image available to Users. If this happens either adjust the setting until it fits the Module, create a new image or scale resize and replace the current version in the Template folder.

Module Class Suffix: Enter the suffix for the CSS class of this module, for example: .moduletable-template. In this example, the -template is the suffix. This suffix class must currently be in the template CSS Style file. This allows individual CSS classes to be applied to certain modules independent of the site's default Template CSS classes.

Pages / Items:

Menu Item Links: Choose the Menu/Menu Item locations that this Module should be displayed on in the Front-end display of the web site if has been Published. In addition to individual pages it is possible to assign the Module as follows:

  • All - The Module will appear on every Menu/Menu Item location.
  • None - The Module will be active but not present on any Menu. It can however, be selected directly by a non-standard link.
  • Unassigned - Where a Content Item is not targeted by a specific Menu/Menu Item link select Unassigned for the Module to appear on that and all other unlinked pages.
note icon NOTE: Further clarity is being sought on the Menu / Menu Item options None & Unassigned.

Related Information:

Template Manager - Site  User Access Levels
 Module Positions  Template Manager [ Site ] - Assign

note icon NOTE: If you have any comments or suggestions regarding this Help screen then please post them in the Suggestions, Modifications, and Corrections forum in the User Documentation Work Group.

Thank you!


The User Documentation Team
Last Updated ( Monday, 09 April 2007 )
< Prev   Next >