JGU FIS

The JGU FIS plugin provides a WordPress shortcode for rendering a list of publications from Gutenberg Research Elements, JGU's Research Information System.

How to use JGU FIS

  1. Show your publications
  2. Live-Example
  3. Shortcode usage
  4. Shortcode parameters
    1. Query parameters
      1. user
      2. orgstructure
      3. tag
      4. equipment
      5. project
      6. grant (not yet activated)
      7. n
    2. Additional parameters
      1. style
      2. type
      3. year
      4. groupBy
      5. locale
    3. Combine Parameters
  5. A note on URL output
To Top of Page

Show your publications

Filter your Publications by user, organizational unit, tag and equipment. Group it by year and publication type.

Start with a query in Gutenberg Research Elements whether your publications are online already. If not, import them.

Gutenberg Research Elements

If your Shortcode is still visible on the published page, activate this plugin in the Dashboard  → JGU Tools  → Plugins

Warning: ⚠️ 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.

Some plugins require administrative preparations (JGU Auth, JGU Downloadcenter). Follow the instructions in Dashboard  → JGU Tools  → Plugins  → Activateand we will set up the plugin for you.

To Top of Page

Live-Example

Try our demo → JGU FIS

To Top of Page

Shortcode usage

Multiple usernames have to be comma separated:

To Top of Page

Shortcode parameters

The shortcode comes with a set of parameters that allows you to set what you want to query, and how the results should be rendered.

To Top of Page

Query parameters

❗ Note: The query parameters user, tag, equipment and orgstructure cannot be used together, i.e. you can query by only one of these parameters. The number of results for each of these parameters can be limited using the n parameter.

To Top of Page

user

Query publications by user
Value: User name, same that you use for logging in to your JGU account. A comma-separated list of users is also allowed.

Example:

To Top of Page

orgstructure

Query publications by organization structure
Value: ID of an organisation structure. A comma-separated list of orgstructure-IDs is also allowed.

  • ❗ Attention: The publication list from a single ID in the bottom level of the organisation is simply shown.
    If you like to show a list from a unit a level up in the structure tree, you need their IDs too. Ask for these IDs directly at the Team of Gutenberg Research Elements researchelements@uni-mainz.de

Example:

To Top of Page

tag

Query publications by tag(s)
Value: Comma-separated list of tags. If multiple tags are used, the query returns publications that are tagged with all given tags (AND logic). The tag has to be added manually in researchelements as Label → Unclassified.

Example:

To Top of Page

equipment

Query publications by equipment
Value: ID of an equipment, for example 69007 for "Mogon". A comma-separated equipment list is also allowed.

To find the ID of a piece of equipment:

Example:

To Top of Page

project

Query publications by project
Value: ID of a project. A comma-separated list of projects is also allowed.

To find the ID of a project:

❗ Note: Publications need to be manually connected to a project in researchelements.

Example:

To Top of Page

grant (not yet activated)

Query publications by grant
Value: ID of a grant

To find the ID of a grant:

Example:

To Top of Page

n

Limit the number of results returned from the query to the given number. The query will then return the last n results in reverse chronological order (in other words: newest first).
Value: Zahl

❗ Note: The n parameter will be ignored if you filter by years or publication type, see below.

Example:

To Top of Page

Additional parameters

To Top of Page

style

Set the CSL stylesheet for rendering the list of publications
Value: CSL style name, default apa-jgu

Available styles:

  • apa-jgu
  • apa
  • apa-cv
  • …
To Top of Page

type

Filter by one or more publication types
Value: Comma separated list of publication types

The following types can be used:

  • article
  • article-journal
  • book
  • chapter
  • document
  • paper-conference
  • patent
  • report
  • thesis
  • webpage

Example:

To Top of Page

year

Filter by one or more years
Value: Comma separated list of years in the format YYYY

Example:

To Top of Page

groupBy

Group results by year or type
Possible values: year or type

Example:

To Top of Page

locale

The locale to be used for rendering the result.
Values: locale in the format en_US, de_DE

Default: locale of the blog

Example:

To Top of Page

Combine Parameters

Separate more than one value with commas, separate parameters with spaces.

Example separate values:

Example separate parameters:

To Top of Page

A note on URL output

Gutenberg Research Elements has three fields that can contain a URL: Author-URL, Publisher-URL und Public-URL. Only one of these fields will be rendered, using the following logic:

If the Author-URL is filled, the Author-URL will be used. If not, the Publisher-URL. If the publisher URL is also empty, the Public-URL field will be used.

This means that if you want to output a specific URL, make sure to use the Author-URL field in Gutenberg Research Elements.

To Top of Page