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 17 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 :: Messages arrow Site Module: Edit [ Random Image ]

Site Module: Edit [ Random Image ] PDF Print E-mail



com_modules /edit A


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

User Level:

Administrator; Super Administrator.


module_random_image_ss random_image_display_ss
Site Module [ Random Image] Random Image Module Display


Module Type: mod_random_image

The Random Image Module displays a random display of the contents of a specified image folder within the Module on the allotted page.



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.


Image Type: Enter the file type(s) that the Module will display. Enter the different 3 letter file types separated by a vertical pipe character. For example: png|jpg|gif. It is not necessary to enter a full stop (period) "." before the file type but it will also work with one. For example: .png|.gif|.jpg .

Image Folder: Enter the location of the image folder that this Module will source its images from. Enter this as a relative address to the particular directory. For example: /images/stories .

Link: Enter a URL that a User will be redirected to if they click on an image within the Random Image Module.

Width (px): Enter the maximum width permitted for the image. If the width of the original image, within the selected directory is greater, than the size entered here,the image will be compressed to fit the available space.

Height (px): Enter the maximum height permitted for the image. If the height of the original image, within the selected directory, is greater than the size entered here,the image will be compressed to fit the available space.

Module Class Suffix: Enter the suffix for the CSS class of this module, for example: .moduletable-random. In this example, the -random 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.

note icon NOTE: Images for inclusion in the Random Image Module rotation need to be uploaded and managed via the Media Manager

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:

Media Manager User Access Levels
Module Positions  

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 >