# Contact Directory

Bringt die Joomla-Kontakte als dynamische Inhaltsquelle in den YOOtheme-Pro-Seitenersteller · Version 1.0.0 · Stand 21.11.2026

[English version](https://docs.graup-it.de/books/contact-directory-en)

# Contact Directory im Überblick

## Was die Erweiterung macht

Contact Directory macht die Kontakte von Joomla (Komponente *Kontakte*) im YOOtheme-Pro-Builder als *dynamischen Inhalt* verfügbar. Sie bauen Team-Seiten, Ansprechpartner-Listen und Standort-Übersichten mit den Elementen des Builders – Raster, Karten, Slider, Listen – und verbinden deren Felder mit den Kontaktdaten.

YOOtheme Pro kennt von sich aus nur die einzelne Kontaktseite. Contact Directory ergänzt, was dort fehlt:

- **Quelle „Kontakte“:** mehrere Kontakte, gefiltert nach Kategorien, Schlagwörtern, Hervorhebung, eigenen Feldern und Benutzergruppen, sortiert nach Name, Nachname, Reihenfolge, Datum, Aufrufen, eigenen Feldern oder zufällig.
- **Quelle „Kontakt“:** genau ein Kontakt, ausgewählt aus einer Liste, oder der Standardkontakt.
- **Vorlagen** für die Ansichten *Kontaktkategorie* und *Hervorgehobene Kontakte*, mit Seitennummerierung.
- **Zusätzliche Felder** je Kontakt: Links, Visitenkarte (vCard), Link zum Kontaktformular, Sortiernamen, Veröffentlichungsdaten.

## Datenschutz eingebaut

Was an einem Kontakt oder in den Optionen der Kontakte **verborgen** ist – etwa die E-Mail-Adresse –, bleibt auch im Builder leer. Das gilt für die Quellen von Contact Directory und ebenso für die Kontaktseite von YOOtheme Pro selbst. Die Einzelheiten stehen unter *Felder und Anzeigeoptionen*.

<div class="callout info" id="bkmrk-joomla-verbirgt-ab-w">Joomla verbirgt ab Werk die E-Mail-Adresse, die Visitenkarte und die Links eines Kontakts. Wer sie zeigen möchte, schaltet sie in den Optionen der Kontakte oder am einzelnen Kontakt frei.

</div>## Was Sie dafür brauchen

- Joomla 6 und PHP 8.3
- YOOtheme Pro 5 als aktives Template
- Kontakte in der Komponente *Kontakte* von Joomla

Die Erweiterung liest nur. Sie legt keine Tabellen an und verändert keine Kontakte.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/482)

# Voraussetzungen und Installation

## Voraussetzungen

- Joomla 6.x
- PHP 8.3 oder neuer
- YOOtheme Pro 5 als Template der Website

## Installieren

1. Öffnen Sie im Backend *System → Installieren → Erweiterungen*.
2. Ziehen Sie das Paket `plg_system_ytp_contacts-….zip` in das Feld oder wählen Sie es aus.
3. Fertig: Bei der Erstinstallation schaltet sich das Plugin selbst ein. Seine Einstellungen finden Sie unter *System → Verwalten → Plugins*, *System - Contact Directory*. Ein Update schaltet ein Plugin, das Sie ausgeschaltet haben, nicht wieder ein.

Danach erscheinen im YOOtheme-Builder unter *Dynamischer Inhalt* in der Gruppe *Kontakte* die Quellen *Kontakte* und *Kontakt*, und unter *Vorlagen* die Typen *Kontaktkategorie* und *Hervorgehobene Kontakte*.

## Einstellungen des Plugins

<table id="bkmrk-anzeigeoptionen-beac"> <tbody> <tr><td>**Anzeigeoptionen beachten**</td><td>Angaben, die am Kontakt oder in den Optionen der Kontakte verborgen sind, bleiben im Builder leer – auch auf der Kontaktseite. Vorgabe: an. Nur ausschalten, wenn alle Angaben aller Kontakte gezeigt werden dürfen.</td></tr> </tbody></table>

## Aktualisieren und entfernen

Eine neue Version installieren Sie über die alte; Ihre Layouts und Vorlagen bleiben erhalten. Wird das Plugin deaktiviert oder deinstalliert, bleiben Elemente mit einer Quelle von Contact Directory leer – YOOtheme blendet sie dann aus.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/483)

# Die Quellen im Builder verwenden

## Eine Quelle zuweisen

