Chunk25

Difference between revisions of "Help screen contact options"

From Joomla! Documentation

Line 91: Line 91:
 
*'''State.''' Show or Hide a State column in the list of Contacts.
 
*'''State.''' Show or Hide a State column in the list of Contacts.
 
*'''Country.''' Show or Hide a Country column in the list of Contacts.
 
*'''Country.''' Show or Hide a Country column in the list of Contacts.
{{Chunk25:ComponentOptions|ListLayouts|Pagination}}
+
{{Chunk25:ComponentOptions|Pagination}}
{{Chunk25:ComponentOptions|ListLayouts|PaginationResults}}
+
{{Chunk25:ComponentOptions|PaginationResults}}
  
 
===Form Tab===
 
===Form Tab===

Revision as of 06:49, 22 March 2013

Click the Options button to open the Contact Manager Options window which lets you configure this component.

Help25-contacts-manager-options-contact.png

Buttons Common to All Tabs[edit]

  • Save. Saves the contact options and stays in the current screen.
  • Save & Close. Saves the contact options and closes the current screen.
  • Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

Contacts Tab[edit]

File:Help25-contacts-manager-options-contacts-tab.png

These settings apply for single Contact unless they are changed for a specific menu item or Contact

  • Choose a layout. Default layout to use for articles.
  • Display format. (Use Global/Sliders/Tabs/Plain) Determines the style used to display sections of the contact form.
  • Contact Category. (Use Global/Hide/Show Without Link/Show With Link) Shows or Hides the contacts category with or without a link.
  • Show Contact List. (Use Global/Hide/Show) Show or Hide a drop down allowing the selection of any other contact from the same category.
  • Name. (Use Global/Hide/Show) Show or Hide the name of the contact.
  • Position. (Use Global/Hide/Show) Show or Hide the position of the contact.
  • Email. (Use Global/Hide/Show) Show or Hide the email of the contact.
  • Street Address. (Use Global/Hide/Show) Show or Hide the street address of the contact.
  • City or Suburb. (Use Global/Hide/Show) Show or Hide the city or suburb of the contact.
  • State or County. (Use Global/Hide/Show) Show or Hide the State or County of the contact.
  • Postal Code. (Use Global/Hide/Show) Show or Hide the Postal/ZIP code of the contact.
  • Country. (Use Global/Hide/Show) Show or Hide the Country of the contact.
  • Telephone. (Use Global/Hide/Show) Show or Hide the telephone number of the contact.
  • Mobile Phone. (Use Global/Hide/Show) Show or Hide the mobile number of the contact.
  • Fax. (Use Global/Hide/Show) Show or Hide the fax number of the contact.
  • Webpage. (Use Global/Hide/Show) Show or Hide the Webpage of the contact.
  • Miscellaneous Information. (Use Global/Hide/Show) Show or Hide the Miscellaneous Information of the contact (note this is called Contact Information in the Contact Component).
  • Image. (Use Global/Hide/Show) Show or Hide an image to be displayed with this item/category in the front-end.
  • Image. Choose the image file to use for the contact.
  • vCard. (Use Global/Hide/Show) Show or Hide the vCard (electronic business card) link for this Contact. Note that the "Enable vCard" option in the Contact Manager - Options must be set to "Show" for this option to work correctly.
  • Show User Articles. (Use Global/Hide/Show) If the contact selected has a Joomla profile linked - then all the articles that user has posted will be displayed.
  • Show Profile. Show Profile.
  • Show Links. (Use Global/Hide/Show) Show extra links for the contact (see the parameters below).
  • Link A Label. (Input Field) Label for an additional link for this contact.
  • Link B Label. An additional link for this contact.
  • Link C Label. An additional link for this contact.
  • Link D Label. An additional link for this contact.
  • Link E Label. An additional link for this contact.

Icons Tab[edit]

Help25-contacts-manager-options-icons-tab.png

These settings apply for single Contact unless they are changed for a specific menu item or Contact

  • Settings. Choose whether to display icons, text or nothing next to the information.
  • Address Icon. Select the Address icon. If none selected, the default icon will be displayed.
  • Email Icon. Select the Email icon. If none selected, the default icon will be displayed.
  • Telephone Icon. Select the Telephone icon. If none selected, the default icon will be displayed.
  • Mobile Icon. Select the Mobile icon. If none selected, the default icon will be displayed.
  • Fax Icon. Select the Fax icon. If none selected, the default icon will be displayed.
  • Misc Icon. Select the Misc icon. If none selected, the default icon will be displayed.

Category Tab[edit]

Help25-contacts-manager-options-category-tab.png

These settings apply for Contact Category Options unless they are changed for a specific menu item.

  • Choose a layout. Default layout to use for articles.
  • Category Title. (Show/Hide) Show or Hide the category Title.
  • Category Description. (Show/Hide) Show or hide the description of the category.
  • Category Image. (Show/Hide) Show or hide the category image.
  • Subcategory Levels. (All/1-5) The number of levels of subcategories to show in the layout. Select All to show all levels in the subcategory hierarchy.
  • Empty Categories. (Show/Hide) Whether to hide or show the categories that contain no content items or subcategories.
  • Subcategories Descriptions. (Show/Hide) Whether to hide or show the category description of subcategories.
  • # Contacts in Category. Show or Hide the number of Contacts in category.

Categories Tab[edit]

Help25-contacts-manager-options-categories-tab.png

These settings apply for Contact Categories Options unless they are changed for a specific menu item.

  • Top Level Category Description. (Show/Hide) Show or Hide the top category description.
  • Subcategory Levels. (All/1-5) The number of levels of subcategories to show in the layout. Select All to show all levels in the subcategory hierarchy.
  • Empty Categories. (Show/Hide) Whether to hide or show the categories that contain no content items or subcategories.
  • Subcategories Descriptions. (Show/Hide) Whether to hide or show the category description of subcategories.
  • # Contacts in Category. (Show/Hide) Show or Hide the number of Contacts in category.

List Layouts Tab[edit]

Help25-contacts-manager-options-list-layouts-tab.png

These settings apply for Contact List Options unless they are changed for a specific menu item. Chunk25:Help screen component options ListLayouts Chunk25:Help screen component options ListLayouts

  • Position. Show or Hide a Position column in the list of Contacts.
  • Email. Show or Hide an Email column in the list of Contacts.
  • Phone. Show or Hide a Phone column in the list of Contacts.
  • Mobile. Show or Hide show a Mobile column in the list of Contacts.
  • Fax. Show or Hide a Fax column in the list of Contacts.
  • City or Suburb. Show or Hide a City or Suburb column in the list of Contacts.
  • State. Show or Hide a State column in the list of Contacts.
  • Country. Show or Hide a Country column in the list of Contacts.
  • Pagination: Can Show or Hide Pagination Options. Pagination allows additional content to be displayed on subsequent pages. This may be useful if your content will not easily fit on one page.
  • Pagination Results: Can show the number of pages of newsfeed content. This option is only viewed if the Pagination option is turned on. An example would be Page 1 of 4.

Form Tab[edit]

Help25-contacts-manager-options-form-tab.png

These settings apply for single Contact unless they are changed for a specific menu item or Contact.

  • Show Contact Form. (Use Global/Hide/Show) Show or Hide contact form.
  • Send Copy to Submitter. (Use Global/Hide/Show) Show or Hide checkbox to allow copy of email to be sent to submitter.
  • Banned Email. Email addresses not allowed to submit information with the contact form.
  • Banned Subject. Subjects not allowed in contact form.
  • Banned Text. Text not allowed in contact form body.
  • Session Check. (Use Global/No/Yes) Check for the existence of session cookie. This means that users without cookies enabled will not be able to send emails.
  • Custom Reply. (Use Global/No/Yes) Turns off the automated reply, allowing for Plugins to handle integration with other systems.
  • Contact Redirect. Enter an alternative email address, where information will be sent to.

Integration Tab[edit]

Help25-contacts-manager-options-integration-tab.png

These settings determine how the Contact Component will integrate with other extensions. Chunk25:Help screen component options Integration Chunk25:Help screen component options Integration

Permissions Tab[edit]

This screen allows you to set the component permissions in Joomla. This is important to consider if you have sites with many different user categories all of whom need to have different accessibilities to the component. The screenshot below describes what you should see and the text below that describes what each permission level gives the user access to:

Help25-components-contacts-options-permissions.png

You work on one Group at a time by opening the slider for that group. You change the permissions in the Select New Settings drop-down list boxes. The options for each value are Inherited, Allowed, or Denied. The Calculated Setting column shows you the setting in effect. It is either Not Allowed (the default), Allowed, or Denied. Note that the Calculated Setting column is not updated until you press the Save button in the toolbar. To check that the settings are what you want, press the Save button and check the Calculated Settings column.

The default values used here are the ones set in the Global Configuration Permissions Tab


Configure
Open the contacts component option screens (the modal window these options are in)
Access Administration Interface
Open the contacts component manger screens
Create
Create new contacts in the component
Delete
Delete existing contacts in the component
Edit
Edit existing contacts in the component
Edit State
Change an contacts state (Publish, Unpublish, Archive, and Trash) in the component.
Edit Own
Edit existing contacts in the component that the logged in user has created.

There are two very important points to understand from this screen. The first is to see how the permissions can be inherited from the parent Group. The second is to see how you can control the default permissions by Group and by Action. This provides a lot of flexibility. For example, if you wanted Shop Suppliers to be able to have the ability to create an article about their product, you could just change their Create value to "Allowed". If you wanted to not allow members of Administrator group to delete objects or change their state, you would change their permissions in these columns to Inherited (or Denied). It is also important to understand that the ability to have child groups is completely optional. It allows you to save some time when setting up new groups. However, if you like, you can set up all groups to have Public as the parent and not inherit any permissions from a parent group.