View source for Menu Item: List Contacts in a Category/en

<noinclude><languages /></noinclude> 

==Description==
The '''List Contacts in a Category''' menu item type is used to show contacts in a given Category in a list layout. Settings include: Contact Details, Contact Form, presentation(slider, tabs, plain view), and Email subject and message filters.

==How To Access==
To create a new List Contacts in a Category menu item:
* Select {{rarr|Menus,[name of the menu]}} from the Administrator menu (for example, {{rarr|Menus,Main Menu}}).
** Select the '''New''' Toolbar button. Then...
** Select the Menu Item Type Select button [[File:Help30-Menu-Item-Type-Select-Button-en.png]]
** In the modal dialog select the Contacts item to open a list and then select the '''List Contacts in a Category''' item.
To edit an existing List Contacts in a Category menu item:
* Select its Title in the Menus: Items list.

==Screenshot==
[[Image:Help-4x-Menus-Menu-Item-Contact-Category-screen-en.png|800px]]

==Form Fields==
{{:Chunk4x:Help screen column header Menu Title/en}}
{{:Chunk4x:Help screen column header Alias/en}}

===Details Tab===
'''Left Panel'''
{{:Chunk4x:Help screen column header Menu Item Type/en}}
*'''Select a Category.''' Select a contact category to display.
*'''Target Window.''' This determines how the new page will be opened. Options are:
**''Parent'' Open new menu item in parent window. This is the default.
**''New Window With Navigation'' Open menu item in a new window with full browser navigation (for example, "back" button).
**''New Without Navigation'' Open menu item in a new window without browser navigation.
*'''Template Style.''' Controls the template style for this menu item. A list box will show the available template styles for your site, similar to the following: 
:[[Image:Help-4x-menu-item-template-style-en.png]]
:Select "Use Default" to use the default style for the site. Select a specific template style to always show this menu item with that style.

'''Right Panel'''
{{:Chunk4x:Help screen column header Menu/en}}
{{Chunk4x:Help screen column header Parent Item/en}}
{{Chunk4x:Help screen column header Ordering/en}}
{{Chunk4x:Help screen column header Status/en}}
{{Chunk4x:Help screen column header Start Publishing/en}}
{{Chunk4x:Help screen column header Finish Publishing/en}}
{{Chunk4x:Help screen column header Default Page/en}}
{{Chunk4x:Help screen column header Access/en}}
{{Chunk4x:Help screen column header Language/en}}
{{Chunk4x:Help screen column header Note/en}}

===Category Tab===
The Category Options control the way that category information is shown in the layout. The Category List Layout has the following Category Options, as shown below.
:[[Image:Help-4x-Menus-Menu-Item-Contact-Category-category-options-parameters-en.png|600px]]
{{Chunk4x:colheader|Category Title/en}}
{{Chunk4x:colheader|Category Description/en}}
{{Chunk4x:colheader|Category Image/en}}
{{Chunk4x:colheader|Subcategory Levels/en}}
{{Chunk4x:colheader|Empty Categories/en}}
{{Chunk4x:colheader|Subcategories Descriptions/en}}
{{Chunk4x:colheader|Number Contacts Category/en}}

===List Layouts Tab===
List Layout Options control the appearance of the list layout.
:[[Image:Help-4x-Menus-Menu-Item-Contact-Category-category-list-layout-options-parameters-en.png|600px]]
* '''Filter Field.''' (Use Global/Hide/Show) The Filter Field creates a text field for the front-end user to enter some part of a contact name to search for.
{{Chunk4x:colheader|Display Select/en}}
{{Chunk4x:colheader|Table Headings/en}}
{{Chunk4x:colheader|Menu Image/en}}
* '''Position.''' (Use Global/Hide/Show) The position this contact holds in the organisation. For example CEO, Secretary, Janitor.
{{Chunk4x:colheader Contact Detail List/en|Email}}
{{Chunk4x:colheader Contact Detail List/en|Phone}}
{{Chunk4x:colheader Contact Detail List/en|Mobile}}
{{Chunk4x:colheader Contact Detail List/en|Fax}}
{{Chunk4x:colheader Contact Detail List/en|City or Suburb}}
{{Chunk4x:colheader Contact Detail List/en|State or County}}
{{Chunk4x:colheader Contact Detail List/en|Country}}
{{Chunk4x:colheader|Pagination/en}}
{{Chunk4x:colheader|Pagination Results/en}}
{{Chunk4x:colheader|Sort by/en}}