1. Öffnen Sie die Seite im YOOtheme-Builder und wählen Sie das Element, das die Kontakte zeigen soll – etwa ein Raster für ein Team.
2. Wählen Sie bei einem Element mit mehreren Einträgen (Raster, Liste, Slider) den **Eintrag** (*Item*) und dort unter *Dynamischer Inhalt* die Quelle *Kontakte*. Der Builder wiederholt den Eintrag dann für jeden Kontakt.
3. Für ein Element mit genau einem Kontakt wählen Sie die Quelle *Kontakt*.
4. Ordnen Sie den Feldern des Elements die Felder des Kontakts zu – Titel auf *Name*, Bild auf *Bild*, Meta auf *Kontaktposition* und so weiter.

## Kontakte

Diese Quelle liefert mehrere Kontakte. Alle Filter lassen sich kombinieren; leere Filter schränken nicht ein.

<table id="bkmrk-nach-kategorien-filt"> <tbody> <tr><td>**Nach Kategorien filtern**</td><td>Mehrfachauswahl aus den Kontaktkategorien. Der Operator legt fest, ob die gewählten Kategorien zutreffen oder ausgeschlossen werden; darunter wählen Sie, ob Unterkategorien dazugehören, nicht dazugehören oder allein zählen.</td></tr> <tr><td>**Nach Schlagwörtern filtern**</td><td>Mehrfachauswahl. „Eines davon“, „alle“ oder „keines“; auch mit Unter-Schlagwörtern.</td></tr> <tr><td>**Nach hervorgehobenen Kontakten filtern**</td><td>Alle, nur hervorgehobene oder nur nicht hervorgehobene.</td></tr> <tr><td>**Nach Benutzergruppen filtern**</td><td>Nur Kontakte, deren verknüpfter Benutzer zu einer der gewählten Gruppen gehört.</td></tr> <tr><td>**Nach Feld filtern**</td><td>Ein eigenes Feld der Kontakte *ist*, *ist nicht* oder *enthält* einen Wert. „ist nicht“ schließt auch Kontakte ohne Wert in diesem Feld ein.</td></tr> <tr><td>**Start und Anzahl**</td><td>Wie viele Kontakte übersprungen und wie viele höchstens geliefert werden. Ohne Begrenzung sind es höchstens 500.</td></tr> <tr><td>**Sortierung**</td><td>Name, Sortiername (z. B. Nachname – die Felder *Sortiername 1–3* des Kontakts, wie in der Kategorieansicht von Joomla), Reihenfolge der Kontakte (wie im Backend), Erstellt, Geändert, Aufrufe, Zufall oder ein eigenes Feld. Dazu die Richtung, *Alphanumerische Sortierung* (Zahlen nach ihrem Wert) und *Ergebnis umkehren*.</td></tr> </tbody></table>

## Kontakt

Diese Quelle liefert genau einen Kontakt: den gewählten oder den *Standardkontakt* (im Backend am Kontakt als Standard markiert). Darf ein Besucher den Kontakt nicht sehen, bleibt das Element leer.

## Wer welche Kontakte sieht

Beide Quellen zeigen nur, was ein Besucher auch auf den Kontaktseiten von Joomla sehen würde: veröffentlichte Kontakte in veröffentlichten Kategorien, im Veröffentlichungszeitraum, in seinen Zugriffsebenen und auf mehrsprachigen Websites in der aktuellen Sprache oder „Alle“.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/484)

# Felder und Anzeigeoptionen

## Felder eines Kontakts

Die Quellen liefern den Kontakt-Typ von YOOtheme Pro. Alle Felder, die YOOtheme dort anbietet, stehen also zur Verfügung – Name, Bild, E-Mail, Kontaktposition, Anschrift (Straße, Ort, Bundesland, Postleitzahl, Land), Telefon, Mobil, Fax, Website, Sonstige Informationen, Erstellt, Geändert, Kategorie, Benutzer, Schlagwörter, Link, Artikel, Aufrufe, Alias, ID – ebenso die **eigenen Felder** der Kontakte. Contact Directory ergänzt:

<table id="bkmrk-hervorgehobenja-oder"> <tbody> <tr><td>**Hervorgehoben**</td><td>Ja oder nein – zum Beispiel für eine Bedingung im Builder.</td></tr> <tr><td>**Sortiername 1–3**</td><td>Die Sortiernamen des Kontakts.</td></tr> <tr><td>**Veröffentlichung starten / beenden**</td><td>Mit dem Datumsfilter des Builders.</td></tr> <tr><td>**Meta-Beschreibung**</td><td>Die Meta-Beschreibung des Kontakts.</td></tr> <tr><td>**Links**</td><td>Die bis zu fünf Links des Kontakts (Reiter *Links*) mit Name und Adresse. Ohne Namen steht die Adresse für sich.</td></tr> <tr><td>**vCard-Download**</td><td>Die Adresse der Visitenkarte, die Joomla erzeugt. Nur mit *vCard erlauben*.</td></tr> <tr><td>**Link zum Kontaktformular**</td><td>Springt zum Formular auf der Kontaktseite. Nur mit *Kontaktformular anzeigen* und einer E-Mail-Adresse oder einem verknüpften Benutzer.</td></tr> </tbody></table>

