Adding/editing a hotpot

From MoodleDocs

Installing the HotPot Module

  1. First, download and install Hot Potatoes software on your PC:
  2. Next create the Hot Potatoes quizzes on your PC:
  3. Install HotPot module on your Moodle site
    1. download from
    2. unzip file - creates folder called "moodle-20.hotpot-module"
    3. upload subfolderfolders of "moodle-20.hotpot-module"
      1. mod/hotpot - upload this to "mod/hotpot" on your Moodle site
      2. question/format/hotpot - upload this to "question/format/hotpot" on your Moodle site
  4. Add HotPot activity to your Moodle course
    1. Login to Moodle, and navigate to a course page
    2. Enable "Edit mode" on course page
    3. Locate course topic/week where you wish to add the Hot Potatoes exercise
    4. Select "HotPot" from "Add an activity" menu
    5. Next to "Source file name" click "Add" button
    6. Click "Upload a file", then "Browse" to the Hot Potatoes file on your PC
    7. Click "Upload this file"
    8. Review other settings
    9. Click "Save changes" at bottom of page

Note: If you have a lot of Hot Potatoes quizzes to upload, you may save time by zipping them all up into a single file, uploading that to Moodle and then unzipping it there.

Relative URLs in Hot Potatoes quizzes


  • URL - The address of an internet resource, such as a webpage, image or sound file
  • Absolute URL - A URL that begins with "http://" is called an absolute URL. Wherever it is used, it always refers to the same target resource.
  • Relative URL - A URL that does not begin with "http://" is called a relative URL. It can be combined with the absolute URL of a "base" page, to get the absolute URL of the target resource.

Relative URLs are a convenient way to specify images, sounds and videos in a Hot Potatoes quiz, because they allow the quiz to be viewed and tested on a local PC, before being uploaded to a Moodle site. When the quiz is uploaded to the Moodle site, the multimedia files must also be uploaded, so that they are available when the quiz is administered via Moodle.

For security reasons, Moodle does not allow direct access to course files. All requests for files in a given course go through a guardian script which verifies that the person requesting the file is enrolled in the course. However, this mechanism can break relative links used in the quiz, because the normal rules for deriving an absolute URL from a relative URL do not work.

The solution is simple enough: all relative URLs must be converted to absolute URLs by the time the quiz reaches the browser. In the case of Hot Potatoes quizzes, the URLs will be converted by Moodle, so content creators do not have to bother with this tedious and error-prone task.

Media players in Hot Potatoes quizzes

Some media players will not accept the media file if it comes via the script which guards the course files. In this situation, it is necessary to replace the media player with one that is known to be compatible with Moodle. You can do this yourself by modifying the reference to the media player in the quiz, or you can force Moodle to do it by setting the "Force media plugins" option on the quiz's settings page to "Yes".