Components Contacts Contacts Edit
From Joomla! Documentation
Revision as of 12:10, 13 October 2013 by Dextercowley
Components Help Screens
This screen is accessed from the back-end Joomla! administrator panel. It is used to create or edit contacts in your Joomla! website.
How to Access
Navigate to the Contact Manager. To add a new Contact, press the "New" icon in the toolbar. To edit an existing Contact, click on the Contact's Name or click the Contact's checkbox and then click on the "Edit" icon in the toolbar.
This is where you can add a Contact or edit an existing Contact. Contacts allow you to list people on your web site. They also allow users to send e-mails to those people.
Details and Options
In this section, you can enter information about the Contact, such as name, address, e-mail, and so on. The options allow you to control settings such as what information gets displayed for each Contact.
Here you enter the basic informatin about the contact.
- Name. The full name of the Contact.
- Alias. The internal name of the item, also used in the URL when SEF is activated. Normally, you can leave this blank and Joomla! will fill in a default value. The default value is the Title or Name in lower case and with dashes instead of spaces. You may enter the Alias manually. The Alias should consist of lowercase letters and hyphens (-). No blank spaces or underscores are allowed. Non-Latin characters can be allowed in the alias if you set the Unicode Aliases option to Yes in Global Configuration. If this option is set to No and the title includes non-Latin characters, the Alias will default to the current date and time (for example "2012-12-31-17-54-38").
- Linked User. Select the User, if any, that this Contact is linked to from the drop-down list box. This allows you to link this Contact's information to a registered Joomla! User. If this Contact is not linked to a User, select "-No User-".
- Miscellaneous Information. Other information about this Contact. No HTML is allowed in this field.
- Category. The Category this item belongs to.
- Tags. Enter one or more optional tags for this item. You can select existing tags by entering in the first few letters. You may also create new tags by entering them here. Tags allow you to see lists of related items across content types (for example, articles, contacts, and categories).
- Status: Published status of the item. Possible values are:
- Published: The item is published. This is the only state that will allow regular website users to view this item.
- Unpublished: The item is unpublished.
- Archived: The item has been archived.
- Trashed: The item has been sent to the Trash.
- Featured. If marked yes, the item will be displayed in featured view.
- Access. The viewing level access for this item.
- Language. Item language.
- Version Note. Optional field to identify this version of the item in the item's Version History window.
- Start Publishing. Date and time to start publishing. Use this field if you want to enter content ahead of time and then have it published automatically at a future time.
- Finish Publishing. Date and time to finish publishing. Use this field if you want to have content automatically changed to Unpublished state at a future time (for example, when it is no longer applicable).
- Created Date. This field defaults to the current time when the Article was created. You can enter in a different date and time or click on the calendar icon to find the desired date.
- Created by. Name of the Joomla! User who created this item. This will default to the currently logged-in user. If you want to change this to a different user, click the Select User button to select a different user.
- Created By Alias. This optional field allows you to enter in an alias for this Author for this Article. This allows you to display a different Author name for this Article.
- Modified Date. (Informative only) Date of last modification.
- Modified By. (Informative only) Username who performed the last modification.
- Revision. (Informative only) Number of revisions to this item.
- Hits. The number of times an item has been viewed.
- ID. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.
- Meta Description. An optional paragraph to be used as the description of the page in the HTML output. This will generally display in the results of search engines. If entered, this creates an HTML meta element with a name attribute of "description" and a content attribute equal to the entered text.
- Meta Keywords. Optional entry for keywords. Must be entered separated by commas (for example, "cats, dogs, pets") and may be entered in upper or lower case. (For example, "CATS" will match "cats" or "Cats"). Keywords can be used in several ways:
- To help Search Engines and other systems classify the content of the Article.
- In combination with Banner tags, to display specific Banners based on the Article content. For example, say you have one Banner with an ad for dog products and another Banner for cat products. You can have your dog Banner display when a User is viewing a dog-related Article and your cat Banner display for a cat-related Article. To do this, you would:
- For articles only, in combination with the Related Articles module, to display Articles that share at least one keyword in common. For example, if the current Article displayed has the keywords "cats, dogs, monkeys", any other Articles with at least one of these keywords will show in the Related Articles module.
- Robots. The instructions for web "robots" that browse to this page.
- Use Global: Use the value set in the Component→Options for this component.
- Index, Follow: Index this page and follow the links on this page.
- No index, Follow: Do not index this page, but still follow the links on the page. For example, you might do this for a site map page where you want the links to be indexed but you don't want this page to show in search engines.
- Index, No follow: Index this page, but do not follow any links on the page. For example, you might want to do this for an events calendar, where you want the page to show in search engines but you do not want to index each event.
- No index, no follow: Do not index this page or follow any links on the page.
- Content Rights. Describe what rights others have to use this content.
- Image. Image to display for this Contact. Select an image file from the drop-down list box. This lists images in the 'images/stories' folder. Images can be uploaded using the Media Manager.
- Position: The Contact's current position.
- E-mail. The Contact's e-mail address. Note that e-mail addresses in Joomla! can be protected from "spambots" by enabling "Content-Email Cloaking" in the Plug-in Manager. This is enabled by default.
- Address. The Contact's street address.
- City or Suburb. The Contact's town or suburb.
- State or Province. The Contact's state or county.
- Postal / ZIP Code. The Contact's postal code.
- Country. The Contact's country.
- Telephone. The Contact's phone number.
- Mobile. The Contact's mobile phone number.
- Fax. The Contact's fax number.
- Website. The Contact's web site address.
- First Sort Field. The part of the name to use as the first sort field.
- Second Sort Field. The part of the name to use as the second sort field.
- Third Sort Field. The part of the name to use as the third sort field.
- Show Category. Show or hide the Contact's category.
- Show Contact List. Show or hide the Contact list.
- Display format. Determines the style used to display sections of the contact form.
- Show Tags. Whether to hide or show any tags for this item.
- Name. Hide or Show the Contact's Name.
- Contact's Position. Hide or Show the Contact's Position.
- E-mail. Hide or Show the Contact's e-mail address.
- Street Address. Hide or Show the Contact's street address.
- City or Suburb. Hide or Show the Contact's town or suburb.
- State or County. Hide or Show the Contact's state or county.
- Postal Code. Hide or Show the Contact's postal code.
- Country. Hide or Show the Contact's country.
- Telephone. Hide or Show the Contact's telephone number.
- Mobile phone. Hide or Show the Contact's mobile phone number.
- Fax. Hide or Show the Contact's fax number.
- Webpage. Hide or Show the Contact's web site URL.
- Misc. Information. Hide or Show any miscellaneous information entered for this Contact.
- Image. Hide or Show the Contact's image.
- vCard. Hide or Show the vCard 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. 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.
- Show Profile. If this contact is mapped to a user, and if this is set to Show, then the profile of this user will show.
- Show Links. Show or hide the links.
- Link A Label. Label for an additional link for this contact.
- Link A URL. The additional link URL for this contact.
- Link B Label. Label for an additional link for this contact.
- Link B URL. The additional link URL for this contact.
- Link C Label. Label for an additional link for this contact.
- Link C URL. The additional link URL for this contact.
- Link D Label. Label for an additional link for this contact.
- Link D URL. The additional link URL for this contact.
- Link E Label. Label for an additional link for this contact.
- Link E URL. The additional link URL for this contact.
- Alternative Layout. Use a different layout from the supplied component view or overrides in the templates.
- Show Contact Form. Hide or Show the E-mail 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. Hide or Show the checkbox: 'E-mail a copy of this message to your own address.'
- Banned Email. Enter any e-mails to be banned from the site. E-mail addresses containing any of the listed text will be banned. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail addresses such as "myspam@.com" or "firstname.lastname@example.org".
- Banned Subject. Enter any e-mail subject words to be banned from the site. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail subjects such as "This is not spam" or "I Like Junk".
- Banned Text. Enter any e-mail text words to be banned from the site. Separate different words with semi-colons ';'. For example, the entry "spam;junk" would ban e-mail content such as "This is not spam" or "I Like Junk".
- Session Check. Check for the existence of session cookie. This means that users without cookies enabled will not be able to send emails.
- Custom Reply. 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.
At the top left you will see the toolbar:
The functions are:
- Save. Saves the contact and stays in the current screen.</translate>
- Save & Close. Saves the contact and closes the current screen.</translate>
- Save & New. Saves the contact and keeps the editing screen open and ready to create another contact.</translate>
- Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.</translate>
- Help. Opens this help screen.</translate>
- At least one Contact Category must be added before adding the first Contact.