Die *Artikel* des verknüpften Benutzers lädt Contact Directory nur für Kontakte mit *Benutzerartikel anzeigen*, und so viele, wie dort eingestellt sind.

## Anzeigeoptionen

Ob eine Angabe erscheint, entscheiden die Anzeigeoptionen – genau wie auf der Kontaktseite von Joomla:

1. Zuerst gilt die Einstellung am Kontakt (Reiter *Anzeige*).
2. Steht sie dort auf *Globale Einstellung verwenden*, gilt die Einstellung unter *Kontakte → Optionen → Kontakt*.

<table id="bkmrk-feldoption-e-maile-m"> <thead><tr><th>Feld</th><th>Option</th></tr></thead> <tbody> <tr><td>E-Mail</td><td>E-Mail</td></tr> <tr><td>Kontaktposition</td><td>Position</td></tr> <tr><td>Straße, Ort, Bundesland, Postleitzahl, Land</td><td>die gleichnamigen Optionen</td></tr> <tr><td>Telefon, Mobil, Fax, Website</td><td>die gleichnamigen Optionen</td></tr> <tr><td>Sonstige Informationen</td><td>Sonstige Informationen</td></tr> <tr><td>Bild</td><td>Bild</td></tr> <tr><td>Schlagwörter</td><td>Schlagwörter</td></tr> <tr><td>Artikel</td><td>Benutzerartikel anzeigen</td></tr> <tr><td>Links</td><td>Links anzeigen</td></tr> <tr><td>vCard-Download</td><td>vCard erlauben</td></tr> <tr><td>Link zum Kontaktformular</td><td>Kontaktformular anzeigen</td></tr> </tbody></table>

Das gilt für die Quellen *Kontakte* und *Kontakt*, für die Vorlagen von Contact Directory und für die Vorlage *Einzelner Kontakt* von YOOtheme Pro. Ist eine Angabe verborgen, bleibt das Feld leer; YOOtheme blendet leere Felder aus.

<div class="callout warning" id="bkmrk-joomla-verbirgt-ab-w">Joomla verbirgt ab Werk die **E-Mail**, die **vCard** und die **Links**. Erscheint eine E-Mail-Adresse nicht, ist sie fast immer dort verborgen.

</div>E-Mail-Adressen verschleiert Joomla's Plugin *Inhalt - E-Mail-Verschleierung* weiterhin, wenn es aktiv ist.

Die Plugin-Option *Anzeigeoptionen beachten* schaltet diese Regel als Ganzes ab. Dann erscheinen alle Angaben aller Kontakte.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/485)

# Vorlagen für Kontaktseiten

## Vorlagen für Kontaktseiten

Mit Vorlagen gestalten Sie im YOOtheme-Builder ganze Seiten einer Komponente. Contact Directory fügt zwei Typen hinzu:

<table id="bkmrk-kontaktkategoriedie-"> <tbody> <tr><td>**Kontaktkategorie**</td><td>Die Ansicht einer Kontaktkategorie (Menüeintrag *Kontakte → Kategorie auflisten*). Bedingungen: Kategorien – mit oder nur mit Unterkategorien –, Seitenzahl, Sprache.</td></tr> <tr><td>**Hervorgehobene Kontakte**</td><td>Die Ansicht der hervorgehobenen Kontakte (Menüeintrag *Kontakte → Hervorgehobene Kontakte*). Bedingungen: Seitenzahl, Sprache.</td></tr> </tbody></table>

Die Vorlage für die einzelne Kontaktseite (*Einzelner Kontakt*) bringt YOOtheme Pro selbst mit.

## Eine Vorlage anlegen

1. Öffnen Sie im YOOtheme-Customizer *Builder → Vorlagen* und legen Sie eine Vorlage an.
2. Wählen Sie als Typ *Kontaktkategorie* oder *Hervorgehobene Kontakte* und setzen Sie bei Bedarf die Bedingungen.
3. Bauen Sie das Layout. Unter *Dynamischer Inhalt* stehen in der Gruppe *Seite* zur Verfügung:

<table id="bkmrk-kontaktkategorietite"> <tbody> <tr><td>**Kontaktkategorie**</td><td>Titel, Beschreibung, Bild und weitere Felder der Kategorie (nur Vorlage *Kontaktkategorie*).</td></tr> <tr><td>**Unterkategorien der Kontakte**</td><td>Die Unterkategorien (nur Vorlage *Kontaktkategorie*).</td></tr> <tr><td>**Kontakte der Seite**</td><td>Die Kontakte dieser Seite – in der Reihenfolge und Seitengröße, die der Menüeintrag festlegt. Start und Anzahl wählen einen Ausschnitt.</td></tr> </tbody></table>

