Moodle-Integration

QUAMP verfügt über eine Schnittstelle zum LMS (Lern-Management-System) Moodle. Diese ermöglicht es, in Moodle-Kursen Links zu Evaluationsfragebögen einzublenden, die pro Kurs und Studierenden nur einmal gültig sind. Die Schnittstelle ist als Moodle-Plugin (Block) realisiert.

This Moodle block module enables you to show up course evaluation links within a sidebar block in your Moodle courses. The given URL leads a student to feedback questionnaires and results reports managed by your QUAMP instance.

• QUAMP Moodle-Plugin v1: Moodle 1.7.x to Moodle 1.9.x
• QUAMP Moodle-Plugin v2: Moodle 2.x, Moodle 3.x
• PHP 5.x, enabled CURL module

1. Log in to your QUAMP backend
2. Select Course evaluation | Import & Export from main menu then QUAMP Moodle Plugin

1. See Moodle installation instructions here
2. Unpack ZIP archive
3. Put folder sl_quamp_course_evaluation_vx under /moodle/blocks folder (x=1 for Moodle 1.x, x=2 for Moodle > 2.x) and rename it into sl_quamp_course_evaluation
4. Visit administration page and select Notifications once you have installed or updated the block plugin
5. Edit global block settings at: Site Administration Block | Modules | Blocks | Course evaluation | Settings
   1. Use your QUAMP instance URL for QUAMP-Server: https://evaluation.your-organisation.de
   2. Find your QUAMP instance API key in QUAMP backend under CMS | Applications then Edit application | System integration

The following global/default settings are available.

• QUAMP server URL. Your QUAMP instance, e.g. https://evaluation.your-organisation.de (including protocol and host names)
• Proxy-Server. For using a proxy server, format: user:password@ip:port
• Connection timeout. Timeout in seconds waiting for QUAMP response
• API key. API key to get allowed connecting QUAMP instance
• Course key field. Select
  • manual mode. lecturers set course key of counterpart's QUAMP course manually or
  • data base field. field of Moodle db course table holding the course key
• Allow overwriting course key by lecturers. Whether or not lecturers can overwrite course key at instance/course level

• Block Title. Course evaluation block title
• Invitation text. Text to invite students
• Questionnaire link text. Link text to click on
• Help page URL for course editors. URL of a Help/FAQ page to link to from instance/course settings page

Lecturers may overwrite some of the global/default settings at instance (course) level.

• Invitation text. Text shown up in the course evaluation block
• Questionnaire link text. Link text shown up to click on
• Course key. Key of the counter part QUAMP course

Lecturers may set the course key manually. This helps when no course key is available at all. Setting the course key manually overwrites the course key given by the specified DB field (see global settings).

To ensure that no Moodle user (student) can fill in the questionnaire multiple times the user's user name will be encoded (MD5 hash) and transmitted when requesting QUAMP for survey URLs. This user key is only used to check whether or not a user (student) has already been participated.

When Moodle is asking your QUAMP instance for a survey URL, QUAMP uses several error codes. The following codes are used:

• access denied No or incorrect API key was given.
• no course No or unknown course key was given. QUAMP is looking for courses using the following course table fields in the QUAMP database: (1) the course key, (2) the user editable moodle name and (3) the user editable course id in combination with the current semester.
• out of time period The survey period has not been reached or is over. The questionnaire is not yet or no longer available.
• no user No user name (any key) was given or user has already been participated. Use a hashed key. QUAMP stores the key as is.
• not active The course is not yet activated for course evaluation. Possible reasons are, the lecturer set course evaluation to finished or no questionnaire was defined.
• paper Paper&Pencil questionnaire set.

Moodle shows up a customizable text message in case one of the error codes was received. Edit the translation files included in the plug in to change the default messages. English and German translations are shipped.

In all other cases an URL is returned by your QUAMP instance containing information on the course, on the user and on the questionnaire's language setting. This URL leads either to the questionnaire or to the Student's report in case the lecturer has finished course evaluation and set „results for students too“ manually.