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

Cloze editor for Atto

From MoodleDocs
Revision as of 02:04, 29 July 2016 by German Valero (talk | contribs) (tidy up)

This is a Moodle 3.1 additional plugin, written by Daniel Thies, for easily making Embedded Answers (Cloze) question type inside the standard Moodle Atto text editor.

Highlights

  • This is a very user-friendly contributed plugin for the Atto editor for Moodle branches 2.7 to 3.1. Future branches will most likely be supported by the time they are released.
  • You can now have the power of the Embedded Answers (Cloze) question type without having to memorize the cloze syntax.
  • A popup window will let you choose any one of the available question types to be embedded. A description of the question type is shown in your own language, for you to easily choose the best question type to use.
  • A 'Duplicate' button lets you easily and quickly write variants of a question, while keeping the distractors and feedback you had previously written, thus saving your valuable time !


Background

Sites using cloze editor plugin for TinyMCE.png

  • As of april 2014, Moodle 2.7 and newer branches have Atto as the default editor, but TinyMCE can still be raised as the user editor in the user preferences as explained in a Moodle Docs page.
  • As of july 2016, two thirds of all registered Moodle sites are using versions 2.7 and higher!

All Moodle registrations by version in july 2016.png

  • We do not know for how long will TinyMCE still be included in the standard Moodle package.
  • In late July 2016, the cloze editor plugin for TinyMCE was the third most downloaded plugin for TinyMCE in Moodle.
  • Even though Atto is the standard text editor for most Moodle sites, only two (other) plugins for Atto have had as many or more downloads, in the previous three months !
  • There was a very energetic exchange of opinions in one Moodle forum thread about improvements on the cloze question type
  • Daniel Thies volunteered to write a cloze editor for Atto.
  • It is currently undergoing testing in Moodle 3.1.1 .
  • Daniel Thies greatly enhanced the plugin and improved the user-friendlines.
  • This Moodle Docs page was started to help new users of this plugin.

Current status

You can look at the progress of this plugin in https://github.com/dthies/moodle-atto_cloze

Current issues at https://github.com/dthies/moodle-atto_cloze/issues

Moodle branches supported

  • Moodle 3.1.1 testing going beautifully.
  • Moodle 2.7.15 testing going beautifully.
  • Other Moodle branches will be tested soon.

Languages supported

All Moodle 2.x and 3.x languages supported by AMOS are supported by this plugin. If you do not see the translations of the diferent question types descriptions, please ask your language pack maintainer.

Installation

Automatic installation from the Moodle plugins database

... Not yet available, but will be working towards it...

Manually installing from Github

  • Go to https://github.com/dthies/moodle-atto_cloze and download the ZIP file
  • Add the contents of this downloaded zip file in '... -> server-> moodle -> lib -> editor -> atto -> plugins ' directory and visit notifications to update database."
  • You must re-name the 'moodle-atto-cloze-master' folder into 'cloze'
  • After visiting notifications and updating the Moodle database, you must add the cloze button cloze icon.gif to the Atto toolbar as described in https://docs.moodle.org/31/en/Text_editor#Adding_extra_buttons adding the line cloze = cloze .

Cloze editor for Atto toolbar config add cloze = cloze.png

  • You may not notice any change because by default, the Atto toolbar has very few buttons showing:

Atto toolbar with few tools.png

  • Then, click on the very first button inside the Atto toolbar to expand the Atto toolbar:
  • Now, when you expand the (normally small) Atto toolbar, you will see the cloze icon.gif familiar cloze button.

Atto toolbar with many tools.png

  • You can now click on the cloze icon.gif button to open the cloze editor popup window.

...

Usage

  • When you want to create a cloze question type, choose 'cloze' in the Activity chooser

Add a Cloze question type.png

  • You will have the Atto editor for writing your new question:

Make a question using Atto.png

  • Notice the following image where you must click on the (red square) first Atto button in order to expand the Atto toolbar, so that it shows the cloze icon.gif cloze plugin button (green square):

Make a question using Atto expand toolbar.png

  • When you click on the cloze button inside the Atto toolbar, a popup window will let you choose any of the available question types:

cloze editor for atto available question types and description.png

Note: The English language strings with the descriptions of the available question types is available for translation in AMOS. So, if you are using Moodle in a language other than English, you may see these descriptions in your home language


DUTCH Atto cloze editor available question types.png


  • Click on any question type you want to use:
  • If you had previoulsy blocked some text just before clicking on the cloze tool button, this text will be automatically inserted as the first correct answer.

Duplicate a question using the same distractors and feedback

  • There is a button on the chooser that loads the previous answers.
  • The form will then populate with the same data as the previous question you just recently made.
  • The advantage of having this is for producing several multichoice questions with the same distractors and feedback.
  • This is specially useful if you want to create a matching type question.

Available question types

MULTICHOICE Cloze multichoice.png

MULTICHOICE_H Type multichoice h.png

MULTICHOICE_V Type multichoice v.png

NUMERICAL Cloze numerical.png

SHORTANSWER Cloze shortanswer.png

The following question types with an S in their names denote that the question behavior shuffle option is on:

MULTICHOICE_S Type multichoice S.png

MULTICHOICE_HS Type multichoice hs.png

MULTICHOICE_VS Type multichoice vs.png

See also