PUMA/BibSonomy Module

PBM is the PUMA/BibSonomy plugin for Moodle. It helps you to publish publication lists from the Publication Management System PUMA or BibSonomy within a Moodle course.

More information about PUMA and BibSonomy can be found at www.academic-puma.de and at bitbucket.bibsonomy.org

Please note that you need a PUMA account from the PUMA server of your institution in order to fetch publication lists from it. Alternatively you can create a BibSonomy account for free in order to test PBM with BibSonomy.

1. What does it do?
2. For Admins
3. For Users

1. What does it do?

The PBM plugin helps you to publish lists of publications within a moodle course. Such lists are fetched from the Publication Management Software PUMA or the social bookmark and publication sharing system BibSonomy. The lists are configured through specifying a user name, a user group, and/or a set of tags.

The style in which the bibliography is displayed on the moodle course page can be chosen from various CSL files (Citation Style Language).

2. For Admins

2.1 Installation

The following steps are necessary to add the PBM Plugin to a running Moodle installation.

• Download the plugin from the BitBucket repository: https://bitbucket.org/bibsonomy/pbm or directly from Moodles plugin repository: https://moodle.org/plugins/view.php?plugin=mod_pbm
• Unzip the file within your mod folder of the moodle installation. (e.g. /var/www/moodle/mod/pbm)
• Go to the Moodle website, log in as an administrator and navigate to "Site administration -> Plugins -> Plugins overview".
• Click the button "Check for available updates" at the top of the plugins overview page.
• Moodle should now inform you that database updates have to be made. Confirm that.
• You will be asked for a default server adress, OAuth consumer credentials and a choice of citation styles. See 2.2 for Details.

2.2 Configuration

Default PBM Server: Insert the address of your institutional PUMA server or the URL of BibSonomy (e.g. http://puma.uni-kassel.de or http://www.bibsonomy.org). This will be used as the default when adding a PBM instance to a course.

Comsumer-Key/Consumer-Secret(Optional): An admin of a PUMA system can create OAuth consumer credentials in the local admin settings. They will be used to link user accounts to PUMA in order to use OAuth authentication. Alternatively you can write an E-Mail to webmaster@bibsonomy.org when using BibSonomy to demand OAuth consumer credentials. This is optional as it's also possible to use BasicAuth.

Available CSL files: Here you can choose between several citation styles which will be available when adding/editing PBM instances within courses. You can find more information about citation styles here: (Citation Style Language).

3. For Users

3.1 Create a publication list in a Moodle course

The following steps explain how the plugin can be used by a teacher/trainer to generate literature lists on a Moodle course page. Note: The teacher/trainer who creates a new PBM instance needs valid authentication credentials deposited in his/her user profile settings. A user profile can be edited by clicking the user name in the upper right corner (default layout) and choosing "Profile". The PBM specific fields can be found under the PUMA/BibSonomy category. See 3.3 for details.

• Turn on the editing mode and click the "Add an activity or resource" link.
• A list with activity modules will pop up. Mark PBM and click add.

• Now you can add information in order to specify the list of publications.

  

  Select Content Source: You can create lists using different criteria: Select posts of a specific user, a group, or posts that are viewable for a particular user/group.

  Id of user, group or viewable source: The identifier for a source: e.g. a user name or group id.

  Tags: A white space separated list of tags.

  Downloadable Documents?: When checked, it is possible to download attached documents.

  Select Authentication Method: Determines which authentication method should be used when the publications being fetched from the PUMA/BibSonomy server. See 3.3 for details.

  URL of PUMA or BibSonomy server: Either the PUMA server of your institution or http://www.bibsonomy.org.

  Citation style language: Some citation styles may differ between certain languages.

  Citation style: The citation style determines how a single publication will be formatted. PBM comes with a couple of csl files. Get more at (http://citationstyles.org/).

3.2 Add to my PUMA Button

When a user has provided authentication credentials (See 3.3 for details) he/she can add publications from a list to his personal list on PUMA/BibSonomy. This is achieved through the button at the lower right of each publication. When a publication already is in the personal list a green tick will be displayed.

3.3 Configuration

API-User: The user id of an PUMA/BibSonomy-Account.

API-Key: The associated key can be found at "Settings -> Settings-Tab" under the API area when logged in at a PUMA/BibSonomy system.

OAuth Link: When this field is checked and changes of the profile are saved the user will be redirected to the default PBM server to allow this user using OAuth.

Note that the user has to be logged in at the PUMA/BibSonomy system before linking his/her account. Otherwise the redirection will not work properly and he/she needs to do the linkage again.

4. Changelog

Version: 2015102000

• Added possibility to use OAuth. (For users when using the new add button, for teachers/trainers when publication lists are being fetched from the a list)
• Prefered authentication method can now be selected in every single PBM instance.
• A new button makes it easy to add publications directly from Moodle to the personal list on PUMA/BibSonomy.
• Admins can now limit/extend the available citation styles for users creating a PBM instance.
• As some citation styles differ between languages it's now possible to specify the language.
• Revised readme file.