==How to access==
Navigate to the [[screen.modules.15|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==
[[Image:Module_new_administrator.png|frame|center]]
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: [[Image:Admin_menu_example.png|frame|center]]
The Type for this Module is "mod_menu". It has no Module Parameters.

'''Advanced Parameters'''
{{colheader|Caching}}

===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. [[Image:Admin_submenu_example.png|frame|center]]
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:[[Image:Admin_custom_html_example.png|frame|center]]
The Type for this Module is "mod_custom". This Module is the same as the Custom HTML Module under [[screen.modulessite.edit.15#Custom HTML|Modules Site]].

===Feed Display===
This Module is not used by default in the Joomla! back end. This Module is the same as the Feed Display Module under [[screen.modulessite.edit.15#Feed Display|Modules Site]].

===Footer===
This Module displays the footer information in the Joomla! back end. An example is shown below: [[Image:Admin_footer_example.png|frame|center]]
This Module is the same as the Footer Module under [[screen.modulessite.edit.15#Footer|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:[[Image:MenuStatsExample.png|frame|center
]] The Type for this Module is "mod_stats".
'''Module Parameters'''
{{colheader|Caching}}

===Latest News===
This Module is used to display the "Recent added Articles" in the '''Site → Control Panel'''. An example is shown below:[[Image:Admin_latest_example.png|frame|center]]
This Module is the same as the Latest News Module under [[screen.modulessite.edit.15#Latest News|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:[[Image:Logged_in_users_example.png|frame|center
]] 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:[[Image:Admin_popular_articles_example.png|frame|center]]
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: [[Image:Admin_quick_icons_example.png|frame|center]]
The Module Type name for this Module is "mod_quickicon".

'''Module Paramters'''
{{colheader|Caching}}

===Title===
This Module shows the Titles for each back-end screen. An example is shown below:[[Image:admin_title_example.png|frame|center]]
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:[[Image:modules_site_toolbar.png|frame|center]]
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.
[[Image:User_status_example.png|frame|center]]
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:

[[Image:banner_edit_toolbar.png]]

The functions are:
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Close}}
{{toolbaricon|Help}}

==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: [[screen.modules.15|Module Manager]]
*To work with Site Modules: [[screen.modulessite.edit.15|Modules Site]]

<noinclude>{{cathelp|1.5|Module Manager|Extensions}}</noinclude>

Help15:Help screens

2008-06-24T23:43:57Z

Marieke92: /* Extensions Menu */

Help screens for Joomla! 1.5 have <s>not progressed very far</s> somewhat progressed <s>and</s> but we urgently need these to be completed.
{{dablink|Please post questions on the [[{{TALKPAGENAME}}|talk page]].}}

==Useful for editors==
*[[Layout helpscreen|Layout of a typical Help Screen]]
*Overview of [{{fullurl:Special:Allpages|namespace=106}} Help screen chunks]<br/>For usage information and examples see the following templates:
** {{tlx|colheader|Column name}} includes one of the ''Help screen column header XYZ'' chunks
** {{tlx|toolbaricon|Action name}} is for ''Help screen toolbar XYZ''
** {{tlx|cpanelicon|Icon name}} is for ''Help screen icon XYZ''
** for proper categorisation read the instructions of {{tim|cathelp}}
* [[Content editors]]
** {{[[Chunk:TinyMCE]]}} for TinyMCE
** {{[[Chunk:No editor]]}} for No editor
* Did you notice a mistake or do think it's useful to add some extra information? You're welcome to modify the Help Screen. Please change the status of the modified Help Screen after you modified it:
** Is the status at the moment 'Ready' or 'To be moved'? Change it to 'Modified by [name]' (replace [name] for your username at the Joomla! Docs Wiki)
** Is the status at the moment 'To be reviewed'? You don't have to change the status in that case.

==Category managers==
{| class="prettytable"
![[screen.categories.15|Category Managers]]
![[screen.categories.edit.15|Category Managers: New/Edit]]
|-
|{{:screen.categories.15}}
|{{:screen.categories.edit.15}}
|}

==Site Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|1
| [[screen.cpanel.15|Control Panel]]
| Site -> Control Panel
| [[jhelp:screen.cpanel.15|screen.cpanel.15]]
| Ready
|-
|2
| [[screen.users.15|User Manager]]
| Site -> User Manager
| [[jhelp:screen.users.15|screen.users.15]]
| Ready
|-
|3
| [[screen.users.edit.15|User Manager - New/Edit]]
| Site -> User Manager -> New/Edit
| [[jhelp:screen.users.edit.15|screen.users.edit.15]]
| Ready
|-
|4
| [[screen.mediamanager.15|Media Manager]]
| Site -> Media Manager
| [[jhelp:screen.mediamanager.15|screen.mediamanager.15]]
| Ready
|-
|5
| [[screen.config.15|Global Configuration]]
| Site -> Global Configuration
| [[jhelp:screen.config.15|screen.config.15]]
| Ready
|}

==Menus Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|6
| [[screen.menumanager.15|Menu Manager]]
| Menus -> Menu Manager
| [[jhelp:screen.menumanager.15|screen.menumanager.15]]
| Ready
|-
|7
| [[screen.menumanager.new.15|Menu Manager - New/Edit]]
| Menus -> Menu Manager -> New/Edit
| [[jhelp:screen.menumanager.new.15|screen.menumanager.new.15]]
| Ready
|-
|8
| [[screen.trashmanager.15|Trash Manager]]
| Menus/Content -> Trash Manager
| [[jhelp:screen.trashmanager.15|screen.trashmanager.15]]
| Ready
|-
|9
| [[screen.menus.15|Menu Item Manager]]
| Menus -> [Menu name]
| [[jhelp:screen.menus.15|screen.menus.15]]
| Ready
|-
|10
| [[screen.menus.edit.15|Menu Item Manager - New/Edit]]
| Menus -> [Menu name] -> New/Edit
| [[jhelp:screen.menus.edit.15|screen.menus.edit.15]]
| Ready
|}

==Content Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|11
| [[screen.content.15|Article Manager]]
| Content -> Article Manager
| [[jhelp:screen.content.15|screen.content.15]]
| Ready
|-
|12
| [[screen.content.edit.15|Article Manager - New/Edit]]
| Content -> Article Manager -> New/Edit
| [[jhelp:screen.content.edit.15|screen.content.edit.15]]
| Ready
|-
|13
| [[screen.sections.15|Section Manager]]
| Content -> Section Manager
| [[jhelp:screen.sections.15|screen.sections.15]]
| Ready
|-
|14
| [[screen.sections.edit.15|Section Manager - New/Edit]]
| Content -> Section Manager -> New/Edit
| [[jhelp:screen.sections.edit.15|screen.sections.edit.15]]
| Ready
|-
|15
| [[screen.contentcategories.15|Category Manager]]
| Content -> Category Manager
| [[jhelp:screen.contentcategories.15|screen.contentcategories.15]]
| Ready
|-
|16
| [[screen.contentcategories.edit.15|Category Manager - New/Edit]]
| Content -> Category Manager -> New/Edit
| [[jhelp:screen.contentcategories.edit.15|screen.contentcategories.edit.15]]
| Ready
|-
|17
| [[screen.frontpage.15|Front Page Manager]]
| Content -> Front Page Manager
| [[jhelp:screen.frontpage.15|screen.frontpage.15]]
| Ready
|}

==Components Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|18
| [[screen.banners.15|Banner Manager]]
| Components -> Banner -> Banners
| [[jhelp:screen.banners.15|screen.banners.15]]
| Ready
|-
|19
| [[screen.banners.edit.15|Banner Manager - New/Edit]]
| Components -> Banner -> Banners -> New/Edit
| [[jhelp:screen.banners.edit.15|screen.banners.edit.15]]
| Ready
|-
|20
| [[screen.banners.client.15|Banner Client Manager]]
| Components -> Banner -> Clients
| [[jhelp:screen.banners.client.15|screen.banners.client.15]]
| Ready
|-
|21
| [[screen.banners.client.edit.15|Banner Client Manager - New/Edit]]
| Components -> Banner -> Clients -> New/Edit
| [[jhelp:screen.banners.client.edit.15|screen.banners.client.edit.15]]
| Ready
|-
|22
| [[screen.bannercategories.15|Banner Category Manager]]
| Components -> Banner -> Categories
| [[jhelp:screen.bannercategories.15|screen.bannercategories.15]]
| Ready
|-
|23
| [[screen.bannercategories.edit.15|Banner Category Manager - New/Edit]]
| Components -> Banner -> Categories -> New/Edit
| [[jhelp:screen.bannercategories.edit.15|screen.bannercategories.edit.15]]
| Ready
|-
|24
| [[screen.contactmanager.15|Contact Manager]]
| Components -> Contacts -> Contacts
| [[jhelp:screen.contactmanager.15|screen.contactmanager.15]]
| Ready
|-
|25
| [[screen.contactmanager.edit.15|Contact Manager - New/Edit]]
| Components -> Contacts -> Contacts -> New/Edit
| [[jhelp:screen.contactmanager.edit.15|screen.contactmanager.edit.15]]
| Ready
|-
|26
| [[screen.contactcategories.15|Contact Category Manager]]
| Components -> Contacts -> Categories
| [[jhelp:screen.contactcategories.15|screen.contactcategories.15]]
| Ready
|-
|27
| [[screen.contactcategories.edit.15|Contact Category Manager - New/Edit]]
| Components -> Contacts -> Categories -> New/Edit
| [[jhelp:screen.contactcategories.edit.15|screen.contactcategories.edit.15]]
| Ready
|-
|28
| [[screen.newsfeeds.15|News Feeds Manager]]
| Components -> News Feeds -> Feeds
| [[jhelp:screen.newsfeeds.15|screen.newsfeeds.15]]
| Ready
|-
|29
| [[screen.newsfeeds.edit.15|News Feeds Manager - New/Edit]]
| Components -> News Feeds -> Feeds -> New/Edit
| [[jhelp:screen.newsfeeds.edit.15|screen.newsfeeds.edit.15]]
| Ready
|-
|30
| [[screen.newsfeedscategories.15|News Feeds Category Manager]]
| Components -> News Feeds -> Categories
| [[jhelp:screen.newsfeedscategories.15|screen.newsfeedscategories.15]]
| Ready
|-
|31
| [[screen.newsfeedscategories.edit.15|News Feeds Category Manager - New/Edit]]
| Components -> News Feeds -> Categories -> New/Edit
| [[jhelp:screen.newsfeedscategories.edit.15|screen.newsfeedscategories.edit.15]]
| Ready
|-
|32
| [[screen.polls.15|Poll Manager]]
| Components -> Polls
| [[jhelp:screen.polls.15|screen.polls.15]]
| Unknown
|-
|33
| [[screen.polls.edit.15|Poll Manager - New/Edit]]
| Components -> Polls -> New/Edit
| [[jhelp:screen.polls.edit.15|screen.polls.edit.15]]
| Ready
|-
|34
| [[screen.stats.searches.15|Search Statistics]]
| Components -> Search
| [[jhelp:screen.stats.searches.15|screen.stats.searches.15]]
| Ready
|-
|35
| [[screen.weblink.15|Web Link Manager]]
| Components -> Web Links -> Links
| [[jhelp:screen.weblink.15|screen.weblink.15]]
| To be moved
|-
|36
| [[screen.screen.weblink.edit.15|Web Link Manager - New/Edit]]
| Components -> Web Links -> Links -> New/Edit
| [[jhelp:screen.weblink.edit.15|screen.weblink.edit.15]]
| To be moved
|-
|37
| [[screen.weblinkcategories.15|Web Link Category Manager]]
| Components -> Web Links -> Categories
| [[jhelp:screen.weblinkcategories.15|screen.weblinkcategories.15]]
| To be moved
|-
|38
| [[screen.weblinkcategories.edit.15|Web Link Category Manager - New/Edit]]
| Components -> Web Links -> Categories -> New/Edit
| [[jhelp:screen.weblinkcategories.edit.15|screen.weblinkcategories.edit.15]]
| To be moved
|}