Für die Seitennummerierung setzen Sie das Element *Seitennummerierung* von YOOtheme ins Layout.

Auch hier gelten die Anzeigeoptionen und die Sichtbarkeit wie bei den Quellen.

## Link einer Kontaktkategorie

Das Feld *Link* einer Kontaktkategorie führt zur Kategorieansicht der Kontakte – auch beim Feld *Kategorie* eines Kontakts. Ohne Contact Directory führt YOOtheme Pro hier zu einer Beitragskategorie.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/486)

# Häufige Fragen und Fehlerbehebung

## Die Quellen erscheinen nicht im Builder

Ist das Plugin *System - Contact Directory* aktiviert? Ist YOOtheme Pro das Template der Website? Nach dem Aktivieren den Customizer einmal neu laden.

## Das Element bleibt leer

- Passt ein Kontakt zu allen Filtern? Leeren Sie die Filter probeweise.
- Ist der Kontakt veröffentlicht, ist seine Kategorie veröffentlicht, läuft sein Veröffentlichungszeitraum?
- Darf der Besucher ihn sehen (Zugriffsebene)? Im Builder sehen Sie als Administrator mehr als ein Gast.
- Auf einer mehrsprachigen Website: Hat der Kontakt die Sprache der Seite oder „Alle“?
- Quelle *Kontakt* mit *Standardkontakt*: Ist ein Kontakt als Standard markiert?

## Die E-Mail-Adresse (oder vCard, Links) fehlt

Joomla verbirgt sie ab Werk. Schalten Sie die Angabe unter *Kontakte → Optionen → Kontakt* oder am Kontakt (Reiter *Anzeige*) frei. Siehe *Felder und Anzeigeoptionen*.

## Die E-Mail-Adresse steht verschlüsselt im Quelltext

Das ist Joomla's Schutz gegen Adresssammler (Plugin *Inhalt - E-Mail-Verschleierung*). Im Browser erscheint die Adresse normal.

## Es erscheinen höchstens 500 Kontakte

Das ist die Obergrenze je Liste, auch bei *ohne Begrenzung*. Für sehr große Verzeichnisse nutzen Sie die Vorlage *Kontaktkategorie* mit Seitennummerierung.

## Die Auswahllisten für Felder und Benutzergruppen sind leer

Sie werden nur im Builder gefüllt. Gibt es noch keine eigenen Felder für Kontakte, bleibt die Liste leer.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/487)

# Verknüpfte Quellen (Pro)

<div class="callout info maillog-vollversion" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktionen gehören zur Pro-Version von Contact Directory. Die Free-Version bietet die Quellen *Kontakte* und *Kontakt*, die Vorlagen und die Anzeigeoptionen.

</div>## Kontakte über eine Verbindung finden

Die Pro-Version hängt Kontakte an andere Inhalte. Sie wählen die Verbindung im Builder dort, wo der Inhalt schon Quelle ist – etwa unter dem Feld eines Beitrags, eines Schlagworts oder eines Kontakts:

<table id="bkmrk-beitrag-%E2%86%92-kontakt-de"> <tbody> <tr><td>**Beitrag → Kontakt des Autors**</td><td>Der Kontakt, dessen verknüpfter Benutzer den Beitrag geschrieben hat. Für einen Ansprechpartner-Kasten unter jedem Beitrag – auch in Beitragslisten.</td></tr> <tr><td>**Kontakt → Weitere Kontakte der Kategorie**</td><td>Die anderen Kontakte derselben Kategorie, ohne den Kontakt selbst. Mit Anzahl und Sortierung – etwa „Weitere Ansprechpartner im Team“ auf der Kontaktseite.</td></tr> <tr><td>**Schlagwort → Kontakte mit diesem Schlagwort**</td><td>Die Kontakte, die das Schlagwort tragen – etwa auf der Schlagwortseite „Vertrieb“. Mit Anzahl und Sortierung.</td></tr> <tr><td>**Benutzer → Kontakt**</td><td>Der Kontakt, der mit dem Benutzer verknüpft ist.</td></tr> </tbody></table>

## Kontakt des angemeldeten Benutzers

Die Quelle *Kontakt des angemeldeten Benutzers* (Gruppe *Kontakte*) liefert den Kontakt des Besuchers, der gerade angemeldet ist – etwa für einen Bereich „Mein Profil“. Für Gäste bleibt das Element leer.

## Was gilt

