Preparation: Search for & copy the "NodeID
- Open the publication or publication list in mediaTUM that you want to integrate into your website.
- Copy the NodeID from the address bar (Image 1, No. 2).
Plugin "CurlContent"
- Create a new content element (Image 2, No. 1).
- Select the "CurlContent" from the Plugin tab (Image 2, No. 2 & 3).
1. Select URL preset from the drop-down menu
- Custom URL (https://...): an individual URL that does not correspond to the following presets
- mediaTUM: All documents (node ID): all documents for the specified NodeID
- mediaTUM: Journals only (node ID): only journal articles for the specified NodeID
- mediaTUM: Books or book chapters only (node ID): only books or book chapters for the specified NodeID
- mediaTUM: Conference presentations, talks, papers (node ID): only conference presentations ("Lecture/Presentation" and "Text contribution/Article") for the specified NodeID
- mediaTUM: Conference presentations and talks (node ID): only conference presentations of the type "Lecture/Presentation" for the specified NodeID
- mediaTUM: Conference papers (node ID): only conference papers of the type "Text contribution/Article" for the specified NodeID
- mediaTUM: Reports only (node ID): only research reports for the specified NodeID
- mediaTUM: Dissertations or habilitations (node ID): only dissertations or habilitation theses for the specified NodeID
- mediaTUM: One or more single documents (node ID, node ID, …): with this option, you can address individual publications and display up to 10 in a list
- mediaTUM: All Documents from multiple nodes (node ID, node ID, ...): all documents from multiple nodes (up to 10 nodes)
2. Enter "Parameters for preset"
Enter the "NodeID" in the field for Parameters for preset.
If you also enter a number (e.g. 5) separated by commas along with the "NodeID," only the 5 most recent publications will be listed.
3. Choose Output Layout / Template
Finally, switch to the Processing tab (Image 5, No. 1). In the XSLT processing drop-down menu, you can choose from four different templates (Image 5, No. 2), for which there are additional options.
- "mediaTUM: Simple list": simple publication list.
- "mediaTUM: List, grouped by year": groups publications by year. The year index appears above the list.
- "mediaTUM: List, grouped by year, then type": groups publications first by year and then by document types.
- "mediaTUM: Detail": a tabular output of individual data; similar to the detail view on the mediaTUM website.
Additional Options: XSL-Parameters
The following parameters can be set in the field for Parameters for this XSL file to influence the appearance of the publication list. Depending on the template, the possible parameters differ:
mediaTUM: Simple list
| Parameter | Description | Default | Example |
|---|---|---|---|
| perpage | This allows a pagination of the list across multiple pages. You specify the number of entries per page. | 0 (no pagination) | perpage=20 |
| num |
| 0 | num=1 |
| bibtex | This option (no value needed) adds links to BibTeX files. | 0 | bibtex |
| www | This option adds the associated www addresses. | 0 | www |
| full | This option (no value needed) adds links to full texts of the publication. These are full texts on mediaTUM or DOI links. | 0 | full |
| math | This option (no value needed) activates Mathjax libraries | 0 | math |
| html | This option (no value needed) ensures that HTML formatting in the titles of certain publication types is interpreted. | 0 | html |
mediaTUM: List, grouped by year
| Parameter | Description | Default | Example |
|---|---|---|---|
| bibtex | This option (no value needed) activates links to BibTeX files. | 0 | bibtex |
| full | This option (no value needed) activates links to full texts of the publication. These are full texts on mediaTUM or DOI links. | 0 | full |
| math | This option (no value needed) activates Mathjax libraries. | 0 | math |
| html | This option (no value needed) ensures that HTML formatting in the titles of certain publication types is interpreted. | 0 | html |
| www | This option adds the associated www addresses. | 0 | www |
| tabs | This option (no value needed) activates the display of the year index in tabs. | 0 | tabs |
| tab_all | Option: adds an additional tab that shows all publications grouped by year. | 0 | tab_all |
| tab_search | Option: activates an additional tab for a quick search of the publications for the entered NodeID | 0 | tab_search |
| tab_initial | Define the default tab of your list:
| first (default) | tab_initial |
mediaTUM: List, grouped by year, then by type
| Parameter | Description | Default | Example |
|---|---|---|---|
| bibtex | This option (no value needed) activates links to BibTeX files. | 0 | bibtex |
| full | This option (no value needed) activates links to the full texts of the publication. These are full texts on mediaTUM or DOI links. | 0 | full |
| math | This option (no value needed) activates Mathjax libraries. | 0 | math |
| html | This option (no value needed) causes HTML formatting in titles of certain publication types to be interpreted. | 0 | html |
| www | This option adds the stored www addresses. | 0 | www |
mediaTUM: Detail
| Parameter | Description | Default | Example |
|---|---|---|---|
| bibtex | This option (no value needed) activates links to BibTeX files. | 0 | bibtex |
| full | This option (no value needed) activates links to the full texts of the publication. These are full texts on mediaTUM or DOI links. | 0 | full |
| math | This option (no value needed) activates Mathjax libraries. | 0 | math |
| www | This option adds the stored www addresses. | 0 | www |
Caching CurlContent
By default, the data is retrieved from mediaTUM every 10 days.
You have the option to control the cache duration directly in the plugin:
- Go to the Cache settings tab (Image 6)
- Set the desired duration
- Please use this option with caution!
For an immediate update, you must use the Clear Cache for this page option:
- Click on the page where the plugin is located
- Click the lightning symbol Clear Cache for this page in the upper right corner
- Refresh the page in the frontend
Custom URL: Filter publications
Do you want to filter only certain publications from a "NodeID"? For example, only the publications of a specific author? You can present the publications as desired using custom queries (Custom URL).
By specific authors
A Custom URL for a specific author could look like this:
To create your own query, replace:
- 976025 with the desired "NodeID."
- jossen with the desired name (twice).
- Enter the Custom URL in the Parameters for preset field.
Hints
You must encode umlauts and accents in the name: for example, Müller becomes Mueller.
(change: ß → ss, ä → ae, ö → oe, ü → ue, etc.)
Further information on the mediaTUM web service can be found in the "readthedocs: MediaTUM" guide.
The query uses the full name. Searching for "Huber" should not return results for Schubert. If it does, or to correctly assign the publications of different individuals with the same last name, you can create a folder in mediaTUM to which you copy the desired publications. Use the "NodeID" of this folder in the CurlContent plugin.
Filtering by last name and first name of the author
For common names like "Müller" or "Maier," you can add the first name or the initial of the first name.
The publications for Daniel Maier can be queried from mediaTUM as follows: https://mediatum.ub.tum.de/services/export/node/670546/allchildren?limit=555&attrreg=author-contrib=.*Maier%2C%20D
%2C indicates a comma and %20 is a space. Using “Maier%2C%20D” searches for “Maier, D”.
Filtering by keywords
If keywords are stored in mediaTUM, publications can be filtered by these keywords. The query filters based on keywords. An example of a Custom URL with the keyword GISTop_Semantic_modeling_and_transformation:
If there are two people with the last name Müller in a department, you can also manage the filtering with keywords, e.g., LSXY_Mueller1 and LSXY_Mueller2.
General notes and hints
If your Custom URL does not yield the desired result, please check the following:
- Enter the Custom URL in the browser and compare the (unformatted) output with the expected result. If you do not get the desired result here, the error lies in the data source at mediaTUM.
- Directly search for the publications in mediaTUM and compare whether the data there matches the Custom URL. Pay particular attention to the "NodeID"!
If you’ve ruled out an error in mediaTUM, there are additional options to check in CurlContent:
- Turn off XSL processing and see if you obtain an unformatted output for your query in the frontend.
- Does your Custom URL start with https? (http is no longer possible for security reasons!)
- Does your Custom URL contain umlauts?