Modules are extensions used for pages' rendering. These modules can be seen as "boxes" set around a component. For example, the Menus, the Smart Search or the Login feature are all displayed by modules. You can display lots of items via a module. It's also possible to publish your own HTML code thanks to the Custom HTML module.
Modules are located in the template's different positions, they can be displayed on some pages and not on others (thanks to the menu assignment or to the languages settings) and they can be visible only to some users (thanks to different access levels).
Depending on the type of module you manage, you need to configure several parameters. Some are simple and others can be complex, but they all have common settings:
- A status (Publish/Unpublish/Trash) allowing you to publish or unpublish the module, or move it to Trash if it has become useless.
- A title that can be displayed or not on the site's Frontend.
- A position determining the module's location on the page in Frontend.
- An access level which determines who will be able to see the module. You can read the Users Management chapter for more information.
- An ordering parameter so you can configure the order in which modules are displayed within the same position (e.g. the columns).
- The start and end publishing dates enabling you to define when the module will be published and for how long.
- The language setting allows you to assign the module to all languages or to one specific language.
- A note so you can add information that will be visible in the module manager (this is useful if you create several modules of same type or if you display several modules according to specific dates).
- The module assignment parameter allows you to choose the pages on which the module will be displayed.
To access the Module Manager, select Extensions → Module Manager.
In this manager, you can customize, thanks to the toolbar (1), the parameters of one or several existing modules (such as publish or duplicate them, move them to trash, etc.). You can create a new module (2). You can also see each module's information (3) (e.g. status, title, position, type...) and you can display your modules with different filters (4).
When filtering by order (5), you can sort you modules by "Dragging/Dropping":
Dragging/Dropping in the Module Manager
How to publish a module on the site?
To publish a module, select Extensions → Module Manager, then click the New button. You'll be taken to the page displaying a list of all the installed modules. As an example, we are going to publish a module entitled “Article Categories”. If you click the “Article Categories” link, you'll see this page:
Edit a module
1 - Enter a title for your module (this title will be displayed in Frontend).
2 - Choose whether you want to show this title or not.
3 - Choose the position in which you want to publish this module.
4 - Choose whether you want to publish this module or not.
5 - You can enter the start and finish publishing dates. If you don't enter these dates, the module will be continuously displayed.
6 - Select the access level for this module. This option allows you to decide who will be able to see the module (more information in the Users Management chapter).
7 - Select the ordering for this module in relation to the other modules published in the same position.
8 - Select a language to assign to this module (more information in the Multilingual Website chapter).
9 - Options - Here you can configure some of the module parameters such as the number of articles to display or the articles' source for example.
10 - Menu assignment - You can configure the pages on which you want to display this module.
11 - Here you can define the module's permissions.
12 - Find here more advanced parameters.
Once everything is set up correctly, you can hit the Save button and then go back to the Backend to see the outcome.
List of Joomla! Native Modules (Frontend)
Articles Category displays a list of articles from one or several categories. You can customize this module's parameters, like the category filters, the authors filtering options, the number of articles to show, etc.
Articles Categories displays a list of categories. Several parameters allow you to customize this module: you can choose to display or not the category description, you can choose the number of articles to show, etc.
Archived Articles displays the list of archived articles in a month view calendar. When you archive an article, this list will be automatically updated.
Articles Related Items lists the published articles that are related to the article that is being displayed. The links are based on the keywords assigned to articles. For example, the article 'Breeding parrots' and the article 'Black cockatoos' are considered related because they both have the keyword 'parrot'.
Most Read Articles displays the most viewed articles list. You can customize this module's parameters: the category filter, the number of categories to show, etc.
Banners displays the banners from the Banner component. See the Banners chapter for more information.
Language Switcher displays the flags of the different languages that are installed on the site, hence allowing users to access the translated page (if the page has been previously translated of course). It is important to properly configure the Joomla! multilingual system, otherwise this module won't be displayed. See the Multilingual Website chapter for more information.
Login allows users to login to the site. The module also displays a “create an account” link (which you can disable). If a user enters a wrong username/password, he/she will be able to ask for an email to be sent so he/she can retrieve it.
Custom HTML allows you to display your own HTML. Therefore, you can display text, images... thanks to an editor.
Footer displays Joomla! copyright information as well as 2 links, one directing to the official website and the other to the page of the GNU license under which Joomla! is released. Publishing this module isn't mandatory, but this is a good way to promote the Joomla! project.
Latest News displays the recently added articles on the site. Several parameters can be configured, such as the number of articles, the category filter, etc., so you can customize this module.
Latest Users displays the list of the latest users who have registered on your site. You can choose the number of users to be displayed in the list.
Wrapper shows an Iframe which contains the page of a specified URL.
Feeds Display displays articles from a RSS, RDF or ATOM feed. See the Newsfeeds Chapter for more information.
Breadcrumbs displays a breadcrumb allowing the user to know where he/she is on the site, hence facilitating site navigation.
Articles Newsflash displays a predefined number of article headers (managed by the read more system). You can, among other actions, filter the categories that you want to display.
Random Image displays images from a specific directory in a random way. It is possible to configure the size of the images and to link them to other pages.
Syndication Feeds displays a RSS/ATOM feed. You can read the Newsfeeds chapter for more information.
Weblinks displays a list of weblinks from a category defined in the weblinks component. See the Weblinks chapter for more information.
Menu displays the menu items of a navigation menu defined in the menus. You can read the chapter Menus and Navigation.
Who's Online displays the list of visitors and/or registered users who are currently navigating the website.
Search displays a box allowing users to perform a search on the site thanks to the Search component. For more information, you can have a look at the Search chapter.
Smart Search displays a box allowing users to perform a search on the site thanks to the Smart Search component. More information in the Smart Search chapter.
Statistics displays different site statistics like the number of visits, of registered users, of articles, of weblinks and it also provides information on the server, depending on your settings.
Popular Tags displays a list of the most used Tags. More information in the Tags chapter.
Similar Tags displays a list of links which direct to tagged items with similar tag(s). You can configure the minimum number of Tags to be displayed. See the Tags chapter for more information.