Skip to content

Latest commit

 

History

History
83 lines (50 loc) · 3.42 KB

README.md

File metadata and controls

83 lines (50 loc) · 3.42 KB
Raw

GIFT Quiz Tool

Apereo Incubating badge

This tool currently contains two pieces of related functionality:

  • It can author and deliver GIFT-authored quizzes using LTI
  • It can convert its quizzes to QTI 1.2

These two pieces are related because they share a bunch of library code.

Preloading Quizzes

You can have this quiz tool consult a folder to pre-load quizzes. Use the following configuration option in your config.php:

$CFG->giftquizzes = $CFG->dirroot.'/../php-solutions/quiz';

It should be a folder with a serires of files that end in *.txt in the GIFT format. You can store these files in a private GitHub repo. You can also add a password to all the files by creating the file .lock in the folder and put in a single line with the plaintext password to unlock the quzzes.

You can request a default quiz from this folder using a GET parameter:

http://localhost:8888/wa4e/mod/gift/?quiz=00-CSS.txt

The instructor still needs to go in and configure the quiz - but the right quiz will be pre-populated in the configuration drop down and pre-loaded if there is no .lock file.

Quiz format convertor from GIFT to QTI 1.2

This includes a simple converter into QTI 1.2 for import into lots of systems like Sakai, Coursera, and Canvas.

GIFT seems to be a micro-format invented by the Moodle community - and a pretty cool idea if I do say so myself. I like it because I can put quizzes in GitHub :)

https://docs.moodle.org/28/en/GIFT_format

There is a stand alone version of the GIFT converter at:

https://www.tsugi.org/gift2qti/

Comments (and Pull requests) welcome.

Unit Tests

If you want to run and/or make Unit tests, first install composer from

https://getcomposer.org/doc/

At some point you can run composer from the command line. Then from the gift folder do:

composer update

This will install phpunit into a vendor folder - don't worry - this won't go back into github - it is ignored.

Then to run the unit tests do:

vendor/bin/phpunit

It should look like this:

PHPUnit 5.7.27 by Sebastian Bergmann and contributors.
.  1 / 1 (100%)
Time: 21 ms, Memory: 4.00MB

OK (1 test, 4 assertions)

The unit tests are in folders under the folder tests - just add a subfolder and your unit tests in php files.

-- Chuck