Skip to content

eLearning-TUDarmstadt/moodle-mod_tureview

Repository files navigation

TU Review (tureview) Moodle Activity Module

PHP Moodle Contributions welcome License

TU Review Banner

The TU Review (tureview) Moodle activity module is designed to facilitate controlled and secure review sessions of quiz activities. It extends the functionality of the standard quiz module by providing enhanced security features, time management, and session control for reviews. This module is ideal for educational institutions and organizations that require a secure environment for reviews, minimizing leakage of exercises, while keeping maximum convenience.

Installation Instructions

Optional Preparations

Since the Safe Exam Browser Mac/iOS are currently not able to append query parameters to an url which already has query parameters, here is an .htaccess file in this directory. If you enable the rewrite module mod_rewrite on your apache servers, you are able to change the start url from /mod/tureview/review.php?cmid=42 to /mod/tureview/42/review.php. To enable the module please use the following commands:

sudo a2enmod rewrite 
sudo a2enmod actions 

Restart Apache afterwards.

Method 1: Installation via Moodle UI

  1. Download the Plugin

    • Visit the Moodle Plugins Directory and search for "TU Review" or "tureview".
    • Download the plugin file.
  2. Log in as Administrator

    • Access your Moodle site and log in with administrator privileges.
  3. Navigate to Plugin Installation

    • Go to Site Administration > Plugins > Install Plugins.
  4. Upload the Plugin

    • Click on "Upload a file" and select the downloaded plugin file.
    • Follow the on-screen instructions to complete the installation.
  5. Enable the Plugin

    • After installation, navigate to Site Administration > Plugins > Activity Modules.
    • Locate "TU Review" and ensure it is enabled.

Method 2: Installation by Unzipping the Plugin into /mod

  1. Download the Plugin

    • Obtain the TU Review plugin file from the Moodle Plugins Directory.
  2. Unzip the Plugin

    • Extract the contents of the plugin file to access the plugin directory.
  3. Upload to Server

    • Using FTP or SSH, upload the extracted plugin files to the /mod/tureview directory on your Moodle server.
  4. Set Permissions

    • Ensure that the directory and file permissions are set correctly to allow Moodle to access the plugin.
  5. Enable the Plugin

    • Log in to your Moodle site as an administrator.
    • Navigate to Site Administration > Plugins > Activity Modules.
    • Locate "TU Review" and enable it if not already enabled.

Notes

  • Backup Your Site: Always ensure a full backup of your Moodle site before installing new plugins to prevent data loss in case of issues.
  • Permissions: Verify that the server has appropriate write permissions for the plugin directory when using the UI method.
  • FTP/SSH Access: For the manual method, ensure you have the necessary access to upload files directly to the server.

Features

  • Open and Close Dates: Define specific time frames during which the review session is accessible to users.
  • Time Limit for Review: Set a maximum duration for completing the review, adding structure and urgency.
  • Classic Review Options: Offers familiar review features such as viewing answers, seeing feedback, and reviewing attempts, similar to the standard quiz activity.
  • Subnet Access Only: Restrict access to specific IP ranges, enhancing security for controlled environments.
  • Per Session Review: Allows only one session per user, ensuring each review is taken seriously.
  • Session Management Page: Provides an overview and control panel for enabling, disabling, or deleting review sessions.
  • Safe Exam Browser Support: Enables the use of a custom configuration for the Safe Exam Browser, enhancing security during exams.
  • Safe Exam Browser Key Support: Adds an extra layer of security by supporting the use of keys for the Safe Exam Browser.
  • Classic Access Restriction: Integrates with Moodle's existing access restrictions, allowing role-based access control.

Activity Settings

General Settings

General Settings are similar to other activities, the only major difference is the Quiz Selector, use the selector to select the quiz to fetch the attempts from.

Timing

The Timing Settings allow for configuration of opening and closing dates (Similar to other activities). Additionally, you are able to configure a time limit for conducting a review (Similar to the quiz). Notably different from the quiz activity a reviewer may continue an already closed review if the individual review time is not over yet.

Review Options

These are the review options for the review, these options and the review options of the quiz activity are alike.

Restrictions

The Restriction Settings allow adding restrictions on the network from which a review may be conducted and also allows bypassing the manual enabling of the access, by automatically enabling sessions from whitelisted networks.

Safe Exam Browser

Enabling this setting allows the usage of Safe Exam Browser for conducting the review. Notably, if you do not use Safe Exam Browser Keys most relevant config settings are automatically corrected by the plugin. This is not the case when using Safe Exam Browser Keys, since these updates would change the corresponding browser key. The Safe Exam Browser Config Key will ALWAYS be checked regardless. Automatically managed settings are marked.

  • Activate URL filtering, add ${wwwroot}/mod/tureview/* Allow
  • Start URL ${wwwroot}/mod/tureview/review.php (Optionally add the ?cmid=<id> parameter for additional restriction Windows Only, or use the path ${wwwroot}/mod/tureview/${cmid}/review.php if the module rewrite is enabled).
  • Use Browser Exam Key and Configuration Key
  • Allow Query String Parameter
  • Quit URL ${wwwroot}/mod/tureview/quitseb.php

Issues

Currently Safe Exam Browser not working under MacOS/IOS, see Issue

About

A quiz review activity for controlled Reviewing

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors