Actions

Difference between revisions of "Module"

From Joomla! Documentation

m (fxing)
(Added a link to an existing doc page. Can be removed as general doc is available. Or replace the non existing.)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<noinclude><languages /></noinclude>
 
<translate>
 
<translate>
 
<!--T:1-->
 
<!--T:1-->
Line 13: Line 14:
 
=== Beginner === <!--T:5-->
 
=== Beginner === <!--T:5-->
 
To understand how to install and use a module in Joomla it is recommended to read [[Administration of a Module in Joomla]]
 
To understand how to install and use a module in Joomla it is recommended to read [[Administration of a Module in Joomla]]
 +
You can read [[Help33:Extensions_Module_Manager_Custom_HTML|Module Manager Custom HTML]] for an example.
  
 
=== Beginner/Intermediate === <!--T:6-->
 
=== Beginner/Intermediate === <!--T:6-->
Line 18: Line 20:
  
 
=== Advanced === <!--T:7-->
 
=== Advanced === <!--T:7-->
Introduced into Joomla 3.2 is a hidden component that allows modules to create AJAX requests. You can find documentation about [[Using the AJAX component|using the AJAX component]] to help you create even better modules.
+
Introduced into Joomla 3.2 is a hidden component that allows modules to create AJAX requests. You can find documentation about [[Using_Joomla_Ajax_Interface|Using Joomla Ajax Interface]] to help you create even better modules.
  
 
==Joomla! Default Modules== <!--T:8-->
 
==Joomla! Default Modules== <!--T:8-->
 
Joomla! is packaged with many modules, more are available on the JED([http://extensions.joomla.org Joomla! Extension Directory]). Here are the standard modules available in a new Joomla! installation.
 
Joomla! is packaged with many modules, more are available on the JED([http://extensions.joomla.org Joomla! Extension Directory]). Here are the standard modules available in a new Joomla! installation.
*[[{{RVer|help}}:Extensions_Module_Manager_Articles_Archive|Archived Articles]] {{Rarr}} This Module shows a list of the calendar months containing Archived Articles.
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Articles_Archive|Archived Articles]] {{Rarr}} This Module shows a list of the calendar months containing Archived Articles.
 
</translate>
 
</translate>
 
<translate>
 
<translate>
Line 34: Line 36:
 
<translate>
 
<translate>
 
<!--T:10-->
 
<!--T:10-->
*[[{{RVer|help}}:Extensions_Module_Manager_Breadcrumbs|Breadcrumbs]] {{Rarr}} This Module displays the Breadcrumbs
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Breadcrumbs|Breadcrumbs]] {{Rarr}} This Module displays the Breadcrumbs
*[[{{RVer|help}}:Extensions_Module_Manager_Custom_HTML|Custom HTML]] {{Rarr}} This Module allows you to create your own HTML Module using a WYSIWYG editor.
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Custom_HTML|Custom HTML]] {{Rarr}} This Module allows you to create your own HTML Module using a WYSIWYG editor.
 
*Feed Display {{Rarr}} This module allows the displaying of a syndicated feed
 
*Feed Display {{Rarr}} This module allows the displaying of a syndicated feed
 
*Footer {{Rarr}} This module shows the Joomla! copyright information.
 
*Footer {{Rarr}} This module shows the Joomla! copyright information.
*Language Switcher {{Rarr}} This module displays a list of available Content Languages (as defined and published in...
+
*Language Switcher {{Rarr}} This module displays a list of available Content Languages (as defined and published in...)
 
*Latest News {{Rarr}} This Module shows a list of the most recently published and current Articles. Some that...
 
*Latest News {{Rarr}} This Module shows a list of the most recently published and current Articles. Some that...
 
*Latest Users {{Rarr}} This module displays the latest registered users
 
*Latest Users {{Rarr}} This module displays the latest registered users
Line 44: Line 46:
 
<translate>
 
<translate>
 
<!--T:11-->
 
<!--T:11-->
*[[{{RVer|help}}:Extensions_Module_Manager_Login|Login]] {{Rarr}} This module displays a username and password login form. It also displays a link to...
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Login|Login]] {{Rarr}} This module displays a username and password login form. It also displays a link to...
*[[{{RVer|help}}:Extensions_Module_Manager_Menu|Menu]] {{Rarr}} This module displays a menu on the frontend.
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Menu|Menu]] {{Rarr}} This module displays a menu on the frontend.
 
