# 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:

<table id="bkmrk-featuredyes-or-no-%E2%80%93-"> <tbody> <tr><td>**Featured**</td><td>Yes or no – for a condition in the builder, for example.</td></tr> <tr><td>**Sort Name 1–3**</td><td>The sort names of the contact.</td></tr> <tr><td>**Start / Finish Publishing**</td><td>With the builder's date filter.</td></tr> <tr><td>**Meta Description**</td><td>The meta description of the contact.</td></tr> <tr><td>**Links**</td><td>The up to five links of the contact (tab *Links*) with name and address. Without a name, the address stands for itself.</td></tr> <tr><td>**vCard Download**</td><td>The address of the contact card Joomla creates. Only with *Allow vCard*.</td></tr> <tr><td>**Contact Form Link**</td><td>Jumps to the form on the contact page. Only with *Show Contact Form* and an e-mail address or a linked user.</td></tr> </tbody></table>

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:

1. The setting in the contact (tab *Display*) comes first.
2. If it is set to *Use Global*, the setting under *Contacts → Options → Contact* applies.

<table id="bkmrk-fieldoption-e-mailem"> <thead><tr><th>Field</th><th>Option</th></tr></thead> <tbody> <tr><td>E-mail</td><td>Email</td></tr> <tr><td>Contacts Position</td><td>Position</td></tr> <tr><td>Street, city, state, postcode, country</td><td>the options of the same name</td></tr> <tr><td>Telephone, mobile, fax, website</td><td>the options of the same name</td></tr> <tr><td>Miscellaneous Information</td><td>Miscellaneous Information</td></tr> <tr><td>Image</td><td>Image</td></tr> <tr><td>Tags</td><td>Tags</td></tr> <tr><td>Articles</td><td>Show User Articles</td></tr> <tr><td>Links</td><td>Show Links</td></tr> <tr><td>vCard Download</td><td>Allow vCard</td></tr> <tr><td>Contact Form Link</td><td>Show Contact Form</td></tr> </tbody></table>

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.

<div class="callout warning" id="bkmrk-out-of-the-box%2C-joom">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.

</div>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.

<small>Applies to version 1.0.0.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/474)