Auch die Verbindungen zeigen nur sichtbare Kontakte (veröffentlicht, Zugriff, Zeitraum, Sprache) und beachten die Anzeigeoptionen. Hat ein Benutzer mehrere Kontakte, gilt wie bei Joomla der neueste.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/488)

# Kontakte auf einer Karte (Pro)

<div class="callout info maillog-vollversion" id="bkmrk-pro-version.-koordin">**Pro-Version.** Koordinaten und Geokodierung gehören zur Pro-Version von Contact Directory.

</div>## Kontakte auf einer Karte

Die Pro-Version gibt jedem Kontakt das Feld *Koordinaten* („Breite, Länge“). Damit zeigt das Element *Karte* von YOOtheme Ihre Kontakte als Marker:

1. Setzen Sie das Element *Karte* auf die Seite.
2. Wählen Sie den **Eintrag** der Karte und darunter die Quelle *Kontakte* mit den gewünschten Filtern.
3. Verbinden Sie *Standort* mit *Koordinaten* und *Titel* mit *Name*.

Kontakte ohne Koordinaten erscheinen nicht auf der Karte.

## Woher die Koordinaten kommen

<table id="bkmrk-von-handlegen-sie-f%C3%BC"> <tbody> <tr><td>**Von Hand**</td><td>Legen Sie für Kontakte ein eigenes Feld an (z. B. „Koordinaten“), tragen Sie dort „Breite, Länge“ ein (etwa <code>48&#46;1374&#44; 11&#46;5755</code>) und wählen Sie das Feld in den Plugin-Optionen unter *Pro-Version → Feld mit Koordinaten*. Diese Angabe hat immer Vorrang.</td></tr> <tr><td>**Automatisch**</td><td>Mit *Pro-Version → Anschriften geokodieren* holt Contact Directory beim Speichern eines Kontakts die Koordinaten zu seiner Anschrift von OpenStreetMap Nominatim. Nur eine geänderte Anschrift wird erneut abgefragt. Vorgabe: aus.</td></tr> </tbody></table>

Für bestehende Kontakte führen Sie nach dem Einschalten einmal auf dem Server aus:

```
php cli/joomla.php ytpcontacts:geocode --limit=100
```

Der Befehl fragt höchstens eine Anschrift je Sekunde ab (Nutzungsregeln von Nominatim) und nimmt nur Kontakte, die noch nie geokodiert wurden. Bei mehr Kontakten führen Sie ihn erneut aus.

## Datenschutz

- Bei der Geokodierung geht die **Anschrift** eines Kontakts an OpenStreetMap Nominatim (OpenStreetMap Foundation). Nennen Sie das in Ihrer Datenschutzerklärung, oder tragen Sie die Koordinaten von Hand ein.
- Ist die Straße eines Kontakts verborgen (Anzeigeoption), bleibt auch das Feld *Koordinaten* leer – sie verraten den Ort sonst genauso.
- Das Element *Karte* von YOOtheme lädt Kartenbilder von OpenStreetMap und fragt dafür die Einwilligung der Besucher ab, wenn Sie die Einwilligungsverwaltung von YOOtheme nutzen.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/489)

# Das Element „Kontakte“ (Pro)

<div class="callout info maillog-vollversion" id="bkmrk-pro-version.-das-ele">**Pro-Version.** Das Element *Kontakte* gehört zur Pro-Version von Contact Directory.

</div>## Das Element „Kontakte“

Die Pro-Version bringt ein eigenes Builder-Element mit. Es zeigt einen oder mehrere Kontakte mit allen Angaben, die ein Joomla-Kontakt hat: Bild, Name, Position, Kategorie, Anschrift, Telefon und Mobilnummer als anwählbare Links, Fax, E-Mail-Adresse (vor Spam-Programmen verschleiert), Website, sonstige Informationen, Schlagwörter, jedes Zusatzfeld einzeln, die Links des Kontakts sowie Schaltflächen für die Visitenkarte und das Kontaktformular.

Sie finden es im Builder unter *Element hinzufügen* in der Gruppe *Graup-IT*.

## Vier Darstellungen

Im Reiter *Inhalt* wählen Sie unter **Layout**, wie die Kontakte erscheinen. Jede Darstellung bringt im Reiter *Einstellungen* nur ihre eigenen Optionen mit; was für einen Kontakt gilt – Bild, Name, Position, Angaben, Links und Schaltflächen –, stellen Sie für alle gleich ein.

