JGU-IdM Persons and Institutions Directory

Show the published members of your team without any extra work by connecting the JGU Directory to your web page. The Plugin Name is JGU IdM.

You activate this plugin in the Dashboard - JGU Tools - Plugins

Be careful to edit the Shortcode in the Text mode only. Editing in the Visual mode may cause the shortcode to fail entirely due to HTML Tags in the Code.

The JGU Directory is a part of the IdM = Identity Management of the JGU.

Decide for yourself: select a Person or all members of your organization.

Display all published Members of your organization

Insert the id of the Organization. You will find the id by displaying the organization data in

Personen.Uni-Mainz.DE

The Number at the end of the URL is the id of the organization.

Warning : ⚠️ Only published Members and published data will be shown! Be sure to be not logged in! You will see more data if you are logged in!

You are not logged in when the upper right corner of the JGU Directory shows "log in", like this:

not logged in
Not logged in to show only the published members of your organization.

Roles

Sometimes you need to tailor the output a bit. You do this by defining parts of the output by roes.

A list of all organization IDs and role IDs is available at https://personen.uni-mainz.de/api/v1/wp-data

Live-Example Organization

This is the Team of the "Applications"-Team of the ZDV  → Applications Team in the IdM Directory

https://personen.uni-mainz.de/public/org/1890

The id for the organization is 1890

Shortcode Parameter

id
Select a person or organization
Mandatory Value: a number

Example:
[idm-organization id="1890"]

layout

  • Default is a listing like in personen.uni-mainz.de. If you like a simple list in alphabetical order, use the display parameter
  • Only Value: azlist

Example:

portraits

  • Hides portraits. Default is true. Means, if you want the portraits, do not use this parameter.
  • Value: true oder false

Example:

link

  • Set if the person's name should be linked to personen.uni-mainz.de, to an persons own website if available or have no link at all.
  • Values: idm (default), false, website

Example:

role_ids

  • Only show members with the given role IDs.
  • Values: Comma separated list of role IDs.

Example:

skip_roles

  • Role IDs to be excluded from member list.
  • Values: Comma separated list of role IDs.grouped_roles

Example:

grouped_roles

  • Affiliated role IDs to show in member list.
  • Values: Comma separated list of affiliated role IDs.

Example:

depth

  • Level of sub-organization units to be show. Maximum is 3.
  • Value: a number

Example:

startlevel

Defines the size of the biggest heading.

Value: a number. Defaults to 2. If there is no heading on your page, you may set this to 1.

Example:

skip

Skip an organizational id. This parameter is optional. Default is to show all organizations. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization skip="123"]

room

Hides the room. Default is true. This parameter is optional. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization room="false"]

person_address

Hides the persons address. Default is true. This parameter is optional. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization person_address="false"]

email

Hides the email address. Default is true. This parameter is optional. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization email="false"]

phone

Hides the phone number. Default is true. This parameter is optional. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization phone="false"]

office_hours

Hides the office_hours. Default is true. This parameter is optional. If you want the data, do not set this parameter.
Value: true oder false,
Example:
[idm-organization office_hours="false"]

department_address

Shows the addresses of the subdepartments. Default is false. This parameter is optional. If you want the data, do set this parameter.
Value: true oder false,
Example:
[idm-organization department_address="false"]

Display the data of one person

Insert the id of the person into the shortcode. You will find the id by displaying the persons data in https://Personen.Uni-Mainz.DE

The number at the end of the URL is the id.

Live-Example

This is the person data of Andre Brinkmann  → One Person in the IdM Directory

The URL is https://personen.uni-mainz.de/public/person/2952

The id for Andre Brinkmann is 2952

Example - Finding the ID of a person

Search for the person is the fastest path to a person.
The URL is https://personen.uni-mainz.de/public/person/2952

The ID for Andre Brinkmann is 2952.

Be sure to look at the person and not its role or membership! This URL shows information about Andre Brinkmann, too, but in the context of its role as Head of the ZDV.

https://personen.uni-mainz.de/public/org/398/member/79148

If you click on "Vollständiges Profil anzeigen" on this page, you will see the person's page with the ID!

Example - shortcode for one person

The data that is actually rendered for a person depends on what this individual shares with the public.

Example output:

Shortcode parameters for a person

id

  • Parameter: id
  • Function: select a person
  • Possible Value: an ID number

Example:

role_ids

  • Parameter: role_ids
  • Function: filter roles of person by role ids
  • Value: Comma separated list of role ids

Example:

org_ids

  • Parameter: org_ids
  • Function: filter roles of person by organization ids
  • Value: Comma separated list of organization ids

Example:

Language

Translations are available for English and German, and are set depending on your blog's language. English is the default for all unsupported languages.