Joomla! Documentation - User contributions [en]

J1.5:Creating a Plugin for Joomla

2009-10-18T13:26:09Z

Mic: /* Creating the installation file */

====== Creating a Plugin for Joomla! 1.5 ======

===== How to create your own plugin =====

This How-To should provide you with the basics of what you need to know to develop your own plugin. Most plugins consist of just a single code file but to correctly install the plugin code it must be packaged into an installation file which can be processed by the Joomla! installer.

==== Creating the installation file ====

As with all add-ons in Joomla!, plugins are easily installed as a .zip file (.tar.gz is also supported) but a correctly formatted XML file must be included. As an example, here is the XML installation file for the categories searchbot plugin.

<source lang="php"><?xml version="1.0" encoding="iso-8859-1"?>
<install version="1.5" type="plugin" group="search">
<name>Categories searchbot</name>
<author>Joomla! Project</author>
<creationDate>November 2005</creationDate>
<copyright>(C) 2005 Open Source Matters. All rights reserved.</copyright>
<license>GNU/GPL</license>
<authorEmail>admin@joomla.org</authorEmail>
<authorUrl>www.joomla.org</authorUrl>
<version>1.1</version>
<description>Allows searching of Categories information</description>
<files>
<filename plugin="categories.searchbot">categories.searchbot.php</filename>
</files>
<params>
<param name="search_limit" type="text" size="5" default="50" label="Search Limit" description="Number of search items to return"/>
</params>
</install></source>

As you can see, the system is similar to other Joomla! XML installation files. You only have to look out for the group="xxx" entry in the<install>tag and the extended information in the<filename>tag. This information tells Joomla! into which folder to copy the file and to which group the plugin should be added.

If you are creating a plugin that responds to existing core events, the group="xxx" tag would be changed to reflect the name of existing plugin folder for the event type you wish to augment. e.g. group="authentication" or group="user". See Tutorial:Creating Plugins for a complete list of existing core event categories. In creating a new plugin to respond to core events it is important that your plugin's name is unique and does not conflict with any of the other plugins that may also be responding to the core event you wish to service as well.

If you are creating a plugin to respond to non-core system events your choice for the group="xxx" tag should be different than any of the existing core categories.

'''Tip''': if you add the parameter '''''method="upgrade"''''' to the tag '''install''', this plugin can be installed without deinstalling it before.
All existing files will be overridden, but old files will not be deleted!
So handle with care.

==== Creating the Plugin ====

Joomla! 1.5 introduces a new, more object-orientated, way of writing plugins. The old method is still supported for backwards-compatibility (see next section).

<source lang="php"><?php
// no direct access
defined( '_JEXEC' ) or die( 'Restricted access' );

// Import library dependencies
jimport('joomla.event.plugin');

class plg<PluginGroup><PluginName> extends JPlugin
{
/**
* Constructor
*
* For php4 compatability we must not use the __constructor as a constructor for
* plugins because func_get_args ( void ) returns a copy of all passed arguments
* NOT references. This causes problems with cross-referencing necessary for the
* observer design pattern.
*/
function plg<PluginGroup><PluginName>( &$subject )
{
parent::__construct( $subject );

// load plugin parameters
$this->_plugin = > JPluginHelper::getPlugin( '<GroupName>', '<PluginName>' );
$this->_params = new JParameter( $this->_plugin->params );
}

/**
* Plugin method with the same name as the event will be called automatically.
*/
function <EventName>()
{
global $mainframe;

// Plugin code goes here.

return true;
}

}
?></source>

==== Creating the Plugin (Legacy Mode) ====

This section describes the legacy method of creating plugins used prior to Joomla! 1.5. Some core Joomla! plugins may still use this method but will be gradually re-written over time. This method is still supported for backwards-compatibility.

The code that you want executed when the event triggers is written as a PHP function. Prior to the function definition you make a call to the registerEvent() method so that the Joomla! event system associates your function with the appropriate event.

For example, take a look at this skeleton code:

<source lang="php"><?php
// no direct access
defined( '_JEXEC' ) or die( 'Restricted access' );

$mainframe->registerEvent( '<EventName>', '<FunctionName>' );

function <FunctionName>( <ParameterList> ) {

//Plugin code goes here

}
?></source>

With the function $mainframe→registerEvent() your plugin is registered into the Joomla! event system. This means that when the event called '<EventName>' is later triggered, the function called '<FunctionName>' will be called.

Now you can write your plugin function code anyway you want. If you want to use parameters, it's no problem, just use them as usual. You can register as many events and plugin functions together in one file as you want. When you're done, your plugin is ready for use.

==== Using Plugins in Your Code ====

Now that you've created your plugin, you will probably want to call it in your code. You might not; the Joomla! core has a number of built-in events that you might want your plugin code to be registered to. In which case you don't need to do the following.

If you want to trigger an event then you use code like this:

<source lang="php">$results = $mainframe->triggerEvent( '<EventName>', <ParameterArray> );</source>

or in Joomla 1.5 fashion:

<source lang="php">$dispatcher =& JDispatcher::getInstance(); $results = $dispatcher->trigger( '<EventName>', <ParameterArray> );</source>

It is important to note that the parameters have to be in an array. The plugin function itself will get the parameters as single values. The return value will consist of an array of return values from the different plugins (so it can also contain multilevel arrays).

If you are creating a plugin for a new, non-core event, it is also important to remember to activate your plugin after you installed it, and of course to precede any reference to your new plugin with the JPluginHelper::importPlugin() command.

===== Conclusion =====

The plugin structure for Joomla! 1.5 is very flexible and powerful. Not only can plugins be used to handle events triggered by the core application and extensions, but plugins can also be used to make third party extensions extensible and powerful.

J1.5:Creating a CSS Drop down Menu

2009-07-04T08:55:16Z

Mic: /* Suckerfish combined with the default Joomla! menu module */

To emphasize W3C valid code and lean pages, neither flash and JavaScript are generally considered to be favourable. But a lot of (drop down) menu solution make use of one of these two. There are a number of techniques one can use to get this more visually attractive (drop down) menus, almost solely using CSS and limiting the use of javascript to a minimum.

All of them use unordered lists (better known as bulleted lists), to create the menu. An often used solution is the drop down menu called “suckerfish”. Its pure CSS, very lean, hack free and just as 12 lines of JavaScript to bail out some tiny problems with IE6 and lower. You can see a [http://www.htmldog.com/articles/suckerfish/dropdowns/example/ demo] of what can be created with Suckerfish. More detailed guides about the Suckerfish technique, can be found at [http://www.htmldog.com/articles/suckerfish/dropdowns/|htmldog.com] and [http://www.alistapart.com/articles/dropdowns/ alistapart.com].

Suckerfish functions very well in combination with Joomla!.
__toc__
==Suckerfish combined with the extended menu module==
In order to let Suckerfish function well, you need your menu outputted as a good clean list. Well it just so happens that there is a module out there to do this. Its called extended_menu, you can find it [http://de.siteof.de/extended-menu.html here] and in the [http://extensions.joomla.org JED].

So, grab the module and install. Now let’s set it up. It’s easiest if you give it a menu and module class suffix. I used “mainnav” (you’ll see in the CSS below). A couple of other settings you will need:
- Menu style: Tree List
- Expand Menu: Yes

So put the menu where you want it, then to the CSS. This is a little tricky, it took me some trial and error to get the effects I wanted, but you can just skip that part and use mine. :)

For the following, you can either edit the exisitng template_css.css or create a new css file, name it and include in inside the <head>..</head> section.

<source lang="css">
#twocols{ /*the columns that gets dropped down over yours might be different*/
z-index:20;
}

#leftcol{ /*the columns that gets dropped down over yours might be different*/
z-index:10;
}

.moduletablemainnav { /* I have absolutely positioned the module, you might have a different scheme*/
position:absolute;
top:187px;
left:20px;
z-index:100;
font:0.9em Verdana, Arial, Helvetica, sans-serif;
margin:0;
padding:0;
}

#mainlevelmainnav,#mainlevelmainnav ul {
float:left;
list-style:none;
line-height:1em;
background:transparent;
font-weight:700;
margin:0;
padding:0;
}

#mainlevelmainnav a {
display:block;
color:#f90;
text-decoration:none;
margin-right:15px;
padding:0.3em;
}

#mainlevelmainnav li {
float:left;
padding:0;
}

#mainlevelmainnav li ul {
position:absolute;
left:-999em;
height:auto;
width:11em;
font-weight:400;
background:#36f;
border:#00C 1px solid;
margin:0;
}

#mainlevelmainnav li li {
width:11em;
}

#mainlevelmainnav li ul a {
width:11em;
color:#fff;
font-size:0.9em;
line-height:1em;
font-weight:400;
}

#mainlevelmainnav li:hover ul ul,#mainlevelmainnav li:hover ul ul ul,#mainlevelmainnav li.sfhover ul ul,#mainlevelmainnav li.sfhover ul ul ul{
left:-999em;
}

#mainlevelmainnav li:hover ul,#mainlevelmainnav li li:hover ul,#mainlevelmainnav li li li:hover ul,#mainlevelmainnav li.sfhover
l,#mainlevelmainnav li li.sfhover ul,#mainlevelmainnav li li li.sfhover ul {
left:auto;
z-index:6000;
}

#mainlevelmainnav li li:hover,#mainlevelmainnav li li.sfhover {
background:#039 url(../images/soccerball.gif) 98% 50% no-repeat;
}
</source>

Now, just make sure you have the z-indexes set up properly, also remember to have a z-index, the element needs some sort of positioning, if not absolute then relative.

Last but not least you need to add the JavaScript for IE into the head of the template index.php (or a js file), it doesn’t like the :hover.

<source lang="javascript">
<script type="text/javascript"><![CDATA[//><!]]></script>
</source>

Hopefully, follow this and Bob’s your Uncle you should have clean valid drop downs for your menu.

==Suckerfish combined with the default Joomla! menu module==
The second approach is to implement Drop Down menu using the mod_mainmenu module that comes with Joomal 1.5. I've played around with the “suckerfish” and CSS to make this work. This work perfectly in IE 7 as well as Netscape.

1. Create your Menu with the following Hierarchy:

Menu 1.

– Menu 1 Sub Menu 1.

– Menu 1 Sub Menu 2.

– Menu 1 Sub Menu 3.

2. Make sure the parameters are set to.

• Menu Style is set to List.

• Always show sub-menu Items is set to Yes.

• Menu Class Suffix is set to <b>san</b> - you can pick you own, but then make sure you change it in CSS & JS files.

3. Insert this piece of JS in your template index.php <head> tag, or in java script file that’s called from index.php

<source lang="javascript">
/* ********* drop down menu Java script code - start **********/
<script type=”text/javascript”><!–//–><![CDATA[//><!– // don’t need this line if using .JS file
sfHover = function()
{
var sfEls = document.menusan.getElementsByTagName(”LI”);

for (var j=0; j<sfEls.length; j++)
{
sfEls[j].onmouseover=function()
{
this.className+=” sfhover”;
}
sfEls[j].onmouseout=function()
{
this.className=this.className.replace(new RegExp(” sfhover\\b”), “”);
}
}
}
if (window.attachEvent) window.attachEvent(”onload”, sfHover);
//–><!]]></script> // don’t need this line if using .JS file

/* ********* drop down menu Java script code – end **********/
</source>

4. Here the corresponding CSS

Here again, either the exisiting template_css.css (of your template) or create a new css file, name it and include it between the <head>...</head> section of the index.php.
Third option can be that you add <script type=text/css">.... here following css code ....</script> and put this into the head section of your index.php.

'''Never put script code parts (css, java,etc.) directly into the code section of your files. You will loose your XHTML-validy!'''

<source lang="css">
/****************** Dropdown Menu styling starts here **************/
.menusan
{
/* use these params to positions your menu */
position: relative;
left: 10px;
}

.menusan, .menusan li, .menusan li ul { /* all lists */
padding: 0;
margin: 0;
list-style: none;
}

.menusan li a {
display: block;
width: 10em;
color:#FFFFFF ;
background-color:#BC031F;
border:2px solid #BC031F;
text-decoration:none;
}

.menusan li { /* all list items */
float: left;
width: 10em; /* width needed or else Opera goes nuts */
border-bottom:1px solid #ccc;
}

.menusan li ul { /* second-level lists */
position: absolute;
width: 10em;
left: -98%; /* using left instead of display to hide menus because display: none isn’t read by screen readers */
}

.menusan li a:hover {
border:2px solid #8C7AD6;
background-color:#8C7AD6;
color:#fff;
}

.menusan li:hover ul, .menusan li.sfhover ul { /* lists nested under hovered list items */
left: auto; /* change is to 10px, 20px, etc for indenting the sub menue */
}
/* **************** Dropdown Menu styling end here ***************/
</source>

5. Save all and you should be good to go

6. Trick
You can use a single menu to create multiple drop downs menus. Here’s how to do it. Just create the menu in the following hierarchy and you’ll have 2 drop down menus , Menu 1 & Menu 2.

Menu 1.

– Menu 1 Sub Menu 1.

– Menu 1 Sub Menu 2.

– Menu 1 Sub Menu 3.

Menu 2.

– Menu 2 Sub Menu 1.

– Menu 2 Sub Menu 2.

– Menu 2 Sub Menu 3.

You might have to play with CSS a bit to work out the positions of the second menu etc.

[[Category:Tips and tricks]]
[[Category:Tips and tricks 1.0]]
[[Category:Tips and tricks 1.5]]

J1.5:Creating a CSS Drop down Menu

2009-07-04T08:49:31Z

Mic: /* Suckerfish combined with the extended menu module */

To emphasize W3C valid code and lean pages, neither flash and JavaScript are generally considered to be favourable. But a lot of (drop down) menu solution make use of one of these two. There are a number of techniques one can use to get this more visually attractive (drop down) menus, almost solely using CSS and limiting the use of javascript to a minimum.

All of them use unordered lists (better known as bulleted lists), to create the menu. An often used solution is the drop down menu called “suckerfish”. Its pure CSS, very lean, hack free and just as 12 lines of JavaScript to bail out some tiny problems with IE6 and lower. You can see a [http://www.htmldog.com/articles/suckerfish/dropdowns/example/ demo] of what can be created with Suckerfish. More detailed guides about the Suckerfish technique, can be found at [http://www.htmldog.com/articles/suckerfish/dropdowns/|htmldog.com] and [http://www.alistapart.com/articles/dropdowns/ alistapart.com].

Suckerfish functions very well in combination with Joomla!.
__toc__
==Suckerfish combined with the extended menu module==
In order to let Suckerfish function well, you need your menu outputted as a good clean list. Well it just so happens that there is a module out there to do this. Its called extended_menu, you can find it [http://de.siteof.de/extended-menu.html here] and in the [http://extensions.joomla.org JED].

So, grab the module and install. Now let’s set it up. It’s easiest if you give it a menu and module class suffix. I used “mainnav” (you’ll see in the CSS below). A couple of other settings you will need:
- Menu style: Tree List
- Expand Menu: Yes

So put the menu where you want it, then to the CSS. This is a little tricky, it took me some trial and error to get the effects I wanted, but you can just skip that part and use mine. :)

For the following, you can either edit the exisitng template_css.css or create a new css file, name it and include in inside the <head>..</head> section.

<source lang="css">
#twocols{ /*the columns that gets dropped down over yours might be different*/
z-index:20;
}

#leftcol{ /*the columns that gets dropped down over yours might be different*/
z-index:10;
}

.moduletablemainnav { /* I have absolutely positioned the module, you might have a different scheme*/
position:absolute;
top:187px;
left:20px;
z-index:100;
font:0.9em Verdana, Arial, Helvetica, sans-serif;
margin:0;
padding:0;
}

#mainlevelmainnav,#mainlevelmainnav ul {
float:left;
list-style:none;
line-height:1em;
background:transparent;
font-weight:700;
margin:0;
padding:0;
}

#mainlevelmainnav a {
display:block;
color:#f90;
text-decoration:none;
margin-right:15px;
padding:0.3em;
}

#mainlevelmainnav li {
float:left;
padding:0;
}

#mainlevelmainnav li ul {
position:absolute;
left:-999em;
height:auto;
width:11em;
font-weight:400;
background:#36f;
border:#00C 1px solid;
margin:0;
}

#mainlevelmainnav li li {
width:11em;
}

#mainlevelmainnav li ul a {
width:11em;
color:#fff;
font-size:0.9em;
line-height:1em;
font-weight:400;
}

#mainlevelmainnav li:hover ul ul,#mainlevelmainnav li:hover ul ul ul,#mainlevelmainnav li.sfhover ul ul,#mainlevelmainnav li.sfhover ul ul ul{
left:-999em;
}

#mainlevelmainnav li:hover ul,#mainlevelmainnav li li:hover ul,#mainlevelmainnav li li li:hover ul,#mainlevelmainnav li.sfhover
l,#mainlevelmainnav li li.sfhover ul,#mainlevelmainnav li li li.sfhover ul {
left:auto;
z-index:6000;
}

#mainlevelmainnav li li:hover,#mainlevelmainnav li li.sfhover {
background:#039 url(../images/soccerball.gif) 98% 50% no-repeat;
}
</source>

Now, just make sure you have the z-indexes set up properly, also remember to have a z-index, the element needs some sort of positioning, if not absolute then relative.

Last but not least you need to add the JavaScript for IE into the head of the template index.php (or a js file), it doesn’t like the :hover.

