Glossary export to quiz: Difference between revisions

From MoodleDocs
mNo edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 2: Line 2:
|type = Block
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_glossary_export_to_quiz
|entry = https://moodle.org/plugins/view.php?plugin=block_glossary_export_to_quiz
|tracker =  
|tracker = https://github.com/rezeau/moodle-block_glossary_export_to_quiz/issues
|discussion = https://moodle.org/mod/forum/discuss.php?d=162866
|discussion = https://moodle.org/mod/forum/discuss.php?d=162866
|maintainer = [[User:Joseph Rézeau|Joseph Rézeau]]
|maintainer = [[User:Joseph Rézeau|Joseph Rézeau]]
Line 10: Line 10:
== Installation ==
== Installation ==


For more information see [[Installing add-ons]]
For more information see [[Installing plugins]].


== Overview ==
== Overview ==
A block to export a Glossary's entries to the Quiz Questions bank. Exports concepts & definitions to SHORTANSWER or MULTICHOICE questions.
A block to export a Glossary's entries to the Quiz Questions bank. Exports concepts & definitions to '''Short answer''', '''Multiple choice''', '''Matching''' or '''Drag and drop into text''' questions.


==Export entries from Glossary to moodle quiz XML file==
==Export entries from Glossary to moodle quiz XML file==
 
=== How to access the block's configuration ===
# Go to your course's front page and go into Edit mode and click on the Configuration icon to configure the Export Glossary to Quiz block.
After this block has been installed (by an Admin) on your Moodle site, it should be available to the site's users with a Teacher capability, in their own courses.
# Use the dropdown list to select the glossary that you want to use to export its entries to the quiz questions bank. If that glossary contains categories, you can select only one category to export its entries. To cancel your choice or to reset the block, simply leave the dropdown list on the Choose... position.
# As a teacher, go to your course's front page, Click on the main Actions icon to go into Edit mode and Turn editing on.
# Maximum number of entries to export. Leave empty to export all entries from selected Glossary or Category. This option can be useful for exporting a limited number of entries from very large glossaries.
# In the side panel, click on Add a block. In the list which appears, click to select the Export Glossary to Quiz block.
# Glossary entries can be exported to the Quiz Questions bank either as multiple choice or short answer questions.
# The Export Glossary to Quiz block gets displayed in your course's default block zone (depending on the current theme).
## Multiple choice questions will consist of the following elements:
# Click on the block's Action icon to configure the Export Glossary to Quiz block.
### question text = glossary entry definition
=== Configuring an Export Glossary to Quiz block ===
### correct answer = glossary entry concept
# Use the drop-down list to '''select the glossary''' that you want to use to export its entries to the quiz questions bank. If that glossary contains categories, you can select one category to export its entries. To cancel your choice or to reset the block, simply leave that drop-down list on the Choose... position. Once a glossary has been selected, more options appear...
### distracters = 3 glossary entry concepts randomly selected from the glossary (or glossary category) that you have selected.
# '''Sorting Order'''. Use this setting to determine how the exported glossary entries will be ordered when you import them to your questions data bank. This can be used, in combination with the Maximum number of entries, for creating a quiz to test the latest entries to your glossary (especially a fairly large one).
### You have a choice of 4 types of numbering for the exported multiple choice questions:<p><ul><li> a. b. c. (the default numbering type)</li><li>A. B. C. D.</li><li>1. 2. 3.</li><li>no numbering</li></ul></p>
# '''Maximum number of entries to export'''. Leave this field empty (or at its default '''0''' value) to export '''all''' entries from selected Glossary or Category. This option can be useful for exporting a limited number of entries from very large glossaries.
##Short answer questions
# '''Select question type'''
### Case insensitive. Student responses will be accepted as correct regardless of the original glossary entry concept case (uppercase or lowercase).<p>Example: original entry "Moodle". Accepted correct responses: "Moodle", "moodle".</p>
##'''''Short answer''''' When you select this type, a Case sensitivity drop-down list is displayed. <ul><li> ''Case insensitive''. Student responses will be accepted as correct regardless of the original glossary entry concept case (upper-case or lower-case). Example: original entry "Moodle". Accepted correct responses: "Moodle", "moodle".</li><li>Case sensitive. Student responses will be only be accepted as correct it the case of the original glossary entry concept is used. Example: original entry "Moodle". Accepted correct response: "Moodle".</li></ul>
### Case sensitive. Student responses will be only be accepted as correct it the case of the original glossary entry concept is used.<p>Example: original entry "Moodle". Accepted correct response: "Moodle".</p>
## '''''Multiple choice''''' questions will consist of the following elements: ''question text'' = glossary entry definition; ''correct answer'' = glossary entry concept; ''distracters'' = 2 (or more) glossary entry concepts randomly selected from the glossary (or glossary category) that you have selected. When you select this type, 3 drop-down lists get displayed. <ul><li> ''Number of choices''. Select the number of total choices/answers you want to make available to the student (this number includes the correct answer plus the distracters).</li><li>''Number the choices'' Select your preferred numbering style for the choices..</li><li>''Shuffle within questions'  Select whether the answers will be shuffled.</li></ul>
# When done, click OK.
## '''''Matching''''' questions will consist of a number of concepts and definitions which the student will have to match. A standard text of instructions will be added to the question: 'Match the definitions and the concepts'. When you select this type, 2 drop-down lists get displayed. <ul><li> ''Number of choices''. Select the number of pairs you want to make available for matching.</li><li>''Shuffle within questions'  Select whether the answers will be shuffled.</li></ul>
## ''''Drag and drop into text'''' questions will consist of a number of definitions which the student will have to complete by dragging & dropping the concepts into blanks. A standard text of instructions will be added to the question: 'Drag each concept label to match its definition'. When you select this type, 2 drop-down lists get displayed. <ul><li> ''Number of choices''. Select the number of articles you want to make available for each question.</li><li>''Shuffle within questions'  Select whether the answers will be shuffled.</li></ul>
# '''Save changes''' Upon saving the form validation check may throw out a message warning you that the number of entries or of choices you entered are incorrect. Please amend as needed before re-saving!
== Exporting the selected entries as questions to a moodle Questions XML file ==
# You are back in the course homepage, but now the block displays the settings you have selected.
# You are back in the course homepage, but now the block displays the settings you have selected.
# Click on the [Export n entries] link.
# Click on the '''Export n entries and create n questions''' link.
# Now you are on page Your course -> Glossaries -> (e.g.) Demo -> Glossary -> Export entries to Quiz (XML)
# Now you are on page Your course -> Glossaries -> [glosssary name] -> Glossary -> Export entries to Quiz (XML)
# Click on the Export entries to file button.
# Click on the Export button.
# At the prompt, save file to your computer. Its name is e.g. Demo_Glossary.xml.
# At the prompt, save file to your computer. Its named after this pattern: '''[glosssary name] [QUESTIONTYPE (abbreviated)] questions.xml'''.
# Go back to the course's homepage. You see that the the Export Glossary to Quiz block has been reset.
# Click the Return to course button/link. You see that the the Export Glossary to Quiz block has been reset.


==Import to the quiz questions bank==
==Import to the quiz questions bank==
Line 42: Line 45:
# On the Edit questions page, Click the Import tab
# On the Edit questions page, Click the Import tab
# Set these settings:<p><ul><li>File format : Moodle XML format</li><li>General</li><li>Category Default</li><li>Get category from file (check it)</li><li>Import from file upload...</li></ul></p>
# Set these settings:<p><ul><li>File format : Moodle XML format</li><li>General</li><li>Category Default</li><li>Get category from file (check it)</li><li>Import from file upload...</li></ul></p>
# Go to the file you saved to your computer in step A 10 (Demo_Glossary.xml. and click Upload this file button.
# Go to the file you saved to your computer and click Upload this file button.
# If all goes well, the imported questions should get displayed on the next screen.
# If all goes well, the imported questions should get displayed on the next screen.
# Click Continue.
# Click Continue.
# On the next page, the Question bank displays the new category name (formed on the name of the exported Glossary, plus the name of its category if you selected one of the glossary's categories) and of course all the questions that were imported (of the SHORTANSWER type).
# On the next page, the Question bank displays the new category name (formed on the name of the exported Glossary, plus the name of its category if you selected one of the glossary's categories) and of course all the questions that were imported  
# You can use the SHORTANSWER or the MULTICHOICE questions in a quiz.
# You can now use these questions in a quiz.
{{New features}}
 
You can use the SHORTANSWER questions to create one or more Random Short-Answer MATCHING questions.
[[Category:Block]]
[[Category:Contributed code]]
 
[[fr:Exporter un glossaire vers un Test]]
[[es:Exportación de glosario a examen]]

Latest revision as of 09:26, 25 September 2018

Installation

For more information see Installing plugins.

Overview

A block to export a Glossary's entries to the Quiz Questions bank. Exports concepts & definitions to Short answer, Multiple choice, Matching or Drag and drop into text questions.

Export entries from Glossary to moodle quiz XML file

How to access the block's configuration

After this block has been installed (by an Admin) on your Moodle site, it should be available to the site's users with a Teacher capability, in their own courses.

  1. As a teacher, go to your course's front page, Click on the main Actions icon to go into Edit mode and Turn editing on.
  2. In the side panel, click on Add a block. In the list which appears, click to select the Export Glossary to Quiz block.
  3. The Export Glossary to Quiz block gets displayed in your course's default block zone (depending on the current theme).
  4. Click on the block's Action icon to configure the Export Glossary to Quiz block.

Configuring an Export Glossary to Quiz block

  1. Use the drop-down list to select the glossary that you want to use to export its entries to the quiz questions bank. If that glossary contains categories, you can select one category to export its entries. To cancel your choice or to reset the block, simply leave that drop-down list on the Choose... position. Once a glossary has been selected, more options appear...
  2. Sorting Order. Use this setting to determine how the exported glossary entries will be ordered when you import them to your questions data bank. This can be used, in combination with the Maximum number of entries, for creating a quiz to test the latest entries to your glossary (especially a fairly large one).
  3. Maximum number of entries to export. Leave this field empty (or at its default 0 value) to export all entries from selected Glossary or Category. This option can be useful for exporting a limited number of entries from very large glossaries.
  4. Select question type
    1. Short answer When you select this type, a Case sensitivity drop-down list is displayed.
      • Case insensitive. Student responses will be accepted as correct regardless of the original glossary entry concept case (upper-case or lower-case). Example: original entry "Moodle". Accepted correct responses: "Moodle", "moodle".
      • Case sensitive. Student responses will be only be accepted as correct it the case of the original glossary entry concept is used. Example: original entry "Moodle". Accepted correct response: "Moodle".
    2. Multiple choice questions will consist of the following elements: question text = glossary entry definition; correct answer = glossary entry concept; distracters = 2 (or more) glossary entry concepts randomly selected from the glossary (or glossary category) that you have selected. When you select this type, 3 drop-down lists get displayed.
      • Number of choices. Select the number of total choices/answers you want to make available to the student (this number includes the correct answer plus the distracters).
      • Number the choices Select your preferred numbering style for the choices..
      • Shuffle within questions' Select whether the answers will be shuffled.
    3. Matching questions will consist of a number of concepts and definitions which the student will have to match. A standard text of instructions will be added to the question: 'Match the definitions and the concepts'. When you select this type, 2 drop-down lists get displayed.
      • Number of choices. Select the number of pairs you want to make available for matching.
      • Shuffle within questions' Select whether the answers will be shuffled.
    4. 'Drag and drop into text' questions will consist of a number of definitions which the student will have to complete by dragging & dropping the concepts into blanks. A standard text of instructions will be added to the question: 'Drag each concept label to match its definition'. When you select this type, 2 drop-down lists get displayed.
      • Number of choices. Select the number of articles you want to make available for each question.
      • Shuffle within questions' Select whether the answers will be shuffled.
  5. Save changes Upon saving the form validation check may throw out a message warning you that the number of entries or of choices you entered are incorrect. Please amend as needed before re-saving!

Exporting the selected entries as questions to a moodle Questions XML file

  1. You are back in the course homepage, but now the block displays the settings you have selected.
  2. Click on the Export n entries and create n questions link.
  3. Now you are on page Your course -> Glossaries -> [glosssary name] -> Glossary -> Export entries to Quiz (XML)
  4. Click on the Export button.
  5. At the prompt, save file to your computer. Its named after this pattern: [glosssary name] [QUESTIONTYPE (abbreviated)] questions.xml.
  6. Click the Return to course button/link. You see that the the Export Glossary to Quiz block has been reset.

Import to the quiz questions bank

  1. Turn editing on
  2. In Administration block, click Questions
  3. On the Edit questions page, Click the Import tab
  4. Set these settings:

    • File format : Moodle XML format
    • General
    • Category Default
    • Get category from file (check it)
    • Import from file upload...

  5. Go to the file you saved to your computer and click Upload this file button.
  6. If all goes well, the imported questions should get displayed on the next screen.
  7. Click Continue.
  8. On the next page, the Question bank displays the new category name (formed on the name of the exported Glossary, plus the name of its category if you selected one of the glossary's categories) and of course all the questions that were imported
  9. You can now use these questions in a quiz.