<table id="bkmrk-rasterkarten-nebenei"> <tbody> <tr><td>**Raster**</td><td>Karten nebeneinander: Spalten je Bildschirmbreite, Abstände, Trenner, Kartenstil und Innenabstand wie beim Raster von YOOtheme, auf Wunsch mit Filter.</td></tr> <tr><td>**Liste**</td><td>Eine Zeile je Kontakt, das Bild neben dem Text: Listenstil (Trennlinie, gestreift), Größe und Spalten wie bei der Liste von YOOtheme, auf Wunsch mit Filter.</td></tr> <tr><td>**Tabelle**</td><td>Eine Zeile je Kontakt, eine Spalte je Angabe. Stil, Hervorhebung beim Überfahren, Größe, Ausrichtung und das Verhalten auf schmalen Bildschirmen (scrollen oder untereinander) wie bei der Tabelle von YOOtheme. Auf Wunsch mit Suchfeld und Sortieren per Klick auf den Spaltenkopf.</td></tr> <tr><td>**Verzeichnis**</td><td>Kontakte nach Anfangsbuchstabe oder Kategorie gruppiert, mit Sprungleiste. Jede Zeile zeigt Name, Position und die ersten Angaben, der Rest klappt auf.</td></tr> </tbody></table>

![Das Raster: oben der Filter mit Alle und den Kategorien, darunter Karten mit Initialen statt Bild, Name, Position, Telefon, E-Mail, Anschrift, einem Zusatzfeld, den Link-Symbolen und den Schaltflächen für Visitenkarte und Kontaktformular.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-raster.png)

![Die Liste: je Kontakt eine Zeile mit Personen-Symbol statt Bild links, daneben Name, Position und die Angaben, getrennt durch Linien.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-liste.png)

![Die Tabelle: oben das Suchfeld und die Zahl der Kontakte, darunter Spalten für Name, Position, Telefon, E-Mail, Anschrift, je eine Spalte für die Zusatzfelder Raum und Vorstandsamt, Links und Aktionen.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-tabelle.png)

![Das Verzeichnis: oben die Sprungleiste mit den vorhandenen Anfangsbuchstaben, darunter je Buchstabe die Kontakte mit Name, Position, den ersten Angaben und der Schaltfläche Details.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-verzeichnis.png)

### Filter nach Kategorie

Raster und Liste zeigen auf Wunsch über den Kontakten (oder links bzw. rechts daneben) einen Filter mit den Kategorien, wie beim Raster von YOOtheme: *Alle* und je Kategorie ein Reiter. Ein Klick blendet die übrigen Kontakte aus, auch mit der Tastatur. Hat ein Eintrag eine eigene Kategorie, gilt diese statt der des Kontakts.

### Kontakt ohne Bild

Unter *Bild › Ohne Bild* wählen Sie, was bei einem Kontakt ohne Bild erscheint: nichts (Vorgabe), seine Initialen oder ein Personen-Symbol.

## Einzelne Kontakte wählen

1. Setzen Sie das Element *Kontakte* auf die Seite.
2. Öffnen Sie einen **Eintrag** und wählen Sie oben unter *Kontakt* den gewünschten Kontakt.
3. Für weitere Kontakte fügen Sie weitere Einträge hinzu.

Name, Position, Bild und Link brauchen Sie nicht auszufüllen: Bleiben sie leer, kommen Name, Position, Bild und die Kontaktseite vom Kontakt. Was Sie selbst eintragen, hat Vorrang. Ein Eintrag ohne Kontakt zeigt nur, was Sie eintragen.

Im Reiter **Kontakt** des Eintrags stehen Telefon, Mobil, Fax, E-Mail, Anschrift, Website, Kategorie, Sonstiges und Schlagwörter als eigene Felder. Leer gelassen kommt die Angabe vom Kontakt; ein eigener Wert – eingetragen oder mit *Dynamischem Inhalt* verknüpft – ersetzt sie. So zeigen auch Einträge ohne Kontakt diese Angaben, etwa aus Beiträgen oder anderen Quellen. Für eigene Werte gelten die Anzeigeoptionen des Kontakts nicht.

## Mehrere Kontakte aus einer Quelle

1. Öffnen Sie den **Eintrag** und wählen Sie unter *Dynamischer Inhalt* in der Gruppe *Kontakte* die Quelle *Kontakte* (oder eine verknüpfte Quelle) mit den gewünschten Filtern.
2. Fertig: Liefert die Quelle Kontakte, nimmt das Element den Kontakt von selbst aus der Quelle, mit Name, Position, Bild und allen Angaben. Das Feld *Kontakt* bleibt dabei unverbunden; das ist richtig so. Verbinden Sie Name, Position oder Bild nur, wenn Sie dort andere Felder zeigen möchten.

Verbinden Sie das Feld *Kontakt* selbst, gilt Ihre Zuordnung. Bei einer Quelle, die keine Kontakte liefert (etwa Beiträge), ordnet das Element nichts zu.

Das Element lädt die Angaben aller Kontakte mit einer einzigen Datenbankabfrage.

## Reiter „Inhalt“: welche Angaben erscheinen