===Contact Display Tab===
Contact Display fields control the appearance of the list layout.
:[[Image:Help-4x-Menus-Menu-Item-Contact-Category-category-contact-display-options-parameters-en.png|600px]]
*'''Choose a Layout.''' Select from the list of templates.
{{Chunk4x:colheader|Contact Category/en}}
{{Chunk4x:colheader|Show Contact List/en}}
{{Chunk4x:colheader|Show Tags/en}}
'''Common Contact Display Fields''' are:
{{Chunk4x:Contact Display Option/en|Name}}
{{Chunk4x:Contact Display Option/en|Contact's Position}}
{{Chunk4x:Contact Display Option/en|Email}}
{{Chunk4x:Contact Display Option/en|Street Address}}
{{Chunk4x:Contact Display Option/en|City or Suburb}}
{{Chunk4x:Contact Display Option/en|State or County}}
{{Chunk4x:Contact Display Option/en|Postal Code}}
{{Chunk4x:Contact Display Option/en|Country}}
{{Chunk4x:Contact Display Option/en|Telephone}}
{{Chunk4x:Contact Display Option/en|Mobile phone}}
{{Chunk4x:Contact Display Option/en|Fax}}
{{Chunk4x:Contact Display Option/en|Webpage}}
{{Chunk4x:Contact Display Option/en|Misc. Information}}
{{Chunk4x:Contact Display Option/en|Image}}
{{Chunk4x:Contact Display Option/en|vCard}}
{{Chunk4x:Contact Display Option/en|Show User Articles|Articles}}
{{Chunk4x:Contact Display Option/en|# Articles to List|Number of Articles}}
{{Chunk4x:Contact Display Option/en|Show Links|additional links}} These could be links to Social Media accounts, such as Twitter, Facebook, Skype...
:All of the '''Common Contact Display Fields''' have the following options available: 
:*''Use Global:'' Use the default value from the contacts options screen. 
:*''Show:'' Show this field. 
:*''Hide:'' Do not display this field.
*'''Link <letter> Label'''. <A to E> Labels (5) to override shown link's label.

===Mail Options Tab===
Contact Mail Options control the appearance of a Contact's {{rarr}}''Contact Form'' if it is enabled.
:[[Image:Help-4x-Menus-Menu-Item-Contact-Category-category-contact-mail-options-parameters-en.png|600px]]
{{Chunk4x:Contact Display Option/en|Contact Form|contact form}}
*'''Send Copy to Submitter.''' (Use Global/Hide/Show) Display the a check box to allow a Submitter to send a copy of email to themselves.
*'''Session Check.''' (Use Global/No/Yes) Check for the existence of session cookie. Users without cookies enabled will not be able to send emails.
*'''Custom Reply.''' (Use Global/No/Yes) Turn on or off the custom message reply to contact form's submitter.
*'''Contact Redirect.''' Enter alternative URL to redirect submitter after a successful contact form email was sent.

===Integration Tab===
The List Contacts in a Category Menu Item has the following Integration Options. 
:[[Image:Help-4x-Menus-Menu-Item-Contact-Category-integration-options-parameters-en.png|600px]]
These determine whether a news feed will be available for the page and what information it will show.
{{Chunk4x:colheader|Show Feed Link/en}}

===Common Options===
See [[Help4.x:Menu_Item:_New_Item/en|Menus: Edit/New Item]] for help on fields common to all Menu Item types located in the following Tabs:
*'''Link Type'''
*'''Page Display'''
*'''Metadata'''
*'''Associations'''
*'''Module Assignment'''

==Toolbar==

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

*'''Save.''' Saves the menu item and stays in the current screen.

*'''Save & Close'''. Saves the menu item and closes the current screen.

*'''Save & New'''. Saves the menu item and keeps the editing screen open and ready to create another menu item.

*'''Save & Close'''. Saves the menu item and closes the current screen.

*'''Cancel'''. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

*'''Help'''. Opens this help screen.

==Quick Tips==
* The Category List layout is a convenient way to list a compact directory of contacts in a category that can include filtering and searching.

==Related Information==
{{Chunk4x:Help screen related Contacts/en}}

{{cathelp|4.0|Menus Help Screens|Menu Item Manager Help Screens}}