Quiz Archiver

Archives quiz attempts as PDF and HTML files for long-term storage independent of Moodle. If desired, Moodle backups (.mbz) of both the quiz and the whole course can be included. A checksum is calculated for every file within the archive, as well as the archive itself, to allow verification of file integrity. Archives can optionally be cryptographically signed by a trusted authority using the Time-Stamp Protocol (TSP). Comprehensive archive settings allow selecting what should be included in the generated reports on a fine-granular level (e.g., exclude example solutions, include answer history, ...).

Generated quiz attempt reports include all elements of the test, even complex ones like MathJax formulas, STACK plots, GeoGebra applets, and other question / content types that require JavaScript processing. All PDF and HTML files are fully text-searchable, including rendered MathJax formulas. Content is saved vector based, whenever possible, to allow high-quality printing and zooming while keeping the file size down.

Quiz archives are created by an external quiz archive worker service to remove load from Moodle and to eliminate the need to install a large number of software dependencies on the webserver. It can easily be deployed using Docker.

Features

• Archiving of quiz attempts as PDF and HTML files
• Support for file submissions / attachments (e.g., essay files)
  
• Quiz attempt reports are accessible completely independent of Moodle, hereby ensuring long-term readability
• Customization of generated PDF and HTML reports
  • Allows creation of reduced reports, e.g., without example solutions, for handing out to students during inspection
• Support for complex content and question types, including Drag and Drop, MathJax formulas, STACK plots, and other question / content types that require JavaScript processing
• Quiz attempt reports are fully text-searchable, including mathematical formulas
• Moodle backups (.mbz) of both the quiz and the whole course are supported
• Generation of checksums for every file within the archive and the archive itself
• Cryptographic signing of archives and their creation date using the Time-Stamp Protocol (TSP)
• Archive and attempt report names are fully customizable and support dynamic variables (e.g., course name, quiz name, username, ...)
• Fine granular permission / capability management (e.g., only allow archive creation but prevent deletion)
• Allows definition of global archiving defaults as well as forced archiving policies (i.e., locked archive job presets that cannot be changed by the user)
  
• Fully asynchronous archive creation to reduce load on Moodle Server
• Automatic deletion of quiz archives after a specified retention period
  
• Data compression and vector based MathJax formulas to preserve disk space
• Technical separation of Moodle and archive worker service
• Data-minimising and security driven design

Installation and Configuration

For detailed installation and configuration instructions refer to the README.md. 

Usage

Once installed and set up, quizzes can be archived by performing the following steps:

1. Navigate to a Moodle quiz

2. Inside the Quiz administration menu expand the Results section and click on Quiz Archiver

3. Select the desired options and start the archive job by clicking the Archive quiz button

4. Wait until the archive job is completed. You can now download the archive from the Quiz Archiver page using the Download archive button.

Created archives can be deleted by clicking the Delete archive button.

If you encounter permission errors, ensure that the user has the required capabilities assigned.

License

2024 Niels Gandraß niels@gandrass.de

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.