Help15:Screen.modulesadministrator.edit.15

How to access

Navigate to the Module Manager and press the "Administrator" link. To create a new Module, press the "New" button on the toolbar. To edit an existing Module, click on the Module Name or click on the Module's checkbox and press the Edit button on the toolbar.

Description

This is where you will add new Modules or edit existing Modules for the back end of your Joomla! web site. When you install Joomla!, 16 built-in Modules are available for use in the back end of your web site.

Screenshot

Note that if you install one or more Joomla! Extensions, these Extensions may add new Administrator Module Types. In this case, your screen will show additional Types.

Module Types

When the New button is pressed, the Module:[New] screen displays all of the Module Types available for new new Module. You can select the desired type either by clicking on the Module Name or by clicking on the Module's radio button and pressing the Next button on the toolbar. Note that you can cancel this action by pressing the Cancel button on the toolbar.

A standard Joomla! installation includes 16 Module Types. Each has it's own function and it's own Parameters, as described below.

Admin Menu

This Module shows the main admin navigation menu. An example of this module is shown below:

The Type for this Module is "mod_menu". It has no Module Parameters.

Advanced Parameters

• Caching. Use Global/No Caching. Whether or not to cache the content of this Module. A setting of "Use Global" will use the Cache Settings from the Global Configuration screen.

Admin Sub Menu

This Module shows the submenu navigation Module. This is used in the Banner, Contacts, News Feeds, Web Links, and Module Managers to allow navigation to the different element types (for example, Banners, Clients, and Categories). An example of this Module is shown below.

The Type for this Module is "mod_submenu". It has one Module Parameter called "Caching", which is always set to Never.

Custom HTML

This Module allows you to display custom HTML. This is used to display the "Wecome to Joomla!" panel in the Site → Control Panel, as shown in the example below:

The Type for this Module is "mod_custom". This Module is the same as the Custom HTML Module under Modules Site.

Feed Display

This Module allows you to show a news feed from an external web site. This is used to display the Joomla! Security Newsfeed panel in the Site → Control Panel, as shown in the example below:

Settings for Display in Admin CPanel: Set Position to cpanel, set Order to 0, set feed url to http://feeds.joomla.org/JoomlaSecurityNews?format=xml, set RTL Feed = No, set Feed Title = yes, set Feed Description = No, set Feed Image = No, set Items = 10, set Item Description = No, set Word Count = 0

This Module is the same as the Feed Display Module under Modules Site.

Footer

This Module displays the footer information in the Joomla! back end. An example is shown below:

This Module is the same as the Footer Module under Modules Site.

Item Stats

This Module shows details of the number of Menu Items that are still current on each of the Menus. This is displayed in the Site → Control Panel by expanding the "Menu Stats" link. An example is shown below:

The Type for this Module is "mod_stats".

Module Parameters

• Caching. Use Global/No Caching. Whether or not to cache the content of this Module. A setting of "Use Global" will use the Cache Settings from the Global Configuration screen.

Latest News

This Module is used to display the "Recent added Articles" in the Site → Control Panel. An example is shown below:

This Module is the same as the Latest News Module under Modules Site.

Logged In Users

This Module shows a list of users who are currently logged into the site. This is displayed in the Site → Control Panel by expanding the "Logged in Users" link. An example is shown below:

The Type for this Module is "mod_logged". This Module has one Module Parameter called Caching, which is always set to Never.

Login Form

This Module displays a Username and Password Login form. It cannot be disabled. The Module Type name for this is "mod_login".

Module Parameters

• Caching. Always set to Never.
• Encrypt Login Form. Whether or not to encrypt the login data. This requires SSL and should not be set to "Yes" unless Joomla! is accessible using the "https://" protocol prefix.

Online Users

This Module shows a count of users currently logged into the Joomla! back end. The Module Type name for this Module is "mod_online". It has one Module Parameter called "Caching", which is always set to Never.

Popular Articles

This Module shows a list of the most popular articles, based on the number of hits. This is displayed in the Site → Control Panel by expanding the "Popular" link. An example is shown below:

The Type for this Module is "mod_popular". It has one Module Parameter called "Caching", which is always set to Never.

Quick Icons

This Module shows the Quick Icons on the Site → Control Panel. An example is shown below:

The Module Type name for this Module is "mod_quickicon".

Module Paramters

• Caching. Use Global/No Caching. Whether or not to cache the content of this Module. A setting of "Use Global" will use the Cache Settings from the Global Configuration screen.

Title

This Module shows the Titles for each back-end screen. An example is shown below:

The Module Type name for this Module is "mod_title". It has a Module Parameter called "Caching", which is always set to Never.

Toolbar

This Module shows the toolbars used in the Joomla! back end. An example is shown below:

The Module Type name for this Module is "mod_toolbar". It has one Module Parameter called "Caching", which is always set to Never.

Unread Messages

This Module displays the number of unread Private Messages and provides a button to navigate to the Tools → Read Messages screen. The Module Type name for this Module is "mod_unread". It has one Module Parameter called "Caching", which is always set to Never.

User Status

This Module shows the User Status icons. This includes a Preview button, a Logout button, and counts of Private Messages and current Users. An example is shown below.

The Module Type name for this Module is "mod_status". It has one Module Parameter called "Caching", which is always set to Never.

Toolbar

At the top right you will see the toolbar:

The functions are:

• Save. Save it and return to editing the menu details.

• Apply. Save it, but stay in the same screen. If you have been working on a screen for a long time and don't want to risk losing your work, pressing Apply saves your work and lets you continue working. If, for example, you lost your Internet connection, your work will be saved up this point.

• Close. Return to the previous screen without saving your work. If you press Close while adding a new item, this new item will not be created. If you were modifying an existing item, the modifications will not be saved.

• Help. Opens this Help Screen.

Quick Tips

• Some Joomla! Extensions provide new Module Types. If you have installed any Extensions, your Joomla! site might have Module Types that are not listed here. In this case, please refer to the documentation for the Extension for information about these Module Types.

Related information

• To add or edit Modules: Module Manager
• To work with Site Modules: Modules Site