Web Development Documentation

The procedure explains how to add a "Custom" module in Joomla! using the Administrator interface. A "Custom" module is a block of formatted text that can be configured to appear when one or more menu items are accessed.

A custom module allows you to add custom text and/or an image and place it in a position on the website.

Create a new Module

1. In the Joomla! back-end (Control Panel), navigate to Extensions > Site Modules, then click the New Button to create a new module
   
2. For "Select a Module Type," select Custom:
   
3. Enter the name of your module in the "Title *" field (see #1 below).
4. (Optional) click "Hide" under "Show title" selection to the right if the module title should not be shown (see #2 below).
5. For "Position," click the dropdown menu, and select the desired module position.  For example, to display the module to the left of the content area, select "Sidebar-left [sidebar-left]" (see #3 below).
6. Under the formatting toolbars, enter the text that you would like to appear in the module.  You can format the text using the buttons on the editor toolbars (see #4 below).
7. Click the "Menu Assignment" menu to specify which menu items will display your module (see #5 below).
8. If the new module should appear on all pages, leave "On all pages" selected. If not, go to the next section, "Assigning the module to specific menu items."
   

Assigning the Module to specific menu items

If the module should appear only when one or more specific menu items are accessed, do the following:

• On the "Menu Assignment" tab, click the dropdown box to the right of Module Assignment and select "Only on the pages selected" (see #1 below).
• For Menu Selection, click None to the right of "Assign to Menu Items" (see #2 below).
• Click the check boxes for any menu items that should display the module when clicked (see #3 below).

Saving the Module

• To save changes and continue editing the module, click the Save button to the upper left of the web page.
• When you are done editing the module, click "Save & Close" to the upper left to save your new module.