Using the sources in the builder
Assigning a source
- Open the page in the YOOtheme builder and select the element that is to show the contacts – a grid for a team, for example.
- In an element with several items (grid, list, slider), select the item and choose the source Contacts under Dynamic Content. The builder then repeats the item for every contact.
- For an element with exactly one contact, choose the source Contact.
- Map the fields of the element to the fields of the contact – title to Name, image to Image, meta to Contacts Position and so on.
Contacts
This source returns several contacts. All filters can be combined; empty filters do not restrict.
| Filter by Categories | Multiple choice of the contact categories. The operator decides whether the selected categories must match or are excluded; below it you choose whether child categories are included, excluded or count alone. |
| Filter by Tags | Multiple choice. "Match one", "match all" or "don't match"; child tags as well. |
| Filter by Featured Contacts | All, featured only or not featured. |
| Filter by User Groups | Only contacts whose linked user belongs to one of the selected groups. |
| Filter by Field | A custom field of the contacts is, is not or contains a value. "Is not" also includes contacts without a value for the field. |
| Start and quantity | How many contacts are skipped and how many are returned at most. Without a limit, at most 500. |
| Order | Name, sort name (e.g. last name – the fields Sort Name 1–3 of the contact, as in Joomla's category view), ordering of the contacts (as in the backend), created, modified, hits, random or a custom field. Plus the direction, Alphanumeric Ordering (numbers by value) and Reverse Results. |
Contact
This source returns exactly one contact: the selected one or the default contact (marked as default in the backend). If a visitor may not see the contact, the element stays empty.
Who sees which contacts
Both sources only show what a visitor would also see on Joomla's contact pages: published contacts in published categories, within their publishing window, in the visitor's access levels and, on multilingual sites, in the current language or "All".
Applies to version 1.0.0.