Joomla! Documentation™

Under Construction

How to Access

Navigate to the Module Manager and either press the "New" button on the toolbar or click on a Module Name.

Description

This is where you create new Modules or edit existing Modules. This screen has two links in the upper left: Site and Administrator. The Site link is selected by default. The Site link allows you to work with Modules that will be visible on your web site's front end. This is where you will do most of your work with Modules.

The Administrator link allows you to work with Modules that show on your web site's back end. In many cases, it is not necessary to modify the back-end Modules for Joomla!. All of the standard Joomla! administrator functions are available with no modifications here. You only need to make changes here if you want to change the standard administrator functions.

When you create a new Module, you will select the Module Type. This will determine what type of content this Module can display. If you edit and existing Module, the Module Type will already be determined. Note that you cannot change the Module Type of an existing Module.

For detailed information about each Module type for your web site, see the Modules Site screen. For detailed information about modifying the Modules for the back end of your site, see Modules Administrator.

All Modules have two sections that are the same: Details and Menu Assignment. The Parameters are different for each Module Type.

Screenshot

Details

• Module Type. This displays the system name of the module. No entry is allowed.
• Title. The Title of the Module.
• Show Title. Whether or not to show the Title of the Module.
• Enabled. Whether or not the Module is enabled. If "No", the Module will not be shown on the page.
• Position. The Position on the page to show the Module. There are two types of Positions you can use.
  1. You can select a Position from the drop-down list box. The Positions in the list box are those provided by your Template. You can see the available Positions on the page by adding the letters "?tp=1" to the end of any front-end Joomla! URL. For example, if your home page is "www.mysite.com", you can type the URL "www.mysite.com?tp=1". The page will display with gray rectangles indicating each pre-defined Position for the current Template.
  2. You can type in a Position that is different from the pre-defined positions (for example, "myposition1"). This type of Position can be used to insert a Module into an Article. If you enter the code "{loadposition xxx}" inside an Article, where "xxx" matches the Position of a Module, and if the Module is assigned to the the Menu Selection where the Article is displayed (see #Menu Assignment below), then the Module will be displayed at that point in the Article.

Quick Tips

• You can insert a Joomla! Module inside an Article by typing "{loadposition xxx}", where "xxx" is the position entered for the desired Module. Note that the position name must not conflict with a position used by your Joomla! template. It can be any name (e.g., "mymoduleposition1") as long as it matches the position name typed in for the Module. The Menu Assignment for the Module must include the Menu Item where the Article is displayed, and the Plugin called "Content - Load Module" must be enabled (which it is by default). This feature allows you, for example, to insert a Custom HTML Module anywhere in an Article. See Article Manager - New/Edit for information about adding and editing Articles.