From Joomla! Documentation
Revision as of 22:49, 13 May 2008 by Dextercowley
This article or section is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it as well. If this article or section
How to Access
Select Extensions → Module Manager from the drop-down menu on the back-end of your Joomla! installation. Or click the "Site" link from the Module Manager / Administrator screen.
The Module Manager is where you add and edit Joomla! Modules. In Joomla!, Modules are used to display things around the main page content. Some Modules, such as the Menu module ("mod_mainmenu"), are used in every Joomla! website. Other modules, such as Banners, "latest news", and "most read", are optional. Your website can have multiple instances of the same module. For example, all Joomla! menus are made using the "mod_mainmenu" module. So, if you have 5 menus, you will have 5 copies of the this module.
When you install Joomla!, 20 Modules are included. If you add extensions to your Joomla! installation, they may contribute additional modules.
Click on the column heading to sort the list by that column's value.
- #. An indexing number automatically assigned by Joomla! for ease of reference.
- Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
- Name. The name of the Banner. You can click on the name to open the Banner for editing.
- Client. The Client for this Banner. Clients are entered using the Banner Client Manager.
- Category. The Category this item belongs to. Clicking on the Category title opens the Category for editing. See Category Manager - Edit.
- Published. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.
- Order. The order to display items. You can change the order by entering the sequential order and clicking the 'Save Order' icon in the column heading.
- Sticky. Whether or not the Banner is "sticky". If one or more Banners in a Category are designated "sticky," they will take priority over Banners that are not sticky. For example, if two Banners in a Category are sticky and a third Banner is not sticky, the third Banner will not display if the Banner display module setting is "Sticky, Randomize" or "Sticky, Order." Only the two sticky Banners will display. If the sticky banners have a fixed number of impressions, once those impressions are used up, the sticky banners will no longer display, and the non-sticky banners will begin displaying automatically.
- Impressions. An Impression is how many times the Banner has been displayed on a page. The first number in this column is the actual number of Impressions so far, and the second number is how many Impressions were purchased by the client.
- Clicks. The first number is the total number of clicks that have been made on the Banner since the counter was reset. The second number is what percentage of the time user clicked on the banner when it was displayed.
- Tags. Optional Tags to be used for displaying specific Banners based on the content of the Article being viewed. If the Banner module Parameter 'Search By Tag' is set to 'Yes', Banners whose Tags match the Keywords entered for each Article will display when that Article is being viewed.
- ID. The ID number. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, for example in internal links. You can not change this number.
- Display #. The number of items to display on one page. If there are more items than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of items, it may be helpful to use the Filter options, located above the column headings, to limit which items display (where applicable).
Filter by Partial Title
You can filter the list of items by typing part of the title or the ID number. Or, you can select a combination of Category and Published State.
- Filter. In the upper left corner just above the column headings is a Filter field and two buttons, as shown below:
Filter by Category and Published State
In the upper right area, above the column headings, are 2 drop-down list boxes as shown below:
The selections may be combined. Only items matching both selections will display in the list.
- Select Category. Use the drop-down list box to select the desired Category. Only items in this Category will display.
- Select State. Use the drop-down list box to select the published state: Published or Unpublished.
The modules are sorted by the Position column by default but you can sort them by any column, just click the column header.
Position of a New Module
A newly installed module is disabled by default and is the last one in the left module position. This way you can easily find it and move it to the desired place.
Support Old Modules in Legacy Mode
Some old 1.0.x modules support Joomla! 1.5 in Legacy Mode. To be able to install such extensions please open the Plugin Manager screen from the Extensions menu and enable plugin System - Legacy as it is disabled by the default.
You can view the installed modules list on the Modules tab of the Extension Manager by clicking the Extensions -> Install/Uninstall menu item. You can remove them in this screen as well.
In Joomla! 1.5 the Module Manager was moved to the Extensions menu and got a tabbed interface for displaying the site and administrator modules. The below changes are related to both clients:
- The Publish toolbar button was renamed to Enable.
- The Unpublish toolbar button was renamed to Disable.
- Go and Reset buttons were added to the Filter field.
- Select Template drop down list was added.
- Select State drop down list was added.
- The Published column was renamed to Enabled.
- Reorder and Order columns merged into one Order column.
- The Access column is renamed to Access Level.
- The ID and Type columns were swapped.
- A column can be sorted ascending/descending by clicking the column header.
- You can create another instance of a module using the New toolbar button.
One module can be enabled/disabled by clicking the icon in the Enabled column. The enabled modules are marked with a green tick while the disabled ones are marked with a red X. When you want to enable/disable several modules, select their checkboxes and click the appropriate toolbar button.
When you want to create a copy of one or more modules select the checkbox(es) and click the Copy toolbar button. An information message will be displayed and you will find the module(s) with the name(s) "Copy of ..." inserted into the module name(s). The copies will have a disabled status.
When you want to delete one or more unnecessary modules select the checkbox(es) and click the Delete toolbar button. An information message will be displayed and the module(s) will be removed from the list.
You can create another instance of an installed or custom module using the New toolbar button. When you click it, the Module: [New] screen will be loaded. Select the desired module and click the Next toolbar button or simply click the module type.
You can enter the title, customize the details and the parameters and assign it to a menu in the loaded Module: [Edit] screen.
The four drop down lists make you easier to narrow the list of your choice, or you can enter a string in the Filter field and click the Go button to find the matching modules in the list.
The items can be moved up/down by clicking the arrows in the list, or they can be renumbered by entering a value in the field next to the arrow. In this case the order should be saved by clicking the floppy icon.
The access for a module can be changed simply by clicking the Public/Registered/Special value in the Access Level column.