How to install ECQuiz Product in Plone

What is ECQuiz

“A Plone product for multiple-choice tests, including extended text questions with tutor grading.” - visit their homepage here. You can find the package at pypi.

This product allows the creation of quizes within the Plone content management system, especially tailored to quizes for universities.

How to use ECQuiz

The ECQuiz product available at pypi is build for Plone 4.1. I was able to get a running version with Plone version 4.1.3.

So the first step in order to install and use ECQuiz with Plone is to download Plone 4.1.3 from the Plone Homepage.

$ wget https://launchpad.net/plone/4.1/4.1.3/+download/Plone-4.1.3-UnifiedInstaller.tgz
Next untar the file and execute the installer to install Plone.
$ tar -xf Plone-4.1.3-UnifiedInstaller.tgz
$ Plone-4.1.3-UnifiedInstaller/install.sh standalone
Plone will be installed to ~/Plone if not executed as root. Next add the egg for ECQuiz to the buildout configuration in order to install the product with the next execution of buildout.
$ nano ~/Plone/zinstance/buildout.cfg

Look for the “Eggs” section and add “Products.ECQuiz” there. If you’re done, this specific section of “buildout.cfg” should look like this:

############################################
# Eggs
# ----
# Add an indented line to the eggs section for any Python
# eggs or packages you wish to include.
#
eggs =
    Plone
    Pillow
    lxml
    Products.ECQuiz

As the correct version of ECQuiz and its dependencies isn’t installed per default, edit the file “versions.cfg” to choose the correct versions of the packages. Therefore add the following lines at the bottom of “versions.cfg”:

Products.ECQuiz                       = 1.4-rc1
Products.DataGridField                = 1.8
Next download and install the needed products by executing the following command.
$ bin/buildout
Finally you can start your Plone instance in debug mode by executing this command.
$ bin/plonectl fg
Choose ECQuiz as well as DataGridField as activated products when setting up your new page. If you already created a page before and just wish to add the ECQuiz functionality to the page, navigate to “Site Setup” and “AddOns” and choose both products. Use the following image as reference on how the AddOn page should look afterwards: