Help310

Help310:Components Contact Manager Options

From Joomla! Documentation

Revision as of 05:59, 11 April 2022 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Other languages:
Deutsch • ‎English • ‎Nederlands • ‎eesti • ‎français • ‎Ελληνικά

Description

Contact Options configuration allows setting of parameters used globally for all contacts.

How to Access

  • Select Components  Contacts from the dropdown menu of the Administrator Panel
  • Click the Options button in the toolbar.

Screenshot

Help30-Components-Contacts-Contacts-options1-en.png

Form Fields

Contact

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

  • Choose a Layout. (Default) Use a different layout from the supplied component view or overrides in the templates.
  • Contact Category. Set to control the Contacts Category display view.
    • Hide: Do not show the Category name of the contacts.
    • Show Without Link: Show Category name of contacts as heading styled text only.
    • Show With Link: Show Category name of contacts as heading styled text linked to Category.
  • Enable Versions. (Yes/No) Whether or not to save version history for contacts and categories.
  • Maximum Versions. The maximum number of versions to store.
    • If a contact or category is saved and the maximum number of versions has been reached, the oldest version will be deleted automatically.
    • If set to '0', then versions will never be deleted automatically. Also, specific versions may be flagged as "Keep Forever" and will not be deleted automatically.
      Note: Versions may be deleted manually using the 'Delete' button in Version History.
  • Show Contact List. (Show/Hide) If Show, the user will be able to change which contact is shown by selecting a contact from a dropdown list of all contacts in the current contact category.
  • Display Format. Determines the style used to display sections of the contact form.
    • Sliders: Slider contact view.
    • Tabs: Tabbed contact view.
    • Plain: Plain text contact view.
  • Tags. (Show/Hide) Show or hide the tags for a contact.
  • Contact Information. (Show/Hide) Show or hide the contact information.
  • Name. (Show/Hide) Show or hide name of the contact.
  • Contact's Position. (Show/Hide) Show or hide the Contact's Position.
  • Email. (Show/Hide) Show or hide the Email.
  • Add Mailto: Link. Adds a mailto: link to the displayed email address.
  • Street Address. (Show/Hide) Show or hide the Street Address.
  • City or Suburb. (Show/Hide) Show or hide the City or Suburb.
  • State or County. (Show/Hide) Show or hide the State or County.
  • Postal/ZIP Code. (Show/Hide) Show or hide the Postal/ZIP Code.
  • Country. (Show/Hide) Show or hide the Country.
  • Telephone. (Show/Hide) Show or hide the Telephone.
  • Mobile Phone. (Show/Hide) Show or hide the Mobile Phone.
  • Fax. (Show/Hide) Show or hide the Fax.
  • Webpage. (Show/Hide) Show or hide the Webpage.
  • Image. (Show/Hide) Show or hide the Image.
  • Image. Click on Select to select an image to display with this contact in the Frontend.
  • Miscellaneous Information. (Show/Hide) Show or hide miscellaneous information.
  • vCard. (Show/Hide) Show or hide a link to allow export to vCard format.
  • Show User Articles. (Show/Hide) If this contact is mapped to a user, and if this is set to Show, then a list of articles created by this user will show.
  • # Articles to List. (Use Contact Settings/5/.../300/All) Number of articles to list.
  • User Profile. (Show/Hide) If the contact is mapped to a user and this option is set to Show, then the profile of the user will be shown in the contact details.
  • Show User Custom Fields. Show user custom fields which belong to all or only selected field groups.
  • Contact Links. (Show/Hide) Show or hide the contact links.
  • Link [A...E] Label. Labels to override shown link's label.

Icons

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

Help30-Component-Contact-Manager-Options-icons-options-subscreen-en.png
  • Settings. (Icons/Text/None) 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

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

Help30-Component-Contact-Manager-Options-category-options-subscreen-en.png
  • Choose a Layout. (Default) This lets you select the default layout to show when you click on a Category link. If you create an alternative layout, you may select that as the default.
  • Category Title. (Show/Hide) If Show, the Category Title will show as a subheading on the page. The subheading is usually displayed inside the H2 tag.
  • Category Description. (Show/Hide) Show or hide the description of the category.
  • Category Image. (Show/Hide) Show or hide the image of the category.
  • Subcategory Levels. (None/All/1-5) The number of subcategory levels to display. Select 'All' to show all levels in the subcategory hierarchy.
  • Subcategories Descriptions. (Show/Hide) Show or hide the subcategories descriptions.
  • Empty Categories. (Show/Hide) Show or hide categories that contain no contacts and no subcategories.
  • # Contacts in Category. (Show/Hide) Show or hide the number of contacts in each category.
  • Category Tags. (Show/Hide) Show or hide the tags for the category.

Categories

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

Help30-Component-Contact-Manager-Options-categories-options-subscreen-en.png
  • Top Level Category Description. (Show/Hide) Show description of the top level category or alternatively replace with the text from the description field found in the menu item. If using Root as a top level category, the description field has to be filled.
  • Subcategory Levels. (None/All/1-5) The number of subcategory levels to display. Select 'All' to show all levels in the subcategory hierarchy.
  • Subcategories Descriptions. (Show/Hide) Show or hide the subcategories descriptions.
  • Empty Categories. (Show/Hide) Show or hide categories that contain no contacts and no subcategories.
  • # Contacts in Category. (Show/Hide) Show or hide the number of contacts in each category.

List Layouts

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

Help30-Component-Contact-Manager-Options-list-options-subscreen-en.png
  • Filter Field. (Show/Hide) The Filter Field creates a text field where a user can enter a field to be used to filter the contacts shown in the list.
  • Display Select. (Show/Hide) Show or hide the Display # control that allows the user to select the number of contacts to show in the list.
  • Table Headings. (Show/Hide) If set to Show, this heading will show above the list. If set to Hide, the list will show with no headings.
  • Image. (Show/Hide) Show or hide an Image column in the list of Contacts.
  • Position. (Show/Hide) Show or hide an Position column in the list of Contacts.
  • Email. (Show/Hide) Show or hide an Email column in the list of Contacts.
  • Phone. (Show/Hide) Show or hide an Phone column in the list of Contacts.
  • Mobile. (Show/Hide) Show or hide an Mobile column in the list of Contacts.
  • Fax. (Show/Hide) Show or hide an Fax column in the list of Contacts.
  • City or Suburb. (Show/Hide) Show or hide an City or Suburb column in the list of Contacts.
  • State or County. (Show/Hide) Show or hide an State or County column in the list of Contacts.
  • Country. (Show/Hide) Show or hide an Country column in the list of Contacts.
  • Pagination. Show or hide 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 listed contacts will not fit on one page.
    • Auto: Pagination links shown if needed.
    • Show: Pagination links shown if needed.
    • Hide: Pagination links not shown. Note: In this case, Users will not be able to navigate to additional pages.
  • Pagination Results. (Show/Hide) Show or hide the current page number and total pages (e.g., "Page 1 of 2") at the bottom of each page.
  • Sort By. (Name/Sort Name/Ordering) Choose the field or fields by which contacts will be sorted.

Form

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

Help30-Component-Contact-Manager-Options-form-options-subscreen-en.png
  • Allow Captcha on Contact. (Use Global (- None Selected -)/- None Selected -). Select the captcha plugin that will be used in the contact form. Captcha is the name of a technique to prevent spam user registrations by requiring a user to type in characters from a distorted image or to mark 'I'am not a robot'. You may need to enter further information for your captcha plugin in the Plugin Manager.
  • Contact Form. (Show/Hide) Show or hide the contact form. If Show is selected, a form is displayed that allows the user to send an e-mail to the Contact from the web site.
  • Send Copy to Submitter. (Show/Hide) 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. (Yes/No) Check for the existence of session cookie. Users without cookies enabled will not be able to send emails.
  • Custom Reply. (Yes/No) Turn on or off the custom message reply to contact form's submitter.
  • Contact Redirect. Enter an alternative URL, where the user will be redirected after mail is send.

Integration

These settings determine how the Contact Component will integrate with other extensions.

Help30-Component-Contact-Manager-Options-integration-options-subscreen-en.png
News Feeds
  • Show Feed Link. (Show/Hide) Show or hide an RSS Feed Link. A Feed Link will show up as a feed icon in the address bar of most browsers.
Routing
  • URL Routing. This is configured for the Contacts component.
    • Legacy: Ensures full comptability for existing sites.
    • Modern: Enables advanced features but may change your URLs.
Custom Fields
  • Enable Custom Fields. (Yes/No) Enable the creation of custom fields.

Permissions

Manage the permission settings for user groups.

Help30-Component-Contact-Manager-Options-permissions-options-subscreen-en.png

To change the permissions for contacts, do the following.

1. Select the Group by clicking its title located on the left.
2. Find the desired Action. Possible Actions are:
  • Configure ACL & Options. Users can edit the options and permissions of contacts.
  • Configure Options Only. Users can edit the options except the permissions of contacts.
  • Access Administration Interface. Users can access user administration interface of contacts.
  • Create. Users can create content of contacts.
  • Delete. Users can delete content of contacts.
  • Edit. Users can edit content of this extension.
  • Edit State. Users can change the published state and related information for content of contacts.
  • Edit Own. Users can edit own created content of contacts.
  • Edit Custom Field Value. Allows users in the group to edit any value of custom fields submitted in contacts.
3. Select the desired Permission for the action you wish to change. Possible settings are:
  • Inherited: Inherited for users in this Group from the Global Configuration permissions of this site.
  • Allowed: Allowed for users in this Group. Note that, if this action is Denied at one of the higher levels, the Allowed permission here will not take effect. A Denied setting cannot be overridden.
  • Denied: Denied for users in this Group.
4. Click Save in Toolbar at top. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.

Toolbar

At the top left you will see the toolbar.

Help30-Save-SaveClose-Cancel-Help-toolbar-en.png

The functions are:

  • Save. Saves the Contact options and stays in the current screen.
  • Save & Close. Saves the Contact options 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

  • If you are a beginning user, you can just keep the default values here until you learn more about using global options.
  • If you are an advanced user, you can save time by creating good default values here. When you set up menu items and create contacts, you will be able to accept the default values for most options.
  • All values set here can be overridden at the menu item, category, or contact level.

Related Information

  • For more information about Joomla's Access Control List system: ACL Tutorial

Help Screens

Component Description
Contacts

Provides an overview of the Contacts available on a Joomla site. The screen is used to find, add, edit and delete Contacts.

Contacts Edit

This is where you can

  • Add a new Contact.
  • Edit an existing Contact.
Categories

Provides an overview of the Contact Categories available on a Joomla site. The screen is used to find, add, edit and delete Contact Categories.

Categories Edit

This is where you can

  • Add a new Contact Category.
  • Edit an existing Contact Category.
Options (this screen)

Contact Options configuration allows setting of parameters used globally for all contacts.

Menu Items Description
Categories

Used to show a list of all Contact Categories. Categories are shown in a hierarchical list.

Category

Used to show all Contacts belonging to a specific Category in a list layout.

Featured

Used to show all Contacts that have been tagged as Featured.

Single Contact

Used to show one Contact in the Frontend of the site.