Fields and display options
Fields of a contact
The sources return YOOtheme Pro's contact type. Every field YOOtheme offers there is available – name, image, e-mail, contacts position, address (street, city, state, postcode, country), telephone, mobile, fax, website, miscellaneous information, created, modified, category, user, tags, link, articles, hits, alias, ID – as are the custom fields of the contacts. Contact Directory adds:
| Featured | Yes or no – for a condition in the builder, for example. |
| Sort Name 1–3 | The sort names of the contact. |
| Start / Finish Publishing | With the builder's date filter. |
| Meta Description | The meta description of the contact. |
| Links | The up to five links of the contact (tab Links) with name and address. Without a name, the address stands for itself. |
| vCard Download | The address of the contact card Joomla creates. Only with Allow vCard. |
| Contact Form Link | Jumps to the form on the contact page. Only with Show Contact Form and an e-mail address or a linked user. |
Contact Directory loads the articles of the linked user only for contacts with Show User Articles, and as many as set there.
Display options
Whether a detail appears is decided by the display options – exactly as on Joomla's contact page:
- The setting in the contact (tab Display) comes first.
- If it is set to Use Global, the setting under Contacts → Options → Contact applies.
| Field | Option |
|---|---|
| Contacts Position | Position |
| Street, city, state, postcode, country | the options of the same name |
| Telephone, mobile, fax, website | the options of the same name |
| Miscellaneous Information | Miscellaneous Information |
| Image | Image |
| Tags | Tags |
| Articles | Show User Articles |
| Links | Show Links |
| vCard Download | Allow vCard |
| Contact Form Link | Show Contact Form |
This applies to the sources Contacts and Contact, to the templates of Contact Directory and to YOOtheme Pro's template Single Contact. If a detail is hidden, the field stays empty; YOOtheme hides empty fields.
Out of the box, Joomla hides the e-mail, the vCard and the links. If an e-mail address does not appear, it is almost always hidden there.
Joomla's plugin Content - Email Cloaking still protects e-mail addresses when it is enabled.
The plugin option Respect Display Options switches this rule off as a whole. Then every detail of every contact appears.
Applies to version 1.0.0.