Importieren Sie dynamisch die Personen- und Einrichtungsinformationen aus personen.uni-mainz.de in Ihre Webseite ein. Personen- und Einrichtungsverzeichnis (englisch JGU Directory) ist Teil des IdM (IdM = Identity Management)). Im Folgenden wird es kurz Personenverzeichnis genannt.
Plugin einschalten
Manche besondere Eigenschaften werden nur in einigen WordPress-Projekten benötigt. Da jede neue Eigenschaft Ihre Seite ein wenig langsamer macht, sind diese Erweiterungen standardmäßig deaktiviert. Die Erweiterungen heißen in WordPress Plugins. Zuerst müssen Sie ein Plugin (einmalig) aktivieren. Sie steuern die Plugins durch sogenannte Shortcodes. Shortcodes sind Kommandos auf Ihrer Webseite, mit dem Sie dem Plugin sagen, was genau es tun soll. Sie erkennen Shortcode-Kommandos daran, daß sie in der Webseite in eckigen Klammern stehen.
Bevor Sie das Plugin verwenden können, müssen Sie es zuerst einschalten!
Ansonsten werden Ihre Shortcodes nur auf der Seite angezeigt anstatt ausgeführt zu werden.
Gehen Sie zu Dashboard -> JGU Tools -> Plugins und aktivieren Sie das Plugin. Ausführliche Anleitung zum Plugin aus- und einschalten
Achtung : ❗ Wechseln Sie auf der Seite, an der Sie das Plugin durch den Shortcode verwenden wollen, in den Modus Text (Kartenreiter oben rechts), bevor Sie etwas an den Shortcodes ändern!
Inhaltsverzeichnis
- Kurzanleitung für Eilige
- Informationen sind unvollständig? Personen fehlen völlig?
- Kontaktdaten ändern
- Personen Ihres Teams
- Beispiel: ID einer Einrichtung finden
- Rollen
- Live-Beispiel für eine Einrichtung
- Shortcode für eine Einrichtung
- Shortcode Parameter von idm-organization
- Live-Beispiel minimale Anzeige
- Kontaktinfos einer Person aus dem IdM anzeigen
- Beispiel: ID einer Person finden
- Live-Beispiel für eine Person
- Shortcode für eine Person
- Rollen-IDs und Organisationseinheiten-IDs
- Shortcode für mehrere Personen
Kurzanleitung für Eilige
Sie kennen sich aus mit Plugins und Shortcodes? Kopieren Sie: [idm-organization id="1890"] an die Stelle, auf der die Kontaktinfos auftauchen sollen. Ersetzen Sie 1890 durch die ID Ihrer Einrichtung. Die ID-Nummer finden Sie am Ende der Personen-Webadresse Ihres Bereichs in personen.uni-mainz.de oder in der Liste aller Rollen-IDs und Organisations-IDs
Informationen sind unvollständig? Personen fehlen völlig?
Warnung : ⚠️ Die Person, deren Daten Sie vermissen, hat es entweder versäumt, die Daten einmalig freizugeben. Beachten Sie, daß nur die Daten angezeigt werden, die auch von den Personen freigegeben wurden!
Prüfen Sie die Datenqualität, indem Sie Ihre Einrichtung incognito ansehen
Um die freigegebenen Kontakt-Daten zu sehen, schauen Sie sich Personen.Uni-Mainz.DE an, wenn sie nicht angemeldet sind. Öffnen Sie dazu
- Chrome: ein neues Incognito-Fenster: Strg + Umschalttaste + N
- Firefox: ein neues privates Fenster: Strg + Umschalttaste + P
- Edge: Neues InPrivate -Fenster: Strg + Umschalttaste + N
- Internet Explorer: InPrivate-Browsen: Strg + Umschalttaste + P
Solange Sie nicht angemeldet sind, sehen Sie oben rechts den Knopf Anmelden. Das ist der Zustand, in dem Sie sich die Kontaktdaten anschauen müssen!
So stellen Sie sich quasi auf eine Stufe mit den Besuchern unserer Webseiten.
Suchen Sie nach einer Person. Wird eine Person nicht gefunden, hat sie Ihre Daten nicht freigegeben und kann daher auch nicht in ausgegeben werden.
Kontaktdaten ändern
Sind die Daten unvollständig, fragen Sie nach, ob dies absichtlich oder versehentlich passiert ist und weisen daraufhin, wie man die Daten freigibt. Häufiger Fehler: Daten nur im persönlichen Bereich angegeben aber in der Rolle nicht. Oder die Daten in der Rolle sind noch nicht freigegeben: Eigene Daten im IdM verwalten und freigeben
Namensänderung von Abteilungen und Personen: bei https://idm.uni-mainz.de
Stellvertretung nötig:
Überlegen Sie, ob jemand (sie?) die Daten stellvertretend pflegen kann. Dies nennt sich Personenverzeichnis-Beauftragter. Sie bekommen diese Rolle beim IdM-Admin Ihrer Einrichtung.
Mehr zum Personenverzeichnis-Beauftragte
Wer kann mich zum Personenverzeichnis-Beauftragten befördern, damit ich rollenbasierte Daten wie Telefon und Sprechzeiten von Kollegen pflege? Das ist ein Personenverzeichnis-Admin. Fragen Sie im Sekretariat Ihrer Einrichtung danach.
Personen Ihres Teams
Warnung : ⚠️ Beachten Sie, daß nur die Daten angezeigt werden, die auch von den Personen freigegeben wurden! Setzen Sie die ID Ihrer Einrichtung ein. Die ID ist die Nummer am Ende der Webadresse im Personenverzeichnis.
Beispiel: ID einer Einrichtung finden
- Öffnen Sie das Personenverzeichnis: https://personen.uni-mainz.de/
- Zeigen Sie Ihre Einrichtung an (in diesem Beispiel das Dekanat der evangelischen Theologie).
- Oben in der Adresszeile steht jetzt:
https://personen.uni-mainz.de/public/org/565 - Die Nummer am Ende der Webadresse (URL) ist die ID. Hier im Beispiel
565
Rollen
Selten müssen Sie die Ausgabe von personen.uni-mainz.de etwas zuschneiden, weil sie nur einen Teil der Personenliste brauchen. Sie tun dies durch Angabe der Rollen-IDs, die Sie angeben oder eben ausklammern wollen. Eine Liste aller Rollen-IDs und Organisations-IDs
Live-Beispiel für eine Einrichtung
Die ID des ZDV → ZDV im IdM Directory Das ZDV → Live Demo
https://personen.uni-mainz.de/public/org/398 Die ID der Einrichtung ist 398
Shortcode für eine Einrichtung
Alle (freigegebenen) Personen Ihres Teams anzeigen. Konkret sind dies die Rollen der Personen in der Organisation
Anwendung
Besuchsadresse:
NatFak (1341)
Anselm-Franz-v.-Bentzel-Weg 12
55128 Mainz, DE
Postadresse:
Saarstraße 21
55122 Mainz, DE
Leitung
Mitarbeiter/innen
Behrens, Michael
Docuware, CMS Support
- Besuchsadresse:
- Johann-Joachim-Becher-Weg 21, 55128 Mainz
- Gebäude:
- NatFak Hauptgebäude (1341)
- Raum:
- NatFak Hauptgebäude - 01-423
- Telefon:
- +49 6131 39 26323
- E-Mail:
- michael.behrens@uni-mainz.de
Kwasnicki, Markus
E-Learning
- Besuchsadresse:
- Anselm-Franz-von-Bentzel-Weg 12, 55128 Mainz
- Gebäude:
- Naturwissenschaftliches Institutsgebäude
- Raum:
- NatFak Hauptgebäude - 01-452
- Telefon:
- +49 6131 39 21379
- E-Mail:
- markus.kwasnicki@uni-mainz.de
Slowinski, Anja
CMS Support
- Besuchsadresse:
- Anselm-Franz-von-Bentzel-Weg 12, 55128 Mainz
- Gebäude:
- Naturwissenschaftliches Institutsgebäude
- Raum:
- NatFak Hauptgebäude - 01-446
- Telefon:
- +49 6131 39 25621
- E-Mail:
- webmaster@uni-mainz.de
- Website:
- https://www.staff.uni-mainz.de/slowi/
Stein, Carmen
- Telefon:
- +49 6131 39 26347
- E-Mail:
- carmen.stein@uni-mainz.de
Lehrbeauftragter
Ersthelfer
Slowinski, Anja
- Telefon:
- +49 6131 39 25621
- E-Mail:
- slowi@uni-mainz.de
- Website:
- https://www.staff.uni-mainz.de/slowi/
Stein, Carmen
- Telefon:
- +49 6131 39 26347
- E-Mail:
- carmen.stein@uni-mainz.de
Anzeige einer A-Z-Liste aller Personen einer Einrichtung mit jeweiligem Link auf das vollständige Profil
Shortcode Parameter von idm-organization
id
Eine Organisationseinheit eindeutig identifizieren.
Wert: ist immer eine Zahl
Beispiel:
[idm-organization id="2952" ]
layout
Zeigen Sie die freigegebenen Personen einer Organisationseinheit alphabetisch sortiert an. Dieser Parameter zeigt nur Namen an, daher sind alle folgenen Parameter für die alphabetische Ausgabe nicht sinnvoll.
Wert: azlist
Beispiel:
[idm-organization layout="azlist"]
portraits
Optional, blendet die Porträts bei Bedarf aus. Die Porträts werden standardmäßig angezeigt.
Wert: : true oder false. Standard ist true
Beispiel:
[idm-organization portraits="false"]
link
Optional, blendet die Verlinkung des Namens der Person mit deren Profil auf personen.uni-mainz.de aus oder verweist auf deren persönliche Webseite. Die Verlinkung wird standardmäßig angezeigt.
Wert:
- false: der Personenname ist nicht verlinkt.
- website: der Personenname verlinkt auf deren im Profil von personen.uni-mainz.de hinterlegte
Persönliche Webseite
Beispiele:
[idm-organization id="398" link="false"]
[idm-organization id="398" link="website"]
role_ids
Zeige innerhalb der Organisationseinheit nur die Rollen mit den angegebenen IDs an. Rollen-ID-Liste
Wert: Kommaseparierte Liste von Rollen-IDs.
Beispiel:
Im ZDV (398) nur die Leitung [idm-organization id="398" role_ids="68, 69"]
skip_roles
Zeige innerhalb der Organisationseinheit alles an außer den Rollen mit den angegebenen IDs.
Wert: Kommaseparierte Liste von Rollen-IDs oder Zugehörigkeiten (gruppierten Rollen) Rollen-ID-Liste
Beispiel:
[idm-organization id="398" skip_roles="5, 27"]
grouped_roles
Zeige innerhalb der Organisationseinheiten nur die Zugehörigkeiten (gruppierten Rollen) an. Rollen-ID-Liste
Wert: Kommaseparierte Liste von Zugehörigkeiten (gruppierten Rollen)
Beispiel:
[idm-organization id="398" grouped_roles="1002"]
depth
Gibt an, bis zu welcher Tiefe die Organisationsuntereinheiten angezeigt werden sollen. Eine Zahl größer 5 führt zu Größenproblemen bei den Überschriften der Organisationseinheiten.
Wert: eine Zahl, Standard ist 5
Beispiel:
[idm-organization depth="2"]
startlevel
Die Überschriftengröße kann so gesteuert werden.
Wert: eine Zahl. Standard ist 2. Sollten sie keine Überschrift auf der Seite gesetzt haben, können Sie dort auch eine 1 eintragen.
Beispiel:
[idm-organization startlevel="1"]
skip
Geben Sie eine Liste von IDs von Organisationseinheiten an die nicht mit ausgegeben werden sollen. Dieser optionale Parameter erwartet ein Komma-separierte Liste. Standardmäßig werden alle Unterorganisationseinheiten angezeigt.
Wert: Kommaseparierte Liste von Zahlen
Beispiel, in der Oberorganisationseinheit 118 soll die Untereinheit 122 nicht angezeigt werden:
[idm-organization id="118" skip="122"]
room
Optionaler Schalter zum Ausblenden des Raums
Wert: true oder false. Standard ist true
Beispiel:
[idm-organization id="118" room="false"]
person_address
Optionaler Schalter zum Ausblenden der Adresse der Person
Wert: Standard ist true
Beispiel:
[idm-organization id="118" person_address="false"]
website
Optionaler Schalter zum Ausblenden der persönlichen Webseite
Wert: Standard ist true
Beispiel:
[idm-organization id="118" website="false"]
Optionaler Schalter zum Ausblenden der Email
Wert: Standard ist true
Beispiel:
[idm-organization id="118" email="false"]
phone
Optionaler Schalter zum Ausblenden der Telefonnummer
Wert: Standard ist true
Beispiel:
[idm-organization id="118" phone="false"]
office_hours
Optionaler Schalter zum Ausblenden der Sprechzeiten
Wert: Standard ist true
Beispiel:
[idm-organization id="118" office_hours="false"]
department_address
Optionaler Schalter zum Ein- oder Ausblenden der Adresse der Unter-Einrichtungen.
Wert: Standard ist false, die Adressen der Untereinrichtungen werden also ausgeblendet.
Beispiel:
[idm-organization id="118" department_address="false"]
Live-Beispiel minimale Anzeige
Der Standard ist, alle vorhandenen Informationen einzublenden. Hier das Extrembeispiel, in dem Sie alle Zusatzinfos ausblenden. Es einfach nur so zu kopieren ist also nicht sinnvoll 🙂
[idm-organization id="118" portraits="true" email="false" room="false" person_address="false" website="false" phone="false" office_hours="false" department_address="false"]
Dies sind die minimalen Infos zur Einrichtung mit der ID 1890 → Anwendungsgruppe / Application group im Personenverzeichnis, minimale Ansicht
Kontaktinfos einer Person aus dem IdM anzeigen
Setzen Sie die ID der Person in den Shortcode ein. Sie finden die ID der Person, indem Sie deren Daten in personen.uni-mainz.de ansehen. Die Nummer am Ende der Webadresse ist die ID der Person.
Beispiel: ID einer Person finden
- Öffnen Sie das Personenverzeichnis: https://personen.uni-mainz.de/
- Suchen Sie nach der Person (z.B. Krausch) und klicken Sie auf den Namen
- Oben in der Adresszeile steht jetzt:
https://personen.uni-mainz.de/public/person/1700 - Die Nummer am Ende der Webadresse (URL) ist die ID. Hier im Beispiel
1700
Live-Beispiel für eine Person
Dies ist der Eintrag von Andre Brinkmann im Personenverzeichnis → Eine Person im Personenverzeichnis
Die Webadresse ist https://personen.uni-mainz.de/public/person/2952 Die ID für Andre Brinkmann ist: 2952
Achtung: ❗Nicht die Nummer der Rolle ("member") verwenden! Hier ein Negativ
Beispiel:
https://personen.uni-mainz.de/public/org/1890/member/12345 Die Nummer am Ende ist NICHT die Id einer Person!
Shortcode für eine Person
Brinkmann, Univ.-Prof. Dr. André
Institut für Informatik
stellv. Geschäftsführende Leitung
Telefon:
+49 6131 39 26390
E-Mail:
brinkman@uni-mainz.de
Informationstechnik und anwendungsorientierte Informatik
Professor/in
Telefon:
+49 6131 39 26390
E-Mail:
brinkman@uni-mainz.de
Website:
https://research.zdv.uni-mainz.de/people/andre-brinkmann/
Rollen-IDs und Organisationseinheiten-IDs
Besonders bei Personen mit vielen Rollen in verschiedenen Organisationseinheiten ist es sinnvoll, bestimmte Rollen einer Personen auszublenden. Sie benötigen dafür die Rollen-IDs und die Organisationsheinheiten-IDs.
Die betreffenden IDs schauen Sie nach in der Liste aller Rollen-IDs und der Organisationsheinheiten-ID:
https://personen.uni-mainz.de/api/v1/wp-data.
role_ids
Schränkt die Rollen einer Person ein. Wird der Parameter weggelassen, werden alle Rollen einer Person angezeigt.
Wert: Kommaseparierte Liste der Rollen-IDs
Beispiel:
Rothlauf, Univ.-Prof. Dr. Franz
Wirtschaftsinformatik
Professor/in
Besuchsadresse:
ReWi I (1226)
Jakob-Welder-Weg 9
55128 Mainz, DE
ReWi I - 01-244
Telefon:
+49 6131 39 22734
E-Mail:
rothlauf@uni-mainz.de
Sprechzeiten
- Mi
-
13:00 - 14:00
nur in der Vorlesungszeit
org_ids
Schränkt die Rollen einer Person anhand der Organisationseinheit ein. Wird der Parameter weggelassen, werden alle Rollen einer Person angezeigt.
Wert: Kommaseparierte Liste der Organisationseinheiten-IDs, deren Rolle angezeigt werden soll
Beispiel:
Rothlauf, Univ.-Prof. Dr. Franz
Gutenberg School of Business Mainz (GSB Mainz)
Akademische/r Leiter/in
Telefon:
+49 6131 39 29517
E-Mail:
rothlauf@uni-mainz.de
Wirtschaftsinformatik
Professor/in
Besuchsadresse:
ReWi I (1226)
Jakob-Welder-Weg 9
55128 Mainz, DE
ReWi I - 01-244
Telefon:
+49 6131 39 22734
E-Mail:
rothlauf@uni-mainz.de
Sprechzeiten
- Mi
-
13:00 - 14:00
nur in der Vorlesungszeit
skip_details: Felder der Personenanzeige ausblenden
Manchmal ist es sinnvoll, bestimmte Kontaktinformationen (E-Mail, Adresse, Büro) auszublenden. bzw. eine Auswahl zu ermöglichen.
Wert: Kommaseparierte Liste der auszublendenden Feldnamen
Feldnamen:
- office_hours
- phone
- room
- website
Beispiel:
Rothlauf, Univ.-Prof. Dr. Franz
Chief Information Officer
Chief Information Officer (CIO)
Besuchsadresse:
ReWi I (1226)
Jakob-Welder-Weg 9
55128 Mainz, DE
ReWi I - 01-244
Telefon:
+49 6131 39 22734
JGU
Chief Information Officer (CIO)
Telefon:
+49 6131 39 22734
Systemadministration und PC-Pool FB 03
Leitung
Besuchsadresse:
ReWi I (1226)
Jakob-Welder-Weg 9
55128 Mainz, DE
ReWi I - 01-244
Telefon:
+49 6131 3922734
Gutenberg School of Business Mainz (GSB Mainz)
Akademische/r Leiter/in
Telefon:
+49 6131 39 29517
Wirtschaftsinformatik
Professor/in
Besuchsadresse:
ReWi I (1226)
Jakob-Welder-Weg 9
55128 Mainz, DE
ReWi I - 01-244
Telefon:
+49 6131 39 22734
Sprechzeiten
- Mi
-
13:00 - 14:00
nur in der Vorlesungszeit
Shortcode für mehrere Personen
Dies ist nützlich, wenn Sie eine andere Zusammenstellung als im Personenverzeichnis vorhanden wünschen
Brinkmann, Univ.-Prof. Dr. André
Institut für Informatik
stellv. Geschäftsführende Leitung
Telefon:
+49 6131 39 26390
E-Mail:
brinkman@uni-mainz.de
Informationstechnik und anwendungsorientierte Informatik
Professor/in
Telefon:
+49 6131 39 26390
E-Mail:
brinkman@uni-mainz.de
Website:
https://research.zdv.uni-mainz.de/people/andre-brinkmann/
Slowinski, Anja
Anwendung
Mitarbeiter/in
CMS Support
Besuchsadresse:
Naturwissenschaftliches Institutsgebäude
Anselm-Franz-von-Bentzel-Weg 12
55128 Mainz, DE
NatFak Hauptgebäude - 01-446
Telefon:
+49 6131 39 25621
E-Mail:
webmaster@uni-mainz.de
Live-Beispiel Person vs Rolle (der Person im Organisationskontext)
Der Personeneintrag ist repetitiv. Der Eintrag der Organisationseinheit ist es nicht.
Personeneintrag vs Rolle → Alternative Darstellung für Sebastian Grätz
Beispiel:
Professoren-Rolle (role_ids="13") in der Organisationseinheit Altes Testament:
Altes Testament und Biblische Archäologie II
Besuchsadresse:
Taubertsberg III (9184)
Wallstraße 7-7a
55122 Mainz, DE
Postadresse:
Saarstraße 21
55122 Mainz, DE
Professor
Grätz, Univ.-Prof. Dr. Sebastian
- Telefon:
- +49 6131 39 22263
- E-Mail:
- graetz@uni-mainz.de
Eine Rolle (oder auch mehrere) in einer Organisationseinheit anzeigen: role_id