TUM MemberList
The TUM MemberList extension retrieves employee information from TUMonline and displays it on your page either as a table or as a gallery.
Requirements: Privacy & TUMonline list
Privacy notice: Only data that has been released in TUMonline as anonymous (publicly accessible) is displayed. Non-public data will not appear on the website.
Before TUM MemberList can be embedded, the “People & Responsibilities” list must exist and be maintained in TUMonline for your organization.
If the list is missing or incomplete, please contact TUMonline Support.
Preparation: Obtaining the Organization ID from TUMonline
Before you can embed TUM MemberList, you need the Organization ID of your organizational unit (referred to in TUMonline as “pOrgNr” or “PORGNR”).
- Go to TUMonline. Important: Make sure you are not logged in.
- Click “People and Responsibilities”.
- Search for the desired organizational unit and click its name.
- Copy the ID that follows
pOrgNr=orPORGNR=from the URL in your browser’s address bar.
Embedding TUM MemberList - step by step
- Open the Page Module and select the target page.
- Click “+ Content” → “Special” group → “Insert Plugin”.
- Select “TUM MemberList”.
- Enter the Organization ID from TUMonline.
- Choose the desired layout (see below).
- Save your changes.
Plugin option: Group mapping
In the “Group Mapping” tab, you can combine, rename, or exclude groups maintained in TUMonline for display purposes.
Syntax:
- Each line follows the format:
New Group Name = Existing Group Name from TUMonline - Combine multiple groups: Separate group names with a semicolon, for example:
All = Head; Secretariat - Capture unmapped groups: Use
?to collect all groups that have not yet been assigned, for example:Remaining = ? - Comments: Lines beginning with
#are ignored.
Important
Once you use Group Mapping, all groups that should be displayed must be explicitly defined. Any groups that are not listed in the mapping will not appear in the directory.
Plugin option: Template
In the “Template” tab, you can define the layout and configure additional display options.
Available layouts:
| Layout | Description |
|---|---|
| Table with grid lines | All cells are displayed with borders |
| Table without lines | Clean table view without borders |
| Table with horizontal lines | Displays only row separators |
| Single-column format | List view without a table structure |
| Two-column layout | Displays people in two columns |
| Gallery format | Shows photos with names and roles |
Additional options
- section-index: link list of group names above the staff list
- base: shows only the abbreviation and extension number
- room+: room number including additional information
- email-icon: icon instead of the full email address
- images: display portrait photos from TUMonline (if released there)
Option compatibility per layout
| Layout | vcard-link | section-index | base | room+ | email-icon | images |
|---|---|---|---|---|---|---|
| Table with grid lines | x | x | x | x | x | x |
| Table without grid lines | x | x | x | x | x | x |
| Table with horizontal lines | x | x | x | x | x | x |
| Without table (single column) | x | x | x | – | x | x |
| Two-column layout | x | x | x | – | x | x |
| Gallery | x | – | – | – | – | x |
Recommendation
The Gallery Format is particularly suitable for department overview pages, as photos and roles are visible at a glance.
Plugin option: Link members
In the “Link Members” tab, you can define where users are directed when they click on a person's name. The following options are available:
- Link to the personal page with the TUMvCard plugin (recommended): If a TUMvCard exists for the person, the name links to that page. If no TUMvCard is available, the link will instead point to the person's profile card in TUMonline.
- Link to the profile card in TUMonline: The name links directly to the person's TUMonline profile card.
- No link: Names are displayed without a hyperlink.
Combining multiple TUMvCards of one person
If multiple TUMvCard elements exist for the same person on different pages, you must specify which TUMvCard the MemberList should link to. This mechanism is identical to the category assignment used by TUMcourses (see TUMcourses):
- Open the TUM MemberList plugin and select the category “PAGE:TUMvCard-xxx” in the corresponding field (xxx = sequential number of the respective TUMvCard).
- Open the Page Properties of the page containing the relevant TUMvCard.
- Assign the same category “PAGE:TUMvCard-xxx” to that page.
- Save both changes.
Data updates
The TUM MemberList automatically retrieves data from TUMonline every 10 days. To update the displayed information immediately after changes have been made in TUMonline:
- Open the page containing the plugin.
- Click the lightning bolt icon “Clear cache for this page” in the top-right corner.
- Reload the page in the frontend.
English Version
The TUM MemberList element must also be translated for the English version of a page, just like any other content element. The general procedure is described in the “English-Language Page” guide:
- Switch to the Language View in the Page Module.
- Click “Translate” on the TUM MemberList element.
- In the plugin settings of the English copy, change the “Language” field to “English”.
- Enable the English element (turn on visibility).