How to access

Navigate to the Module Manager. To create a new Module, press the "New" button on the toolbar. To edit an existing Module, click on the Module Name or click on the Module's checkbox and press the Edit button on the toolbar.

Description

This is where you will add new Modules or edit existing Modules for the front end of your Joomla! web site. When you install Joomla!, 20 built-in Modules are available for use in the front end of your web site. Some Modules, like the Menu Module, are used in every Joomla! web site. Other Modules are optional.

Note that all Module Types have the same fields in the Details and Menu Assignment sections. These are documented in the Module Manager - New/Edit screen. Each Module Type has different Parameter fields. These are documented for each Module Type below.

Screenshot

Module new.png

Note that if you install one or more Joomla! Extensions, these Extensions may add new Module Types. In this case, your screen will show additional Types.

Module Types

When the New button is pressed, the Module:[New] screen displays all of the Module Types available for new new Module. You can select the desired type either by clicking on the Module Name or by clicking on the Module's radio button and pressing the Next button on the toolbar. Note that you can cancel this action by pressing the Cancel button on the toolbar.

A standard Joomla! installation includes 20 Module Types. Each has it's own function and it's own Parameters, as described below.

Archived Content

This Module shows Articles that have been set to Archived. The Articles are available behind a Month/Year directory list, as shown in the example below.

Archive module1.png

Selecting a month link shows a screen like the one below.

Archive module2.png

Articles are stored by creation date not archival date. Only those months and years with archived Articles will be displayed. This list is generated automatically.

The Module Type name for this is "mod_archive". This module does not relate to any other component. This Module provides functionality that is similar to the Archived Article List Layout available on the Menu Item Manager New / Edit screen.

Module Parameters

Archive module parameters1.png

Advanced Parameters

Archive module parameters2.png

This Module allows you to show active Banners from the Banner Component created in the Banner Manager screen. The Module Type name for this is "mod_banners".

Module Parameters

Banner module parameters.png

Advanced Parameters

Banner module parameters advanced.png

Breadcrumbs

This Module shows a set of navigation links that illustrates where you are inside the web site and allows you to navigate back. An example is shown below:

Breadcrumbs example.png

The Module Type name for this is "mod_breadcrumbs". This Module does not relate to any other component.

Module Parameters

Module.Breadcrumbs Params.png

Advanced Parameters

Module Params.Cache.png

Custom HTML

This allows you to create a Module that contains any valid HTML code. There are many cases where you might want to put free-form HTML inside a web page. For example, you might want to create an HTML Image Map or you might want to copy HTML code from PayPal, Amazon, or some other site.

The Custom HTML Module allows you to create a self-contained HTML unit and then put it in any valid location on a page.

Custom Output

When you create or edit a Custom HTML Module, an editor session is opened using your default editor.

Important Note: The editor does not allow you to enter certain HTML tags. To work around this, you can temporarily change your User's editor to "No Editor", create the Custom HTML Module, and then change the editor back to TinyMCE. Another option is to use an editor from an Extension that allows HTML code to be entered. Another possibility is (if the editor has this option) to switch to the HTML mode, enter the code, save and switch back to normal view.

An example of a Custom HTML editor session is shown below. Note that the "No Editor" option is being used.

Custom html example.png

Module Parameters

Custom html parameters.png

Feed Display

This Module shows an RSS News Feed from a website. An example is shown below:

FP Module.Feed Output.png

The Module Type name for this Module is "mod_feed". This Module is not related to the News Feeds Component or the News Feeds Layouts in the Menu Items - New/Edit screen but is an alternative that allows a feed to display in a Module position.

Module Parameters

Module.Feed Params.png

Advanced Parameters

Newsfeed module advanced.png

Footer

This Module displays the web site copyright and Joomla! license information, as shown in the example below:

Footer module example.png

The Module Type name for this Module is "mod_footer". It is not related to any other component.

Module Parameters

Footer parameters.png

Language Switcher

Latest News

This Module shows a list of the most recently published Articles. An example is shown below:

Latest module example.png

The Module Type name for this is "mod_latest". It is not related to any other component.

Module Parameters

Latest parameters.png

Advanced Parameters

Newsfeed module advanced.png

Login

This Module displays a username and password Login form. It also displays a link to retrieve a forgotten password. An example is shown below:

Login module example.png

The Module Type name for this is "mod_login". If User registration is enabled in the User Settings of the Global Configuration screen, then the link "Create an Account" will be shown to invite Users to self-register.

This module is not related to any other component. Similar functionality can also be provided with a Menu Item of type Default Login Layout. See the Menu Item New/Edit screen for more information.

Module Parameters

Login module parameters.png

Menu

This Module allows you to place your Menus on the page. Every Joomla! website has at least one Menu that is created in the Menu Manager screen. The Menu Module allows you place all or part of the selected Menu at the desired position and on the desired web pages. The name for this Module is "mod_mainmenu".

Module Parameters

The Menu Module has the following Module Paramters:

Menu module parameters.png

Start and End Levels

Start and End Levels can be used to display different parts of one menu at different locations. For example, say you have one Menu with three levels as follows:

Menu Item 1
Menu Item 2
Menu Item 2.1
Menu Item 2.1.1
Menu Item 2.1.2
Menu Item 2.2
Menu Item 3

