Module

From Joomla! Documentation

Revision as of 03:28, 1 May 2013 by Wilsonge (talk | contribs) (Update 1.6 to 2.5)
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

<translate> Modules are lightweight and flexible extensions used for page rendering. These modules are often “boxes” arranged around a component on a typical page. A well-known example is the login module. Modules are assigned per menu item, so you can decide to show or hide (for example) the login module depending on which page (menu item) the user is currently on. Some modules are linked to components: the “latest news” module, for example, links to the content component (com_content) and displays links to the newest content items. However, modules do not need to be linked to components; they don't even need to be linked to anything and can be just static HTML or text.

Modules are managed in the Joomla! Administrator view by the Module Manager. More information about module management can be found on the appropriate version help screens.

See also: Component, Plugin, Template</translate>

Module positions[edit]

<translate> A module position is a placeholder in a template. Placeholders identify one or several positions within the template and tell the Joomla! application where to place output from modules assigned to a particular position. The template designer has complete control over module positions, creating variations between templates and the respective Joomla! default positions assigned to modules in the installation sample data.

For example, the module position Left could be defined to be on the left side of the template to display a site navigation menu. So if a module is assigned the Left position, it will be displayed wherever the designer puts that Left module position - not necessarily the left side of the page. </translate>

Since Joomla 1.5 Joomla 1.5 you can see what positions are available in the template you are using by adding either ?tp=1 or &tp=1 to the end of the URL in the frontend.

Joomla 2.5 Joomla 2.5 and newer will only show the template positions with ?tp=1 or &tp=1 if the Preview Module Positions mode in the Template Manager has been enabled: Extensions > Template Manager > Options (upper right corner) > (templates tab) Preview Module Positions: Enabled.

Recommended Reading[edit]

Developers[edit]

<translate> Module Development</translate>

<translate> This page contains many links to selected documentation concerning Module Development for Joomla 2.5 and Joomla 3.x. A good place to start is with the Recommended Reading articles below as they provide a good introductory base of knowledge to build on.</translate>

<translate> What is a Module?</translate>

<translate>

Modules are lightweight and flexible extensions used for page rendering. These modules are often “boxes” arranged around a component on a typical page. A well-known example is the login module. Modules are assigned per menu item, so you can decide to show or hide (for example) the login module depending on which page (menu item) the user is currently on.

See also: Component, Plugin, Template</translate>

<translate> Recommended Reading</translate>

{{Portal:Module_Development/Reading list/<translate> en</translate>}}

<translate> FAQs</translate>

{{Portal:Module_Development/FAQs/<translate> en</translate>}}

<translate> Module Development Tutorials</translate>

{{Portal:Module_Development/Tutorials/<translate> en</translate>}}


<translate> Module Development Articles Needed</translate>

{{Portal:Module_Development_Projects/<translate> en</translate>}}

_

For more developer information, see Module Development.