Help39

Help39:Extensions Module Manager

From Joomla! Documentation


Other languages:
Deutsch • ‎English • ‎français • ‎Nederlands

Description

The Module Manager is where you add and edit Joomla! Modules. In Joomla!, Modules are used to display content and/or media around the main content.

Module Facts:

  1. All Joomla! websites require at least 1 Menu Module
  2. All Other Module Types are Optional. (Examples: News, Banner, Latest News)
  3. Every Menu is accompanied by a menu module. (Example mod_mainmenu)
  4. Multiple occurrences of similar module types.
  5. Some Modules are linked to components. For example, each Menu Module is related to one Menu component. To define a Menu in Joomla!, you need to create the Menu and Menu Items using the Menus screens and then create the Module for the Menu using this screen. Other Modules, such as Custom HTML and Breadcrumbs, do not depend on any other content.

How to Access

Select Extensions  Modules from the drop-down menu on the back-end of your Joomla! installation.

Screenshot

Help30-Extensions-Module-Manager-screen-en.png

Column Headers

In the table containing Modules, these are the different columns shown below. Click on the column heading to sort the list by that column's value.

Help3x-Extensions-Modules-Manage-columns-en.png
  • Order. Order items will be displayed in.
  • 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.
  • Status. (Published/Unpublished/Trashed) The published status of the item.
  • Title. The name of the item. For a Menu Item, the Title will display in the Menu. For an Article or Category, the Title may optionally be displayed on the web page. This entry is required. You can open the item for editing by clicking on the Title.
  • Position. Set to control the Position's display in list.
  • Type. The system name of the Module. Joomla! installs 20 standard Modules. Many Joomla! Extensions contribute additional Modules. See Module Manager New/Edit for information about each of the standard Modules.
  • Pages. The Menu Items where this Module will be displayed. Options are "All" for all Menu Items, "None" for no Menu Items, and "Varies" for selected Menu Items. A Module will only display on Menu Items where it is selected.
  • Language. Item language.
  • ID. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.

List Filters

Site and Administrator filter

At the top left you will see the following filter:

Help30-Extensions-Module-Manager-links-subscreen-en.png

  • Site. Filters on Site modules. This is the default selection and allows you to manage the Modules for the front end of the web site.
  • Administrator. This allows you to manage the Modules for the back end administration of the web site. If you do not need to change the Joomla! administrator menus, no modifications are required here.

Filter by Partial Title or ID. In the upper left is a filter or search field and two buttons, as shown below.

Help30-colheader-filter-field-en.png

  • To filter by partial title, enter part of the title and click Search.
  • To filter by ID number, enter "id:xx", where "xx" is the ID number (for example, "id:9").
Click Clear to clear the Filter field and restore the list to its unfiltered state.

Filter by Status, Position, Type, Menu Item, Access and Language

In the upper right area, above the column headings, are following drop-down list boxes as shown below:

Help30-Extensions-Module-Manager-filters-subscreen-en.png

The selections may be combined. Only items matching both selections will display in the list.

  • Select Status. Use the drop-down list box to select the published state: Published, Unpublished, Trashed, or All. For Articles, you may also select Archived. Important: With the default setting of -Select Status-, the screen only shows Published and Unpublished items. If you have the filter set to -Select Status- and you change items to Trashed, the Trashed items will disappear from the screen. However, they have not been permanently deleted. To do that you need to:
  1. Change the filter to Trashed. The Delete icon will now show in the toolbar.
  2. Select the items you want to permanently delete.
  3. Click on the Delete icon.
You can see all items, regardless of their published state, by selecting All for this filter. You can also re-publish Trashed items by selecting them and clicking on the Publish icon in the toolbar.
  • Select Position. Select a Position from the drop-down list box of available Positions.
  • Select Type. Select the Module Type from the drop-down list box of available Module Types. Joomla! installs with 20 available Module Types. Additional ones may be available if you have installed any Joomla! Extensions. See Module Manager - New/Edit for information about the available Module Types.

Filter by Menu. Lets you show only items that have a specific menu assigned. The list box will show the menus defined for your site, similar to the example below.

Help30-colheader-select-menu-en.png

  • - Select Menu - Show items for any menu.
  • <your menu>: Show items only for this menu.

Filter by Access. Lets you show only items that have a specified viewing access level. The list box will show the access levels defined for your site.

Help30-colheader-select-access-en.png

  • - Select Access -: Show items with any viewing access level.
  • <access level group>: Show items only with this viewing access level.

Filter by Language. Lets you show only items that have a specific language assigned. The list box will show the languages defined for your site, similar to the example below.

Help30-colheader-select-language-en.png

  • - Select Language - or All: Show items for any language.
  • <your language>: Show items only for this language.

Toolbar

At the top left you will see the toolbar:

Help30-New-Edit-Duplicate-Publish-Unpublish-Checkin-Trash-Options-Help-toolbar-en.png

The functions are:

  • New. Opens the editing screen to create a new module.
  • Edit. Opens the editing screen for the selected module. If more than one module is selected (where applicable), only the first module will be opened. The editing screen can also be opened by clicking on the Name of the module.
  • Duplicate: Makes a copy of the selected module. The copy is created immediately and is given the same name as the original but prefixed with "Copy of" and/or suffixed with a number (eg. "(2)") so that it can be distinguished from the original and any other copies.
  • Publish. Makes the selected modules available to visitors to your website.
  • Unpublish. Makes the selected modules unavailable to visitors to your website.
  • Check-In. Checks-in the selected modules. Works with one or multiple modules selected.
  • Batch. Batch processes the selected modules. Works with one or multiple items selected.
  • Trash. Changes the status of the selected modules to indicate that they are trashed. Trashed modules can still be recovered by selecting "Trashed" in the Select Status filter and changing the status of the modules to Published or Unpublished as preferred. To permanently delete trashed modules, select "Trashed" in the Select Status filter, select the modules to be permanently deleted, then click the Empty Trash toolbar icon.
  • Help. Opens this help screen.
  • Options. Opens the Options window where settings such as default parameters can be edited.

Quick Tips

You can change the order of Modules within a Module Position as follows:

  • Select the desired Position using the Position Filter. This will limit the list to Modules that are assigned to this Position.
  • Change the order using the Up or Down arrows and changing the order by drag-and drop. The Modules will display in the new order within the Position.
  • To create or edit Modules: Module Manager - New/Edit

Related Information

  • More about Modules: what is a module position, Description of the default Site and Administrator Modules.