attention open in a new windowPDFPrintEmail

Last Updated (Thursday, 03 May 2007 09:34)Written by AdministratorWednesday, 11 October 2006 00:00

Article Index
All Pages

Module - Joomla! Extension Directory Modules

A more lightweight and flexible extension used for page rendering is a module. Modules are used for small bits of the page that are generally less complex and able to be seen across different components. To continue in our book analogy, a module can be looked at as a footnote or header block, or perhaps an image/caption block that can be rendered on a particular page. Obviously you can have a footnote on any page but not all pages will have them. Footnotes also might appear regardless of which chapter you are reading. Simlarly modules can be rendered regardless of which component you have loaded.

Modules are like little mini-applets that can be placed anywhere on your site. They work in conjunction with components in some cases and in others are complete stand alone snippets of code used to display some data from the database such as Content (Newsflash) Modules are usually used to output data but they can also be form items to input data (Login Module and Polls as an example)

Modules can be assigned to module positions which are defined in both your template and backend under the Site/Template Manager/Module Positions menu items. For example, "left" and "right" are common for a 3 column layout.

Displaying Modules

Each module is assigned to a module position on your site. If you wish it to display in two different locations you must copy the module and assign the copy to display at the new location. You can also set which menu items (and thus pages) a module will display on. You can select all menu items or you can pick and choose specific menu items by holding down the control key and selecting multiple menu items one by one in the Modules Edit screen

Note your Main Menu is a Module! When you create a new menu in the menu manager you are actually copying the Main Menu module code and giving it the name of your new menu. When you copy a module you do not copy all it's parameters you simply allow Joomla to use the same code with two separate settings.

NewsFlash Example

NewsFlash is a Module which will display content items from your site in an assignable module position. It can be used and configured to display one category, all categories or to randomly choose content items to highlight to users. It will display as much of an article as you set, and will show a "read more" link to take the user to the full page.

The Newsflash component is particularly useful for things like Site News or to show the latest content item added to your site.

More information on Modules is available from the Joomla! help manual: Modules