![Der Reiter Inhalt im Builder: die Gruppen Anzeigen, Kontaktangaben, Zusatzfelder mit den Feldern Raum, Instagram, Vorstandsamt und Interne Durchwahl sowie Aktionen, jeweils mit Schaltern.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-reiter-inhalt.png)

<table id="bkmrk-anzeigenbild%2C-name%2C-"> <tbody> <tr><td>**Anzeigen**</td><td>Bild, Name, Position und Kategorie.</td></tr> <tr><td>**Kontaktangaben**</td><td>Telefon, Mobil, Fax, E-Mail, Anschrift, Website, sonstige Informationen und Schlagwörter.</td></tr> <tr><td>**Zusatzfelder**</td><td>Jedes veröffentlichte Zusatzfeld der Kontakte mit eigenem Schalter (siehe unten).</td></tr> <tr><td>**Aktionen**</td><td>Die Links des Kontakts sowie die Schaltflächen für die Visitenkarte und das Kontaktformular.</td></tr> </tbody></table>

Angaben, die ein Kontakt oder die Optionen der Kontakte verbergen, zeigt das Element nie – unabhängig von diesen Schaltern (siehe *Felder und Anzeigeoptionen*). Kontakte, die der Besucher nicht sehen darf (unveröffentlicht, andere Zugriffsebene, andere Sprache), entfallen.

## Zusatzfelder

Jedes Zusatzfeld, das Sie unter *Kontakte › Felder* angelegt und veröffentlicht haben, erscheint im Element als eigene Angabe – mit Schalter, eigener Gruppe im Reiter *Einstellungen* sowie Symbol und Stelle im Reiter *Kontakt*. Neue Felder erscheinen von selbst und sind zunächst ausgeschaltet. Benennen Sie ein Feld um, bleiben seine Einstellungen erhalten.

- Es gilt, was Joomla für das Feld vorsieht: seine **Zugriffsebene** (ein Feld nur für Registrierte sieht ein Gast nicht) und seine **Kategorien** (ein Feld nur für eine Kategorie erscheint nur bei Kontakten dieser Kategorie).
- Ist in den Optionen der Kontakte *Eigene Felder aktivieren* ausgeschaltet, zeigt das Element keine Zusatzfelder – sofern in den Plugin-Optionen *Anzeigeoptionen beachten* eingeschaltet ist.
- Leere Felder entfallen.

Ein Feld vom Typ **URL** lässt sich in seiner Gruppe unter **Zeigen als** auf drei Arten zeigen:

<table id="bkmrk-angabewie-jede-ander"> <tbody> <tr><td>**Angabe**</td><td>Wie jede andere Angabe, mit dem Link, den Joomla ausgibt.</td></tr> <tr><td>**Symbol bei den Links**</td><td>Als Symbol in der Reihe der Links des Kontakts, hinter Link A bis E. Das Symbol richtet sich nach der Adresse, etwa Instagram, LinkedIn oder YouTube; sonst ein Link-Symbol.</td></tr> <tr><td>**Schaltfläche**</td><td>Als Schaltfläche hinter Visitenkarte und Kontaktformular, beschriftet mit dem Namen des Felds, auf Wunsch mit eigenem Stil.</td></tr> </tbody></table>

![Der Reiter Einstellungen mit den Gruppen der Zusatzfelder Raum, Instagram und Vorstandsamt; bei Instagram die Auswahl Zeigen als mit dem Wert Symbol bei den Links und der Stil der Schaltfläche.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-reiter-einstellungen.png)

Elemente aus früheren Versionen, in denen „Eigene Felder zeigen“ eingeschaltet war, zeigen danach jedes Feld einzeln, das beim Aktualisieren veröffentlicht ist.

## Reiter „Einstellungen“: die Gestaltung

Oben stehen die Gruppen der gewählten Darstellung (siehe *Vier Darstellungen*), danach die Teile eines Kontakts, in jeder Darstellung gleich, und zuletzt *Allgemein* wie bei jedem Element von YOOtheme.

