# Contact Directory at a glance

## What the extension does

Contact Directory makes the contacts of Joomla (component *Contacts*) available as *dynamic content*in the YOOtheme Pro builder. You build team pages, lists of contact persons and location overviews with the builder's elements – grid, cards, slider, list – and connect their fields to the contact data.

On its own, YOOtheme Pro only knows the single contact page. Contact Directory adds what is missing:

- **Source "Contacts":** several contacts, filtered by categories, tags, featured state, custom fields and user groups, sorted by name, last name, ordering, date, hits, custom fields or at random.
- **Source "Contact":** exactly one contact, picked from a list, or the default contact.
- **Templates** for the views *Contact Category* and *Featured Contacts*, with pagination.
- **Additional fields** per contact: links, contact card (vCard), contact form link, sort names, publishing dates.

## Privacy built in

Whatever is **hidden** in a contact or in the options of the contacts – the e-mail address, for example – stays empty in the builder too. This applies to the sources of Contact Directory and also to YOOtheme Pro's own contact page. The details are under *Fields and display options*.

<div class="callout info" id="bkmrk-out-of-the-box%2C-joom">Out of the box, Joomla hides the e-mail address, the vCard and the links of a contact. To show them, switch them on in the options of the contacts or in the single contact.

</div>## What you need

- Joomla 6 and PHP 8.3
- YOOtheme Pro 5 as the active template
- Contacts in Joomla's *Contacts* component

The extension only reads. It creates no tables and changes no contacts.

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

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