==Extensions Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|39
| [[screen.installer.15|Extension Manager]]
| Extensions -> Install/Uninstall
| [[jhelp:screen.installer.15|screen.installer.15]]
| To be moved
|-
|40
| [[screen.modules.15|Module Manager]]
| Extensions -> Module Manager
| [[jhelp:screen.modules.15|screen.modules.15]]
| To be moved
|-
|41
| [[screen.modules.edit.15|Module Manager - New/Edit]]
| Extensions -> Module Manager -> New/Edit
| [[jhelp:screen.modules.edit.15|screen.modules.edit.15]]
| To be moved
|-
|41a
| [[screen.modulessite.edit.15|Modules Site]]
| Extensions -> Module Manager -> New/Edit -> Site
| [[jhelp:screen.modulessite.edit.15|screen.modulessite.edit.15]]
| To be moved
|-
|41b
| [[screen.modulesadministrator.edit.15|Modules Administrator]]
| Extensions -> Module Manager -> New/Edit -> Administrator
| [[jhelp:screen.modulesadministrator.edit.15|screen.modulesadministrator.edit.15]]
| To be moved
|-
|42
| [[screen.plugins.15|Plugin Manager]]
| Extensions -> Plugin Manager
| [[jhelp:screen.plugins.15|screen.plugins.15]]
| Mark is working on
|-
|43
| [[screen.plugins.edit.15|Plugin Manager - Edit]]
| Extensions -> Plugin Manager -> Edit
| [[jhelp:screen.plugins.edit.15|screen.plugins.edit.15]]
| Unknown
|-
|44
| [[screen.templates.15|Template Manager]]
| Extensions -> Template Manager
| [[jhelp:screen.templates.15|screen.templates.15]]
| Adapt
|-
|45
| [[screen.languages.15|Language Manager]]
| Extensions -> Language Manager
| [[jhelp:screen.languages.15|screen.languages.15]]
| Adapt
|}

==Tools & Help Menu ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|46
| [[screen.messages.inbox.15|Private messages - Inbox]]
| Tools -> Read messages
| [[jhelp:screen.messages.inbox.15|screen.messages.inbox.15]]
| Unknown
|-
|47
| [[screen.messages.read.15|Private messages - Read]]
| Tools -> Read Message -> [Message]
| [[jhelp:screen.messages.read.15|screen.messages.read.15]]
| Unknown
|-
|48
| [[screen.messages.edit.15|Private messages - Write]]
| Tools -> Write Message
| [[jhelp:screen.messages.edit.15|screen.messages.edit.15]]
| Unknown
|-
|49
| [[screen.users.massmail.15|Mass Mail]]
| Tools -> Mass Mail
| [[jhelp:screen.users.massmail.15|screen.users.massmail.15]]
| Unknown
|-
|50
| [[screen.checkin.15|Global Check-in]]
| Tools -> Global Check-in
| [[jhelp:screen.checkin.15|screen.checkin.15]]
| Unknown
|-
|51
| [[screen.cache.15|Clean Cache]]
| Tools -> Clean Cache
| [[jhelp:screen.cache.15|screen.cache.15]]
| Unknown
|-
|52
| [[screen.system.info.15|System Information]]
| Help -> System Info
| [[jhelp:screen.system.info.15|screen.system.info.15]]
| Adapt
|}