Using Start Level and End Level, you could show this one Menu as three different small menus on your pages. To do this, you would:

  1. Create a "Main" menu with a Start Level of 0 and End Level of 1. This Module would display on all Menu Selections.
  2. Your "Middle" Menu Module would have Start Level of 1 and End Level of 2. It would only display Menu Items 2.1 and 2.2. It could be placed at a different Position than the "Main" menu and might only display on Menu Selection pages for Menu Items 2, 2.1, 2.1.1, 2.1.2, and 2.2.
  3. The "Third" Menu Module would have Start Level of 2 and End Level of 3, so it would only display Menu Items 2.1.1 and 2.1.2. It could be placed at a different Position from the other Menu Modules. It might only have a Menu Assignment for the Menu Items 2.1, 2.1.1, and 2.1.2.

In this way, you can have one large, multi-level Menu but break it up into separate Modules. Also, doing a Menu in this manner has the advantage of making the Breadcrumbs Module display in a hierarchical manner.

Advanced Parameters

Menu module advanced parameters.png

Other Parameters

Menu module other parameters.png

Most Read Content

This Module displays a list of Articles with the highest hit counts. An example is shown below:

Most read example.png

The Module Type name for this is "mod_mostread". This Module is not related to any other component.

Module Parameters

Most read parameters.png

Advanced Parameters

Most read advanced.png

Newest Users

This module displays the latest registered users

Module Parameters

NewsFlash

This Module shows one or more Articles from one Category each time the page is refreshed. One random Article or a list of Articles can be displayed. An example is shown below.

Newsflash example.png

The Module Type name for this Module is "mod_newsflash". This Module is not related to any other component.

Module Parameters

Newsflash parameters.png

Advanced Parameters

Most read advanced.png

Poll

This Module shows a Poll that was created using the Poll Manager screen. The user can vote for an option or see the results of the Poll. An example is shown below:

Poll module example.png

The Module Type name for this Module is "mod_poll". If you press the "Results" button, the current Poll results display, similar to the Internal Link - Polls Layout available in the Menu Item Manager - New/Edit screen. An example of pressing the "Results" button is shown below:

Poll module results example.png

The Poll Module works with the Polls Component created in the Poll Manager screen.

Module Parameters

Poll module parameters.png

Advanced Parameters

Most read advanced.png

Random Image

This Module displays a random image from a directory. An example is shown below:

Random image example.png

The Module Type name for this Module is "mod_random_image". It is not related to any other component.

Module Parameters

Random image parameters.png

Advanced Parameters

Most read advanced.png

Related Articles

This Module shows a list of Articles that are related to the current Article being viewed by the user (for example, a Article Layout or a Blog or List layout where the user has clicked on an Article link). Articles are considered to be related to each other if they share at least one Keyword in the Article's Metadata Information. Article Keywords are entered in the Metadata Information section of the Article Manager - New/Edit screen.

An example is shown below:

Related items example.png

The Module Type name for this Module is "mod_related_items". It is not related to any other component.

Module Parameters

Related items parameters.png

Advanced Parameters

Most read advanced.png

Search

This Module displays a Search entry field where the user can type in a phrase and press Enter to search the web site. An example of a Search results screen is shown below:

Search module example.png

The Module Type name for this module is "mod_search". It is similar in function to the Internal Link - Search Layout available in the Menu Item Manager - New/Edit screen. This Module is not related to any other components.

Module Parameters

Search module parameters.png

Advanced Parameters

Most read advanced.png

Sections

This module does not exist in 1.6.

Categories

This Module shows a list of all categories within a selected category in the web site database. Sections are set up using the Section Manager screen. If the parameter Show Unauthorized Links [this has to be done in the article configuration at the Article Manager] is set to "No", only Sections that the User can access will be shown (after ACL like Public, Registered, Special). An example of the Sections Module is shown below:

Sections module example.png

The Module Type name for this Module is "mod_sections". It is not related to any other component.

Module Parameters

Module.Sections Params.png

Advanced Parameters

Most read advanced.png

Statistics

This Module shows a set of web site statistics. An example is shown below:

Stats module example.png

The Module Type name for this Module is "mod_stats". It is not related to any other component.

Module Paramters

Stats module parameters.png

Advanced Parameters

Most read advanced.png

Syndicate

This Module creates a RSS Feed link for the page. This allows a User to create a newsfeed for the current page. An example is shown below.

Syndicate module example.png

The Module Type name for this Module is "mod_syndicate". It is not related to any other component.

Module Parameters

Syndicate module parameters.png

Weblinks

Who's Online

This Module displays information about Users currently browsing the web site. An example is shown below:

Whosonline module example.png

The Module Type name for this Module is "mod_whosonline". It is not related to any other component.

Module Parameters

Whosonline module parameters.png

Wrapper

This Module allows you to insert an external web site into an IFrame at the Module position. If the web page is bigger than the Module size, scroll bars can be displayed. An example is shown below.

Wrapper module example.png

This Module provides functionality similar to the Internal Link - Wrapper Layout in the Menu Item Manager - New/Edit screen. The Module Type name for this Module is "mod_wrapper". It is not related to any other component.

Module Parameters

Wrapper module parameters.png

Advanced Parameters

Most read advanced.png

Toolbar

At the top right you will see the toolbar:

Banner edit toolbar.png

The functions are:

Quick Tips

Related information

License: Joomla! Electronic Documentation License
Source page: http://docs.joomla.org/Screen.modulessite.edit.15
Page retrieved: 0.306 seconds, 1.72 MB

Top