<source lang="javascript">
<script type="text/javascript"><![CDATA[//><!]]></script>
</source>

Hopefully, follow this and Bob’s your Uncle you should have clean valid drop downs for your menu.

==Suckerfish combined with the default Joomla! menu module==
The second approach is to implement Drop Down menu using the mod_mainmenu module that comes with Joomal 1.5. I've played around with the “suckerfish” and CSS to make this work. This work perfectly in IE 7 as well as Netscape.

1. Create your Menu with the following Hierarchy:

Menu 1.

– Menu 1 Sub Menu 1.

– Menu 1 Sub Menu 2.

– Menu 1 Sub Menu 3.

2. Make sure the parameters are set to.

• Menu Style is set to List.

• Always show sub-menu Items is set to Yes.

• Menu Class Suffix is set to <b>san</b> - you can pick you own, but then make sure you change it in CSS & JS files.

3. Insert this piece of JS in your template index.php <head> tag, or in java script file that’s called from index.php

<source lang="javascript">
/* ********* drop down menu Java script code - start **********/
<script type=”text/javascript”><!–//–><![CDATA[//><!– // don’t need this line if using .JS file
sfHover = function()
{
var sfEls = document.menusan.getElementsByTagName(”LI”);

for (var j=0; j<sfEls.length; j++)
{
sfEls[j].onmouseover=function()
{
this.className+=” sfhover”;
}
sfEls[j].onmouseout=function()
{
this.className=this.className.replace(new RegExp(” sfhover\\b”), “”);
}
}
}
if (window.attachEvent) window.attachEvent(”onload”, sfHover);
//–><!]]></script> // don’t need this line if using .JS file

/* ********* drop down menu Java script code – end **********/
</source>

4. Here the corresponding CSS

<source lang="css">
/****************** Dropdown Menu styling starts here **************/
.menusan
{
/* use these params to positions your menu */
position: relative;
left: 10px;
}

.menusan, .menusan li, .menusan li ul { /* all lists */
padding: 0;
margin: 0;
list-style: none;
}

.menusan li a {
display: block;
width: 10em;
color:#FFFFFF ;
background-color:#BC031F;
border:2px solid #BC031F;
text-decoration:none;
}

.menusan li { /* all list items */
float: left;
width: 10em; /* width needed or else Opera goes nuts */
border-bottom:1px solid #ccc;
}

.menusan li ul { /* second-level lists */
position: absolute;
width: 10em;
left: -98%; /* using left instead of display to hide menus because display: none isn’t read by screen readers */
}

.menusan li a:hover {
border:2px solid #8C7AD6;
background-color:#8C7AD6;
color:#fff;
}

.menusan li:hover ul, .menusan li.sfhover ul { /* lists nested under hovered list items */
left: auto; /* change is to 10px, 20px, etc for indenting the sub menue */
}
/* **************** Dropdown Menu styling end here ***************/
</source>

5. Save all and you should be good to go

6. Trick
You can use a single menu to create multiple drop downs menus. Here’s how to do it. Just create the menu in the following hierarchy and you’ll have 2 drop down menus , Menu 1 & Menu 2.

Menu 1.

– Menu 1 Sub Menu 1.

– Menu 1 Sub Menu 2.

– Menu 1 Sub Menu 3.

Menu 2.

– Menu 2 Sub Menu 1.

– Menu 2 Sub Menu 2.

– Menu 2 Sub Menu 3.

You might have to play with CSS a bit to work out the positions of the second menu etc.

[[Category:Tips and tricks]]
[[Category:Tips and tricks 1.0]]
[[Category:Tips and tricks 1.5]]

J1.5:Language Guidelines for 3rd Party Extensions

2009-03-06T14:03:28Z

Mic:

The purpose of this document is to give some guidelines for developers for their 3rd party Joomla! 1.5 extension, so that users can easier adapt extensions for use in their local language. '''These guidelines are not rules''' which would limit their freedom in development and distribution. But extensions based on these guidelines will be more flexible and easier to translate, which might have a positive influence on their use and popularity.

== Do NOT use hard coded language text ==
A module (e.g. mod_somemodule) with the following hard coded Dutch language text in the XML installation (and configuration) file,
needs to be fully analyzed and rewritten for any other language.
<source lang="xml">
<param name="dateformat" type="text" default="%A %d %B %Y, %H:%M"
label="Datum / Tijd formaat" description="Gebruik de PHP strftime datum en tijd opmaak." />
<param name="posttext" type="text" default=""
label="Tekst achter datum" description="Eventuele tekst die achter de datum wordt getoond." />
</source>

== Use language labels instead ==
The same mod_somemodule.xml installer file but now with language labels is much easier to translate!
<source lang="xml">
<param name="dateformat" type="text" default="%A %d %B %Y, %H:%M"
label="DATUMTIJDFORMAAT" description="DATUMTIJDFORMAATBESCHR" />
<param name="posttext" type="text" default=""
label="TEKSTACHTER" description="TEKSTACHTERBESCHR" />
</source>

Only the '''nl-NL.mod_somemodule.ini''' language file needs to be translated to get the module working in any other language:
<source lang="ini">
DATUMTIJDFORMAAT = Datum / Tijd formaat
DATUMTIJDFORMAATBESCHR = Gebruik de PHP strftime datum en tijd opmaak.
TEKSTACHTER = Tekst achter datum
TEKSTACHTERBESCHR = Eventuele tekst die achter de datum wordt getoond.
</source>

== Use English language labels ==
The previous example with language labels and an external language file is easier to translate. However Non-Dutch users will have much difficulties in translating the language file. Please use English language labels instead!
<source lang="xml">
<param name="dateformat" type="text" default="%A %d %B %Y, %H:%M"
label="DATETIMEFORMAT" description="DATETIMEFORMATDESCR" />
<param name="posttext" type="text" default=""
label="TEXTAFTER" description="POSTTEXTDESCR" />
</source>

And the same English labels with Dutch translation in nl-NL.mod_somemodule.ini
<source lang="ini">
DATETIMEFORMAT = Datum / Tijd formaat
DATETIMEFORMATDESCR = Gebruik de PHP strftime datum en tijd opmaak.
TEXTAFTER = Tekst achter datum
POSTTEXTDESCR = Eventuele tekst die achter de datum wordt getoond.
</source>

== Include an English language file ==
Again, the above example is easier to translate because of the English labels. But again, not everyone can read and translate the Dutch translation. Most people can read English, so include at least an English language file. Translating English to some other language is easier for most people.

en-GB.mod_somemodule.ini
<source lang="ini">
DATETIMEFORMAT = Date/Time format
DATETIMEFORMATDESCR = Use the PHP strftime formatting.
TEXTAFTER = Text after date
POSTTEXTDESCR = Any text that should be placed after the date.
</source>

Another reason to provide an English language file is to help translators using the Translation Manager Component to create the file in other languages.
The Translation Manager Component proposes the basic en-GB set as a reference when creating/editing these files.

== PHP strftime ==
Countries have different date and time formats. Please use the '''PHP strftime function''' for dates and times in your extension. That way the local date/time format will be used automatically, because it's based on the local format.

== Use UTF8 ==
All .ini language files need to be saved as UTF-8 no BOM for the proper display of characters which are not in the ASCII range [a..z] and [A..Z].

es-ES.mod_somemodule.ini
<source lang="ini">
DATETIMEFORMAT = Formato de fecha/tiempo
DATETIMEFORMATDESCR = Usan el PHP strftime formateo.
TEXTAFTER = Texto despuÃ©s de Fecha
POSTTEXTDESCR = Cualquier texto que deberÃa ser colocado despuÃ©s de la fecha.
</source>
despuÃ©s is UTF-8 and will be displayed as después.

== Group logical entities in translation file ==
Large translation files are difficult to read. Try to group logical entities together, and use # comment lines (start with "#") to describe the logical entity. A good example is the Joomla core translation file '''/language/en-GB/en-GB.ini'''. Date format, Months, Days of the Week, Time Zones, Mailer Codes are all grouped together and those logical entities start with a comment line.

Another possibility is the usage of '''brackets''' like [here is the group for advanced parameters].

== Translation File Version Control ==
Keep in mind that your extensions might be used in a broad range of different languages. A new release of a new version of your extension might have changes in your default language file. If your extension has a large language files, then individual users might have difficulties to find the changes. Please make their lives easier and find a way to make translation easier. Some 3rd party extension developers put changed language labels on top, or bottom, of the language files which makes the changes easier to spot. Some added # comments (e.g. with version information) are also very welcome.

'''[Please suggest more workable solutions here]'''

== Collect and distribute translations ==
Ask your users to send you any missing language translation files, and make those available for download at the same place as your extension. Creating new translations, while others have already done that, is a waste of time.

== Conclusion ==
Make your extensions easy to translate with these guidelines. The result of easy translation able extensions is that more users can benefit from your hard work.

== Other documentation ==
More information regarding the use of language files can be found at the following places:
* [[Adding multi-language support]]
* [[How to create a language pack]]
* [[Creating a language definition file]]
* [[Location of template language definition files]]
* [[Formatted fields in language translation strings]]
<noinclude>[[Category:Languages]]</noinclude>

Help15:Screen.languages.15

2009-01-29T15:29:27Z

Mic: /* Column Headers */

==How to Access==
Select '''Extensions → Language Manager''' from the drop-down menu on the back-end of your Joomla! installation '''or''' click the icon '''Language''' in the control center.

==Description==
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.

==Screenshot==
[[Image:Extensions.Languages.png]]

==Column Headers==
Both the ''Site'' and ''Administrator'' tabs have the following column titles. These details are fetched from the XML file included in the language pack.
{{colheader|Number}}
*'''Checkbox.''' Check this radio button to select the Language.
*'''Language Name.''' The names of the installed Languages on this web site.
*'''Default.''' The default language of the site, marked with a yellow graphical asterisk in this column. ''Note'': to every user a language can be assigned (see "User Management"), user from groups "Administrator" and "Super Administrator" can select their preferred language themself at login.
*'''Version.''' The version number of the installed language.
*'''Date.''' The creation date of the language.
*'''Author.''' The name of the language translator is displayed in this column.
*'''Author E-mail.''' The e-mail address of the translator.
{{colheader|Display}}

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

[[Image:Language_manager_toolbar.png]]
*'''Default.''' Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
{{toolbaricon|Help}}

==Site and Administrator Links==
At the top left, above the columns, you will see two links as shown below:

[[Image:Template_manager_links.png]]
*'''Site.''' Shows the Languages available for the Front-end of the web site.
*'''Administrator.''' Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.

==Quick Tips==
*Users can use any Language from the list of installed Languages, either by having it assigned in the [[screen.users.15|User Manager]] or by filling out a [[Screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]] at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
[[Image:Spanish_language_example.png|frame|center]]
:*This User's choice is not affected by the Default Language set for the Front-end.
:*Changing a User's Language or the Default Language does not affect the web site's Articles and other content.

*'''Important''': Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.

*Additional Languages can be added using the [[screen.installer.15#Install Screen|Extension Manager - Install Screen]].

*If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.

==Related Information==
*To install more Languages: [[screen.installer.15#Install Screen|Extension Manager - Install Screen]]
*To uninstall a Language: [[screen.installer.15#Languages Screen|Extension Manager - Languages screen]]
*To change the Language for a User: [[screen.users.15|User Manager]]
*To create a form that allows a User to set their own Language: [[screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]]
*To set the Language of an Article: [[screen.content.edit.15#Parameters - Advanced|Article Manager - New/Edit - Parameters - Advanced
]]
<noinclude>{{cathelp|1.5|Language Manager|Extensions}}</noinclude>

Help15:Screen.languages.15

2009-01-29T15:22:41Z

Mic: /* Screenshot */

==How to Access==
Select '''Extensions → Language Manager''' from the drop-down menu on the back-end of your Joomla! installation '''or''' click the icon '''Language''' in the control center.

==Description==
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.

==Screenshot==
[[Image:Extensions.Languages.png]]

==Column Headers==
Both the ''Site'' and ''Administrator'' tabs have the following column titles. These details are fetched from the XML file included in the language pack.
{{colheader|Number}}
*'''Checkbox.''' Check this radio button to select the Language.
*'''Language Name.''' The names of the installed Languages on this web site.
*'''Default.''' The default language of the site, marked with a yellow graphical asterisk in this column.
*'''Version.''' The version number of the installed language.
*'''Date.''' The creation date of the language.
*'''Author.''' The name of the language translator is displayed in this column.
*'''Author E-mail.''' The e-mail address of the translator.
{{colheader|Display}}

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

[[Image:Language_manager_toolbar.png]]
*'''Default.''' Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
{{toolbaricon|Help}}

==Site and Administrator Links==
At the top left, above the columns, you will see two links as shown below:

[[Image:Template_manager_links.png]]
*'''Site.''' Shows the Languages available for the Front-end of the web site.
*'''Administrator.''' Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.

==Quick Tips==
*Users can use any Language from the list of installed Languages, either by having it assigned in the [[screen.users.15|User Manager]] or by filling out a [[Screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]] at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
[[Image:Spanish_language_example.png|frame|center]]
:*This User's choice is not affected by the Default Language set for the Front-end.
:*Changing a User's Language or the Default Language does not affect the web site's Articles and other content.

*'''Important''': Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.

*Additional Languages can be added using the [[screen.installer.15#Install Screen|Extension Manager - Install Screen]].

*If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.

==Related Information==
*To install more Languages: [[screen.installer.15#Install Screen|Extension Manager - Install Screen]]
*To uninstall a Language: [[screen.installer.15#Languages Screen|Extension Manager - Languages screen]]
*To change the Language for a User: [[screen.users.15|User Manager]]
*To create a form that allows a User to set their own Language: [[screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]]
*To set the Language of an Article: [[screen.content.edit.15#Parameters - Advanced|Article Manager - New/Edit - Parameters - Advanced
]]
<noinclude>{{cathelp|1.5|Language Manager|Extensions}}</noinclude>

File:Extensions.Languages.png

2009-01-29T15:21:59Z

Mic: Extensions Language

== Summary ==
Extensions Language
== Licensing: ==
{{JEDL}}

Help15:Screen.tools.expired.cache.15

2009-01-29T07:44:38Z

Mic: /* Description */

Article stub for purge expired cache.

==How to Access==
Select '''Tools → Purge Expired Cache''' from the drop-down menu on the Back-end of your Joomla! installation.

==Description==
This tool will purge all expired cache files and therefore clean up the the webspace.
*''Note'': if you have a large amount of items we recommend to purge the files as many times as possible to avoid overloading your webspace!
*'''Warning''': if you have a great amount of cached files and your server settings of 'max_input_time' is set to less then 60 (seconds), you mave recieve a php warning message. In this case start this process again!

==Screenshot==
[[Image:Cache.Manager_PurgeExpiredCache.png]]

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

[[Image:TB.PurgeExpired.Help.png]]
*'''Purge Expired'''.Click on this Button will start the purging process.
{{toolbaricon|Help}}

==Quick Tips==
*Purging cached files is recommended if there is a great amount of items.
*If you recieve an error / a warning during the process, start this tool again.

==Related Information==
*To change the cache settings for your site: [[screen.config.15#Cache Settings|Global Configuration - Cache Settings]]
<noinclude>{{cathelp|1.5|Cache|Tools}}</noinclude>

Help15:Screen.tools.expired.cache.15

2009-01-29T07:44:00Z

Mic: /* Quick Tips */

Article stub for purge expired cache.

==How to Access==
Select '''Tools → Purge Expired Cache''' from the drop-down menu on the Back-end of your Joomla! installation.

==Description==
This tool will purge all expired cache files and therefore clean up the the webspace.
*''Note'': if you have a large amount of items we recommend to purge the files as many times as possible to avoid overloading your webspace!
*'''Warning''': if you have a great amount of cache files and your server settings of 'max_input_time' is set to less then 60 (seconds), you mave recieve a php warning message. In this case start this process again!

==Screenshot==
[[Image:Cache.Manager_PurgeExpiredCache.png]]

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

[[Image:TB.PurgeExpired.Help.png]]
*'''Purge Expired'''.Click on this Button will start the purging process.
{{toolbaricon|Help}}

==Quick Tips==
*Purging cached files is recommended if there is a great amount of items.
*If you recieve an error / a warning during the process, start this tool again.

==Related Information==
*To change the cache settings for your site: [[screen.config.15#Cache Settings|Global Configuration - Cache Settings]]
<noinclude>{{cathelp|1.5|Cache|Tools}}</noinclude>

File:TB.PurgeExpired.Help.png

2009-01-29T07:42:26Z

Mic: Toolbar

== Summary ==
Toolbar
== Licensing: ==
{{JEDL}}

File:Cache.Manager PurgeExpiredCache.png

2009-01-29T07:41:21Z

Mic: Cache Manager Purge Expired Cache

== Summary ==
Cache Manager Purge Expired Cache
== Licensing: ==
{{JEDL}}

Help15:Screen.tools.expired.cache.15

2009-01-29T07:39:31Z

Mic:

Article stub for purge expired cache.

==How to Access==
Select '''Tools → Purge Expired Cache''' from the drop-down menu on the Back-end of your Joomla! installation.

==Description==
This tool will purge all expired cache files and therefore clean up the the webspace.
*''Note'': if you have a large amount of items we recommend to purge the files as many times as possible to avoid overloading your webspace!
*'''Warning''': if you have a great amount of cache files and your server settings of 'max_input_time' is set to less then 60 (seconds), you mave recieve a php warning message. In this case start this process again!

==Screenshot==
[[Image:Cache.Manager_PurgeExpiredCache.png]]

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

[[Image:TB.PurgeExpired.Help.png]]
*'''Purge Expired'''.Click on this Button will start the purging process.
{{toolbaricon|Help}}

==Quick Tips==
*Purging cached files is recommended if there is a great amount it items.

==Related Information==
*To change the cache settings for your site: [[screen.config.15#Cache Settings|Global Configuration - Cache Settings]]
<noinclude>{{cathelp|1.5|Cache|Tools}}</noinclude>

Help15:Screen.weblinks.categories.edit.15

2009-01-27T17:28:54Z

Mic: /* Details */

==How to Access==
Navigate to the [[screen.weblinkcategories.15|Web Link Category Manager]]. To add a new Web Link Category, and click the "New" icon in the toolbar. To edit an existing Web Link Category, click the Category's Name, or check the Category's checkbox and press the "Edit" icon in the toolbar.

==Description==
This is where you can add a new Web Link Category or edit an existing one. Note that you need to create at least one Web Link Category before you can create a Web Link. Also, Web Link Categories are separate from other types of Categories, such as those for Articles, Banners, and News Feeds.

Note that the screen for adding and editing Web Link Categories looks the same screen used to create Article Categories. However, for Web Link Categories, the only required field is ''Title''. Published, Section, Category Order, and Access Level are not used. An Image and Description may be entered, but they are not displayed on the web site.

==Screenshot==
[[Image:web_link_category_edit.png]]

==Details==
{{colheader|Details Title}}
{{colheader|Alias}}
*'''Published.''' This field is not used for Web Link Categories.
*'''Section.''' This displays 'N/A' for not applicable, since Sections are not used for Web Links.
*'''Category Order.''' This field is only used for ordering at the weblinks management.
*'''Access Level.''' This field is not used for Web Link Categories.
{{colheader|Image}}
{{colheader|Image Position}}
*'''Description.''' Optional description for the Web Link Category. This description is just for your information and will not display on the page.
*'''Image Button.''' This command is not normally used for Web Link Categories.

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

[[Image:section_edit_toolbar.png]]
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Close}}
{{toolbaricon|Help}}

==Related Information==

*To work with Web Links: [[screen.weblink.15|Web Link Manager]]
*To work with Web Links Categories: [[screen.weblinkcategories.15|Web Link Category Manager]]

<noinclude>{{cathelp|1.5|Web Link Manager|Components}}</noinclude>

Help15:Screen.newsfeeds.categories.edit.15

2009-01-27T13:01:54Z

Mic: /* Column Headers */

==How to Access==
Select '''Components → News Feeds → Categories'''. Once at the [[Screen.newsfeedscategories.15|News Feeds Category Manager]], from the toolbar, select '''New'''.
==Description==
The New/Edit page for the News Feeds Category Manager is a create/edit screen that allows website administrators to create or edit News Feed Categories. Categories allow a broken down structure of News Feeds. ''You must have at least one category before you can create any News Feeds!''

==Screenshot==
[[Image:News_feed_category_edit.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Alias}}
{{colheader|Published}}
* '''Section'''. Not used here.
* '''Category Order'''. Where this category shall be placed.
{{colheader|Access Level}}
{{colheader|Image}}
{{colheader|Image Position}}

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

[[Image:banner_edit_toolbar.png]]
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Cancel}}
{{toolbaricon|Help}}

==Quick Tips==
*You must create at least one News Feed Category before you can create any News Feeds.

==Related Information==
*To work with News Feeds: [[screen.newsfeeds.15|News Feeds Manager]]

<noinclude>{{cathelp|1.5|News Feed Manager|Components}}</noinclude>

Help15:Screen.newsfeeds.categories.edit.15

2009-01-27T13:00:16Z

Mic: /* Column Headers */

==How to Access==
Select '''Components → News Feeds → Categories'''. Once at the [[Screen.newsfeedscategories.15|News Feeds Category Manager]], from the toolbar, select '''New'''.
==Description==
The New/Edit page for the News Feeds Category Manager is a create/edit screen that allows website administrators to create or edit News Feed Categories. Categories allow a broken down structure of News Feeds. ''You must have at least one category before you can create any News Feeds!''

==Screenshot==
[[Image:News_feed_category_edit.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Alias}}
{{colheader|Published}}
* '''Section'''. Not used here.
{{colheader|Access Level}}
{{colheader|Image}}
{{colheader|Image Position}}

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

[[Image:banner_edit_toolbar.png]]
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Cancel}}
{{toolbaricon|Help}}

==Quick Tips==
*You must create at least one News Feed Category before you can create any News Feeds.

==Related Information==
*To work with News Feeds: [[screen.newsfeeds.15|News Feeds Manager]]

<noinclude>{{cathelp|1.5|News Feed Manager|Components}}</noinclude>

Help15:Screen.contact details.categories.edit.15

2009-01-27T07:52:04Z

Mic: /* Details */

==How to Access==
Navigate to the [[screen.contact_details.categories.15|Contact Category Manager]]. To add a new Contact Category, and click on the "New" icon in the toolbar. To edit an existing Contact Category, click on the Category's Name, or check the Category's checkbox and press the "Edit" icon in the toolbar.

==Description==
This is where you can add a new Contact Category or edit an existing one. Note that you need to create at least one Contact Category before you can create a Contact. Also, Contact Categories are separate from other types of Categories, such as those for Articles, Banners, News Feeds, and so on.

Note that the screen for adding and editing Contact Categories is the same screen used to create Article Categories. However, for Contact Categories, the only required field is ''Title''. Published, Section, Category Order, and Access Level are not used. An Image and Description may be entered, but they are not displayed on the web site.

==Screenshot==
[[Image:contact_category_edit.png]]

==Details==
{{colheader|Details Title}}
{{colheader|Alias}}
*'''Published.''' Will be used at selectable lists (drop downs).
*'''Section.''' This displays 'N/A' for not applicable, since Sections are not used for Contacts.
*'''Category Order.''' Is used at select lists (drop downs) and at the manager site.
*'''Access Level.''' This field is yet not used for Contact Categories.
{{colheader|Image}} You will not normally use an Image for a Contact Category, since it will not display on the page.
{{colheader|Image Position}}
*'''Description.''' Optional description for the Contact Category. This description is just for your information and will not display on the page.
*'''Image Button.''' This command is not normally used for Contact Categories.

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

[[Image:section_edit_toolbar.png]]
{{toolbaricon|Save}}
{{toolbaricon|Apply}}
{{toolbaricon|Close}}
{{toolbaricon|Help}}

==Related Information==

*To work with Contacts: [[screen.contactmanager.15|Contact Manager]]

<noinclude>{{cathelp|1.5|Contact Manager|Components}}</noinclude>

Help15:Screen.contactmanager.15

2009-01-26T15:00:17Z

Mic: /* Toolbar */

==How to access==
Select '''Components → Contacts → Contacts''' from the drop-down menu on the back-end of your Joomla! installation, or select the "Contacts" link from the [[screen.contact_details.categories.15|Contacts Manager - Categories]].

==Description==
The Contact Manager screen allows you to add contact information to your Joomla! site. You can enter information such as name, address, phone and e-mail. You can also link contacts to registered users. Afterwards, you can use the [[Screen.menumanager.15|Menu Manager]] to create front-end links to the the contacts.

==Screenshot==
[[Image:contact_manager.png]]

==Column Headers==
Click on the column heading to sort the list by that column's value.
{{colheader|Number}}
{{colheader|Checkbox}}
* '''Name'''. The name of the Contact. You can click on the Name to open the Contact for editing.
{{colheader|Published}}
{{colheader|Order}}
{{colheader|Access Level}}
* '''Category.''' The Category that this Contact belongs to. Clicking on the Category Title opens the Category for editing. See [[screen.contact_details.categories.edit.15|Contact Category Manager - New/Edit]]. Note that Contact Categories are separate from other Categories, such as those for Articles, Banners, Newsfeeds, and Web Links.
* '''Linked to User'''. The username this contact is linked to (if applicable).
{{colheader|Id}}
{{colheader|Display #}}

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

[[Image:Contacts_toolbar.png]]

The functions are:
{{toolbaricon|Publish}}
{{toolbaricon|Unpublish}}
{{toolbaricon|Delete}}
{{toolbaricon|Edit}}
{{toolbaricon|New}}
*'''Parameters.''' See [[#Global Configuration|Global Configuration]] section below.
{{toolbaricon|Help}}

==Global Configuration==
Click the Parameters button to open the Contacts Global Configuration window. This window allows you to set default parameters for Contacts, as shown below.

[[Image:contacts_parameters.png|frame|center]]
{{colheader|Save}}
{{colheader|Cancel}}
*'''Icons/Text.''' Whether an Icon, Text or nothing is displayed next to the Contact fields.
{{colheader|Address Icon}}
{{colheader|E-mail Icon}}
{{colheader|Telephone Icon}}
{{colheader|Mobile Icon}}
{{colheader|Fax Icon}}
{{colheader|Miscellaneous Icon}}
{{colheader|Show Table Headings}}
{{colheader|Show Contact's Position}}
{{colheader|Show E-mail Address}}
{{colheader|Show Telephone Number}}
{{colheader|Show Mobile Number}}
{{colheader|Show Fax Number}}
{{colheader|Enable vCard}}
{{colheader|Banned E-mail}}
{{colheader|Banned Subject}}
{{colheader|Banned Text}}
{{colheader|Session Check}}
{{colheader|Custom Reply}}

==List Filters==
'''Filter by Partial Title'''

You can filter the list of items by typing in part of the Title or the ID number. You can also select a combination of Category and Published State.
{{colheader|List Filter}}

'''Filter by Category and Published State'''
In the upper right area, above the column headings, are 2 drop-down list boxes as shown below:[[Image:banner_filter.png|center]] The selections may be combined. Only items matching both selections will display in the list.
{{colheader|Select Category}}
{{colheader|Select State}}

==Quick Tips==
*You need to add at least one Category for your Contacts ''before'' you can add your first Contact. Categories are added using the [[Screen.contact_details.categories.15|Contacts Category Manager]].

==Related Information==
*To add or edit Contacts: [[screen.contactmanager.edit.15|Contact Manager - New/Edit]]
*To work with Contact Categories: [[screen.contact_details.categories.15|Category Manager (Contacts)]]
*To work with Users: [[screen.users.15|User Manager]]

<noinclude>{{cathelp|1.5|Contact Manager|Components}}</noinclude>

Chunk:Help screen column header Other Categories

2009-01-25T09:07:21Z

Mic:

*'''Other Categories.''' Show also other categories. ''Note: there must be at least one item assigned in the other category/categories to show it!''

Help15:Screen.menus.edit.15

2009-01-24T10:53:16Z

Mic: /* Default Login Layout */

==How To Access==
To access the New Menu Creation wizard, navigate to the [[Screen.menus.15|Menu Item Manager]] for the desired menu and press the New button on the toolbar.

==Description==
In this screen, you will select the Menu Item Type for this Menu Item. The Menu Item Type determines the type of page that will display when this menu choice is selected by the User.

==Screenshot==
[[Image:Menu_Item_New.png]]

Note: If you install one or more Joomla! extensions, these extensions may add new Menu Item Types. In this case, your list will have additional types.

==Menu Item Types==
Menu Item Types are organized into four groups: Internal Link, External Link, Separator, and Alias. Internal Links are the most commonly used and will display pages on your web site. External Links are used to display links to external web sites. Separators are used to place a graphic or other separator between menu options. Alias Item Types are used to point back to an already existing Menu Item.

==Internal Link - Articles==
When the Articles link is selected, it expands to show the options shown below.
[[Image:menu_item_type_articles.png|frame|center]]
Each of these is described below.

===Archived Article List===
Used to show a list of Articles that have been Archived and can be searched by date. Archived articles are no longer published but are still stored on the site. Articles are Archived using the [[screen.content.15|Article Manager]] screen. Note that Articles assigned to the "Uncategoried" Section will not show on the Archived Article List layout.

'''Parameters - Basic'''
This Menu Item Type Archived Article List allows you to set the sort order of Archived Articles, as shown in the screenshot below.
[[Image:menu_item_archive_parameters.png|frame|center]]
The Default order is most recent first. The Order option sorts Articles by the Order column in the [[screen.content.15|Article Manager]].

===Article Layout===
Used to show a single article on the page. Note: This layout replaces the ''Static Content'' and ''Link Content'' used in Joomla! version 1.0.

'''Parameters - Basic'''
The Article Layout has one Parameter, the Article to include in the layout, as shown below.
[[Image:menu_item_article_parameters.png|frame|center]]Press the Select button to select the desired Article for this layout.

===Article Submission Layout===
Allows users to submit an article. This only works for users who are members of the Authors, Publishers, or Editors groups. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

This type has no Basic or Advanced Parameters.

===Category Blog Layout===
Used to show articles belonging to a specific Category, in a blog layout.
{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Category Blog Layout has the following Basic Parameters, as shown below.
[[Image:category_blog_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Used to show articles belonging to one Category, in a list layout. A list layout lists each Article's Title and allows the User to link to the Article. An example is shown below:[[Image:category_list_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below.
[[Image:category_list_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Number of Links}}
{{colheader|Table Headings}}
{{colheader|Date Column}}
{{colheader|Date Format}}
{{colheader|Filter}}
{{colheader|Filter Field}}

'''Parameters - Advanced'''
The Category List Layout has the following Advanced Parameters, as shown below.
[[Image:Category_list_advanced_parameters.png|frame|center]]
{{colheader|Primary Order}}
*'''Pagination.''' Hide or Show Pagination support. Pagination provides page links at the bottom of the page that allow the User to navigate to additional pages. These are needed if the Articles will not fit on one page. An example is shown below.[[Image:blog_layout_pagination.png|frame|center]]The following options are available.
**''Hide:'' Pagination links not shown. Note: In this case, Users will not be able to navigate to additional pages.
**''Show:'' Pagination links shown if needed.
*'''Display Select:''' Show or Hide the Display # drop-down list box. This allows you to limit the number of Articles listed on one page.
{{colheader|Show a Feed Link}}

===Front Page Blog Layout===
Used to show all Articles that have been published to the Front Page, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Front Page Blog Layout has the following Basic Parameters, as shown below.
[[Image:front_page_basic_parameters.png|frame|center]]
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Blog Layout===
Used to show Articles belonging to one Section, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Section Blog Layout has the following Basic Parameters, as shown below.
[[Image:section_blog_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Section Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Layout===
Used to show Articles by Category in one Section, in a list layout. This layout shows a list Categories in the Section. An example is shown below: [[Image:section_layout_example.png|frame|center]]

Each Category links to a page that is similar to a Category List Layout, providing links to each Article in that Category. Note that you cannot directly set parameters to control the display of these Category List Layouts from within this screen. However, it is possible to do this using separate Menu Items for each Category. See the article [[How_to_control_Category_List_layouts_when_drilling_from_a_Section_Layout|How to control Category List layouts when drilling from a Section Layout]] for more information.

'''Parameters - Basic'''
The Section Layout has the following Basic Parameters, as shown below.
[[Image:section_layout_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Section Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|Category List - Section}}
{{colheader|Empty Categories in Section}}
{{colheader|No. Category Items}}
{{colheader|Category Description}}

'''Parameters - Advanced'''
The Section Layout has the following Advanced Parameters, as shown below.
[[Image:section_layout_advanced_parameters.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Show a Feed Link}}

===Parameters - Component for Articles===
All Articles Layouts have the same options under Parameters - Component. For each of these components, you may select one of three options: No/Hide, Yes/Show, or Use Global. An example of this section is shown below.[[Image:Article_parameters_component.png|frame|center]]

These values work with the values set in the [[Screen.content.15|Article Manager/Parameters]] and the values set in the [[Screen.content.edit.15|Article Manager New/Edit]] to determine the action on the page. The parameters in all three places work together in a hierarchy, as follows.
# The value from the Parameters - Advanced section of the [[Screen.content.edit.15|Article Manager New/Edit]] is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If the value above is set to "Use Global" then the value from the Parameters - Component section of the [[screen.menus.type.15|Menu Item Type]] (this screen) is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If ''both'' of the values above are set to "Use Global" then the value from [[Screen.content.15|Article Manager/Parameters]] is used to determine the result.

The individual Parameters are described below.
{{colheader|Show Unauthorized Links}}
{{colheader|Show Article Title}}
{{colheader|Title Linkable}}
{{colheader|Show Intro Text}}
{{colheader|Section Name}}
{{colheader|Section Title Linkable}}
{{colheader|Category Title}}
{{colheader|Category Title Linkable}}
{{colheader|Author Name}}
{{colheader|Created Date and Time}}
{{colheader|Modified Date and Time}}
{{colheader|Show Navigation}}
{{colheader|Read more... Link}}
{{colheader|Article Rating/Voting}}
{{colheader|Icons}}
{{colheader|PDF Icon}}
{{colheader|Print Icon}}
{{colheader|E-mail Icon}}
{{colheader|Hits Parameter}}
{{colheader|For each feed item show}}

==Internal Link - Contacts==
When the Contacts link is selected, it expands to display the options shown below.
[[Image:menu_item_type_contacts.png|frame|center]]
Each of these is described below.

===Contact Category Layout===
Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.

'''Parameters - Basic'''
The Contact Category Layout has the following Basic Parameters, as shown below. [[Image:Menu_Item.Contact.Category_Layout_Params.Basic.png|frame|center]]
{{colheader|Category Parameter}}
*'''# Links'''. Number of contacts to show.
{{colheader|Contact Image}}
{{colheader|Image Align}}
{{colheader|Limit Box}}
{{colheader|Show a Feed Link}}

===Standard Contact Layout===
Used to show the details of a single Contact.

'''Parameters - Basic'''
The Standard Contact Layout has the following Basic Parameters, as shown below. [[Image:contact_standard_basic_parameters.png|frame|center]]
{{colheader|Contact}}
{{colheader|Drop Down}}
{{colheader|Show Category in Breadcrumbs}}

===Parameters - Component for Contacts===
All Contacts Layouts have the same options under Parameters - Component. An example of this section is
shown below.

[[Image:contact_parameters_component1.png|center]]

These settings work with the settings in the [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] and the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]]. The setting in the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]] takes priority. If the setting there is 'Use Global', then the setting here takes effect. If both of these settings are 'Use Global', then the setting in [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] takes effect.
{{colheader|Icons/Text}}
{{colheader|Address Icon}}
{{colheader|Contact E-mail Icon}}
{{colheader|Telephone Icon}}
{{colheader|Mobile Icon}}
{{colheader|Fax Icon}}
{{colheader|Miscellaneous Icon}}
{{colheader|Show Table Headings}}
{{colheader|Show Contact's Position}}
{{colheader|Show E-mail Address}}
{{colheader|Show Telephone Number}}
{{colheader|Show Mobile Number}}
{{colheader|Show Fax Number}}
{{colheader|Enable vCard}}
{{colheader|Banned E-mail}}
{{colheader|Banned Subject}}
{{colheader|Banned Text}}
{{colheader|Session Check}}
{{colheader|Custom Reply}}

==Internal Link - News Feeds==
When the News Feeds link is selected, it expands to display the options shown below.
[[Image:menu_item_type_news_feeds.png|frame|center]]
Each of these is described below. Note that News Feed Categories are separate from Article Categories. News Feeds and News Feed Categories are entered by selecting Components → News Feeds. See [[screen.newsfeeds.15|News Feeds Manager]] and [[screen.categories.15|Category Manager]] for more information.

===Category List Layout===
Used to show a list of all News Feed Categories.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:news_category_list_parameters.png|frame|center]]
{{colheader|Limit Box}}
{{colheader|News Feed Description Hide Show}}
{{colheader|Description Text}}
{{colheader|Image}}
{{colheader|Image Align}}

===Category Layout===
Used to show a list of News Feeds in a Category.

'''Parameters - Basic'''
The Category Layout has the following Basic Parameters, as shown below. [[Image:news_category_layout_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Limit Box}}

===Single Feed Layout===
Used to show a single News Feed.

'''Parameters - Basic'''
The Single Feed Layout has the following Basic Parameter, as shown below. [[Image:news_single_parameters.png|frame|center]]
{{colheader|Feed}}

===Parameters - Component for News Feeds===
All News Feed Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:News_feed_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]]. If a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]] is used.
{{colheader|Table Headings}}
{{colheader|Name Column}}
{{colheader|No. Articles Column}}
{{colheader|Link Column}}
{{colheader|Category Description}}
{{colheader|No. Category Items}}
{{colheader|Feed Image}}
{{colheader|Feed Description}}
{{colheader|Item Description}}
{{colheader|Word Count}}

==Internal Link - Polls==
When the Polls link is selected, it expands to display the Poll Layout. This is used to show the results of a Poll, as shown below.[[Image:poll_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Poll Layout has the following Basic Parameter, as shown below.[[Image:poll_parameters.png|frame|center]]
*'''Poll.''' Select the desired Poll from the drop-down list box. Polls are entered using the [[screen.polls.15|Poll Manager]].

==Internal Link - Search==
When the Search link is selected, it expands to display the Search layout. This is used to show the Search form and the Search results as shown below. [[Image:search_layout_example.png|frame|center]]

'''Parameters - Basic'''

The Search Layout has the following Basic Parameters, as shown below.[[Image:search_basic_parameters.png|frame|center]]

*'''Use Search Areas.''' Whether or not to show the Search Areas check boxes. These check boxes allow a User to limit the search to any combination of Articles, Web Links, Contacts, Categories, Sections, and News Feeds.
*'''Show Created Date.''' Hide or Show the Date and Time the Article was created when displaying the Search results.

'''Parameters - Component'''

Search Layout has the following options under Parameters - Component:
[[Image:search_parameters_component1.png|frame|center]]
These setting work with the settings in the [[screen.stats.searches.15|Search Statistics]]. If a parameter here is set to 'Yes', 'No', 'Show', or 'Hide', then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.stats.searches.15|Search Statistics]] is used.
*'''Gather Search Statistics.''' Whether or not to enable the gathering of Search Statistics. Yes/No/Use Global.
*'''Show Created Date.''' Whether to Hide or Show the Created Date for an Article. This parameter can be overridden at the Menu Item and Article level.

==Internal Link - User==
When the User link is selected, it expands to display the options shown below.
[[Image:menu_item_type_user.png|frame|center]]
Each of these is described below.

===Default Login Layout===
Allows a user to login to the site, as shown below.
[[Image:default_login_layout.png|frame|center]]

'''Parameters - Basic'''
The Default Login Layout has the following Basic Parameters, as shown below.[[Image:default_login_parameters.png|frame|center]]
*'''Show Login Page Title.''' Hide or Show the Title of this Page.
*'''Login Page Title.''' Title to display as the Page Title. If blank, the Title of the Menu Item will be used.
*'''Login Redirection URL.''' The URL of the Page that the User will be redirected to after a successful login. If blank, the Front Page will be used.
*'''Login JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful login.
*'''Login Description.''' Hide or Show the Login Description Text, entered below.
*'''Login Description Text.''' Text to display on a successful login. If blank, the variable "LOGIN_DESCRIPTION" will be used.
*'''Login Image.''' Image for the Login Page. This must be in the "images/stories" folder.
*'''Login Image Align.''' Align image to the left or right of the page.
*'''Show Logout Page Title.''' Hide or Show the Logout Page Title.
*'''Logout Page Title.''' Text to display at the top of the Page. If blank, the Menu Item Title will be used.
*'''Logout Redirection URL.''' The URL of the Page the User will be directed to after a successful logout. If blank, the Front Page will be used.
*'''Logout JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful logout.
*'''Logout Description.''' Hide or Show the Logout Description Text, entered below.
*'''Logout Description Text.''' Text to display on a successful logout. If blank, the variable "LOGOUT_DESCRIPTION" will be used.
*'''Logout Image.''' Image for the Logout Page. This must be in the "images/stories" folder.
*'''Logout Image Align.''' Align image to the left or right of the page.

===Default Registration Layout===
Allows a user to register for the site, as shown below.
[[Image:default_user_registration_layout.png|frame|center]]This Layout has no unique Parameters.

===Default Remind Layout===
Allows the user to receive an e-mail with their username, as shown below.
[[Image:default_remind_layout.png|frame|center]] This Layout has no unique Parameters.

===Default Reset Layout===
Allows the user to reset their password, as shown below.
[[Image:default_reset_layout.png|frame|center]] This Layout has no unique Parameters.

===Default User Layout===
Shows a welcome message when the User enters the registered zone. This Layout has no unique Parameters.

===User Form Layout===
Allows a User to edit their account details, choose a new password, change the language for both the Back-end and Front-end, and modify their time zone. Users with publishing permissions may choose a text editor. Users with administrator permissions may choose the Help Site they want to use in the back-end. The layout for users in the Registered and Author groups is shown below.[[Image:user_form_layout.png|frame|center]] This Layout has no unique Parameters.

==Internal Link - Web Links==
When the 'Web Links' link is selected, it expands to display the options shown below.
[[Image:menu_item_web_links.png|frame|center]]
Each of these is described below.

===Web Link Category List Layout===
Shows a list of all the Web Link Categories. The User may click on a Category to see the links for that Category.

'''Parameters - Basic'''
The Web Link Category List Layout has the following Basic Parameters, as shown below. [[Image:web_link_category_list_parameters1.png|frame|center]]
{{colheader|Image}}
{{colheader|Image Align}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Shows a list of all of the Web Links in a Category.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:Category_list_web_parameters.png|frame|center]]
*'''Category.''' Web Link Category for this Page. Select a Web Link Category from the drop-down list box. Note that these Categories are different from Article Categories and are entered from the selection Components/Web Links/Categories.
{{colheader|Show a Feed Link}}

===Web Link Submission Layout===
Shows a form that allows a Registered User to submit a Web Link, as shown below. [[Image:submit_web_link.png|frame|center]] This only works for users who are members of the Authors, Publishers, or Editors group. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

===Parameters - Component for Web Links===
All Web Links Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:web_link_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]]. The a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]] is used.
{{colheader|Web Links Description}}
{{colheader|Web Links Introduction}}
{{colheader|Web Links Hits}}
{{colheader|Link Descriptions}}
{{colheader|Other Categories}}
{{colheader|Table Headings}}
{{colheader|Target}}
{{colheader|Icon}}

==Internal Link - Wrapper==
When the Wrapper link is selected, it expands to display the Wrapper layout. This is used to show an external web site inside a page in your web site, using an HTML [[:Wikipedia:IFrame|IFrame]]. The external web site is contained inside the Wrapper. You can navigate to different pages in the wrapped web site, all inside the page of your web site. The example below shows the Joomla! web site inside a Wrapper. [[Image:menu_item_type_wrapper.jpg|frame|center]]

'''Parameters - Basic'''
The Wrapper Layout has the following Basic Parameters, as shown below. [[Image:wrapper_basic_parameters.png|frame|center]]
*'''Wrapper URL.''' URL for the web site to open inside the Wrapper IFrame.
*'''Scroll Bars.''' Whether or not to include horizontal and vertical scroll bars. Auto will add the scroll bars automatically when needed.
*'''Width.''' Width of the IFrame Window. You can enter in a number of pixels or enter in a percentage by including a "%" at the end of the number. For example, "550" means 550 pixels. "75%" means 75% of the page width.
*'''Height.''' Height of the IFrame window, either in pixels or percent (by adding "%" to the number).

==External Link==
This Menu Item Type is used to create a menu choice that links to an external web site or page.

'''Parameters - Basic'''
The External Link has one Basic Parameter.
{{colheader|Menu Image}}

==Separator==
This Menu Item type creates a Menu Placeholder or a Separator within a Menu. These can be used to break up a long Menu.

'''Parameters - Basic'''
The Separator has one Basic Parameter.
{{colheader|Menu Image}}

==Alias==
This Menu Item Type creates a Link to an existing Menu Item. It allows you to have identical Menu Items on two or more different Menus without duplicating the settings. So, for example, if you change a parameter of a Menu Item that has an Alias linked to it, the Alias will automatically acquire the same change.

'''Parameters - Basic'''
The Alias has one Basic Parameter.
*'''Menu Item.''' The Menu Item that this Alias links to. Select the Menu Item from the drop-down list box.

==Menu Item Details and Parameters - System==
When any of the Menu Item Types listed above are selected, a details screen similar to the one below displays.
[[Image:category_blog_layout1.png]]

The 'Menu Item Details' and the 'Parameters - System' parts are the same for each Menu Item. These are documented below. The 'Parameters - Component' part is different for each Internal Link group -- Articles, Contacts, News Feeds, Polls, Search, User, Web Links, and Wrapper. Therefore, these are documented in each group's section above.

The Parameters - Basic section is different for each Menu Type. Also, some Menu Types contain a Parameters - Advanced section, which is also different for each Menu Type. These are documented for each individual Menu Type above.

'''Menu Item Details'''
{{colheader|Enter Title}}
{{colheader|Alias}}
{{colheader|Link}}
{{colheader|Display in}}
{{colheader|Parent Item}}
{{colheader|Enter Published}}
{{colheader|Order (Details)}}
{{colheader|Enter Access Level}}
{{colheader|On Click, Open in}}

'''Parameters - System'''

This section, shown below, allows setting additional parameters. [[Image:menu_item_parameters_system.png|frame|center]]
These are described below.
{{colheader|Page Title}}
{{colheader|Show Page Title}}
{{colheader|Page Class Suffix}}
{{colheader|Menu Image}}
{{colheader|SSL Enabled}}

==Quick Tips==
*Parameters for Articles and Contacts can be set at 3 different levels:
*# the individual Article or Contact New or Edit screen (Article:[Edit] or Contact:[Edit]).
*# the Menu Item that displays the Article or Contact (this screen).
*# the Global Configuration screen, accessed using the Parameters button on the Article Manager and Contact Manager screens.
: The parameter set for the individual Article or Contact always takes first priority. If the individual parameter is set to "Use Global", then the parameter set in the Menu Item takes priority. If both of these are set to "Use Global", then the parameter in the Global Configuration takes priority.
*Parameters for News Feeds, Search, and Web Links work in a similar way, except that they are only set in this screen and in the Global Configuration screens. No parameters are set for individual items of these types. As with Articles and Contacts, the Menu Item setting takes priority over the Global Configuration setting.
*Use the Global Configuration parameters whenever possible. This way, if you want to change a parameter setting for all content items, you can just change it once in the Global Configuration and it will automatically be reflected in all affected content items.
*Often on the Front Page component, Joomla! users do not want their Articles to display in 2 columns, which is the default value. The first Article displays in one column (using the full width), but subsequent Articles display in 2 columns. This can be adjusted by changing the values of the Parameters - Basic for the Front Page.
*If you are trying to manually change the order of articles on the Front Page or in a Blog or List Layout, make sure that you have the Primary Order and Category Order parameters set correctly in the Parameters - Advanced Section. If these parameters are set incorrectly, changing the order manually will have no effect on the order on the web page.

==Toolbar==
*{{toolbaricon|Cancel}}
*{{toolbaricon|Help}}

==Related Information==
* To add or edit Articles: [[Screen.content.edit.15|Article Manager - New/Edit]]
* To work with Banners: [[Screen.banners.15|Banner Manager]]
* To work with Categories: [[Screen.categories.15|Category Manager]]
* To work with Contacts: [[Screen.contactmanager.15|Contact Manager]]
* To add or edit Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To create a 'main_menu' Module to Add a Menu to One or More Pages: [[screen.modules.15|Module Manager]]
* To work with News Feeds: [[Screen.newsfeeds.15|News Feeds Manager]]
* To work with Polls: [[Screen.polls.15|Polls Manager]]

<noinclude>{{cathelp|1.5|Menu Item Manager|Menus}}</noinclude>

Help15:Screen.menus.edit.15

2009-01-21T15:52:44Z

Mic: /* Contact Category Layout */

==How To Access==
To access the New Menu Creation wizard, navigate to the [[Screen.menus.15|Menu Item Manager]] for the desired menu and press the New button on the toolbar.

==Description==
In this screen, you will select the Menu Item Type for this Menu Item. The Menu Item Type determines the type of page that will display when this menu choice is selected by the User.

==Screenshot==
[[Image:Menu_Item_New.png]]

Note: If you install one or more Joomla! extensions, these extensions may add new Menu Item Types. In this case, your list will have additional types.

==Menu Item Types==
Menu Item Types are organized into four groups: Internal Link, External Link, Separator, and Alias. Internal Links are the most commonly used and will display pages on your web site. External Links are used to display links to external web sites. Separators are used to place a graphic or other separator between menu options. Alias Item Types are used to point back to an already existing Menu Item.

==Internal Link - Articles==
When the Articles link is selected, it expands to show the options shown below.
[[Image:menu_item_type_articles.png|frame|center]]
Each of these is described below.

===Archived Article List===
Used to show a list of Articles that have been Archived and can be searched by date. Archived articles are no longer published but are still stored on the site. Articles are Archived using the [[screen.content.15|Article Manager]] screen. Note that Articles assigned to the "Uncategoried" Section will not show on the Archived Article List layout.

'''Parameters - Basic'''
This Menu Item Type Archived Article List allows you to set the sort order of Archived Articles, as shown in the screenshot below.
[[Image:menu_item_archive_parameters.png|frame|center]]
The Default order is most recent first. The Order option sorts Articles by the Order column in the [[screen.content.15|Article Manager]].

===Article Layout===
Used to show a single article on the page. Note: This layout replaces the ''Static Content'' and ''Link Content'' used in Joomla! version 1.0.

'''Parameters - Basic'''
The Article Layout has one Parameter, the Article to include in the layout, as shown below.
[[Image:menu_item_article_parameters.png|frame|center]]Press the Select button to select the desired Article for this layout.

===Article Submission Layout===
Allows users to submit an article. This only works for users who are members of the Authors, Publishers, or Editors groups. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

This type has no Basic or Advanced Parameters.

===Category Blog Layout===
Used to show articles belonging to a specific Category, in a blog layout.
{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Category Blog Layout has the following Basic Parameters, as shown below.
[[Image:category_blog_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Used to show articles belonging to one Category, in a list layout. A list layout lists each Article's Title and allows the User to link to the Article. An example is shown below:[[Image:category_list_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below.
[[Image:category_list_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Number of Links}}
{{colheader|Table Headings}}
{{colheader|Date Column}}
{{colheader|Date Format}}
{{colheader|Filter}}
{{colheader|Filter Field}}

'''Parameters - Advanced'''
The Category List Layout has the following Advanced Parameters, as shown below.
[[Image:Category_list_advanced_parameters.png|frame|center]]
{{colheader|Primary Order}}
*'''Pagination.''' Hide or Show Pagination support. Pagination provides page links at the bottom of the page that allow the User to navigate to additional pages. These are needed if the Articles will not fit on one page. An example is shown below.[[Image:blog_layout_pagination.png|frame|center]]The following options are available.
**''Hide:'' Pagination links not shown. Note: In this case, Users will not be able to navigate to additional pages.
**''Show:'' Pagination links shown if needed.
*'''Display Select:''' Show or Hide the Display # drop-down list box. This allows you to limit the number of Articles listed on one page.
{{colheader|Show a Feed Link}}

===Front Page Blog Layout===
Used to show all Articles that have been published to the Front Page, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Front Page Blog Layout has the following Basic Parameters, as shown below.
[[Image:front_page_basic_parameters.png|frame|center]]
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Blog Layout===
Used to show Articles belonging to one Section, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Section Blog Layout has the following Basic Parameters, as shown below.
[[Image:section_blog_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Section Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Layout===
Used to show Articles by Category in one Section, in a list layout. This layout shows a list Categories in the Section. An example is shown below: [[Image:section_layout_example.png|frame|center]]

Each Category links to a page that is similar to a Category List Layout, providing links to each Article in that Category. Note that you cannot directly set parameters to control the display of these Category List Layouts from within this screen. However, it is possible to do this using separate Menu Items for each Category. See the article [[How_to_control_Category_List_layouts_when_drilling_from_a_Section_Layout|How to control Category List layouts when drilling from a Section Layout]] for more information.

'''Parameters - Basic'''
The Section Layout has the following Basic Parameters, as shown below.
[[Image:section_layout_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Section Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|Category List - Section}}
{{colheader|Empty Categories in Section}}
{{colheader|No. Category Items}}
{{colheader|Category Description}}

'''Parameters - Advanced'''
The Section Layout has the following Advanced Parameters, as shown below.
[[Image:section_layout_advanced_parameters.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Show a Feed Link}}

===Parameters - Component for Articles===
All Articles Layouts have the same options under Parameters - Component. For each of these components, you may select one of three options: No/Hide, Yes/Show, or Use Global. An example of this section is shown below.[[Image:Article_parameters_component.png|frame|center]]

These values work with the values set in the [[Screen.content.15|Article Manager/Parameters]] and the values set in the [[Screen.content.edit.15|Article Manager New/Edit]] to determine the action on the page. The parameters in all three places work together in a hierarchy, as follows.
# The value from the Parameters - Advanced section of the [[Screen.content.edit.15|Article Manager New/Edit]] is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If the value above is set to "Use Global" then the value from the Parameters - Component section of the [[screen.menus.type.15|Menu Item Type]] (this screen) is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If ''both'' of the values above are set to "Use Global" then the value from [[Screen.content.15|Article Manager/Parameters]] is used to determine the result.

The individual Parameters are described below.
{{colheader|Show Unauthorized Links}}
{{colheader|Show Article Title}}
{{colheader|Title Linkable}}
{{colheader|Show Intro Text}}
{{colheader|Section Name}}
{{colheader|Section Title Linkable}}
{{colheader|Category Title}}
{{colheader|Category Title Linkable}}
{{colheader|Author Name}}
{{colheader|Created Date and Time}}
{{colheader|Modified Date and Time}}
{{colheader|Show Navigation}}
{{colheader|Read more... Link}}
{{colheader|Article Rating/Voting}}
{{colheader|Icons}}
{{colheader|PDF Icon}}
{{colheader|Print Icon}}
{{colheader|E-mail Icon}}
{{colheader|Hits Parameter}}
{{colheader|For each feed item show}}

==Internal Link - Contacts==
When the Contacts link is selected, it expands to display the options shown below.
[[Image:menu_item_type_contacts.png|frame|center]]
Each of these is described below.

===Contact Category Layout===
Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.

'''Parameters - Basic'''
The Contact Category Layout has the following Basic Parameters, as shown below. [[Image:Menu_Item.Contact.Category_Layout_Params.Basic.png|frame|center]]
{{colheader|Category Parameter}}
*'''# Links'''. Amount of contacts to show.
{{colheader|Contact Image}}
{{colheader|Image Align}}
{{colheader|Limit Box}}
{{colheader|Show a Feed Link}}

===Standard Contact Layout===
Used to show the details of a single Contact.

'''Parameters - Basic'''
The Standard Contact Layout has the following Basic Parameters, as shown below. [[Image:contact_standard_basic_parameters.png|frame|center]]
{{colheader|Contact}}
{{colheader|Drop Down}}
{{colheader|Show Category in Breadcrumbs}}

===Parameters - Component for Contacts===
All Contacts Layouts have the same options under Parameters - Component. An example of this section is
shown below.

[[Image:contact_parameters_component1.png|center]]

These settings work with the settings in the [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] and the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]]. The setting in the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]] takes priority. If the setting there is 'Use Global', then the setting here takes effect. If both of these settings are 'Use Global', then the setting in [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] takes effect.
{{colheader|Icons/Text}}
{{colheader|Address Icon}}
{{colheader|Contact E-mail Icon}}
{{colheader|Telephone Icon}}
{{colheader|Mobile Icon}}
{{colheader|Fax Icon}}
{{colheader|Miscellaneous Icon}}
{{colheader|Show Table Headings}}
{{colheader|Show Contact's Position}}
{{colheader|Show E-mail Address}}
{{colheader|Show Telephone Number}}
{{colheader|Show Mobile Number}}
{{colheader|Show Fax Number}}
{{colheader|Enable vCard}}
{{colheader|Banned E-mail}}
{{colheader|Banned Subject}}
{{colheader|Banned Text}}
{{colheader|Session Check}}
{{colheader|Custom Reply}}

==Internal Link - News Feeds==
When the News Feeds link is selected, it expands to display the options shown below.
[[Image:menu_item_type_news_feeds.png|frame|center]]
Each of these is described below. Note that News Feed Categories are separate from Article Categories. News Feeds and News Feed Categories are entered by selecting Components → News Feeds. See [[screen.newsfeeds.15|News Feeds Manager]] and [[screen.categories.15|Category Manager]] for more information.

===Category List Layout===
Used to show a list of all News Feed Categories.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:news_category_list_parameters.png|frame|center]]
{{colheader|Limit Box}}
{{colheader|News Feed Description Hide Show}}
{{colheader|Description Text}}
{{colheader|Image}}
{{colheader|Image Align}}

===Category Layout===
Used to show a list of News Feeds in a Category.

'''Parameters - Basic'''
The Category Layout has the following Basic Parameters, as shown below. [[Image:news_category_layout_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Limit Box}}

===Single Feed Layout===
Used to show a single News Feed.

'''Parameters - Basic'''
The Single Feed Layout has the following Basic Parameter, as shown below. [[Image:news_single_parameters.png|frame|center]]
{{colheader|Feed}}

===Parameters - Component for News Feeds===
All News Feed Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:News_feed_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]]. If a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]] is used.
{{colheader|Table Headings}}
{{colheader|Name Column}}
{{colheader|No. Articles Column}}
{{colheader|Link Column}}
{{colheader|Category Description}}
{{colheader|No. Category Items}}
{{colheader|Feed Image}}
{{colheader|Feed Description}}
{{colheader|Item Description}}
{{colheader|Word Count}}

==Internal Link - Polls==
When the Polls link is selected, it expands to display the Poll Layout. This is used to show the results of a Poll, as shown below.[[Image:poll_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Poll Layout has the following Basic Parameter, as shown below.[[Image:poll_parameters.png|frame|center]]
*'''Poll.''' Select the desired Poll from the drop-down list box. Polls are entered using the [[screen.polls.15|Poll Manager]].

==Internal Link - Search==
When the Search link is selected, it expands to display the Search layout. This is used to show the Search form and the Search results as shown below. [[Image:search_layout_example.png|frame|center]]

'''Parameters - Basic'''

The Search Layout has the following Basic Parameters, as shown below.[[Image:search_basic_parameters.png|frame|center]]

*'''Use Search Areas.''' Whether or not to show the Search Areas check boxes. These check boxes allow a User to limit the search to any combination of Articles, Web Links, Contacts, Categories, Sections, and News Feeds.
*'''Show Created Date.''' Hide or Show the Date and Time the Article was created when displaying the Search results.

'''Parameters - Component'''

Search Layout has the following options under Parameters - Component:
[[Image:search_parameters_component1.png|frame|center]]
These setting work with the settings in the [[screen.stats.searches.15|Search Statistics]]. If a parameter here is set to 'Yes', 'No', 'Show', or 'Hide', then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.stats.searches.15|Search Statistics]] is used.
*'''Gather Search Statistics.''' Whether or not to enable the gathering of Search Statistics. Yes/No/Use Global.
*'''Show Created Date.''' Whether to Hide or Show the Created Date for an Article. This parameter can be overridden at the Menu Item and Article level.

==Internal Link - User==
When the User link is selected, it expands to display the options shown below.
[[Image:menu_item_type_user.png|frame|center]]
Each of these is described below.

===Default Login Layout===
Allows a user to login to the site, as shown below.
[[Image:default_login_layout.png|frame|center]]

'''Parameters - Basic'''
The Default Login Layout has the following Basic Parameters, as shown below.[[Image:default_login_parameters.png|frame|center]]
*'''Show Login Page Title.''' Hide or Show the Title of this Page.
*'''Login Page Title.''' Title to display as the Page Title. If blank, the Title of the Menu Item will be used.
*'''Login Redirection URL.''' The URL of the Page that the User will be redirected to after a successful login. If blank, the Front Page will be used.
*'''Login JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful login.
*'''Login Description.''' Hide or Show the Login Description Text, entered below.
*'''Login Description Text.''' Text to display on a successful login. If blank, the variable "_LOGIN_DESCRIPTION" will be used.
*'''Login Image.''' Image for the Login Page. This must be in the "images/stories" folder.
*'''Login Image Align.''' Align image to the left or right of the page.
*'''Show Logout Page Title.''' Hide or Show the Logout Page Title.
*'''Logout Page Title.''' Text to display at the top of the Page. If blank, the Menu Item Title will be used.
*'''Logout Redirection URL.''' The URL of the Page the User will be directed to after a successful logout. If blank, the Front Page will be used.
*'''Logout JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful logout.
*'''Logout Description.''' Hide or Show the Logout Description Text, entered below.
*'''Logout Description Text.''' Text to display on a successful logout. If blank, the variable "_LOGOUT_DESCRIPTION" will be used.
*'''Logout Image.''' Image for the Logout Page. This must be in the "images/stories" folder.
*'''Logout Image Align.''' Align image to the left or right of the page.

===Default Registration Layout===
Allows a user to register for the site, as shown below.
[[Image:default_user_registration_layout.png|frame|center]]This Layout has no unique Parameters.

===Default Remind Layout===
Allows the user to receive an e-mail with their username, as shown below.
[[Image:default_remind_layout.png|frame|center]] This Layout has no unique Parameters.

===Default Reset Layout===
Allows the user to reset their password, as shown below.
[[Image:default_reset_layout.png|frame|center]] This Layout has no unique Parameters.

===Default User Layout===
Shows a welcome message when the User enters the registered zone. This Layout has no unique Parameters.

===User Form Layout===
Allows a User to edit their account details, choose a new password, change the language for both the Back-end and Front-end, and modify their time zone. Users with publishing permissions may choose a text editor. Users with administrator permissions may choose the Help Site they want to use in the back-end. The layout for users in the Registered and Author groups is shown below.[[Image:user_form_layout.png|frame|center]] This Layout has no unique Parameters.

==Internal Link - Web Links==
When the 'Web Links' link is selected, it expands to display the options shown below.
[[Image:menu_item_web_links.png|frame|center]]
Each of these is described below.

===Web Link Category List Layout===
Shows a list of all the Web Link Categories. The User may click on a Category to see the links for that Category.

'''Parameters - Basic'''
The Web Link Category List Layout has the following Basic Parameters, as shown below. [[Image:web_link_category_list_parameters1.png|frame|center]]
{{colheader|Image}}
{{colheader|Image Align}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Shows a list of all of the Web Links in a Category.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:Category_list_web_parameters.png|frame|center]]
*'''Category.''' Web Link Category for this Page. Select a Web Link Category from the drop-down list box. Note that these Categories are different from Article Categories and are entered from the selection Components/Web Links/Categories.
{{colheader|Show a Feed Link}}

===Web Link Submission Layout===
Shows a form that allows a Registered User to submit a Web Link, as shown below. [[Image:submit_web_link.png|frame|center]] This only works for users who are members of the Authors, Publishers, or Editors group. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

===Parameters - Component for Web Links===
All Web Links Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:web_link_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]]. The a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]] is used.
{{colheader|Web Links Description}}
{{colheader|Web Links Introduction}}
{{colheader|Web Links Hits}}
{{colheader|Link Descriptions}}
{{colheader|Other Categories}}
{{colheader|Table Headings}}
{{colheader|Target}}
{{colheader|Icon}}

==Internal Link - Wrapper==
When the Wrapper link is selected, it expands to display the Wrapper layout. This is used to show an external web site inside a page in your web site, using an HTML [[:Wikipedia:IFrame|IFrame]]. The external web site is contained inside the Wrapper. You can navigate to different pages in the wrapped web site, all inside the page of your web site. The example below shows the Joomla! web site inside a Wrapper. [[Image:menu_item_type_wrapper.jpg|frame|center]]

'''Parameters - Basic'''
The Wrapper Layout has the following Basic Parameters, as shown below. [[Image:wrapper_basic_parameters.png|frame|center]]
*'''Wrapper URL.''' URL for the web site to open inside the Wrapper IFrame.
*'''Scroll Bars.''' Whether or not to include horizontal and vertical scroll bars. Auto will add the scroll bars automatically when needed.
*'''Width.''' Width of the IFrame Window. You can enter in a number of pixels or enter in a percentage by including a "%" at the end of the number. For example, "550" means 550 pixels. "75%" means 75% of the page width.
*'''Height.''' Height of the IFrame window, either in pixels or percent (by adding "%" to the number).

==External Link==
This Menu Item Type is used to create a menu choice that links to an external web site or page.

'''Parameters - Basic'''
The External Link has one Basic Parameter.
{{colheader|Menu Image}}

==Separator==
This Menu Item type creates a Menu Placeholder or a Separator within a Menu. These can be used to break up a long Menu.

'''Parameters - Basic'''
The Separator has one Basic Parameter.
{{colheader|Menu Image}}

==Alias==
This Menu Item Type creates a Link to an existing Menu Item. It allows you to have identical Menu Items on two or more different Menus without duplicating the settings. So, for example, if you change a parameter of a Menu Item that has an Alias linked to it, the Alias will automatically acquire the same change.

'''Parameters - Basic'''
The Alias has one Basic Parameter.
*'''Menu Item.''' The Menu Item that this Alias links to. Select the Menu Item from the drop-down list box.

==Menu Item Details and Parameters - System==
When any of the Menu Item Types listed above are selected, a details screen similar to the one below displays.
[[Image:category_blog_layout1.png]]

The 'Menu Item Details' and the 'Parameters - System' parts are the same for each Menu Item. These are documented below. The 'Parameters - Component' part is different for each Internal Link group -- Articles, Contacts, News Feeds, Polls, Search, User, Web Links, and Wrapper. Therefore, these are documented in each group's section above.

The Parameters - Basic section is different for each Menu Type. Also, some Menu Types contain a Parameters - Advanced section, which is also different for each Menu Type. These are documented for each individual Menu Type above.

'''Menu Item Details'''
{{colheader|Enter Title}}
{{colheader|Alias}}
{{colheader|Link}}
{{colheader|Display in}}
{{colheader|Parent Item}}
{{colheader|Enter Published}}
{{colheader|Order (Details)}}
{{colheader|Enter Access Level}}
{{colheader|On Click, Open in}}

'''Parameters - System'''

This section, shown below, allows setting additional parameters. [[Image:menu_item_parameters_system.png|frame|center]]
These are described below.
{{colheader|Page Title}}
{{colheader|Show Page Title}}
{{colheader|Page Class Suffix}}
{{colheader|Menu Image}}
{{colheader|SSL Enabled}}

==Quick Tips==
*Parameters for Articles and Contacts can be set at 3 different levels:
*# the individual Article or Contact New or Edit screen (Article:[Edit] or Contact:[Edit]).
*# the Menu Item that displays the Article or Contact (this screen).
*# the Global Configuration screen, accessed using the Parameters button on the Article Manager and Contact Manager screens.
: The parameter set for the individual Article or Contact always takes first priority. If the individual parameter is set to "Use Global", then the parameter set in the Menu Item takes priority. If both of these are set to "Use Global", then the parameter in the Global Configuration takes priority.
*Parameters for News Feeds, Search, and Web Links work in a similar way, except that they are only set in this screen and in the Global Configuration screens. No parameters are set for individual items of these types. As with Articles and Contacts, the Menu Item setting takes priority over the Global Configuration setting.
*Use the Global Configuration parameters whenever possible. This way, if you want to change a parameter setting for all content items, you can just change it once in the Global Configuration and it will automatically be reflected in all affected content items.
*Often on the Front Page component, Joomla! users do not want their Articles to display in 2 columns, which is the default value. The first Article displays in one column (using the full width), but subsequent Articles display in 2 columns. This can be adjusted by changing the values of the Parameters - Basic for the Front Page.
*If you are trying to manually change the order of articles on the Front Page or in a Blog or List Layout, make sure that you have the Primary Order and Category Order parameters set correctly in the Parameters - Advanced Section. If these parameters are set incorrectly, changing the order manually will have no effect on the order on the web page.

==Toolbar==
*{{toolbaricon|Cancel}}
*{{toolbaricon|Help}}

==Related Information==
* To add or edit Articles: [[Screen.content.edit.15|Article Manager - New/Edit]]
* To work with Banners: [[Screen.banners.15|Banner Manager]]
* To work with Categories: [[Screen.categories.15|Category Manager]]
* To work with Contacts: [[Screen.contactmanager.15|Contact Manager]]
* To add or edit Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To create a 'main_menu' Module to Add a Menu to One or More Pages: [[screen.modules.15|Module Manager]]
* To work with News Feeds: [[Screen.newsfeeds.15|News Feeds Manager]]
* To work with Polls: [[Screen.polls.15|Polls Manager]]

<noinclude>{{cathelp|1.5|Menu Item Manager|Menus}}</noinclude>

Help15:Screen.menus.edit.15

2009-01-21T15:44:56Z

Mic: /* Contact Category Layout */

==How To Access==
To access the New Menu Creation wizard, navigate to the [[Screen.menus.15|Menu Item Manager]] for the desired menu and press the New button on the toolbar.

==Description==
In this screen, you will select the Menu Item Type for this Menu Item. The Menu Item Type determines the type of page that will display when this menu choice is selected by the User.

==Screenshot==
[[Image:Menu_Item_New.png]]

Note: If you install one or more Joomla! extensions, these extensions may add new Menu Item Types. In this case, your list will have additional types.

==Menu Item Types==
Menu Item Types are organized into four groups: Internal Link, External Link, Separator, and Alias. Internal Links are the most commonly used and will display pages on your web site. External Links are used to display links to external web sites. Separators are used to place a graphic or other separator between menu options. Alias Item Types are used to point back to an already existing Menu Item.

==Internal Link - Articles==
When the Articles link is selected, it expands to show the options shown below.
[[Image:menu_item_type_articles.png|frame|center]]
Each of these is described below.

===Archived Article List===
Used to show a list of Articles that have been Archived and can be searched by date. Archived articles are no longer published but are still stored on the site. Articles are Archived using the [[screen.content.15|Article Manager]] screen. Note that Articles assigned to the "Uncategoried" Section will not show on the Archived Article List layout.

'''Parameters - Basic'''
This Menu Item Type Archived Article List allows you to set the sort order of Archived Articles, as shown in the screenshot below.
[[Image:menu_item_archive_parameters.png|frame|center]]
The Default order is most recent first. The Order option sorts Articles by the Order column in the [[screen.content.15|Article Manager]].

===Article Layout===
Used to show a single article on the page. Note: This layout replaces the ''Static Content'' and ''Link Content'' used in Joomla! version 1.0.

'''Parameters - Basic'''
The Article Layout has one Parameter, the Article to include in the layout, as shown below.
[[Image:menu_item_article_parameters.png|frame|center]]Press the Select button to select the desired Article for this layout.

===Article Submission Layout===
Allows users to submit an article. This only works for users who are members of the Authors, Publishers, or Editors groups. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

This type has no Basic or Advanced Parameters.

===Category Blog Layout===
Used to show articles belonging to a specific Category, in a blog layout.
{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Category Blog Layout has the following Basic Parameters, as shown below.
[[Image:category_blog_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Used to show articles belonging to one Category, in a list layout. A list layout lists each Article's Title and allows the User to link to the Article. An example is shown below:[[Image:category_list_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below.
[[Image:category_list_basic_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Number of Links}}
{{colheader|Table Headings}}
{{colheader|Date Column}}
{{colheader|Date Format}}
{{colheader|Filter}}
{{colheader|Filter Field}}

'''Parameters - Advanced'''
The Category List Layout has the following Advanced Parameters, as shown below.
[[Image:Category_list_advanced_parameters.png|frame|center]]
{{colheader|Primary Order}}
*'''Pagination.''' Hide or Show Pagination support. Pagination provides page links at the bottom of the page that allow the User to navigate to additional pages. These are needed if the Articles will not fit on one page. An example is shown below.[[Image:blog_layout_pagination.png|frame|center]]The following options are available.
**''Hide:'' Pagination links not shown. Note: In this case, Users will not be able to navigate to additional pages.
**''Show:'' Pagination links shown if needed.
*'''Display Select:''' Show or Hide the Display # drop-down list box. This allows you to limit the number of Articles listed on one page.
{{colheader|Show a Feed Link}}

===Front Page Blog Layout===
Used to show all Articles that have been published to the Front Page, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Front Page Blog Layout has the following Basic Parameters, as shown below.
[[Image:front_page_basic_parameters.png|frame|center]]
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Category Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Blog Layout===
Used to show Articles belonging to one Section, in a Blog Layout.

{{colheader|Blog Layout}}

'''Parameters - Basic'''
The Section Blog Layout has the following Basic Parameters, as shown below.
[[Image:section_blog_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|No. Leading}}
{{colheader|No. Intro}}
{{colheader|Columns}}
{{colheader|No. Links}}

'''Parameters - Advanced'''
The Section Blog Layout has the following Advanced Parameters, as shown below.
[[Image:Front_page_parameters_advanced.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Multi Column Order}}
{{colheader|Pagination}}
{{colheader|Pagination Results}}
{{colheader|Show a Feed Link}}

===Section Layout===
Used to show Articles by Category in one Section, in a list layout. This layout shows a list Categories in the Section. An example is shown below: [[Image:section_layout_example.png|frame|center]]

Each Category links to a page that is similar to a Category List Layout, providing links to each Article in that Category. Note that you cannot directly set parameters to control the display of these Category List Layouts from within this screen. However, it is possible to do this using separate Menu Items for each Category. See the article [[How_to_control_Category_List_layouts_when_drilling_from_a_Section_Layout|How to control Category List layouts when drilling from a Section Layout]] for more information.

'''Parameters - Basic'''
The Section Layout has the following Basic Parameters, as shown below.
[[Image:section_layout_basic_parameters.png|frame|center]]
{{colheader|Section Parameter}}
{{colheader|Section Description Hide Show}}
{{colheader|Description Image Hide Show}}
{{colheader|Category List - Section}}
{{colheader|Empty Categories in Section}}
{{colheader|No. Category Items}}
{{colheader|Category Description}}

'''Parameters - Advanced'''
The Section Layout has the following Advanced Parameters, as shown below.
[[Image:section_layout_advanced_parameters.png|frame|center]]
{{colheader|Category Order}}
{{colheader|Primary Order}}
{{colheader|Show a Feed Link}}

===Parameters - Component for Articles===
All Articles Layouts have the same options under Parameters - Component. For each of these components, you may select one of three options: No/Hide, Yes/Show, or Use Global. An example of this section is shown below.[[Image:Article_parameters_component.png|frame|center]]

These values work with the values set in the [[Screen.content.15|Article Manager/Parameters]] and the values set in the [[Screen.content.edit.15|Article Manager New/Edit]] to determine the action on the page. The parameters in all three places work together in a hierarchy, as follows.
# The value from the Parameters - Advanced section of the [[Screen.content.edit.15|Article Manager New/Edit]] is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If the value above is set to "Use Global" then the value from the Parameters - Component section of the [[screen.menus.type.15|Menu Item Type]] (this screen) is examined. If this value is set to Yes/Show or No/Hide, then that action is taken and no further checking is done.
# If ''both'' of the values above are set to "Use Global" then the value from [[Screen.content.15|Article Manager/Parameters]] is used to determine the result.

The individual Parameters are described below.
{{colheader|Show Unauthorized Links}}
{{colheader|Show Article Title}}
{{colheader|Title Linkable}}
{{colheader|Show Intro Text}}
{{colheader|Section Name}}
{{colheader|Section Title Linkable}}
{{colheader|Category Title}}
{{colheader|Category Title Linkable}}
{{colheader|Author Name}}
{{colheader|Created Date and Time}}
{{colheader|Modified Date and Time}}
{{colheader|Show Navigation}}
{{colheader|Read more... Link}}
{{colheader|Article Rating/Voting}}
{{colheader|Icons}}
{{colheader|PDF Icon}}
{{colheader|Print Icon}}
{{colheader|E-mail Icon}}
{{colheader|Hits Parameter}}
{{colheader|For each feed item show}}

==Internal Link - Contacts==
When the Contacts link is selected, it expands to display the options shown below.
[[Image:menu_item_type_contacts.png|frame|center]]
Each of these is described below.

===Contact Category Layout===
Used to show all of the published Contacts in a given Category. Note that Contact Categories are separate from Article Categories. Contacts and Contact Categories are entered by selecting Components/Contacts. See [[screen.contactmanager.15|Contact Manager]] and [[screen.categories.15|Category Manager]] for more information.

'''Parameters - Basic'''
The Contact Category Layout has the following Basic Parameters, as shown below. [[Image:Menu_Item.Contact.Category_Layout_Params.Basic.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Contact Image}}
{{colheader|Image Align}}
{{colheader|Limit Box}}
{{colheader|Show a Feed Link}}

===Standard Contact Layout===
Used to show the details of a single Contact.

'''Parameters - Basic'''
The Standard Contact Layout has the following Basic Parameters, as shown below. [[Image:contact_standard_basic_parameters.png|frame|center]]
{{colheader|Contact}}
{{colheader|Drop Down}}
{{colheader|Show Category in Breadcrumbs}}

===Parameters - Component for Contacts===
All Contacts Layouts have the same options under Parameters - Component. An example of this section is
shown below.

[[Image:contact_parameters_component1.png|center]]

These settings work with the settings in the [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] and the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]]. The setting in the [[screen.contactmanager.edit.15#Contact Parameters|Contact Manager - New/Edit]] takes priority. If the setting there is 'Use Global', then the setting here takes effect. If both of these settings are 'Use Global', then the setting in [[screen.contactmanager.15#Contacts Parameters|Contacts: Global Configuration]] takes effect.
{{colheader|Icons/Text}}
{{colheader|Address Icon}}
{{colheader|Contact E-mail Icon}}
{{colheader|Telephone Icon}}
{{colheader|Mobile Icon}}
{{colheader|Fax Icon}}
{{colheader|Miscellaneous Icon}}
{{colheader|Show Table Headings}}
{{colheader|Show Contact's Position}}
{{colheader|Show E-mail Address}}
{{colheader|Show Telephone Number}}
{{colheader|Show Mobile Number}}
{{colheader|Show Fax Number}}
{{colheader|Enable vCard}}
{{colheader|Banned E-mail}}
{{colheader|Banned Subject}}
{{colheader|Banned Text}}
{{colheader|Session Check}}
{{colheader|Custom Reply}}

==Internal Link - News Feeds==
When the News Feeds link is selected, it expands to display the options shown below.
[[Image:menu_item_type_news_feeds.png|frame|center]]
Each of these is described below. Note that News Feed Categories are separate from Article Categories. News Feeds and News Feed Categories are entered by selecting Components → News Feeds. See [[screen.newsfeeds.15|News Feeds Manager]] and [[screen.categories.15|Category Manager]] for more information.

===Category List Layout===
Used to show a list of all News Feed Categories.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:news_category_list_parameters.png|frame|center]]
{{colheader|Limit Box}}
{{colheader|News Feed Description Hide Show}}
{{colheader|Description Text}}
{{colheader|Image}}
{{colheader|Image Align}}

===Category Layout===
Used to show a list of News Feeds in a Category.

'''Parameters - Basic'''
The Category Layout has the following Basic Parameters, as shown below. [[Image:news_category_layout_parameters.png|frame|center]]
{{colheader|Category Parameter}}
{{colheader|Limit Box}}

===Single Feed Layout===
Used to show a single News Feed.

'''Parameters - Basic'''
The Single Feed Layout has the following Basic Parameter, as shown below. [[Image:news_single_parameters.png|frame|center]]
{{colheader|Feed}}

===Parameters - Component for News Feeds===
All News Feed Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:News_feed_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]]. If a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.newsfeeds.15#Global Configuration|News Feeds: Global Configuration]] is used.
{{colheader|Table Headings}}
{{colheader|Name Column}}
{{colheader|No. Articles Column}}
{{colheader|Link Column}}
{{colheader|Category Description}}
{{colheader|No. Category Items}}
{{colheader|Feed Image}}
{{colheader|Feed Description}}
{{colheader|Item Description}}
{{colheader|Word Count}}

==Internal Link - Polls==
When the Polls link is selected, it expands to display the Poll Layout. This is used to show the results of a Poll, as shown below.[[Image:poll_layout_example.png|frame|center]]

'''Parameters - Basic'''
The Poll Layout has the following Basic Parameter, as shown below.[[Image:poll_parameters.png|frame|center]]
*'''Poll.''' Select the desired Poll from the drop-down list box. Polls are entered using the [[screen.polls.15|Poll Manager]].

==Internal Link - Search==
When the Search link is selected, it expands to display the Search layout. This is used to show the Search form and the Search results as shown below. [[Image:search_layout_example.png|frame|center]]

'''Parameters - Basic'''

The Search Layout has the following Basic Parameters, as shown below.[[Image:search_basic_parameters.png|frame|center]]

*'''Use Search Areas.''' Whether or not to show the Search Areas check boxes. These check boxes allow a User to limit the search to any combination of Articles, Web Links, Contacts, Categories, Sections, and News Feeds.
*'''Show Created Date.''' Hide or Show the Date and Time the Article was created when displaying the Search results.

'''Parameters - Component'''

Search Layout has the following options under Parameters - Component:
[[Image:search_parameters_component1.png|frame|center]]
These setting work with the settings in the [[screen.stats.searches.15|Search Statistics]]. If a parameter here is set to 'Yes', 'No', 'Show', or 'Hide', then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.stats.searches.15|Search Statistics]] is used.
*'''Gather Search Statistics.''' Whether or not to enable the gathering of Search Statistics. Yes/No/Use Global.
*'''Show Created Date.''' Whether to Hide or Show the Created Date for an Article. This parameter can be overridden at the Menu Item and Article level.

==Internal Link - User==
When the User link is selected, it expands to display the options shown below.
[[Image:menu_item_type_user.png|frame|center]]
Each of these is described below.

===Default Login Layout===
Allows a user to login to the site, as shown below.
[[Image:default_login_layout.png|frame|center]]

'''Parameters - Basic'''
The Default Login Layout has the following Basic Parameters, as shown below.[[Image:default_login_parameters.png|frame|center]]
*'''Show Login Page Title.''' Hide or Show the Title of this Page.
*'''Login Page Title.''' Title to display as the Page Title. If blank, the Title of the Menu Item will be used.
*'''Login Redirection URL.''' The URL of the Page that the User will be redirected to after a successful login. If blank, the Front Page will be used.
*'''Login JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful login.
*'''Login Description.''' Hide or Show the Login Description Text, entered below.
*'''Login Description Text.''' Text to display on a successful login. If blank, the variable "_LOGIN_DESCRIPTION" will be used.
*'''Login Image.''' Image for the Login Page. This must be in the "images/stories" folder.
*'''Login Image Align.''' Align image to the left or right of the page.
*'''Show Logout Page Title.''' Hide or Show the Logout Page Title.
*'''Logout Page Title.''' Text to display at the top of the Page. If blank, the Menu Item Title will be used.
*'''Logout Redirection URL.''' The URL of the Page the User will be directed to after a successful logout. If blank, the Front Page will be used.
*'''Logout JS Message.''' Hide or Show the JavaScript pop-up that indicates a successful logout.
*'''Logout Description.''' Hide or Show the Logout Description Text, entered below.
*'''Logout Description Text.''' Text to display on a successful logout. If blank, the variable "_LOGOUT_DESCRIPTION" will be used.
*'''Logout Image.''' Image for the Logout Page. This must be in the "images/stories" folder.
*'''Logout Image Align.''' Align image to the left or right of the page.

===Default Registration Layout===
Allows a user to register for the site, as shown below.
[[Image:default_user_registration_layout.png|frame|center]]This Layout has no unique Parameters.

===Default Remind Layout===
Allows the user to receive an e-mail with their username, as shown below.
[[Image:default_remind_layout.png|frame|center]] This Layout has no unique Parameters.

===Default Reset Layout===
Allows the user to reset their password, as shown below.
[[Image:default_reset_layout.png|frame|center]] This Layout has no unique Parameters.

===Default User Layout===
Shows a welcome message when the User enters the registered zone. This Layout has no unique Parameters.

===User Form Layout===
Allows a User to edit their account details, choose a new password, change the language for both the Back-end and Front-end, and modify their time zone. Users with publishing permissions may choose a text editor. Users with administrator permissions may choose the Help Site they want to use in the back-end. The layout for users in the Registered and Author groups is shown below.[[Image:user_form_layout.png|frame|center]] This Layout has no unique Parameters.

==Internal Link - Web Links==
When the 'Web Links' link is selected, it expands to display the options shown below.
[[Image:menu_item_web_links.png|frame|center]]
Each of these is described below.

===Web Link Category List Layout===
Shows a list of all the Web Link Categories. The User may click on a Category to see the links for that Category.

'''Parameters - Basic'''
The Web Link Category List Layout has the following Basic Parameters, as shown below. [[Image:web_link_category_list_parameters1.png|frame|center]]
{{colheader|Image}}
{{colheader|Image Align}}
{{colheader|Show a Feed Link}}

===Category List Layout===
Shows a list of all of the Web Links in a Category.

'''Parameters - Basic'''
The Category List Layout has the following Basic Parameters, as shown below. [[Image:Category_list_web_parameters.png|frame|center]]
*'''Category.''' Web Link Category for this Page. Select a Web Link Category from the drop-down list box. Note that these Categories are different from Article Categories and are entered from the selection Components/Web Links/Categories.
{{colheader|Show a Feed Link}}

===Web Link Submission Layout===
Shows a form that allows a Registered User to submit a Web Link, as shown below. [[Image:submit_web_link.png|frame|center]] This only works for users who are members of the Authors, Publishers, or Editors group. Members of the Registered or Public groups will not be able to submit articles even if this page is visible to them. If the page is visible to a user without the correct access level, they will get an error message when trying to load the page.

===Parameters - Component for Web Links===
All Web Links Layouts have the same options under Parameters - Component. An example of this section is shown below.[[Image:web_link_parameters_component1.png|frame|center]]
These settings work with the settings in the [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]]. The a parameter here is set to 'Hide' or 'Show' then that action is taken. If a parameter here is set to 'Use Global', then the setting in [[screen.weblink.15#Global Configuration|Web Links: Global Configuration]] is used.
{{colheader|Web Links Description}}
{{colheader|Web Links Introduction}}
{{colheader|Web Links Hits}}
{{colheader|Link Descriptions}}
{{colheader|Other Categories}}
{{colheader|Table Headings}}
{{colheader|Target}}
{{colheader|Icon}}

==Internal Link - Wrapper==
When the Wrapper link is selected, it expands to display the Wrapper layout. This is used to show an external web site inside a page in your web site, using an HTML [[:Wikipedia:IFrame|IFrame]]. The external web site is contained inside the Wrapper. You can navigate to different pages in the wrapped web site, all inside the page of your web site. The example below shows the Joomla! web site inside a Wrapper. [[Image:menu_item_type_wrapper.jpg|frame|center]]

'''Parameters - Basic'''
The Wrapper Layout has the following Basic Parameters, as shown below. [[Image:wrapper_basic_parameters.png|frame|center]]
*'''Wrapper URL.''' URL for the web site to open inside the Wrapper IFrame.
*'''Scroll Bars.''' Whether or not to include horizontal and vertical scroll bars. Auto will add the scroll bars automatically when needed.
*'''Width.''' Width of the IFrame Window. You can enter in a number of pixels or enter in a percentage by including a "%" at the end of the number. For example, "550" means 550 pixels. "75%" means 75% of the page width.
*'''Height.''' Height of the IFrame window, either in pixels or percent (by adding "%" to the number).

==External Link==
This Menu Item Type is used to create a menu choice that links to an external web site or page.

'''Parameters - Basic'''
The External Link has one Basic Parameter.
{{colheader|Menu Image}}

==Separator==
This Menu Item type creates a Menu Placeholder or a Separator within a Menu. These can be used to break up a long Menu.

'''Parameters - Basic'''
The Separator has one Basic Parameter.
{{colheader|Menu Image}}

==Alias==
This Menu Item Type creates a Link to an existing Menu Item. It allows you to have identical Menu Items on two or more different Menus without duplicating the settings. So, for example, if you change a parameter of a Menu Item that has an Alias linked to it, the Alias will automatically acquire the same change.

'''Parameters - Basic'''
The Alias has one Basic Parameter.
*'''Menu Item.''' The Menu Item that this Alias links to. Select the Menu Item from the drop-down list box.

==Menu Item Details and Parameters - System==
When any of the Menu Item Types listed above are selected, a details screen similar to the one below displays.
[[Image:category_blog_layout1.png]]

The 'Menu Item Details' and the 'Parameters - System' parts are the same for each Menu Item. These are documented below. The 'Parameters - Component' part is different for each Internal Link group -- Articles, Contacts, News Feeds, Polls, Search, User, Web Links, and Wrapper. Therefore, these are documented in each group's section above.

The Parameters - Basic section is different for each Menu Type. Also, some Menu Types contain a Parameters - Advanced section, which is also different for each Menu Type. These are documented for each individual Menu Type above.

'''Menu Item Details'''
{{colheader|Enter Title}}
{{colheader|Alias}}
{{colheader|Link}}
{{colheader|Display in}}
{{colheader|Parent Item}}
{{colheader|Enter Published}}
{{colheader|Order (Details)}}
{{colheader|Enter Access Level}}
{{colheader|On Click, Open in}}

'''Parameters - System'''

This section, shown below, allows setting additional parameters. [[Image:menu_item_parameters_system.png|frame|center]]
These are described below.
{{colheader|Page Title}}
{{colheader|Show Page Title}}
{{colheader|Page Class Suffix}}
{{colheader|Menu Image}}
{{colheader|SSL Enabled}}

==Quick Tips==
*Parameters for Articles and Contacts can be set at 3 different levels:
*# the individual Article or Contact New or Edit screen (Article:[Edit] or Contact:[Edit]).
*# the Menu Item that displays the Article or Contact (this screen).
*# the Global Configuration screen, accessed using the Parameters button on the Article Manager and Contact Manager screens.
: The parameter set for the individual Article or Contact always takes first priority. If the individual parameter is set to "Use Global", then the parameter set in the Menu Item takes priority. If both of these are set to "Use Global", then the parameter in the Global Configuration takes priority.
*Parameters for News Feeds, Search, and Web Links work in a similar way, except that they are only set in this screen and in the Global Configuration screens. No parameters are set for individual items of these types. As with Articles and Contacts, the Menu Item setting takes priority over the Global Configuration setting.
*Use the Global Configuration parameters whenever possible. This way, if you want to change a parameter setting for all content items, you can just change it once in the Global Configuration and it will automatically be reflected in all affected content items.
*Often on the Front Page component, Joomla! users do not want their Articles to display in 2 columns, which is the default value. The first Article displays in one column (using the full width), but subsequent Articles display in 2 columns. This can be adjusted by changing the values of the Parameters - Basic for the Front Page.
*If you are trying to manually change the order of articles on the Front Page or in a Blog or List Layout, make sure that you have the Primary Order and Category Order parameters set correctly in the Parameters - Advanced Section. If these parameters are set incorrectly, changing the order manually will have no effect on the order on the web page.

==Toolbar==
*{{toolbaricon|Cancel}}
*{{toolbaricon|Help}}

==Related Information==
* To add or edit Articles: [[Screen.content.edit.15|Article Manager - New/Edit]]
* To work with Banners: [[Screen.banners.15|Banner Manager]]
* To work with Categories: [[Screen.categories.15|Category Manager]]
* To work with Contacts: [[Screen.contactmanager.15|Contact Manager]]
* To add or edit Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To create a 'main_menu' Module to Add a Menu to One or More Pages: [[screen.modules.15|Module Manager]]
* To work with News Feeds: [[Screen.newsfeeds.15|News Feeds Manager]]
* To work with Polls: [[Screen.polls.15|Polls Manager]]

<noinclude>{{cathelp|1.5|Menu Item Manager|Menus}}</noinclude>

File:Menu Item.Contact.Category Layout Params.Basic.png

2009-01-21T15:43:07Z

Mic: Menu Item Contact Category Parameters Basic

== Summary ==
Menu Item Contact Category Parameters Basic
== Licensing: ==
{{JEDL}}

Chunk:Help screen column header Menu Type

2009-01-19T13:09:21Z

Mic:

*'''Type'''. The type column in the menu manager will actually be the Unique Name of the menu.

Help15:Screen.menus.15

2009-01-19T13:07:54Z

Mic: /* Screenshot */

==How to access==
Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation. For example, if a Menu is called "Main Menu", select Menus → Main Menu. Or you can navigate to the [[screen.menumanager.15|Menu Manager]] and click on the icon in the Menu Items column.

==Description==
The Menu Item Manager lists the menu items contained in a menu created using the [[screen.menumanager.15|Menu Manager]].

==Screenshot==
[[Image:Menu_Item.Manager.png]]

==Column Headers==
{{colheader|Number}}
{{colheader|Menu Item}}
{{colheader|Default}}
{{colheader|Published}}
{{colheader|Order}}
{{colheader|Access Level}}
{{colheader|Menu Type}}
{{colheader|ItemID}}

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

[[Image:Menus.toolbar.jpg]]

The functions are:
{{toolbaricon|Menus}}
{{toolbaricon|Default}}
{{toolbaricon|Publish}}
{{toolbaricon|Unpublish}}
{{toolbaricon|Move}}
{{toolbaricon|Copy}}
{{toolbaricon|Trash}}
{{toolbaricon|Edit}}
{{toolbaricon|New}}
{{toolbaricon|Help}}

==Quick Tips==
* Select an item and click on the ''Default'' button to set your Home page.
* Set different filter options to only show some of the menu items.

==Related information==
* [[Screen.menumanager.15|Menu Manager]]
* [[Screen.menus.edit.15|Menu Item Manager - New/Edit]]

<noinclude>{{cathelp|1.5|Menu Item Manager|Menus}}</noinclude>

File:Menu Item.Manager.png

2009-01-19T13:06:57Z

Mic: Menu Item Manager Overview

== Summary ==
Menu Item Manager Overview
== Licensing: ==
{{JEDL}}

Help15:Screen.menumanager.new.15

2009-01-19T12:50:52Z

Mic: /* Column Headers */

==How to access==
Go to the Menu Manager by clicking on the Menu Manager icon in the Control Panel, or by clicking on 'Menu Manager' in the 'Menus' menu. After that, click on the 'New' button in the toolbar, or select a menu and click on the 'Edit' button.

==Description==
You can add or modify menus in this screen.

==Screenshot==
[[Image:Menu.Manager_New.Edit.png]]

==Column Headers==
{{colheader|Unique Name}}
{{colheader|Title}}
{{colheader|Description}}

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

[[Image:Menumanager.new.toolbar.jpg]]

The functions are:
{{toolbaricon|Save}}
{{toolbaricon|Cancel}}
{{toolbaricon|Help}}

==Quick Tips==
* Hover your mouse over the 'i' icon next to the input box, and extra information will be shown.
* If you forgot to create a module for this menu, you can do so by using the [[Screen.modules.15|Module Manager]], found by going to Extensions -> Module Manager. Click on 'New', and then on 'Menu'. Fill in a title and select the Menu in the Module Parameters.
* It is a good idea to give a descriptive title for new menus. This is how the menu will be identified in the ''Backend Menus menu''. It is also a good idea to fill in the ''Description'' field with information about the menu. This is how the menu's module will be referred to in the Module Manager.
* When you create a new menu, use only alphanumeric characters without spaces in the ''Unique Name'' field. It is a good idea to use only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.

==Related information==
* [[Screen.menumanager.15|Menu Manager]]
* [[Screen.cpanel.15|Control Panel]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

Help15:Screen.menumanager.new.15

2009-01-19T12:50:15Z

Mic: /* Screenshot */

==How to access==
Go to the Menu Manager by clicking on the Menu Manager icon in the Control Panel, or by clicking on 'Menu Manager' in the 'Menus' menu. After that, click on the 'New' button in the toolbar, or select a menu and click on the 'Edit' button.

==Description==
You can add or modify menus in this screen.

==Screenshot==
[[Image:Menu.Manager_New.Edit.png]]

==Column Headers==
{{colheader|Unique Name}}
{{colheader|Title}}
{{colheader|Description}}
{{colheader|Module Title}}

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

[[Image:Menumanager.new.toolbar.jpg]]

The functions are:
{{toolbaricon|Save}}
{{toolbaricon|Cancel}}
{{toolbaricon|Help}}

==Quick Tips==
* Hover your mouse over the 'i' icon next to the input box, and extra information will be shown.
* If you forgot to create a module for this menu, you can do so by using the [[Screen.modules.15|Module Manager]], found by going to Extensions -> Module Manager. Click on 'New', and then on 'Menu'. Fill in a title and select the Menu in the Module Parameters.
* It is a good idea to give a descriptive title for new menus. This is how the menu will be identified in the ''Backend Menus menu''. It is also a good idea to fill in the ''Description'' field with information about the menu. This is how the menu's module will be referred to in the Module Manager.
* When you create a new menu, use only alphanumeric characters without spaces in the ''Unique Name'' field. It is a good idea to use only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.

==Related information==
* [[Screen.menumanager.15|Menu Manager]]
* [[Screen.cpanel.15|Control Panel]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

File:Menu.Manager New.Edit.png

2009-01-19T12:49:03Z

Mic: Backend Menu Manager - New / Edit

== Summary ==
Backend Menu Manager - New / Edit
== Licensing: ==
{{JEDL}}

Help15:Screen.menumanager.15

2009-01-19T12:18:15Z

Mic: /* Toolbar */

==Access==
In the backend of Joomla! use either '''Menus -> Menus''' or the icon '''Menus''' from the controlcenter.

==Description==
The Menu Manager controls how Joomla!'s menus will look and act.

==Screenshot==
[[Image:Menu_manager.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Menu Type}}
{{colheader|Menu items}}
*'''Published'''. Amount of the current included and published menu items.
*'''Unpublished'''. Amount of the current number of items that are not published or publicly available.
*'''Trashed'''. Amount of the current number of items that have been deleted, but not purged from the trash manager
{{colheader|Modules Column}}
{{colheader|Id}}

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

[[image:Menu-manager-toolbar.jpg]]

The functions are:
*'''Copy'''. To copy a menu (and all included menu items), select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu. The title is what the menu will be referred to as in the Menu Manager. Module Name is what the menu will be referred to as in the [[Screen.modules.15|Module Manager]].<br />
*'''Delete'''. To delete a menu (and all included menu items), select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.<br />
*'''Edit'''. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
*'''New'''. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.

==Quick Tips==
* It is expedient to give a descriptive title for new menus because, later, you will see it in the ''Backend Menus'' menu. It is a good idea to fill in the ''Description'' field with information about the menu. If you enter a short title in the ''Module title'' field, you can identify the menu's module using that title in the [[screen.modules.15|Module Manager]].
* Though you can create a copy of a selected menu by clicking the ''Copy'' toolbar button, you can make another instance in the Module Manager as well.
* When you create a new menu, use only English alphanumeric characters without space in the Unique Name field. It is a good idea using only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.
* If you don't enter a ''Module title'', no module will be created and the menu cannot be displayed in the front end. However you can use the Module Manager later to create a new mod_mainmenu module, and assign it to the menu.
* If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.
* The Main Menu has your default menu item, so it '''should not be deleted'''. The default menu item is your home page, and your site will not function if it is deleted. If you change the default menu item, make sure that you don't delete that menu item either! The menu with the default menu item is marked with an asterisk (*) in the ''Menus'' menu. More information can be found at the [[Screen.menus.15|Menu Manager page]]

==Related Information==
* To add new Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To add or edit Menu Items: [[Screen.menus.15|Menu Item Manager]]
* To add or edit Menu Modules: [[screen.modules.15|Module Manager]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

Help15:Screen.menumanager.15

2009-01-19T12:16:28Z

Mic: /* Toolbar */

==Access==
In the backend of Joomla! use either '''Menus -> Menus''' or the icon '''Menus''' from the controlcenter.

==Description==
The Menu Manager controls how Joomla!'s menus will look and act.

==Screenshot==
[[Image:Menu_manager.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Menu Type}}
{{colheader|Menu items}}
*'''Published'''. Amount of the current included and published menu items.
*'''Unpublished'''. Amount of the current number of items that are not published or publicly available.
*'''Trashed'''. Amount of the current number of items that have been deleted, but not purged from the trash manager
{{colheader|Modules Column}}
{{colheader|Id}}

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

[[image:Menu-manager-toolbar.jpg]]

The functions are:
*'''Copy'''. To copy a menu (and all included menu items), select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu. The title is what the menu will be referred to as in the Menu Manager. Module Name is what the menu will be referred to as in the [[Screen.modules.15|Module Manager]].<br />
*'''Delete'''. To delete a menu, select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.<br />
*'''Edit'''. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
*'''New'''. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.

==Quick Tips==
* It is expedient to give a descriptive title for new menus because, later, you will see it in the ''Backend Menus'' menu. It is a good idea to fill in the ''Description'' field with information about the menu. If you enter a short title in the ''Module title'' field, you can identify the menu's module using that title in the [[screen.modules.15|Module Manager]].
* Though you can create a copy of a selected menu by clicking the ''Copy'' toolbar button, you can make another instance in the Module Manager as well.
* When you create a new menu, use only English alphanumeric characters without space in the Unique Name field. It is a good idea using only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.
* If you don't enter a ''Module title'', no module will be created and the menu cannot be displayed in the front end. However you can use the Module Manager later to create a new mod_mainmenu module, and assign it to the menu.
* If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.
* The Main Menu has your default menu item, so it '''should not be deleted'''. The default menu item is your home page, and your site will not function if it is deleted. If you change the default menu item, make sure that you don't delete that menu item either! The menu with the default menu item is marked with an asterisk (*) in the ''Menus'' menu. More information can be found at the [[Screen.menus.15|Menu Manager page]]

==Related Information==
* To add new Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To add or edit Menu Items: [[Screen.menus.15|Menu Item Manager]]
* To add or edit Menu Modules: [[screen.modules.15|Module Manager]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

Help15:Screen.menumanager.15

2009-01-19T10:33:22Z

Mic: /* Column Headers */

==Access==
In the backend of Joomla! use either '''Menus -> Menus''' or the icon '''Menus''' from the controlcenter.

==Description==
The Menu Manager controls how Joomla!'s menus will look and act.

==Screenshot==
[[Image:Menu_manager.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Menu Type}}
{{colheader|Menu items}}
*'''Published'''. Amount of the current included and published menu items.
*'''Unpublished'''. Amount of the current number of items that are not published or publicly available.
*'''Trashed'''. Amount of the current number of items that have been deleted, but not purged from the trash manager
{{colheader|Modules Column}}
{{colheader|Id}}

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

[[image:Menu-manager-toolbar.jpg]]

The functions are:
*'''Copy'''. To copy a menu, select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu. The title is what the menu will be referred to as in the Menu Manager. Module Name is what the menu will be referred to as in the [[Screen.modules.15|Module Manager]].<br />
*'''Delete'''. To delete a menu, select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.<br />
*'''Edit'''. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
*'''New'''. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.

==Quick Tips==
* It is expedient to give a descriptive title for new menus because, later, you will see it in the ''Backend Menus'' menu. It is a good idea to fill in the ''Description'' field with information about the menu. If you enter a short title in the ''Module title'' field, you can identify the menu's module using that title in the [[screen.modules.15|Module Manager]].
* Though you can create a copy of a selected menu by clicking the ''Copy'' toolbar button, you can make another instance in the Module Manager as well.
* When you create a new menu, use only English alphanumeric characters without space in the Unique Name field. It is a good idea using only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.
* If you don't enter a ''Module title'', no module will be created and the menu cannot be displayed in the front end. However you can use the Module Manager later to create a new mod_mainmenu module, and assign it to the menu.
* If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.
* The Main Menu has your default menu item, so it '''should not be deleted'''. The default menu item is your home page, and your site will not function if it is deleted. If you change the default menu item, make sure that you don't delete that menu item either! The menu with the default menu item is marked with an asterisk (*) in the ''Menus'' menu. More information can be found at the [[Screen.menus.15|Menu Manager page]]

==Related Information==
* To add new Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To add or edit Menu Items: [[Screen.menus.15|Menu Item Manager]]
* To add or edit Menu Modules: [[screen.modules.15|Module Manager]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

Help15:Screen.menumanager.15

2009-01-19T10:20:42Z

Mic:

==Access==
In the backend of Joomla! use either '''Menus -> Menus''' or the icon '''Menus''' from the controlcenter.

==Description==
The Menu Manager controls how Joomla!'s menus will look and act.

==Screenshot==
[[Image:Menu_manager.png]]

==Column Headers==
{{colheader|Title}}
{{colheader|Menu Type}}
{{colheader|Menu items}}
{{colheader|Published}}
{{colheader|Unpublished}}
{{colheader|Trashed}}
{{colheader|Modules Column}}
{{colheader|Id}}

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

[[image:Menu-manager-toolbar.jpg]]

The functions are:
*'''Copy'''. To copy a menu, select the radio button next to it and click the "Copy" button. You can than then enter in a new title and module name for the new menu. The title is what the menu will be referred to as in the Menu Manager. Module Name is what the menu will be referred to as in the [[Screen.modules.15|Module Manager]].<br />
*'''Delete'''. To delete a menu, select the radio button, and then the "Delete" button. You will be given one last chance to change your mind. If you're sure you want to delete the menu, click the delete button one last time.<br />
*'''Edit'''. The "Edit" button allows you to change the unique name, title, description, and module name for the selected menu.
*'''New'''. To create a new menu, click the "New" button. You can enter a unique name, a title, description, and the name for the module that will also be created with the menu.

==Quick Tips==
* It is expedient to give a descriptive title for new menus because, later, you will see it in the ''Backend Menus'' menu. It is a good idea to fill in the ''Description'' field with information about the menu. If you enter a short title in the ''Module title'' field, you can identify the menu's module using that title in the [[screen.modules.15|Module Manager]].
* Though you can create a copy of a selected menu by clicking the ''Copy'' toolbar button, you can make another instance in the Module Manager as well.
* When you create a new menu, use only English alphanumeric characters without space in the Unique Name field. It is a good idea using only a-z, 0-9 and underscore (_) characters. Please read the tooltips as well.
* If you don't enter a ''Module title'', no module will be created and the menu cannot be displayed in the front end. However you can use the Module Manager later to create a new mod_mainmenu module, and assign it to the menu.
* If you delete an existing menu, do not forget that all the menu items of the respective menu will be also deleted.
* The Main Menu has your default menu item, so it '''should not be deleted'''. The default menu item is your home page, and your site will not function if it is deleted. If you change the default menu item, make sure that you don't delete that menu item either! The menu with the default menu item is marked with an asterisk (*) in the ''Menus'' menu. More information can be found at the [[Screen.menus.15|Menu Manager page]]

==Related Information==
* To add new Menus: [[Screen.menumanager.new.15|Menu Manager New/Edit]]
* To add or edit Menu Items: [[Screen.menus.15|Menu Item Manager]]
* To add or edit Menu Modules: [[screen.modules.15|Module Manager]]

<noinclude>{{cathelp|1.5|Menu Manager|Menus}}</noinclude>

Chunk:Help screen toolbar Delete

2009-01-18T14:09:49Z

Mic:

* '''Delete'''. To delete one or more items, select them and click this button. The selected items will be deleted. '''Note''': ''only empty items can be deleted.''

Chunk:Help screen toolbar Move

2009-01-18T13:48:33Z

Mic:

* '''Move'''. Select one or more items and click on this button to move them. A new screen will display showing the possible "Move to" locations on the left and the list of item(s) being moved on the right. To complete the move, select the desired "Move to" location and press the "Save" button. To cancel the operation, press "Cancel".

Chunk:Help screen toolbar Image

2009-01-13T14:10:17Z

Mic:

*'''Image.''' This button provides an easy way to insert an image into an Article. Images may be inserted from the 'images/stories' folder and may also be uploaded. When you click the Image button, a window pops up, as shown below:[[Image:Article_Button.Image_Popup.png|center]]
**'''Directory.''' The current directory on the host server. This is the 'images/stories' directory under your Joomla! home directory. Use the drop-down list box to select a subdirectory.
**'''Up.''' Navigate to the parent directory. Note that the top directory for this function is 'images/stories'. You can not navigate to a higher directory.
**'''Insert.''' Insert the selected image. The insert point will be the current cursor position. You will see the image display inside the edit window.
**'''Cancel'''. Cancel the operation and close the popup window. You can cancel also in clicking the X at right top corner.
**'''Thumbnail Browse Area.''' Click on an image thumbnail to select the image. Click on a folder icon to navigate to that subdirectory.
**'''Image URL.''' Click on one of the image thumbnails and the URL for the image will be entered for you.
**'''Align.''' Select the desired alignment (left or right) from the drop-down list box.
**'''Image Description.''' Enter a description for the image.
**'''Image Title.''' Enter a Title for this image. This displays when a User hovers the mouse on the image.
**'''Caption.''' If checked, image title will display as a caption below the image.
**'''Search...''' Click this button to browse to an image file to upload from your local computer. A file dialog will open allowing you to select a file.
**'''Start Upload.''' Once you have selected a file, press this button to upload the file to your Joomla! 'images/stories' folder. The thumbnail for the new image will now show in the thumbnail area.

Chunk:Help screen toolbar Image

2009-01-13T14:08:46Z

Mic:

*'''Image.''' This button provides an easy way to insert an image into an Article. Images may be inserted from the 'images/stories' folder and may also be uploaded. When you click the Image button, a window pops up, as shown below:[[Image:Article_Button.Image_Popup.png|center]]
**'''Directory.''' The current directory on the host server. This is the 'images/stories' directory under your Joomla! home directory. Use the drop-down list box to select a subdirectory.
**'''Up.''' Navigate to the parent directory. Note that the top directory for this function is 'images/stories'. You can not navigate to a higher directory.
**'''Insert.''' Insert the selected image. The insert point will be the current cursor position. You will see the image display inside the edit window.
**'''Cancel'''. Cancel the operation and close the popup window.
**'''Thumbnail Browse Area.''' Click on an image thumbnail to select the image. Click on a folder icon to navigate to that subdirectory.
**'''Image URL.''' Click on one of the image thumbnails and the URL for the image will be entered for you.
**'''Align.''' Select the desired alignment (left or right) from the drop-down list box.
**'''Image Description.''' Enter a description for the image.
**'''Image Title.''' Enter a Title for this image. This displays when a User hovers the mouse on the image.
**'''Caption.''' If checked, image title will display as a caption below the image.
**'''Search...''' Click this button to browse to an image file to upload from your local computer. A file dialog will open allowing you to select a file.
**'''Start Upload.''' Once you have selected a file, press this button to upload the file to your Joomla! 'images/stories' folder. The thumbnail for the new image will now show in the thumbnail area.

File:Article Button.Image Popup.png

2009-01-13T14:04:01Z

Mic: Article Edit Button Image Popup

== Summary ==
Article Edit Button Image Popup
== Licensing: ==
{{JEDL}}

Chunk:Help screen column header Global Created Date and Time

2009-01-12T18:04:23Z

Mic:

*'''Created Date and Time.''' (Hide/Show) Whether or not to display the date and time the Article was created.

Chunk:Help screen column header Select Section

2009-01-12T15:54:55Z

Mic:

*'''Select Section.''' Use the drop-down list box to select the desired Section. Only items in this Section will display. You may also select 'Uncategorized'.

Chunk:Help screen column header Select Category

2009-01-12T15:54:04Z

Mic:

*'''Select Category.''' Use the drop-down list box to select the desired Category. Only items in this Category will display.

Chunk:Help screen column header Select Section

2009-01-12T15:52:36Z

Mic:

*'''Select Section.''' Use the drop-down list box to select the desired Section. Only items in this Section will display.

Help15:Screen.content.15

2009-01-12T14:55:29Z

Mic: /* Screenshot */

==How to access==
Click the Article Manager icon in the [[screen.cpanel.15|Control Panel]], or click 'Article Manager' in the 'Content' menu in the back-end of your Joomla! installation.

==Description==
The Article Manager is the place in the back-end where you can add and manage all of the articles for your web site.

==Screenshot==
[[Image:Article.Manager.png]]

''Note: greyed item (# 15) is archived and cannot be edited before unarchived.''

==Column Headers==
Click on the column heading to sort the list by that column's value.
{{colheader|Number}}
{{colheader|Checkbox}}
{{colheader|Title}}
{{colheader|Article Published}}
{{colheader|Front Page}}
{{colheader|Order}}
{{colheader|Access Level}}
{{colheader|Section}}
{{colheader|Category}}
{{colheader|Author}}
{{colheader|Date}}
{{colheader|Hits}}
{{colheader|Id}}
{{colheader|Display #}}

==Toolbar==
At the top right you will see the following toolbar:
[[Image:article_manager_toolbar.png]]

The functions are:
{{toolbaricon|Unarchive}}
{{toolbaricon|Archive}}
{{toolbaricon|Publish}}
{{toolbaricon|Unpublish}}
{{toolbaricon|Move}}
{{toolbaricon|Copy}}
{{toolbaricon|Trash}}
{{toolbaricon|Edit}}
{{toolbaricon|New}}
*'''Parameters.''' Click this button to open the Global Configuration window. This window allows you to set default parameters for Articles. This default parameter will take effect if the corresponding Menu Item parameter and Article parameter are both set to 'Use Global'. See [[#Global Configuration|Global Configuration]] below.
{{toolbaricon|Help}}

==List Filters==
'''Filter by Partial Title'''

You can filter the list of items either by entering in part of the title or the ID number. Or you can select a combination of Section, Category, Author, and Published State.
{{colheader|List Filter}}

'''Filter by Section, Category, Author, Published State'''
In the upper right area, above the column headings, are 4 drop-down list boxes as shown below:[[Image:article_manager_filter2.png|center]] The selections may be combined. Only items matching all selections will display in the list.
{{colheader|Select Section}}
{{colheader|Select Category}}
{{colheader|Select Author}}
{{colheader|Select State}}

==Global Configuration==
This pop-up screen is shown when the User clicks the 'Parameters' button on the Toolbar.

===Screenshot===
[[Image:articles_global1.png|center]]
[[Image:articles_global2.png|center]]

===Column Headers===

{{colheader|Global Show Unauthorized Links}}
{{colheader|Global Show Article Title}}
{{colheader|Global Title Linkable}}
{{colheader|Global Show Intro Text}}
{{colheader|Global Section Name}}
{{colheader|Global Section Title Linkable}}
{{colheader|Global Category Title}}
{{colheader|Global Category Title Linkable}}
{{colheader|Global Author Name}}
{{colheader|Global Created Date and Time}}
{{colheader|Global Modified Date and Time}}
{{colheader|Global Show Navigation}}
{{colheader|Global Read more... Link}}
{{colheader|Global Article Rating/Voting}}
{{colheader|Global Icons}}
{{colheader|Global PDF Icon}}
{{colheader|Global Print Icon}}
{{colheader|Global E-mail Icon}}
{{colheader|Hits}}
{{colheader|Global For each feed item show}}

===Filtering Options (HTML)===

'''Note:''' If you allow others you do not know (and therefore have no reason to trust) to submit articles on your Joomla! Web site, the safest way to do this is to restrict users to Author and turn on Full HTML filtering.

Web sites can be attacked by users entering in special HTML code. Filtering is a way to protect your Joomla! web site. Joomla! 1.5.2 brings new filtering options to give you more control over the HTML that your content providers submit. You can be as strict or as liberal as you desire, depending on your site's needs. The filtering is opt-in meaning you must select an option if you wish to enable filters. You must define the maximum user group that will receive additional filtering, and then control the type and extent of that filtering.

The default filtering is modified by entering in the following fields:

*'''Filter Groups.''' This sets the user groups that you want additional filters applied to. Other groups will have no additional filtering done. By default, all groups have filtering to protect against markup commonly associated with web site attacks.
*'''Filter Type.''' Black List (Default), White List, No HTML.
**Black list means allow all HTML tags and attributes ''except'' those listed.
**White list means allow ''only'' the listed tags and attributes.
**No HTML means allow no HTML markup at all. All HTML is removed from an Article when it is saved.
*'''Filter Tags.''' The ''extra'' tags to exclude in a Black List, or the ''only'' tags to allow in a White List.
*'''Filter Attributes.''' The ''extra'' tag attributes to exclude in a Black List, or the ''only'' tag attributes to allow in a White List.

====Default Filters====
The default filter method in Joomla! is 'Black List'. The default 'Black List' contains the following tags to exclude:

:'applet', 'body', 'bgsound', 'base', 'basefont', 'embed', 'frame', 'frameset', 'head', 'html', 'id', 'iframe', 'ilayer', 'layer', 'link', 'meta', 'name', 'object', 'script', 'style', 'title', 'xml'

The default 'Black List' contains the following attributes to exclude:

:'action', 'background', 'codebase', 'dynsrc', 'lowsrc'

You can 'Black List' (disallow) additional tags and attributes by adding to the Filter tags and Filter attributes fields, separating each tag or attribute name with a space or comma.

Please note that these settings work regardless of the editor that you are using. Even if you are using a WYSIWYG editor, the filtering settings may strip additional tags and attributes prior to saving information in the database.

====Filter Example====

For example, to allow people in your Author group to only submit content with basic HTML tags, use the following settings:

* In the Filter groups box, select Registered and Author.
* Select White List as the Filter type
* Set the Filter tags to: p, b, i, em, br, a, ul, ol, li, img
* Set the Filter attributes to: href, target, src

====Developers Notes====

The filtering parameters in config.xml have the new parameter menu="hide". This hides the filters from the Menu Item's Component pane as you do not want cascading overrides to occur at the menu item level.

==Quick Tips==
*In Joomla! versions prior to 1.5, there were separate processes for creating a Static Content Item and normal Content Items. Both processes are now done just by adding Articles. Normal Content Items are now just called Articles, and Static Content Items are now called Uncategorized Articles.

*To create a static content item, create a new Article in the same way as for normal content and assign it to the 'Uncategorized' Section and Category. You can then use the Menu Item Type called Article Layout to show the Article in a page.

*Joomla! 1.5 changes the method you must use to create the 'Read more...' link. When you are adding or editing an article, just press the 'Read more...' button located at the bottom of the screen, next to Image and Pagebreak buttons. This inserts a 'Read more...' break in the Article. The text before the break will display as the Intro Text, and the text after the break will display when the 'Read more...' link is pressed.

==Related Information==
* To add or edit Articles: [[screen.content.edit.15|Article Manager - New/Edit]]
* To manage Categories: [[screen.categories.15|Category Manager]]
* To manage Sections: [[screen.sections.15|Section Manager]]
* To manage Users: [[screen.users.15|User Manager]]

<noinclude>{{cathelp|1.5|Article Manager|Content}}</noinclude>

Help15:Screen.content.15

2009-01-12T14:53:07Z

Mic: /* Screenshot */

==How to access==
Click the Article Manager icon in the [[screen.cpanel.15|Control Panel]], or click 'Article Manager' in the 'Content' menu in the back-end of your Joomla! installation.

==Description==
The Article Manager is the place in the back-end where you can add and manage all of the articles for your web site.

==Screenshot==
[[Image:Article.Manager.png]]

==Column Headers==
Click on the column heading to sort the list by that column's value.
{{colheader|Number}}
{{colheader|Checkbox}}
{{colheader|Title}}
{{colheader|Article Published}}
{{colheader|Front Page}}
{{colheader|Order}}
{{colheader|Access Level}}
{{colheader|Section}}
{{colheader|Category}}
{{colheader|Author}}
{{colheader|Date}}
{{colheader|Hits}}
{{colheader|Id}}
{{colheader|Display #}}

==Toolbar==
At the top right you will see the following toolbar:
[[Image:article_manager_toolbar.png]]

The functions are:
{{toolbaricon|Unarchive}}
{{toolbaricon|Archive}}
{{toolbaricon|Publish}}
{{toolbaricon|Unpublish}}
{{toolbaricon|Move}}
{{toolbaricon|Copy}}
{{toolbaricon|Trash}}
{{toolbaricon|Edit}}
{{toolbaricon|New}}
*'''Parameters.''' Click this button to open the Global Configuration window. This window allows you to set default parameters for Articles. This default parameter will take effect if the corresponding Menu Item parameter and Article parameter are both set to 'Use Global'. See [[#Global Configuration|Global Configuration]] below.
{{toolbaricon|Help}}

==List Filters==
'''Filter by Partial Title'''

You can filter the list of items either by entering in part of the title or the ID number. Or you can select a combination of Section, Category, Author, and Published State.
{{colheader|List Filter}}

'''Filter by Section, Category, Author, Published State'''
In the upper right area, above the column headings, are 4 drop-down list boxes as shown below:[[Image:article_manager_filter2.png|center]] The selections may be combined. Only items matching all selections will display in the list.
{{colheader|Select Section}}
{{colheader|Select Category}}
{{colheader|Select Author}}
{{colheader|Select State}}

==Global Configuration==
This pop-up screen is shown when the User clicks the 'Parameters' button on the Toolbar.

===Screenshot===
[[Image:articles_global1.png|center]]
[[Image:articles_global2.png|center]]

===Column Headers===

{{colheader|Global Show Unauthorized Links}}
{{colheader|Global Show Article Title}}
{{colheader|Global Title Linkable}}
{{colheader|Global Show Intro Text}}
{{colheader|Global Section Name}}
{{colheader|Global Section Title Linkable}}
{{colheader|Global Category Title}}
{{colheader|Global Category Title Linkable}}
{{colheader|Global Author Name}}
{{colheader|Global Created Date and Time}}
{{colheader|Global Modified Date and Time}}
{{colheader|Global Show Navigation}}
{{colheader|Global Read more... Link}}
{{colheader|Global Article Rating/Voting}}
{{colheader|Global Icons}}
{{colheader|Global PDF Icon}}
{{colheader|Global Print Icon}}
{{colheader|Global E-mail Icon}}
{{colheader|Hits}}
{{colheader|Global For each feed item show}}

===Filtering Options (HTML)===

'''Note:''' If you allow others you do not know (and therefore have no reason to trust) to submit articles on your Joomla! Web site, the safest way to do this is to restrict users to Author and turn on Full HTML filtering.

Web sites can be attacked by users entering in special HTML code. Filtering is a way to protect your Joomla! web site. Joomla! 1.5.2 brings new filtering options to give you more control over the HTML that your content providers submit. You can be as strict or as liberal as you desire, depending on your site's needs. The filtering is opt-in meaning you must select an option if you wish to enable filters. You must define the maximum user group that will receive additional filtering, and then control the type and extent of that filtering.

The default filtering is modified by entering in the following fields:

*'''Filter Groups.''' This sets the user groups that you want additional filters applied to. Other groups will have no additional filtering done. By default, all groups have filtering to protect against markup commonly associated with web site attacks.
*'''Filter Type.''' Black List (Default), White List, No HTML.
**Black list means allow all HTML tags and attributes ''except'' those listed.
**White list means allow ''only'' the listed tags and attributes.
**No HTML means allow no HTML markup at all. All HTML is removed from an Article when it is saved.
*'''Filter Tags.''' The ''extra'' tags to exclude in a Black List, or the ''only'' tags to allow in a White List.
*'''Filter Attributes.''' The ''extra'' tag attributes to exclude in a Black List, or the ''only'' tag attributes to allow in a White List.

====Default Filters====
The default filter method in Joomla! is 'Black List'. The default 'Black List' contains the following tags to exclude:

:'applet', 'body', 'bgsound', 'base', 'basefont', 'embed', 'frame', 'frameset', 'head', 'html', 'id', 'iframe', 'ilayer', 'layer', 'link', 'meta', 'name', 'object', 'script', 'style', 'title', 'xml'

The default 'Black List' contains the following attributes to exclude:

:'action', 'background', 'codebase', 'dynsrc', 'lowsrc'

You can 'Black List' (disallow) additional tags and attributes by adding to the Filter tags and Filter attributes fields, separating each tag or attribute name with a space or comma.

Please note that these settings work regardless of the editor that you are using. Even if you are using a WYSIWYG editor, the filtering settings may strip additional tags and attributes prior to saving information in the database.

====Filter Example====

For example, to allow people in your Author group to only submit content with basic HTML tags, use the following settings:

* In the Filter groups box, select Registered and Author.
* Select White List as the Filter type
* Set the Filter tags to: p, b, i, em, br, a, ul, ol, li, img
* Set the Filter attributes to: href, target, src

====Developers Notes====

The filtering parameters in config.xml have the new parameter menu="hide". This hides the filters from the Menu Item's Component pane as you do not want cascading overrides to occur at the menu item level.

==Quick Tips==
*In Joomla! versions prior to 1.5, there were separate processes for creating a Static Content Item and normal Content Items. Both processes are now done just by adding Articles. Normal Content Items are now just called Articles, and Static Content Items are now called Uncategorized Articles.

*To create a static content item, create a new Article in the same way as for normal content and assign it to the 'Uncategorized' Section and Category. You can then use the Menu Item Type called Article Layout to show the Article in a page.

*Joomla! 1.5 changes the method you must use to create the 'Read more...' link. When you are adding or editing an article, just press the 'Read more...' button located at the bottom of the screen, next to Image and Pagebreak buttons. This inserts a 'Read more...' break in the Article. The text before the break will display as the Intro Text, and the text after the break will display when the 'Read more...' link is pressed.

==Related Information==
* To add or edit Articles: [[screen.content.edit.15|Article Manager - New/Edit]]
* To manage Categories: [[screen.categories.15|Category Manager]]
* To manage Sections: [[screen.sections.15|Section Manager]]
* To manage Users: [[screen.users.15|User Manager]]

<noinclude>{{cathelp|1.5|Article Manager|Content}}</noinclude>

File:Article.Manager.png

2009-01-12T14:52:02Z

Mic: Backend Article Management

== Summary ==
Backend Article Management
== Licensing: ==
{{JEDL}}

Help15:Screen.languages.15

2009-01-12T12:00:50Z

Mic: /* How to Access */

==How to Access==
Select '''Extensions → Language Manager''' from the drop-down menu on the back-end of your Joomla! installation '''or''' click the icon '''Language''' in the control center.

==Description==
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.

==Screenshot==
[[Image:Language_manager.png]]

==Column Headers==
Both the ''Site'' and ''Administrator'' tabs have the following column titles. These details are fetched from the XML file included in the language pack.
{{colheader|Number}}
*'''Checkbox.''' Check this radio button to select the Language.
*'''Language Name.''' The names of the installed Languages on this web site.
*'''Default.''' The default language of the site, marked with a yellow graphical asterisk in this column.
*'''Version.''' The version number of the installed language.
*'''Date.''' The creation date of the language.
*'''Author.''' The name of the language translator is displayed in this column.
*'''Author E-mail.''' The e-mail address of the translator.
{{colheader|Display}}

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

[[Image:Language_manager_toolbar.png]]
*'''Default.''' Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
{{toolbaricon|Help}}

==Site and Administrator Links==
At the top left, above the columns, you will see two links as shown below:

[[Image:Template_manager_links.png]]
*'''Site.''' Shows the Languages available for the Front-end of the web site.
*'''Administrator.''' Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.

==Quick Tips==
*Users can use any Language from the list of installed Languages, either by having it assigned in the [[screen.users.15|User Manager]] or by filling out a [[Screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]] at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
[[Image:Spanish_language_example.png|frame|center]]
:*This User's choice is not affected by the Default Language set for the Front-end.
:*Changing a User's Language or the Default Language does not affect the web site's Articles and other content.

*'''Important''': Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.

*Additional Languages can be added using the [[screen.installer.15#Install Screen|Extension Manager - Install Screen]].

*If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.

==Related Information==
*To install more Languages: [[screen.installer.15#Install Screen|Extension Manager - Install Screen]]
*To uninstall a Language: [[screen.installer.15#Languages Screen|Extension Manager - Languages screen]]
*To change the Language for a User: [[screen.users.15|User Manager]]
*To create a form that allows a User to set their own Language: [[screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]]
*To set the Language of an Article: [[screen.content.edit.15#Parameters - Advanced|Article Manager - New/Edit - Parameters - Advanced
]]
<noinclude>{{cathelp|1.5|Language Manager|Extensions}}</noinclude>

Help15:Screen.languages.15

2009-01-12T11:45:02Z

Mic: /* How to Access */

==How to Access==
Select '''Extensions → Language Manager''' from the drop-down menu on the back-end of your Joomla! installation or click the icon '''Language''' in the control center.

==Description==
In the Language Manager you can set the default Language for both the Front-end and Back-end of your Joomla! web site.

==Screenshot==
[[Image:Language_manager.png]]

==Column Headers==
Both the ''Site'' and ''Administrator'' tabs have the following column titles. These details are fetched from the XML file included in the language pack.
{{colheader|Number}}
*'''Checkbox.''' Check this radio button to select the Language.
*'''Language Name.''' The names of the installed Languages on this web site.
*'''Default.''' The default language of the site, marked with a yellow graphical asterisk in this column.
*'''Version.''' The version number of the installed language.
*'''Date.''' The creation date of the language.
*'''Author.''' The name of the language translator is displayed in this column.
*'''Author E-mail.''' The e-mail address of the translator.
{{colheader|Display}}

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

[[Image:Language_manager_toolbar.png]]
*'''Default.''' Select the Language that you want to be the default Language. Then click this button. The default star symbol will show in the Default column, indicating that this is now the default Language.
{{toolbaricon|Help}}

==Site and Administrator Links==
At the top left, above the columns, you will see two links as shown below:

[[Image:Template_manager_links.png]]
*'''Site.''' Shows the Languages available for the Front-end of the web site.
*'''Administrator.''' Shows the Languages available for the Back-end of the web site. Note that the languages for the Front and Back end can be different.

==Quick Tips==
*Users can use any Language from the list of installed Languages, either by having it assigned in the [[screen.users.15|User Manager]] or by filling out a [[Screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]] at the Front end. This will cause the Joomla! system prompts to be generated in this Language just for this User. For example, if a User chooses Spanish as their language, then the Search Module will show with prompts in Spanish, as shown below:
[[Image:Spanish_language_example.png|frame|center]]
:*This User's choice is not affected by the Default Language set for the Front-end.
:*Changing a User's Language or the Default Language does not affect the web site's Articles and other content.

*'''Important''': Do not delete the default language files (for example, with FTP). This will create errors on both the Front-end and Back-end.

*Additional Languages can be added using the [[screen.installer.15#Install Screen|Extension Manager - Install Screen]].

*If desired, you can show the Front-end site in one Language and show the Back-end administration pages in a different Language. Also, individual articles can be configured to use a different language in the Advanced Parameter pane when editing the Article.

==Related Information==
*To install more Languages: [[screen.installer.15#Install Screen|Extension Manager - Install Screen]]
*To uninstall a Language: [[screen.installer.15#Languages Screen|Extension Manager - Languages screen]]
*To change the Language for a User: [[screen.users.15|User Manager]]
*To create a form that allows a User to set their own Language: [[screen.menus.edit.15#User Form Layout|Menu Item Manager - New/Edit - User Form Layout]]
*To set the Language of an Article: [[screen.content.edit.15#Parameters - Advanced|Article Manager - New/Edit - Parameters - Advanced
]]
<noinclude>{{cathelp|1.5|Language Manager|Extensions}}</noinclude>

Chunk:Help screen toolbar Edit

2009-01-11T17:57:15Z

Mic:

* '''Edit'''. Select one item and click on this button to open it in edit mode. If you have more than one item selected (where applicable), the first item will be opened. You can also open an item for editing by clicking on its Title or Name.

Help15:Screen.config.15

2009-01-11T15:16:15Z

Mic: /* Server Settings */

==How to access==
To access the page, either click on ''Global Configuration'' in the main [[screen.cpanel.15|Control panel]] or go to '''Site > Global Configuration'''.

==Description==
The Global Configuration screen allows you to configure the Joomla! site with your personal settings.

==Site==
===Screenshot===
[[Image:Global.Config_Site.png]]

===Setting Groups===
====Site Settings====
* '''Site Offline'''. This setting shows when the site is offline. Only Administrators will be able to see the site when ''Site Offline'' is set to Yes. The default setting is '''No'''.
* '''Offline Message'''. The message that will be displayed on the site when the site is offline.
* '''Site Name'''. The name of the site.
* '''Default WYSIWYG Editor'''. (WYSIWYG stands for What You See Is What You Get) The default [[Content creators#Content_Editors|editor]] to use when creating articles.
* '''List Length'''. The length of lists in the Control Panel for all Users. By default, this is set to '''20'''.
* '''Feed Length'''. The number of content items to be shown in the feed(s). By default, this is set to '''10'''.

====Metadata Settings====
* '''Global Site Meta Description'''. This is the description of the site which is indexed by search engine spiders.
* '''Global Site Meta Keywords'''. These keywords describe the site and are the basis for improving the ability of search engine spiders ability to index the site.
* '''Show Title Meta Tag'''. It shows the Meta information of each article. This Meta information is used by search engine spiders when indexing the site. Each article can have its own Meta Data information (set under the '''Metadata Information''' pane when creating or editing an article).
* '''Show Author Meta Tag'''. It shows the Author Meta information for articles and is used by search engine spiders when indexing the site.

====SEO Settings====
SEO stands for ''Search Engine Optimization''.

* '''Search Engine Friendly URLs'''. When set to ''Yes'', URLs are rewritten to be more friendly for search engine spiders. For example, the URL: ''www.example.com/index.php?option=com_content&view=etc...'', would turn into: ''www.example.com/alias''. Most of the items created in Joomla! have an Alias box where a search engine friendly URL can be inserted. The default setting is '''No'''.
* '''Use Apache ''mod_rewrite'''''. When set to ''Yes'', Joomla! will use the ''mod_rewrite'' settings of Apache when creating search engine friendly URLs. Please note: it is advised that you do not modify any '''.htaccess''' file without an understanding of how it works. You must use the '''.htaccess''' file provided with Joomla! in order to use this setting. To use this file, rename the '''htaccess.txt''' file (found in the root directory) to '''.htaccess'''. By default, this setting is set to '''No'''.
* '''Add suffix to URLs'''. When set to ''Yes'', Joomla! will add '''.html''' to the end of the URLs. The default setting is '''No'''.

==System==
===Screenshot===
[[Image:Global.Config_System.png]]

===Setting Groups===
====System Settings====
* '''Secret Word'''. This is generated when Joomla! is first installed and is not changeable. It is used internally by Joomla! for security purposes.
* '''Path to Log folder'''. The path where the logs should be stored. The Joomla! installer should automatically fill in this folder.
* '''Enable Web Services'''. This feature enables Joomla! to make RPC (Remote Procedure Calls) using HTTP as the transport medium and XML as the encoding language. This function should remain on to ensure that many third party extensions works. The default setting '''Yes'''.
* '''Help Server'''. The place Joomla! looks for help information when you click the '''Help''' button (visible in many screens and options of the administration panel). By default, it uses Joomla!'s main help site.

====User Settings====
* '''Allow User Registration'''. This determines whether users can register on the site. The default setting is '''Yes'''.
* '''New User Registration Type'''. If ''Allow User Registration'' is set to ''Yes'', this setting tells Joomla! what level of access should be given to new users who register. The default setting is '''Registered'''.
* '''New User Account Activation'''. This setting determines whether a new user will have to activate their account before they can use it. If set to '''Yes''', users will be sent an email containing a link to a web address. The user must follow this link to activate his/her account. By default, this setting is set to '''Yes'''.
* '''Front-end User Parameters'''. When set to ''Show'', users will be able to select their language, article editor, and help site preferences from within their Details screen. The default setting is '''Show'''.

====Media Settings====
* '''Legal Extensions (File Types)'''. These are the file types users are allowed to upload. By default, when Joomla! is installed, basic image and document files are allowed.
* '''Maximum Size (in bytes)'''. The maximum file size users are allowed to upload, in bytes. The default setting is '''10000000''' (or 10mb).
* '''Path to Media Folder'''. The path where non-image media files are located, including videos and document files. The default is "<Joomla! home>/images". You can create a new folder to use with the Media Manager and enter the path to that folder here. '''Warning''': ''Do not delete or rename the existing "<Joomla! home>/images" folder on your server.'' This folder and its subfolders "images/banners", "images/M_images", "images/smiles", and "images/stories" are used by Joomla!. Deleting or renaming these folders may cause errors.
* '''Path to Image Folder'''. The path where images are stored. The default is "<Joomla! home>/images/stories". You can create a new folder to use with the Media Manager and enter the path to that folder here. If you want to access this folder from the Media Manager, either use the default value or make the new folder a sub-folder of the Media Manager folder. '''Warning''': ''Do not delete or rename the existing "images/stories" folder on your server.'' This folder is used by Joomla! and deleting or renaming it will cause errors.
* '''Restrict Uploads'''. This feature restricts uploads by user type. The default setting is '''Yes'''.
* '''Check MIME Types'''. This uses MIME Magic or Fileinfo to verify files. The default setting is '''Yes'''. By checking the MIME information, you help ensure users don't upload malicious files to your site. If invalid MIME type errors are received then change the setting to ''No''.
* '''Legal Image Extensions (File Types)'''. This allows you to limit the types of images that can be uploaded. It operates by checking the file image headers. By default, Joomla! only allows '''bmp,gif,jpg,png'''.
* '''Ignored Extensions'''. This sets which extensions are ignored for MIME type checking and restricts uploads. By default, no extensions are ignored.
* '''Legal MIME Types'''. This sets the list of legal MIME types for uploads. By default, Joomla! automatically includes some standard file types. It is recommended that you do not touch this setting unless you know what you are doing.
* '''Illegal MIME Types'''. This sets the list of illegal MIME types for uploads. By default, Joomla! automatically blocks HTML MIME types. It is recommended that you do not touch this setting unless you know what you are doing.
* '''Enable Flash Uploader'''. This setting anables the integrated Flash Uploader which is used for example at the Media Management. If enabled it is possible to upload several fieles at once. Default setting is '''No'''. '''''Tip''': if enabled and the download does not work, disable the flash uploader (can happen due incompatible flash settings by Adobe)''

====Debug Settings====
* '''Debug System'''. This will turn on the debugging system of Joomla!. When set to '''Yes''', this tool will provide diagnostic information, language translations, and SQL errors. If any such issues or errors occur, they will be displayed at the bottom of each page, in both the front-end and back-end.
* '''Debug Language'''. This will turn on the debugging indicators (*...*) or (?...?) for the Joomla! Language files. Debug Language will work without the Debug System tool set to on. But it will not provide additional detailed references which would help in correcting any errors.

====Cache Settings====
* '''Cache'''. This setting sets whether site caching is enabled or not. When enabled, it keeps a local copy of the content on the server to speed up accessing and lessen stress on the database. The default setting is '''No'''.
* '''Cache Time'''. This setting sets the maximum length of time (in minutes) for a cache file to be stored before it is refreshed. The default setting is '''15''' minutes.
* '''Cache Handler'''. This setting sets how the cache operates. There is only one caching mechanism which is file-based.

====Session Settings====
* '''Session Lifetime'''. This setting sets how long a session should last and how long a user can remain signed in for (before logging them off for being inactive). The default setting is '''15''' minutes.
* '''Session Handler'''. This setting sets how the session should be handled once a user connects and logs into the site. The default setting is set to '''Database'''.

==Server==
===Screenshot===
[[Image:Global.Config_Server.png]]

===Setting Groups===
====Server Settings====
* '''Path to Temp-folder'''. The path where files are temporarily stored. This is filled in by default when Joomla! is installed.
* '''GZIP Page Compression'''. Compressing pages typically increases your site's speed. The default setting is '''No'''.
* '''Error Reporting'''. This sets the appropriate level of reporting. The default setting is '''System Default'''.
* '''Force SSL''. This setting forces the site access for selected areas under SSL (https). '''Note'': you must have set already the server to use SSL. Options are:
** '''None'''. SSL is not activated
** '''Administrator Only'''. SSL is only valid for the backend.
** '''Entire Site'''. SSL is valid for the whole site (front- & backend).

====Locale Settings====
* '''Time Zone'''. This tool sets the current date and time. The set time should be where the site's server is located. The default setting is '''(UTC 00:00) Western Europe Time, London, Lisbon, Casablanca'''.

====FTP Settings====
FTP stands for File Transfer Protocol. Most of these settings are set during the initial Joomla! installation.

* '''Enable FTP'''. This setting tells Joomla! to use it's built-in FTP function instead of the normal upload process used by PHP.
* '''FTP Host'''. The host server's URL connecting the FTP.
* '''FTP Port'''. The port where the FTP is accessed. The default setting is '''21'''.
* '''FTP Username'''. The username that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access a folder where files will be uploaded to.
* '''FTP Password'''. The password that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access the folder where files will be uploaded to.
* '''FTP Root'''. The root directory where files should be uploaded to.

====Database Settings====
These settings are set during the initial setup of Joomla! It is advised to leave these settings the way they are, unless you have a good understanding of how databases work.

* '''Database Type'''. The type of databased to be used. The default setting is '''mysql''', but this can be changed during the initial setup of Joomla!.
* '''Hostname'''. The hostname where the database is located. It is typically set to '''localhost''' for most servers. It is possible for the hostname to be located on a different server all together.
* '''Username'''. The username to access the database.
* '''Database'''. The name of the database.
* '''Database Prefix'''. The prefix used before the actual table's name. This allows you to have multiple Joomla! installations in the same database. The default setting is '''jos_''', but this can be changed during initial setup of Joomla!.

====Mail Settings====
The mail settings are set during the initial setup of Joomla!. These settings can be changed whenever needed.

* '''Mailer'''. This setting sets which mailer to use to deliver emails from the site. The default setting is '''PHP Mail Function'''. This can be changed during the initial setup of Joomla!.
** '''PHP Mail Function'''. This uses the mail function that is built into PHP.
** '''Sendmail'''. This uses the Sendmail program, which is typically used when creating HTML email forms.
** '''SMTP Server'''. This uses the site's SMTP server.
* '''Mail from'''. The email address used by Joomla! to send site email.
* '''From Name'''. The name Joomla! will use when sending site emails. By default, Joomla! uses the site name during the initial setup.
* '''Sendmail Path'''. The path where the Sendmail program is located. This is typically filled in by Joomla! during the initial setup. This path is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Authentication'''. If the SMTP server requires authentication to send mail, set this to '''Yes'''. Otherwise leave it at '''No'''. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Username'''. The username to use for access to the SMTP host. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Password'''. The password to use for access to the SMTP host. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Host'''. The SMTP address to use when sending mail. This is only used if '''Mailer''' is set to '''Sendmail'''.

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

[[Image:Config.toolbar.jpg]]

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

==Quick Tips==
* Most, if not all, of these settings can be set once and then left alone.
* If major modifications need to be made, then consider taking the site offline to test it and to make sure everything is in working order.
* The settings are saved in '<Joomla! root>/configuration.php'. You have to either activate the FTP-layer or make the 'configuration.php' file writable to save your changes.

==Related Information==
* [[screen.cpanel.15|Control panel]]
* [[screen.content.edit.15 | Article Manager - New/Edit]]
* [http://httpd.apache.org/docs/2.2/howto/htaccess.html Info about .htaccess]

<noinclude>{{cathelp|1.5|Global Configuration|Site}}</noinclude>

Help15:Screen.config.15

2009-01-11T15:05:03Z

Mic: /* Screenshot */

==How to access==
To access the page, either click on ''Global Configuration'' in the main [[screen.cpanel.15|Control panel]] or go to '''Site > Global Configuration'''.

==Description==
The Global Configuration screen allows you to configure the Joomla! site with your personal settings.

==Site==
===Screenshot===
[[Image:Global.Config_Site.png]]

===Setting Groups===
====Site Settings====
* '''Site Offline'''. This setting shows when the site is offline. Only Administrators will be able to see the site when ''Site Offline'' is set to Yes. The default setting is '''No'''.
* '''Offline Message'''. The message that will be displayed on the site when the site is offline.
* '''Site Name'''. The name of the site.
* '''Default WYSIWYG Editor'''. (WYSIWYG stands for What You See Is What You Get) The default [[Content creators#Content_Editors|editor]] to use when creating articles.
* '''List Length'''. The length of lists in the Control Panel for all Users. By default, this is set to '''20'''.
* '''Feed Length'''. The number of content items to be shown in the feed(s). By default, this is set to '''10'''.

====Metadata Settings====
* '''Global Site Meta Description'''. This is the description of the site which is indexed by search engine spiders.
* '''Global Site Meta Keywords'''. These keywords describe the site and are the basis for improving the ability of search engine spiders ability to index the site.
* '''Show Title Meta Tag'''. It shows the Meta information of each article. This Meta information is used by search engine spiders when indexing the site. Each article can have its own Meta Data information (set under the '''Metadata Information''' pane when creating or editing an article).
* '''Show Author Meta Tag'''. It shows the Author Meta information for articles and is used by search engine spiders when indexing the site.

====SEO Settings====
SEO stands for ''Search Engine Optimization''.

* '''Search Engine Friendly URLs'''. When set to ''Yes'', URLs are rewritten to be more friendly for search engine spiders. For example, the URL: ''www.example.com/index.php?option=com_content&view=etc...'', would turn into: ''www.example.com/alias''. Most of the items created in Joomla! have an Alias box where a search engine friendly URL can be inserted. The default setting is '''No'''.
* '''Use Apache ''mod_rewrite'''''. When set to ''Yes'', Joomla! will use the ''mod_rewrite'' settings of Apache when creating search engine friendly URLs. Please note: it is advised that you do not modify any '''.htaccess''' file without an understanding of how it works. You must use the '''.htaccess''' file provided with Joomla! in order to use this setting. To use this file, rename the '''htaccess.txt''' file (found in the root directory) to '''.htaccess'''. By default, this setting is set to '''No'''.
* '''Add suffix to URLs'''. When set to ''Yes'', Joomla! will add '''.html''' to the end of the URLs. The default setting is '''No'''.

==System==
===Screenshot===
[[Image:Global.Config_System.png]]

===Setting Groups===
====System Settings====
* '''Secret Word'''. This is generated when Joomla! is first installed and is not changeable. It is used internally by Joomla! for security purposes.
* '''Path to Log folder'''. The path where the logs should be stored. The Joomla! installer should automatically fill in this folder.
* '''Enable Web Services'''. This feature enables Joomla! to make RPC (Remote Procedure Calls) using HTTP as the transport medium and XML as the encoding language. This function should remain on to ensure that many third party extensions works. The default setting '''Yes'''.
* '''Help Server'''. The place Joomla! looks for help information when you click the '''Help''' button (visible in many screens and options of the administration panel). By default, it uses Joomla!'s main help site.

====User Settings====
* '''Allow User Registration'''. This determines whether users can register on the site. The default setting is '''Yes'''.
* '''New User Registration Type'''. If ''Allow User Registration'' is set to ''Yes'', this setting tells Joomla! what level of access should be given to new users who register. The default setting is '''Registered'''.
* '''New User Account Activation'''. This setting determines whether a new user will have to activate their account before they can use it. If set to '''Yes''', users will be sent an email containing a link to a web address. The user must follow this link to activate his/her account. By default, this setting is set to '''Yes'''.
* '''Front-end User Parameters'''. When set to ''Show'', users will be able to select their language, article editor, and help site preferences from within their Details screen. The default setting is '''Show'''.

====Media Settings====
* '''Legal Extensions (File Types)'''. These are the file types users are allowed to upload. By default, when Joomla! is installed, basic image and document files are allowed.
* '''Maximum Size (in bytes)'''. The maximum file size users are allowed to upload, in bytes. The default setting is '''10000000''' (or 10mb).
* '''Path to Media Folder'''. The path where non-image media files are located, including videos and document files. The default is "<Joomla! home>/images". You can create a new folder to use with the Media Manager and enter the path to that folder here. '''Warning''': ''Do not delete or rename the existing "<Joomla! home>/images" folder on your server.'' This folder and its subfolders "images/banners", "images/M_images", "images/smiles", and "images/stories" are used by Joomla!. Deleting or renaming these folders may cause errors.
* '''Path to Image Folder'''. The path where images are stored. The default is "<Joomla! home>/images/stories". You can create a new folder to use with the Media Manager and enter the path to that folder here. If you want to access this folder from the Media Manager, either use the default value or make the new folder a sub-folder of the Media Manager folder. '''Warning''': ''Do not delete or rename the existing "images/stories" folder on your server.'' This folder is used by Joomla! and deleting or renaming it will cause errors.
* '''Restrict Uploads'''. This feature restricts uploads by user type. The default setting is '''Yes'''.
* '''Check MIME Types'''. This uses MIME Magic or Fileinfo to verify files. The default setting is '''Yes'''. By checking the MIME information, you help ensure users don't upload malicious files to your site. If invalid MIME type errors are received then change the setting to ''No''.
* '''Legal Image Extensions (File Types)'''. This allows you to limit the types of images that can be uploaded. It operates by checking the file image headers. By default, Joomla! only allows '''bmp,gif,jpg,png'''.
* '''Ignored Extensions'''. This sets which extensions are ignored for MIME type checking and restricts uploads. By default, no extensions are ignored.
* '''Legal MIME Types'''. This sets the list of legal MIME types for uploads. By default, Joomla! automatically includes some standard file types. It is recommended that you do not touch this setting unless you know what you are doing.
* '''Illegal MIME Types'''. This sets the list of illegal MIME types for uploads. By default, Joomla! automatically blocks HTML MIME types. It is recommended that you do not touch this setting unless you know what you are doing.
* '''Enable Flash Uploader'''. This setting anables the integrated Flash Uploader which is used for example at the Media Management. If enabled it is possible to upload several fieles at once. Default setting is '''No'''. '''''Tip''': if enabled and the download does not work, disable the flash uploader (can happen due incompatible flash settings by Adobe)''

====Debug Settings====
* '''Debug System'''. This will turn on the debugging system of Joomla!. When set to '''Yes''', this tool will provide diagnostic information, language translations, and SQL errors. If any such issues or errors occur, they will be displayed at the bottom of each page, in both the front-end and back-end.
* '''Debug Language'''. This will turn on the debugging indicators (*...*) or (?...?) for the Joomla! Language files. Debug Language will work without the Debug System tool set to on. But it will not provide additional detailed references which would help in correcting any errors.

====Cache Settings====
* '''Cache'''. This setting sets whether site caching is enabled or not. When enabled, it keeps a local copy of the content on the server to speed up accessing and lessen stress on the database. The default setting is '''No'''.
* '''Cache Time'''. This setting sets the maximum length of time (in minutes) for a cache file to be stored before it is refreshed. The default setting is '''15''' minutes.
* '''Cache Handler'''. This setting sets how the cache operates. There is only one caching mechanism which is file-based.

====Session Settings====
* '''Session Lifetime'''. This setting sets how long a session should last and how long a user can remain signed in for (before logging them off for being inactive). The default setting is '''15''' minutes.
* '''Session Handler'''. This setting sets how the session should be handled once a user connects and logs into the site. The default setting is set to '''Database'''.

==Server==
===Screenshot===
[[Image:Global.Config_Server.png]]

===Setting Groups===
====Server Settings====
* '''Path to Temp-folder'''. The path where files are temporarily stored. This is filled in by default when Joomla! is installed.
* '''GZIP Page Compression'''. Compressing pages typically increases your site's speed. The default setting is '''No'''.
* '''Error Reporting'''. This sets the appropriate level of reporting. The default setting is '''System Default'''.
* '''Force SSL''. This setting forces the site access for selected areas under SSL (https). '''Note'': you must have set already the server to use SSL.

====Locale Settings====
* '''Time Zone'''. This tool sets the current date and time. The set time should be where the site's server is located. The default setting is '''(UTC 00:00) Western Europe Time, London, Lisbon, Casablanca'''.

====FTP Settings====
FTP stands for File Transfer Protocol. Most of these settings are set during the initial Joomla! installation.

* '''Enable FTP'''. This setting tells Joomla! to use it's built-in FTP function instead of the normal upload process used by PHP.
* '''FTP Host'''. The host server's URL connecting the FTP.
* '''FTP Port'''. The port where the FTP is accessed. The default setting is '''21'''.
* '''FTP Username'''. The username that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access a folder where files will be uploaded to.
* '''FTP Password'''. The password that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access the folder where files will be uploaded to.
* '''FTP Root'''. The root directory where files should be uploaded to.

====Database Settings====
These settings are set during the initial setup of Joomla! It is advised to leave these settings the way they are, unless you have a good understanding of how databases work.

* '''Database Type'''. The type of databased to be used. The default setting is '''mysql''', but this can be changed during the initial setup of Joomla!.
* '''Hostname'''. The hostname where the database is located. It is typically set to '''localhost''' for most servers. It is possible for the hostname to be located on a different server all together.
* '''Username'''. The username to access the database.
* '''Database'''. The name of the database.
* '''Database Prefix'''. The prefix used before the actual table's name. This allows you to have multiple Joomla! installations in the same database. The default setting is '''jos_''', but this can be changed during initial setup of Joomla!.

====Mail Settings====
The mail settings are set during the initial setup of Joomla!. These settings can be changed whenever needed.

* '''Mailer'''. This setting sets which mailer to use to deliver emails from the site. The default setting is '''PHP Mail Function'''. This can be changed during the initial setup of Joomla!.
** '''PHP Mail Function'''. This uses the mail function that is built into PHP.
** '''Sendmail'''. This uses the Sendmail program, which is typically used when creating HTML email forms.
** '''SMTP Server'''. This uses the site's SMTP server.
* '''Mail from'''. The email address used by Joomla! to send site email.
* '''From Name'''. The name Joomla! will use when sending site emails. By default, Joomla! uses the site name during the initial setup.
* '''Sendmail Path'''. The path where the Sendmail program is located. This is typically filled in by Joomla! during the initial setup. This path is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Authentication'''. If the SMTP server requires authentication to send mail, set this to '''Yes'''. Otherwise leave it at '''No'''. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Username'''. The username to use for access to the SMTP host. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Password'''. The password to use for access to the SMTP host. This is only used if '''Mailer''' is set to '''Sendmail'''.
* '''SMTP Host'''. The SMTP address to use when sending mail. This is only used if '''Mailer''' is set to '''Sendmail'''.

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

[[Image:Config.toolbar.jpg]]

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

==Quick Tips==
* Most, if not all, of these settings can be set once and then left alone.
* If major modifications need to be made, then consider taking the site offline to test it and to make sure everything is in working order.
* The settings are saved in '<Joomla! root>/configuration.php'. You have to either activate the FTP-layer or make the 'configuration.php' file writable to save your changes.

==Related Information==
* [[screen.cpanel.15|Control panel]]
* [[screen.content.edit.15 | Article Manager - New/Edit]]
* [http://httpd.apache.org/docs/2.2/howto/htaccess.html Info about .htaccess]

<noinclude>{{cathelp|1.5|Global Configuration|Site}}</noinclude>

File:Global.Config Site.png

2009-01-11T15:04:09Z

Mic: Global Configuration Site Settings

== Summary ==
Global Configuration Site Settings
== Licensing: ==
{{JEDL}}