STACK Question for ILIAS:

Software Requirements

STACK requires PHP version 7.4 to work properly on your ILIAS platform

STACK requires the mbstring PHP library to run properly, this library is by default included in ILIAS, but please ensure your installation includes that library on the composer.json dependencies.

STACK requires Maxima, an Open-Source Computer Algebra System to work. Ensure you have a Maxima instance installed on the web server running your ILIAS installation, or you have a Maxima Pool / Goemaxima connection before installing this plugin in your platform.

If you are using a local Maxima Installation, ensure it is at least Maxima 5.45

If you are using MaximaPool or GoeMaxima, the expected compiled version for the current ilias7_stack2021 branch is 2021120900

STACK requires GNUPlot, which is used by Maxima to generate graphical plots of functions etc. It is freely available and part of most Linux distrubutions. GNUplot needs to be installed on the web server running your ILIAS and maxima installations.

STACK requires Mathjax, to be active on your ILIAS installation.

MathJax is an open source JavaScript display engine for mathematics. It is used by the STACK plugin to display maths in question, user input validation and feedback. It can either be linked from cdn.mathjax.org or downloaded to your own web server. It has to be configured in ILIAS

The STACK Question Plugin repository has been transferred from ILI-FAU to Surlabs' repository on 01.06.2023. If the plugin was already installed in your platform, you need to update the git remotes. You will need to follow this Instructions as if you are installing the plugin for the first time. All STACK Content created in your platform will remain and work as previously, it's just a GIT remote change. For that, you need to remove the current assStackQuestion folder, and continue the Installation process as it follows.

Installation & Update

Create subdirectories, if necessary for Customizing/global/plugins/Modules/TestQuestionPool/Questions/

In Customizing/global/plugins/Modules/TestQuestionPool/Questions/ execute

At Installation on the Questions folder, run:

git clone https://github.com/surlabs/STACK.git ./assStackQuestion

cd assStackQuestion

git checkout ilias7_stack2021

At Update, on the assStackQuestion folder, run:

git fetch

git pull

STACK uses the ILIAS composer autoloader functionality so, when installing or updating the plugin, ensure you always run on the ILIAS root folder

composer install --no-dev

Please ensure you don't ignore plugins on composer.json

Go to Administration > Plugins

Choose action "Install" or "Update" for the assStackQuestion plugin

Choose action "Activate" for the assStackQuestion plugin

Choose action "Refresh Languages" for the assStackQuestion plugin

Choose action "Configure" for the assStackQuestion plugin

Set the platform type and maxima servers according your installation

Go to the tab "Health Check" and click "Do Health Check"

If you can see the 3 Plots being rendered at the end of the screen, the plugin has been properly installed

Please, repeat this sequence everytime you update STACK