*Most Read Content {{Rarr}} This Module shows a list of the currently published Articles which have the highest...
 
*Most Read Content {{Rarr}} This Module shows a list of the currently published Articles which have the highest...
*[[{{RVer|help}}:Extensions_Module_Manager_Tags_Popular|Popular Tags]] {{Rarr}} The Popular Tags Module displays the most commonly used tags, optionally within specific...
+
*[[S:MyLanguage/{{RVer|help}}:Extensions_Module_Manager_Tags_Popular|Popular Tags]] {{Rarr}} The Popular Tags Module displays the most commonly used tags, optionally within specific...
 
*Random Image {{Rarr}} This Module displays a random image from your chosen directory.
 
*Random Image {{Rarr}} This Module displays a random image from your chosen directory.
 
*Search {{Rarr}} This module will display a search box.
 
*Search {{Rarr}} This module will display a search box.

Latest revision as of 09:27, 12 August 2014

Other languages: català 43% • ‎English 100% • ‎español 100% • ‎français 100% • ‎Bahasa Indonesia 100% • ‎italiano 71% • ‎日本語 100% • ‎Nederlands 100% • ‎Kiswahili 100%

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


Contents

Learning More

Module Positions

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.


Recommended Reading

Modules are one of the simplest parts of Joomla and a great entry point for people learning to use the system (the equivalent of widgets in wordpress). They can be displayed just about anywhere on a page (in all the positions a template allows as well as in the main content area using the loadmodule plugin for the com_content component).

Beginner

To understand how to install and use a module in Joomla it is recommended to read Administration of a Module in Joomla You can read Module Manager Custom HTML for an example.

Beginner/Intermediate

Creating a simple module for Joomla is one of the simplest development steps you can do - and the creating a simple module tutorial is designed to take you through this. It starts with a simple module and then shows a few things you can then do with the module.

Advanced

Introduced into Joomla 3.2 is a hidden component that allows modules to create AJAX requests. You can find documentation about Using Joomla Ajax Interface to help you create even better modules.

Joomla! Default Modules

Joomla! is packaged with many modules, more are available on the JED(Joomla! Extension Directory). Here are the standard modules available in a new Joomla! installation.

  • Archived Articles    This Module shows a list of the calendar months containing Archived Articles.
  • Articles - Newsflash    The Newsflash Module will display a fixed number of articles from a specific category.
  • Articles - Related Articles    This Module displays other Articles that are related to the one currently being viewed....
  • Articles Categories    This module displays a list of categories from one parent category.
  • Articles Category    This module displays a list of articles from one or more categories.
  • Banners    The Banner Module displays the active Banners from the Component.
  • Breadcrumbs    This Module displays the Breadcrumbs
  • Custom HTML    This Module allows you to create your own HTML Module using a WYSIWYG editor.
  • Feed Display    This module allows the displaying of a syndicated feed
  • Footer    This module shows the Joomla! copyright information.
  • Language Switcher    This module displays a list of available Content Languages (as defined and published in...)
  • Latest News    This Module shows a list of the most recently published and current Articles. Some that...
  • Latest Users    This module displays the latest registered users
  • Login    This module displays a username and password login form. It also displays a link to...
  • Menu    This module displays a menu on the frontend.
  • Most Read Content    This Module shows a list of the currently published Articles which have the highest...
  • Popular Tags    The Popular Tags Module displays the most commonly used tags, optionally within specific...
  • Random Image    This Module displays a random image from your chosen directory.
  • Search    This module will display a search box.
  • Similar Tags    The Similar Tags Module displays links to other items with similar tags. The closeness...
  • Smart Search Module    This is a search module for the Smart Search system.
  • Statistics    The Statistics Module shows information about your server installation together with...
  • Syndication Feeds    Smart Syndication Module that creates a Syndicated Feed for the page where the Module is...
  • Weblinks    This modules displays Web Links from a category defined in the Weblinks component.
  • Who's Online    The Who's Online Module displays the number of Anonymous Users (e.g. Guests) and...
  • Wrapper    This Module shows an iframe window to specified location.