==General ==
{| class="wikitable" style="width:100%; vertical-align:top; border:1px solid Sienna; background-color:Cornsilk;"
|- style="background-color:Wheat; font-weight:bold; text-align: left;"
!width=3%|<nowiki>#</nowiki>
!width=25%|Help screen
!width=35%|Path in Joomla! 1.5.x
!width=25%|Joomla! 1.5.x help screen
!width=12%|Status
|-
|53
| [[joomla.credits.15|Credits]]
| General
| [[jhelp:joomla.credits.15|joomla.credits.15]]
| Ready
|-
|54
| [[joomla.glossary.15|Glossary]]
| General
| [[jhelp:joomla.glossary.15|joomla.glossary.15]]
| Ready
|-
|55
| [[joomla.support.15|Support]]
| General
| [[jhelp:joomla.support.15|joomla.support.15]]
| Ready
|-
|56
| [[joomla.whatsnew10.15|What's New in Version 1.0]]
| General
| [[jhelp:joomla.whatsnew10.15|joomla.whatsnew10.15]]
| Ready
|-
|57
| [[joomla.whatsnew15.15|What's New in Version 1.5]]
| General
| [[jhelp:joomla.whatsnew15.15|joomla.whatsnew15.15]]
| Ready
|}

<noinclude>
[[Category:DocCamp]]
[[Category:Joomla! 1.5]]
</noinclude>

Help15:Screen.modulessite.edit.15

2008-06-24T23:42:00Z

Marieke92:

==How to access==
Navigate to the [[screen.modules.15|Module Manager]]. 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 front end of your Joomla! web site. When you install Joomla!, 20 built-in Modules are available for use in the front end of your web site. Some Modules, like the Menu Module, are used in every Joomla! web site. Other Modules are optional.

==Screenshot==
[[Image:Module_new.png|frame|center]]
Note that if you install one or more Joomla! Extensions, these Extensions may add new 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 20 Module Types. Each has it's own function and it's own Parameters, as described below.

===Archived Content===
This Module shows Articles that have been set to Archived. The Articles are available behind a Month/Year directory list, as shown in the example below.[[Image:Archive_module1.png|frame|center]] Selecting a month link shows a screen like the one below.[[Image:Archive_module2.png|frame|center]]
Articles are stored by creation date not archival date. Only those months and years with archived Articles will be displayed. This list is generated automatically.

The Module Type name for this is "mod_archive". This module does not relate to any other component. This Module provides functionality that is similar to the Archived Article List Layout available on the [[screen.menus.edit.15#Archived Article List|Menu Item Manager New / Edit]] screen.

'''Module Parameters'''
[[Image:Archive_module_parameters1.png|frame|center]]
*'''Count.''' The number of Articles to display.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:Archive_module_parameters2.png|frame|center]]
{{colheader|Caching}}

===Banner===
This Module allows you to show active Banners from the Banner Component created in the [[screen.banners.15|Banner Manager]] screen. The Module Type name for this is "mod_banners".

'''Module Parameters'''
[[Image:Banner_module_parameters.png|frame|center]]
{{colheader|Target}}
*'''Count.''' The number of Banners to display.
*'''Banner Client.''' The Client for this Banner Module. Select from the drop-down list box of Banner Clients. Banner Clients are created in the [[screen.banners.client.15|Banner Client Manager]] screen.
*'''Category.''' The Category for this Banner Module. Select from the drop-down list box of Banner Categories. Banner Categories are created in the [[screen.bannercategories.15|Banner Category Manager]] screen.
*'''Search By Tags.''' Whether or not to select the Banner by matching the Banner Tags to the current Article keywords.
*'''Randomise.''' Sticky, Ordering / Sticky, Randomise. "Sticky, Ordering" means that the Banners will display in order. "Sticky, Randomise" means that the Banners will display in random order.
*'''Header Text.''' Text to display before the Banner group.
*'''Footer Text.''' Text to display after the Banner group.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:Banner_module_parameters_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Breadcrumbs===
This Module shows a set of navigation links that illustrates where you are inside the web site and allows you to navigate back. An example is shown below:[[Image:Breadcrumbs_example.png|frame|center]] The Module Type name for this is "mod_breadcrumbs". This Module does not relate to any other component.

'''Module Parameters'''
[[Image:Breadcrumbs_parameters.png|frame|center]]
*'''Show Home.''' Whether or not to show the Home page in the Breadcrumbs path.
*'''Text for Home entry.''' The text to display for the Home page in the Breadcrumbs.
*'''Text Serarator.''' The text to use to separate navigation elements. If blank, ">>" is used.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:Breadcrumbs_parameters_advanced.png|frame|center]]
*'''Caching.''' The only valid value is "Never".
{{colheader|Cache Time}}

===Custom HTML===
This allows you to create a Module that contains any valid HTML code. There are many cases where you might want to put free-form HTML inside a web page. For example, you might want to create an HTML Image Map or you might want to copy HTML code from PayPal, Amazon, or some other site.

The Custom HTML Module allows you to create a self-contained HTML unit and then put it in any valid location on a page.

'''Custom Output'''

When you create or edit a Custom HTML Module, an editor session is opened using your default editor.

:''Important Note:'' The TinyMCE editor does not allow you to enter certain HTML tags. To work around this, you can temporarily change your User's editor to "No Editor", create the Custom HTML Module, and then change the editor back to TinyMCE. Another option is to use an editor from an Extension that allows HTML code to be entered.

An example of a Custom HTML editor session is shown below. Note that the "No Editor" option is being used.[[Image:Custom_html_example.png|frame|center]]

'''Module Parameters'''
[[Image:Custom_html_parameters.png|frame|center]]
{{colheader|Module Class Suffix}}

===Feed Display===
This Module shows an RSS News Feed from a website. An example is shown below:[[Image:Newsfeed_module_example.png|frame|center]] The Module Type name for this Module is "mod_feed". This Module is not related to the News Feeds Component or the News Feeds Layouts in the [[Screen.menus.edit.15#Single Feed Layout|Menu Items - New/Edit]] screen but is an alternative that allows a feed to display in a Module position.

'''Module Parameters'''
[[Image:Newsfeed_parameters.png|frame|center]]
{{colheader|Module Class Suffix}}
*'''Feed URL.''' The URL address of the RSS news feed.
*'''RTL Feed''' Whether or not the feed is in a language that reads from right to left.
*'''Feed Title.''' Whether or not to display the Feed Title.
*'''Feed Description.''' Whether or not to display the Feed Description.
*'''Feed Image.''' Whether or not to display the Feed Image.
*'''Items.''' The number of news feed items to display.
*'''Item Description.''' Whether or not to show the Description or Into Text of individual items.
*'''Word Count.''' The maximum number of words to display in the Item Description. A value of 0 will display the entire Item Description.

'''Advanced Parameters'''
[[Image:Newsfeed_module_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Footer===
This Module displays the web site copyright and Joomla! license information, as shown in the example below:
[[Image:Footer_module_example.png|frame|center]] The Module Type name for this Module is "mod_footer". It is not related to any other component.

'''Module Parameters'''
[[Image:Footer_parameters.png|frame|center]]
{{colheader|Caching}}

===Latest News===
This Module shows a list of the most recently published Articles. An example is shown below:[[Image:Latest_module_example.png|frame|center]]

The Module Type name for this is "mod_latest". It is not related to any other component.

'''Module Parameters'''
[[Image:Latest_parameters.png|frame|center]]
*'''Count.''' The number of Articles to show.
*'''Order.''' Recently Added First or Recently Modified First. Whether to show the Articles based on the date added or the date modified.
*'''Authors.''' Anyone, Added or modified by Me, or Not added or modified by me. Optional filter to limit the display to Articles based on whether they were authored or modified by the current user. Only applies if a user is logged in to the site.
*'''Front Page Articles.''' Show or Hide Articles published to the Front Page.
*'''Section ID.''' Optional filter to select Articles only from specific Sections. Include one or more Section ID numbers, separated by a comma (for example, "12,15").
*'''Category ID.''' Optional filter to select Articles only from specific Categories. Include one or more Category ID numbers, separated by a comma (for example, "12,15").
{{colheader|Module Class Suffix}}
[[Image:Latest_parameters_advanced.png|frame|center]]

===Login===
This Module displays a username and password Login form. It also displays a link to retrieve a forgotten password. An example is shown below:[[Image:Login_module_example.png|frame|center]]
The Module Type name for this is "mod_login". If User registration is enabled in the User Settings of the [[screen.config.15#User Settings|Global Configuration]] screen, then the link "Create an Account" will be shown to invite Users to self-register.

This module is not related to any other component. Similar functionality can also be provided with a Menu Item of type Default Login Layout. See the [[screen.menus.edit.15#Default Login Layout|Menu Item New/Edit]] screen for more information.

'''Module Parameters'''
[[Image:Login_module_parameters.png|frame|center]]
*'''Caching.''' Caching is not allowed, so "Never" is always selected.
{{colheader|Module Class Suffix}}
*'''Pre-text.''' Optional text or HTML to display above the login form.
*'''Post-text.''' Optional text or HTML to display below the login form.
*'''Login Redirection Page.''' The page to load after a successful login. Select from the drop-down list box. If no page is selected, the home page will be used.
*'''Logout Redirection Page.''' The page to load after a successful logout. Select from the drop-down list box. If no page is selected, the home page will be used.
*'''Greeting.''' Whether or not to show the simple greeting text, for example, "Hi Administrator".
*'''Name/Username.''' Whether to use the user's Name or Username in the simple greeting.
*'''Encrypt Login Form.''' Whether or not to encrypt the login form using SSL. Do not enable this option if Joomla! is not accessible using the "https://" prefix.

===Menu===
This Module allows you to place your Menus on the page. Every Joomla! website has at least one Menu that is created in the [[screen.menumanager.15|Menu Manager]] screen. The Menu Module allows you place all or part of the selected Menu at the desired position and on the desired web pages. The name for this Module is "mod_mainmenu".

'''Module Parameters'''

The Menu Module has the following Module Paramters:
[[Image:Menu_module_parameters.png|frame|center]]
*'''Menu Name.''' The name of the Menu created in the [[screen.menumanager.15|Menu Manager]] screen. The default is "mainmenu". Note that you can have more than one Menu Module with the same Menu Name specified here (for example, if you are using Start and End Levels).
*'''Menu Style.''' The style of the menu. The options are as follows:
** ''List.'' Joomla! 1.5 List style. This is the style used by the menus in the Sample website.
** ''Legacy Vertical.'' Compatible with Joomla! 1.0 vertical style.
** ''Legacy Horizontal.'' Compatible with Joomla! 1.0 horizontal style.
** ''Legacy Flat List.'' Compatible with Joomla! 1.0 flat list style.
'''Start and End Levels'''

Start and End Levels can be used to display different parts of one menu at different locations. For example, say you have one Menu with three levels as follows:
:Menu Item 1
:Menu Item 2
::Menu Item 2.1
:::Menu Item 2.1.1
:::Menu Item 2.1.2
::Menu Item 2.2
:Menu Item 3
Using Start Level and End Level, you could show this one Menu as three different small menus on your pages. To do this, you would:
#Create a "Main" menu with a Start Level of 0 and End Level of 1. This Module would display on all Menu Selections.
#Your "Middle" Menu Module would have Start Level of 1 and End Level of 2. It would only display Menu Items 2.1 and 2.2. It could be placed at a different Position than the "Main" menu and might only display on Menu Selection pages for Menu Items 2, 2.1, 2.1.1, 2.1.2, and 2.2.
#The "Third" Menu Module would have Start Level of 2 and End Level of 3, so it would only display Menu Items 2.1.1 and 2.1.2. It could be placed at a different Position from the other Menu Modules. It might only have a Menu Assignment for the Menu Items 2.1, 2.1.1, and 2.1.2.
In this way, you can have one large, multi-level Menu but break it up into separate Modules. Also, doing a Menu in this manner has the advantage of making the Breadcrumbs Module display in a hierarchical manner.
*'''Start Level.''' Optional level to start the display of the Menu. Default is 0 for the Top Level.
*'''End Level.''' Optional level to end the display of the Menu. Default is 0, which will display all levels of the menu.
*'''Always show sub-menu Items.''' Whether or not to show sub-menu items when the parent is not active. If "No", a sub-menu Item will only display when the parent Item is clicked. If "Yes", sub-menu Items will always display in the menu.
*'''Target Position.''' Optional Javascript values, in pixels, to position a Popup window (for example, "top=50,left=50,width=200,height=300"). This is used in some templates to specify the location of drop-down or pop-up menus.

'''Advanced Parameters'''

[[Image:Menu_module_advanced_parameters.png|frame|center]]
*'''Show Whitespace.''' Whether or not to show whitespace in the rendered XHTML. Whitespace includes spaces, tabs, newlines, and other formatting characters that don't affect the XHTML content. Note that this setting does not affect the appearance of the page. It only affects the appearance of the XHTML source code (for example, if you look at the source code from your browser).
{{colheader|Caching}}
{{colheader|Menu Tag ID}}
{{colheader|Menu Class Suffix}}
{{colheader|Module Class Suffix}}
*'''Maximum Menu Depth.'''

'''Other Parameters'''

[[Image:Menu_module_other_parameters.png|frame|center]]
*'''Show Menu Images.''' Whether or not to show Menu Images for the Menu Items.
*'''Menu Image Alignment.''' Whether to align the images to the left or the right.
*'''Menu Image Link.''' Whether or not to have the image be a link to the Menu Item.
*'''Expand Menu.''' Whether or not to expand the menu so that all sub-menu items are always visible.
*'''Activate Parent.''' Whether or not to set the ID's of the parent Menu Items as active when a sub-menu choice is activated.
*'''Full Active Highlighting.''' Whether or not to enable activation of the Link - Article and Link - URL. Note that setting this to "Yes" can cause the loss of XHTML compliance if more than one item is active.
*'''Indent Image.''' What image will be shown for each indented sub-level of menu item. Options are:
**''Template.'' The Template will control the indenting images.
**''Joomla! default images.'' Joomla! default images for indenting will be used.
**''Use Parameters Below.'' Image file for each level 1 - 6 will be as indicated in the values below.
**''None.'' Images will not be indented.
*'''Indent Image 1 - 6.''' Select an image file from the drop-down list box for each of the sub-levels 1 - 6. The images are selected from the "images/M_images" folder.
*'''Spacer.''' Spacer for horizontal menu. Enter any characters here to display between Menu Items.
*'''End Spacer.''' End spacer for horizontal menu. Enter any characters here to display after the last Menu Item on a horizontal menu.

===Most Read Content===
This Module displays a list of Articles with the highest hit counts. An example is shown below:[[Image:most_read_example.png|frame|center]]

The Module Type name for this is "mod_mostread". This Module is not related to any other component.

'''Module Parameters'''
[[Image:most_read_parameters.png|frame|center]]
{{colheader|Module Class Suffix}}
*'''Front Page Articles.''' Whether to Show or Hide Front Page Articles in the list.
*'''Count.''' The number of Articles to display in the list. The default value is 5.
*'''Category ID.''' Optional list of Category ID's. This will include only Articles in the listed Categories. Type a list of Category ID's, separated by a comma (for example, "29,31"). You can find the Category ID in the ID column of the [[screen.contentcategories.15|Category Manager]] screen.
*'''Section ID.''' Optional list of Section ID's. This will include only Articles in the listed Sections. Type a list of Section ID's, separated by a comma (for example, "1,4"). You can find the Section ID in the ID column of the [[screen.sections.15|Section Manager]] screen.

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===NewsFlash===
This Module shows one or more Articles from one Category each time the page is refreshed. One random Article or a list of Articles can be displayed. An example is shown below.[[Image:newsflash_example.png|frame|center]]

The Module Type name for this Module is "mod_newsflash". This Module is not related to any other component.

'''Module Parameters'''
[[Image:newsflash_parameters.png|frame|center]]
*'''Category.''' Select one Category from the drop-down list box.
*'''Layout.'''
**''Randomly choose one at a time.'' Display one Article at random from the selected Category each time the page is refreshed.
**''Horizontal.'' Display the number of Articles listed in "# of Articles" Parameter in horizontal columns.
**''Vertical.'' Display the number of Articles listed in "# of Articles" Parameter in a vertical layout.
*'''Show Images.''' Whether or not to show any images in the Article.
{{colheader|Title Linkable}}
*'''Show last separator.''' Whether or not to show a separator after the last Article.
*'''Read more... link.''' Whether to Hide or Show the Read more... link.
*'''Article Title.''' Whether or not to show the Article Title.
*'''# of Articles.''' The number of Articles to display if a Horizontal or Vertical Layout is selected above. If blank, 5 Articles will display. Articles are displayed based on their order within the Category in the [[Screen.content.15|Article Manager]] screen.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Poll===
This Module shows a Poll that was created using the [[screen.polls.15|Poll Manager]] screen. The user can vote for an option or see the results of the Poll. An example is shown below:
[[Image:poll_module_example.png|frame|center]]
The Module Type name for this Module is "mod_poll". If you press the "Results" button, the current Poll results display, similar to the Internal Link - Polls Layout available in the [[Screen.menus.edit.15#Internal Link - Polls|Menu Item Manager - New/Edit]] screen. An example of pressing the "Results" button is shown below:
[[Image:poll_module_results_example.png|frame|center]]

The Poll Module works with the Polls Component created in the [[screen.polls.15|Poll Manager]] screen.

'''Module Parameters'''
[[Image:poll_module_parameters.png|frame|center]]
*'''Poll.''' Select the Poll to display from the drop-down list box. Only Polls created in the [[screen.polls.15|Poll Manager]] screen will display.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Random Image===
This Module displays a random image from a directory. An example is shown below:[[Image:random_image_example.png|frame|center]]
The Module Type name for this Module is "mod_random_image". It is not related to any other component.

'''Module Parameters'''
[[Image:random_image_parameters.png|frame|center]]
*'''Image Type.''' The type of image to display. Options are "jpg", "png", "gif", and so on. The default is "jpg".
*'''Image Folder.''' The folder on the server that stores the image files. The path is relative to the site URL (for example, "images/stories").
*'''Link.''' Optional web site to link to when image is clicked.
*'''Width (px).''' Optional image width, in pixels. If entered, image will be forced to this width.
*'''Height (px).''' Optional image height, in pixels. If entered, image will be forced to this height.

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Related Articles===
This Module shows a list of Articles that are related to the current Article being viewed by the user (for example, a Article Layout or a Blog or List layout where the user has clicked on an Article link). Articles are considered to be related to each other if they share at least one Keyword in the Article's Metadata Information. Article Keywords are entered in the Metadata Information section of the [[screen.content.edit.15#Metadata Information|Article Manager - New/Edit]] screen.

An example is shown below:[[Image:related_items_example.png|frame|center]]

The Module Type name for this Module is "mod_related_items". It is not related to any other component.

'''Module Parameters'''
[[Image:related_items_parameters.png|frame|center]]
*'''Show Date.''' Whether to Hide or Show the Article's creation date.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Search===
This Module displays a Search entry field where the user can type in a phrase and press Enter to search the web site. An example of a Search results screen is shown below:
[[Image:search_module_example.png|frame|center]]
The Module Type name for this module is "mod_search". It is similar in function to the Internal Link - Search Layout available in the [[screen.menus.edit.15#Internal Link - Search|Menu Item Manager - New/Edit]] screen. This Module is not related to any other components.

'''Module Parameters'''
[[Image:search_module_parameters.png|frame|center]]
{{colheader|Module Class Suffix}}
*'''Box Width.''' The size of the search box, in characters. Default value is 20.
*'''Text.''' Default text to display in the Search box. If blank, the "search box" field from the language file will be used.
*'''Search button.''' Whether or not to display a Search button. If no button is displayed, the user starts the search by pressing Enter.
*'''Button Position.''' Position of the Search button. Options are Right, Left, Top, or Bottom.
*'''Search button as image.''' Whether or not to display the Search button as an image. If yes, the image file must be named "searchButton.gif" and be located in the "images/M_images" folder.
*'''Button Text.''' The text to display in the Search button. If left blank, the "search" string from the language file will be used.

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Sections===
This Module shows a list of all Sections in the web site database. Sections are set up using the [[screen.sections.15|Section Manager]] screen. If the parameter ''Show Unauthorized Links'' is set to "No", only Sections that the User can access will be shown. An example of the Sections Module is shown below:
[[Image:Sections_module_example.png|frame|center]]
The Module Type name for this Module is "mod_sections". It is not related to any other component.

'''Module Parameters'''
[[Image:Sections_module_parameters.png|frame|center]]
*'''Count.''' The number of Sections to display. The default value is 5.
{{colheader|Module Class Suffix}}
*'''Show Unauthorized Links.''' Whether or not to show Sections that the current User can not access. If set to "No", only Sections that the User can access will display. A User can access a Section if the User's Access Level (for example, Public, Registered, and so on) is equal to or higher than the Section's Access Level.

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Statistics===
This Module shows a set of web site statistics. An example is shown below:
[[Image:Stats_module_example.png|frame|center]]
The Module Type name for this Module is "mod_stats". It is not related to any other component.

'''Module Paramters'''
[[Image:Stats_module_parameters.png|frame|center]]
*'''Server Info.''' Whether or not to show server information.
*'''Site Info.''' Whether or not to show site information.
*'''Hit Counter.''' Whether or not to show hit counter information.
*'''Increase Counter.''' Optional number to increase "Content View Hits" by. This number is added to the actual number of hits.
{{colheader|Module Class Suffix}}

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

===Syndicate===
This Module creates a RSS Feed link for the page. This allows a User to create a newsfeed for the current page. An example is shown below.
[[Image:Syndicate_module_example.png|frame|center]]
The Module Type name for this Module is "mod_syndicate". It is not related to any other component.

'''Module Parameters'''
[[Image:Syndicate_module_parameters.png|frame|center]]
*'''Caching.''' Always set to "Never".
*'''Text.''' Text to be displayed next to the RSS Link button.
*'''Format.''' Format of the newsfeed. Options are RSS 2.0 or Atom 1.0.
{{colheader|Module Class Suffix}}

===Who's Online===
This Module displays information about Users currently browsing the web site. An example is shown below:
[[Image:Whosonline_module_example.png|frame|center]]
The Module Type name for this Module is "mod_whosonline". It is not related to any other component.

'''Module Parameters'''
[[Image:Whosonline_module_parameters.png|frame|center]]
*'''Caching.''' Always set to "Never".
*'''Display.'''
**''# of Guests / Members.'' Display the total number of Guests (Users who are not logged in) and Members (Users who are logged in).
**''Member Names.'' Display a list of the names of Members logged in. No count of Guests will display.
**''Both.'' A count of users and a list of Member Names will both display.
{{colheader|Module Class Suffix}}

===Wrapper===
This Module allows you to insert an external web site into an IFrame at the Module position. If the web page is bigger than the Module size, scroll bars can be displayed. An example is shown below.
[[Image:Wrapper_module_example.png|frame|center]]

This Module provides functionality similar to the Internal Link - Wrapper Layout in the [[Screen.menus.edit.15#Internal Link - Wrapper|Menu Item Manager - New/Edit]] screen. The Module Type name for this Module is "mod_wrapper". It is not related to any other component.

'''Module Parameters'''
[[Image:Wrapper_module_parameters.png|frame|center]]
{{colheader|Module Class Suffix}}
*'''URL.''' URL for the web site to be wrapped.
*'''Scroll Bars.''' Whether or not to provide scroll bars for the IFrame. If the setting is "Auto", scroll bars will be provided automatically if needed.
*'''Width.''' Width of the IFrame, in pixels. If you add a "%" to the end of the number, it is read as a percentage instead of pixels.
*'''Height.''' Height of the IFrame, in pixels.
*'''Auto Height.''' Whether or not to set the height automatically to the size of the external page.
*'''Auto Add.''' Whether or not to automatically add "http:" or "https:" to the beginning of the URL. This will be added only if it is missing.
*'''Target Name.''' Optional name of the IFrame when used as a target.

'''Advanced Parameters'''
[[Image:most_read_advanced.png|frame|center]]
{{colheader|Caching}}
{{colheader|Cache Time}}

==Toolbar==
At the top right you will see the toolbar:

[[Image:banner_edit_toolbar.png]]

The functions are:
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Close}}
{{toolbaricon|Help}}

==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: [[screen.modules.15|Module Manager]]
*To work with Administrator Modules: [[screen.modulesadministrator.edit.15|Modules Administrator]]

<noinclude>{{cathelp|1.5|Module Manager|Extensions}}</noinclude>