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 for Atto.

Cloze editor for Atto: Difference between revisions

From MoodleDocs
(tidy up)
(tidy up)
Line 50: Line 50:
==Installation==
==Installation==
===Automatic installation from the Moodle plugins database===
===Automatic installation from the Moodle plugins database===
... Not yet available, but [https://moodle.org/plugins/atto_cloze working towards it...]
... Not yet available, but working towards it... We hope it will soon be available for download from [https://moodle.org/plugins/atto_cloze the Moodle plugins database].


[[File:Atto cloze editor in Moodle plugins database.png|600px]]
[[File:Atto cloze editor in Moodle plugins database.png|600px]]

Revision as of 19:03, 2 August 2016

This is a Moodle (2.7 to 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.
  • 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 registered 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 kindly volunteered to write a cloze editor for Atto, wrote the first version and improved on it for one month.
  • It has been extensively tested in Moodle 3.1, 3.0, 2.9, 2.8 and 2.7 in several languages.
  • Several user-friendly features have been incorporated into the current version.
  • This Moodle Docs page was started to help new users of this plugin.

Current status

This plugin is currently in a beta status. It has been submitted to Moodle, so it is in the review queue.You can look at the progress in https://github.com/dthies/moodle-atto_cloze

Current issues (if any) at https://github.com/dthies/moodle-atto_cloze/issues

Moodle branches supported

  • Moodle 3.1.1 testing has gone beautifully and all issues found have been happily solved.
  • Moodle 3.0.5+ (Build: 20160721) testing for plugin version 2016073100 has gone beautifully and no issues were found.
  • Moodle 2.9.7 (Build: 20160711) testing for plugin version 2016073100 has gone beautifully and no issues were found.
  • Moodle 2.8.12 (Build: 20160509) testing for plugin version 2016073100 has gone beautifully and no issues were found.
  • Moodle 2.7.15 (Build: 20160711) testing for plugin version 2016073100 has gone beautifully and no issues were found.
  • Future Moodle branches will most likely be supported by the time they are released (May and November).
    • Moodle 3.2dev (Build: 20160728) testing for plugin version 2016073100 has gone beautifully and no issues were found.

Moodle branches not supported

  • Moodle 2.6 and 2.5 branches: Even if you first install the Atto editor additional plugin, there is no way to configure the Atto toolbar to show the cloze button. This version of Atto is a very early version of Atto and is not the same as the one that was shipped with 2.7. That is why there is no config for it.

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 different question types descriptions, please ask your language pack maintainer.

Installation

Automatic installation from the Moodle plugins database

... Not yet available, but working towards it... We hope it will soon be available for download from the Moodle plugins database.

Atto cloze editor in Moodle plugins database.png

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/32/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

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. When you choose any question type, you will see a plain language description of what that question type does:

Cloze editor screen with button to duplicate answers.png

Note: The English language strings with the descriptions of the available question types are 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


Cloze editor screen in Spanish.png

  • Select the question type you want to use and click on the 'Add' button:
  • 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 'Duplicate' 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.

Cloze editor screen with button to duplicate answers.png

  • You can create several variants from one original question very quickly:

cloze question plus two variants.png

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