<table id="bkmrk-bildbreite-und-h%C3%B6he%2C"> <tbody> <tr><td>**Bild**</td><td>Breite und Höhe, Laden, Rahmen, Schatten, Verlinkung, Ausrichtung zum Text und was ohne Bild erscheint.</td></tr> <tr><td>**Name**</td><td>Stil, Verlinkung zur Kontaktseite, Hover-Stil, Schriftfamilie, Farbe, HTML-Element und Abstand (diese beiden nur in Raster und Liste).</td></tr> <tr><td>**Position**</td><td>Stil, Farbe, Stelle über oder unter dem Namen, HTML-Element und Abstand (diese drei nur in Raster und Liste).</td></tr> <tr><td>**Kontaktangaben**</td><td>Darstellung als Liste oder als Beschreibungsliste (Beschriftung links, Wert rechts), Beschriftung als Symbol, Text, beides oder keine (bleibt für Screenreader erhalten), Stil und Breite der Beschriftung, Listenstil, Abstand, Textstil, Abstand oben, Farbe und Größe der Symbole.</td></tr> <tr><td>**Je Angabe**</td><td>Für jede eingeschaltete Angabe und jedes eingeschaltete Zusatzfeld eine eigene Gruppe: Textstil, Textfarbe, Schriftfamilie, Abstand oben und Symbolfarbe. „Wie Kontaktangaben“ übernimmt die gemeinsamen Einstellungen. Bei Telefon, Mobil und E-Mail schaltet *Link* ab, dass die Angabe zum Anrufen bzw. Schreiben verlinkt ist (Vorgabe: verlinkt).</td></tr> <tr><td>**E-Mail**</td><td>Unter *Zeigen als* die *Adresse* unter den Angaben oder eine *Schaltfläche* „E-Mail“ hinter Visitenkarte und Kontaktformular, auf Wunsch mit eigenem Stil. Die Adresse bleibt in beiden Fällen vor Spam-Programmen verschleiert.</td></tr> <tr><td>**Links**</td><td>Als Symbol-Schaltfläche, Symbol oder Text, Größe und Abstand.</td></tr> <tr><td>**Schaltflächen**</td><td>Stil, Größe, volle Breite und Ausrichtung; Visitenkarte und Kontaktformular auf Wunsch mit eigenem Stil.</td></tr> </tbody></table>

## Reiter „Kontakt“

![Der Reiter Kontakt: oben die Teile der Anschrift mit Schaltern, darunter Symbol und Reihenfolge für jede Angabe und jedes Zusatzfeld, ausgegraut bei ausgeschalteten Angaben.](https://docs.graup-it.de/uploads/images/gallery/2026-11/element-reiter-kontakt.png)

<table id="bkmrk-teile-der-anschrifts"> <tbody> <tr><td>**Teile der Anschrift**</td><td>Straße, PLZ und Ort, Bundesland und Land einzeln ein- und ausschalten – etwa nur den Ort in der Tabelle.</td></tr> <tr><td>**Symbol und Reihenfolge**</td><td>Je Angabe und je Zusatzfeld ein eigenes Symbol aus der Symbolauswahl von YOOtheme und ihre Stelle in der Reihenfolge (1 = zuerst). Leer gelassen gilt die Vorgabe; Zusatzfelder stehen dann hinter den übrigen Angaben.</td></tr> <tr><td>**Ländervorwahl**</td><td>Telefonnummern ohne Ländervorwahl (z. B. <code>0711 12345</code>) werden mit dieser gewählt, z. B. <code>&#43;49</code> für Deutschland.</td></tr> <tr><td>**Strukturierte Daten**</td><td>Beschreibt die gezeigten Kontakte für Suchmaschinen (schema.org *Person*). Die E-Mail-Adresse bleibt dabei draußen.</td></tr> </tbody></table>

## Verzeichnis

Der Anfangsbuchstabe kommt aus *Sortierung Feld 1* des Kontakts (meist der Nachname), sonst aus dem Namen; Umlaute stehen beim Grundbuchstaben. Die Sprungleiste zeigt nur die vorhandenen Gruppen oder A–Z mit ausgegrauten leeren Buchstaben. Wie viele Angaben gleich neben dem Namen stehen und ob der Rest aufklappt, immer zu sehen ist oder entfällt, stellen Sie in der Gruppe *Verzeichnis* ein.

## Elemente aus früheren Versionen

Elemente, die mit einer früheren Version angelegt wurden, stellt Contact Directory beim Laden selbst um, gleich aus welcher Version: Gleichnamige Einstellungen bleiben, wie sie sind; Video, Hover-Bild, Lightbox und der Text im Feld *Inhalt* eines Eintrags entfallen, weil sie zu Kontakten nicht passen. Speichern Sie die Seite einmal im Builder, damit die Umstellung dauerhaft gilt.

<small>Gilt für Version 1.0.0.</small>

[English version](https://docs.graup-it.de/link/490)

# Änderungsprotokoll

Dieses Änderungsprotokoll listet alle veröffentlichten Versionen von Contact Directory, die neueste zuerst.

<div class="callout info" id="bkmrk-diese-seite-wird-bei">Diese Seite wird beim Release automatisch aus der Änderungsdatei des Produkts erzeugt. Änderungen von Hand gehen beim nächsten Abgleich verloren.

</div>## Version 1.0.0 – 21.11.2026

### Hinzugefügt

- Initiales Release.

[English version](https://docs.graup-it.de/link/491)