Note: You are currently viewing documentation for Moodle 3.2. Up-to-date documentation for the latest stable version of Moodle is probably available here: Cloze editor module.

Cloze editor module

From MoodleDocs
Revision as of 11:07, 27 February 2014 by Andreas Glombitza (talk | contribs) (copied over from the last version for 2.5 (which should be identical))

An interface that integrates with Moodle's existing HTML editor (HTMLArea in 1.9 and TinyMCE in 2.x) to support teachers in creating Cloze (Embedded answers) questions in the GIFT syntax.

Download

You can download specific versions for Moodle 1.9, 2.0, 2.1 and for 2.4 up to 2.7 from Google code.

Overview

The integration (PHP/javascript) is essentially a new button in the HTML editor which brings up an interface that helps create CLOZE questions in the correct syntax. It will also read and edit existing CLOZE items (which you have selected with your cursor).

Here's a demonstrator (which can also be used to create your own CLOZE quizzes):

http://goo.gl/zxRQmN

Installation instructions

Installation for Moodle 1.9 version

  1. Unzip
  2. copy to your moodleroot directory, keeping the directory structure

The following files in your origina Moodle installation will be overwritten with mod'd files (so make sure to BACK THEM UP before):

lib/weblib.php *
lib/editor/htmlarea/htmlarea.php
lib/editor/htmlarea/dialog.js
* Overwriting the weblib.php file is OPTIONAL:
  • If you choose to include this modified weblib.php file, the CLOZE-editor button will only show for teachers, and only in question-interfaces. In any other editor instances, and for students, it will be hidden. This is very convenient :)
  • If you refrain from overwriting the weblib.php file, the cloze editor plugin will still work, but the editor button will be visible in EVERY editor instance for teachers, but not for students. This might be disconcertirg for some teachers :(

Installation for Moodle 2.0 and 2.1

  1. Unzip.
  2. Copy the contents of the directory to the directory lib/editor/tinymce on your Moodle installation, keeping the directory structure.
  3. Visit ' Administration > Site Administration > Notifications '
  4. Finish the installation process by clicking on the 'Upgrade Moodle database now' button.

The following files in your installation will be OVERWRITTEN with mod'd files (so make sure to BACK THEM UP):

lib/editor/tinymce/lib.php
lib/editor/tinymce/land/en/editor_tinymce.php

Installation for Moodle 2.4 and higher versions

  1. Unzip
  2. Copy the contents of the directory to the directory lib/editor/tinymce/plugins on your Moodle installation, keeping the directory structure.
  3. Visit ' Administration > Site Administration > Notifications '
  4. Finish the installation process by clicking on the 'Upgrade Moodle database now' button.

Installation for Moodle 2.5 and higher versions

As of Moodle version 2.5, the plugin can be deployed from within Moodle, by uploading the cloze editor ZIP file (see https://docs.moodle.org/25/en/Installing_add-ons#Installing_via_uploaded_ZIP_file).

  1. Download the cloze editor ZIP-package
  2. In your Moodle "Site Administration" menu, go to "Plugins/Install add-ons"
  3. Select "Editor TinyMCE / tinymce (tinymce)" as "Plugin type"
  4. Upload and select the cloze editor ZIP-package for Moodle 2.4+ (which you previously downloaded)
  5. Follow Moodle's instructions to finish the installation process

Using the cloze editor

  • We will be asking the students to choose the correct word used in a poem by Emily Dickinson:
  • The cloze editor button is a small yellow question mark in the HTML editor.

Cloze editor symbol.png

  • Write a small text (e.g, the poem) in the HTML editor

to make a prairie 1.png

  • Select a word to be replaced by a CLOZE (in this case, bee)

to make a prairie 2.png

  • Click on the small yellow question mark Cloze editor symbol small.png
  • Choose the type of CLOZE sub-question format that you want (in this case, a drop-down menu in-line in the text)

to make a prairie 3.png

  • The correct answer has been placed automatically.
  • Check it and write some feedback if you want

to make a prairie 3.png

  • Fill in the wrong answers (if any)

to make a prairie 4.png

  • Click on the 'Insert' button to process

to make a prairie 5.png

  • The correct CLOZE syntax will be shown within the editor window

to make a prairie 6.png

  • Save the question
  • Check that the question works as intended

to make a prairie 7.png

Editing existing CLOZE items

  • Select an existing CLOZE item with your cursor (including the curly outer brackets). Then click on the small yellow question mark. The editor will come up, with the fields correctly populated for this item.

The cloze editor button and Moodle roles

  • The CLOZE-editor button will only show for teachers.
  • For students, it will be hidden.
  • Once installed, all teachers will see the cloze editor button every time they use the HTML editor, even when they are writing something else not related to a cloze question (e.g: a forum post).

Other languages

  • If you make a Language customization, you can have the cloze editor in your preferred language.
  • The following image shows a mexican spanish translation of the English language strings of this add-on.

cloze editor language customization.png

  • And here are the translated strings being used inside the plugin:

Cloze editor in spanish.png

See also