Help4.x:Modules

Description

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

How to Access

Home Dashboard → Site → Modules

To add a Module:

• click the New toolbar button

To edit a Module:

• select a Title from the list

Screenshot

Column Headers

• Checkbox. Check this box to select modules. To select all modules, check the box in the column heading. After boxes are checked the toolbar button 'Actions' get active.
• Ordering. You can change the order of an module within a list as follows:
  • Select the Ordering icon in the List heading to make it active.
  • Select one of the Three dots icons and drag it up or down to change the position of that row in the list.
  • In the Filter Options you may limit the list to modules that are assigned for example to a Language.
• Status. Status of module. Hover icon for informations.
• Title. The title of the module. Edit the module by clicking on the Title.
• Position. The position on the page where this module is displayed. Positions are locations on the page where modules can be placed (for example, "left" or "right"). Positions are defined in the Template in use for the page. Positions can also be used to insert a Module inside an Article using the syntax "{loadposition xxx}", where "xxx" is a unique position for the module.
• Type. The system name of the Module. Joomla! installs with around 50 available Module Types. Additional ones may be available if you have installed any Joomla! Extensions. Select the New button in the Toolbar to see the full list of available Site or Administrator 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.
• Access. The viewing Access Level for this module.
• Language. Modules language, default is 'All'.
• ID. A unique identification number for this module, you cannot change this number.

List Filters

Site and Administrator filter. Selects either Site modules or Administrator modules.

Search bar. Near the top of the page you will see the search bar shown in the Screenshot above.

• Search by Text. Enter part of the search term and click the Search icon. Hover to see a Tooltip indicating which fields will be searched.
  To 'Search by ID' enter "id:x", where "x" is the ID number (for example, "id:19").
• Filter Options. Click to display the additional filters.
• Clear. Click to clear the Filter field and restore the list to its unfiltered state.
• Ordering. Shows the current list ordering field. 2 ways to change the order:
  • Select from the dropdown list. Ordering may be in ascending or descending order.
  • Click a column heading. The column heading toggles between ascending and descending order.
• Number to Display. Shows the number of items in a list. Select from the dropdown list to change the number displayed.
  The default for a site is '20' but this may be changed in the Global Configuration.

Filter Options 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 around 50 available Module Types. Additional ones may be available if you have installed any Joomla! Extensions. The drop-down list shows which modules are active. Select the New button in the Toolbar to see the full list of available Site or Administrator modules.

• Select Menu Item. Select from the list of available menu items.

• Select Access. Select from the list of available viewing access levels.

• Select Language. Select from the list of available languages, if the site manages more than 1 language.

Toolbar

At the top of the page you will see the toolbar shown in the Screenshot above. The functions are:

• New. Opens the editing screen to create a new module.

• Actions: Reveals a list of actions for selected Items. Check one or more Item checkboxes to activate the list.

• 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.

• 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 articles 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.

• Batch. Batch processes the selected modules. Works with one or multiple items selected.

• 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.

• Options. Opens the Options window where settings such as default parameters can be edited.

• Help. Opens this help screen.

Quick Tips

• All Joomla! websites require at least 1 Menu Module
• All Other Module Types are Optional. (Examples: News, Banner, Latest News)
• Every Menu is accompanied by a menu module. (Example mod_mainmenu)
• Multiple occurrences of similar module types are allowed and common.
• 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.

Related Information

• Home Dashboard: Access to many default Joomla functions.
• The Joomla! installation has over 40 module types. Additional 3rd party modules can be obtained from the Joomla Extensions Directory.