MoodleDocs - User contributions [en]

Assignment settings

2012-03-25T09:52:27Z

Jtneill: /* Enable 'Send for marking' button */

{{Assignment}}
This page describes the various configuration options available within the Assignment module - both at the Site level and the Activity level.

==Course administration settings==
The following configuration options are available when creating or editing/updating any Assignment activity. Settings specific to each of the assignment types are detailed separately below.

To '''add a new Assignment activity''' to your course login with the appropriate access rights (e.g.editing teacher, course creator or administrator) and Turn Editing On. Within the required Week or Topic Block click on the Add Activity dropdown menu arrow and select the required assignment type.

To '''edit an existing Assignment activity''', login to your course with the appropriate access rights (e.g.editing teacher, course creator or administrator) and Turn Editing On and select the Update icon against the relevant Assignment item. Alternatively, after logging into your course simply click on the name of the Assignment activity you wish to edit and then click the Edit Settings link under ''Assignment administration'' within the Settings block.

===Assignment name===
Give your Assignment a name (e.g. “Report on Topic 1 Content”). The title entered here will be the name that learners see in the course content area. Learners will click on this name to view the details of the assignment and, if applicable, submit their work.

===Description===
The description of the assignment, which should include precise instructions for students regarding the subject of the assignment, the form, in which it should be submitted, the grading criteria etc.

Use this area to describe the assignment and explain what learners are expected to do to complete this task. The assignment description can be as brief or as detailed as you feel is necessary to meet the needs of your learners. However, it is to your benefit to provide as much detail and information as possible, especially at the start of the course while you are still establishing procedures. Generally, the more information you are able to provide here the fewer questions and problems your learners will have completing the task.

The assignment description field can also be used to provide information or resources related to the assignment. An instructor, for example, could provide some literature, a video clip, an image, or a link to a webpage, and then ask the learners to use these materials in completing the task.

===Available from===
The Available from setting prevents students from submitting their assignment before the shown date.

This option allows an instructor to set a day, month, year and time (24 hour clock) from which learners can begin to submit their assignments. Please note that this setting does not hide the activity from the learners. Instead, the learner will see the activity, be able to view the instructions and use any materials you have include in the description, but the learner will not be able to submit or complete the assignment until the Available from date.

By default the Available from date is Enabled (ticked) and is set at the day and time you selected Add Assignment. To Disable this feature simply ensure the Enable checkbox is not marked.

===Due date===
The Due date setting prevents students from submitting their assignment after the shown date.

This option allows an instructor to set a day, month, year and time (24 hour clock) before which learners must submit their assignment.

By default the Available from date is Enabled (ticked) and is set at 7 days ahead of the day and time you selected Add Assignment. To Disable this feature simply ensure the Enable checkbox is not marked.

====Notes on Date Settings====
Both the Available from and Due dates are displayed for learners in the assignment details, but the Due date is also marked in the course Calendar as a visible reminder for participants and provides a link to the activity.

Your use of the Available from and Due date settings will probably be dependent on the overall structure of your course. If you are facilitating an open ended course or a course with rolling enrolment, then you might find it easier to not apply the Available from and Due date settings. This arrangement will allow the learners to access the assignment according to their own schedule and progress within the course.

Alternatively, if you are working within a more structured format or adhering to a timeline, the Available from and Due date settings are useful for keeping learners on schedule. Using the Available from setting will make it possible for learners to preview upcoming activities, while at the same time, prevent them from finishing the course in the first week and not returning for additional activities or information. Likewise, the Due dates help keep the learners from lagging too far behind and decrease the likelihood that the learner will become overwhelmed by having to complete several weeks worth of work at once.

Assignments without a Due date will not appear on the My home page.

===Prevent late submissions===
Setting Prevent late submissions to Yes will prevent learners from being able to submit this assignment after the Due date (where specified). If you set Prevent late submissions to No, then learners can submit the assignment as long as the assignment is visible or accessible to them but their submissions will be marked as late.

===Grade===
Specify the maximum grade or [[Scales|Scale]] to be applied to the assignment. If you will not be giving a grade for the assignment, choose No Grade.

===Grading method===

{{New features}}Select either [[Rubric]] (advanced grading form used for criteria-based assessment) or simple direct grading (entering a grade or scale item).

===Grade Category===
Any custom [[Grade_categories|Grade Categories]] that have been created within your site or course will be listed here and will be available for selection. Select the required Grade Category to add this assignment as a [[Grade_items|Grade item]] within this Category.

===Common module settings===

==== Group mode ====
When course group mode is turned on, the [[Groups|group mode]] can be one of three levels: No groups, Separate groups or Visible groups.

'''No groups''' - There are no groups and all students submit their assignments in one Assignment area

'''Separate groups''' - Students submit their assignments within a separate Group based submission area and teachers/trainers can sort submissions by Group or view All Participants.

'''Visible groups''' - All students submits their assignment within a single Assignment area but may choose which Group to associate their submission with before uploading. Teachers/trainers can sort submissions by Group or view All Participants.

====Groupings====
Groupings is an Advanced setting. A grouping is a collection of groups within a course. If a existing grouping is selected from the dropdown list, students assigned to groups within the grouping will be able to work together within the group mode specified above.

====Visible====
Choose whether to Show or Hide the assignment from learner view. A hidden assignment will be displayed greyed out on the main course page for those with teacher, creator, manager or admin type roles but invisible to students/learners.

====ID number====
Setting an ID number provides a way of identifying the assignment for grade calculation purposes. If the activity is not included in any grade calculation then the ID number field can be left blank.

The ID number can also be set in the gradebook, though it can only be edited on the activity settings page.

===Restrict access settings===
The [[Restrict_access_settings|Restrict access]] area becomes visible in Moodle activities and resource settings if [[Conditional_activities|Conditional Activities]] have been enabled.

====Allow access from====
The Access from date determines the day, month and year students may first access the activity via the assignment name link on the course page. To activate this option click in the Enable checkbox to add a tick.

====Allow access until====
The Access until date determines the day, month and year students may last access the activity via the assignment name link on the course page. To activate this option click in the Enable checkbox to add a tick.

'''Note:''' The difference between access from/to dates and availability settings for the activity is that outside the set dates the latter allows students to view the activity description, whereas access from/to dates prevent access completely.

[[Image:restrictinassignment.png|frame|center|Restrict access settings in Assignment]]

====Grade Condition====
This setting determines any grade conditions which must be met in order for students to access the activity. Multiple grade conditions may be set using the 'Add 2 grade conditions to form' button. If there are multiples completion conditions applied to an activity, it will only be accessible to learners when ''all'' grade conditions are met. See [[Conditional_activities_settings|Conditional Activities]] for more information.

====Before activity can be accessed====
Before a learner has fulfilled the the Grade Conditions specified above and the activity is still inaccessible to them, you can choose whether to show the activity greyed-out on the course page with the grade conditions listed (restriction information) or to hide the activity from learner view entirely.

==Assignment Type Specific Settings==

===Advanced uploading of files===
The Advanced upload of files assignment type allows a learner to upload and edit multiple files to form their final submission while the assignment is open and accessible to students.

[[Image:Advanceduploadsettings.png|frame|center|Advanced uploading of file Assignment Type Settings]]

====Maximum size====
This setting specifies the maximum size per file of '''each''' of the files that the students can upload as part of their submission. This maximum upload size may only be equal to or less than the course limit (which in turn may only be equal to or less than the site limit)

====Allow deleting====
If enabled, students may delete uploaded files at any time before submitting for grading.

====Maximum number of uploaded files====
The maximum number of files which may be uploaded by each learner. As this figure is not displayed anywhere, it is suggested that it is mentioned in the assignment Description.

====Allow notes====
If enabled, students may enter notes into a text area associated with the assignment
This text box can be used for communication with the grading person, assignment progress description or any other written activity.

====Hide description before available date====
If enabled, the assignment description is hidden before the "Available from" date. Only the assignment name is displayed.

====Email alerts to teachers====
If enabled, teachers receive email notification whenever students add or update an assignment submission.

Only teachers who are able to grade the particular assignment are notified. So, for example, if the course uses separate groups, teachers restricted to particular groups won't receive notification about students in other groups.

====Enable 'Send for marking' button====

Where grading is enabled, the "Send for marking" button allows students to indicate to the teacher that they have finished working on an assignment. The teacher may choose to revert the assignment to draft status (if it requires further work, for example).

'''Note:''' this means that the learner can no longer edit their submission (to do so would risk invalidating any work their assessor had done on their submission). If students regret their decision and wish to edit, they need to request that somebody with course editing access reverts them to Draft Status. This is also true if Send For Marking is never turned on and a submission is uploaded; the teacher must take steps to give the student a chance to resubmit.

To revert to the draft stage or let a student resubmit, click on the assignment activity, then click on ''View # submitted assignments,'' in the upper right corner. On the page with the roster and their submissions, click '''Grade''' (or '''Update''' for students who have already been graded) for the student who should get to resubmit. When the new window opens, click Revert to Draft at the lower right, or click the black '''X''' to delete their files.

===Online text===
The Online text assignment type allows a learner to compose and edit text on screen using the standard Moodle HTML Editor. The online text assignment can be set up to allow learners to compose, revise and edit over time or such that the learner only has one opportunity to enter his or her response.

====Allow resubmitting====
If set to Yes, students will be allowed to resubmit assignments after they have been graded (for them to be re-graded). This may be useful if the teacher wants to encourage an iterative process to assignment completion.

====Email alerts to teachers====
If enabled, teachers receive email notification whenever students add or update an assignment submission. Only teachers who are able to grade the particular assignment are notified.

====Comment inline====
If enabled, the submission text will be copied into the feedback comment field during grading, making it easier to comment inline (using a different colour, perhaps) or to edit the original text. Note that if the teacher makes inline comments and changes, the student's original submission is kept intact.

If inline comments are not permitted, then the teacher will see the student’s submission with a separate area for making comments.

===Upload a single file===
The Upload single file assignment type allows a learner to upload a single file for their submission while the assignment is open and accessible to students.

====Allow resubmitting====
If enabled, students will be allowed to resubmit assignments after they have been graded (for them to be re-graded).

====Email alerts to teachers====
If enabled, then teachers are alerted with a short email whenever students add or update an assignment submission. Only teachers who are able to grade the particular submission are notified. So, for example, if the course uses separate groups, then teachers restricted to particular groups won't receive any notices about students in other groups.

====Maximum Size====
This setting specifies the maximum size per file of '''each''' of the files that the students can upload as part of their submission. This maximum upload size may only be equal to or less than the course limit (which in turn may only be equal to or less than the site limit).

[[Image:uploadsingleasgn.png|frame|center|Upload single file Assignment settings]]

===Offline Activity===
The Offline Activity assignment is used when an activity or assessment process is performed outside of Moodle. It could be something elsewhere on the web or in person. Students can see a description of the assignment, but can't upload files. Grading works normally, and students will get notification of their grades.

The Offline Activity[[Assignment_module#Assignment_types|Assignment Type]] doesn't currently have any specific settings.

Finally, to save your setting changes and to create your assignment activity choose either''' Save and return to course''' or '''Save and display'''. To discard your changes click '''Cancel'''.

==Locally assigned roles==

In ''Settings > Assignment administration > Locally assigned roles'' selected users can be given additional roles in the activity. See the Using Moodle [http://moodle.org/mod/forum/discuss.php?d=98208 Custom role for 'Course Monitor'] forum discussion for an example.

==Assignment permissions==

Role permissions for the activity can be changed in ''Settings > Assignment administration > Permissions''.

==Site administration settings==

The following configuration options are available for an administrator under ''Settings > Site administration > Plugins > Activity modules > Assignment''. They apply to all four assignment types.

===Maximum size===

An Administrator can specify the maximum size of any individual file uploaded within the Upload Single File or Advanced Upload of Files Assignment type across all courses on the site. This limit may be equal to or less than course file upload limit

===Count===
Applicable the Online Text Assignment type only, you can set whether Moodle automatically counts the number of words or letters of a submission. A word or number count is displayed in parenthesis to Teachers and Learners after the Last Edited date and time stamp within the Assignment submission.

===Show recent submissions===
This option allows everyone to see notifications of submissions in [[Recent activity]] reports and the Recent Activity Block, within a course context. Note that the default for this option is Yes which means students will be able to see when classmates have submitted or updated any Assignments.

[[Image:Assignmentadmin.png|frame|center|Assignment Module Settings]]

==See also==

*[[Assignment_permissions|Assignment Permissions]]
*[http://www.youtube.com/watch?v=SahXhi3zLqs Marking and sending back work in Moodle]
*[http://moodle.org/mod/forum/discuss.php?d=126431 single file upload vs. advanced uploading forum thread]

[[de:Aufgabe anlegen]]
[[cs:Přidání/úprava úkolu]]
[[fr:Ajouter/modifier un devoir]]
[[ja:課題を追加/編集する]]

Assignment FAQ

2012-02-10T02:36:21Z

Jtneill: Add question ==Where are the submitted assignment files stored?== - which needs an answer

{{Assignment}}
==How can I find assignments which have not yet been graded?==

On the assignment submissions page, sort the assignments by Last modified (Teacher) by clicking on the column title. Assignments which have been graded have Update in the status column, whereas those that haven't been graded have Grade in the status column.

==Why can't I edit grades for assignment submissions?==

If you edit assignment [[Grades|grades]] directly in the gradebook, an "overridden" flag is set, meaning that the grade can no longer be edited from the [[Assignment submissions|assignment submissions]] page.

If required, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.

==How can a selected outcome be removed from an assignment?==
To remove previously selected outcomes (which appear greyed out on the update assignment page):
[[Image:Edit categories and items showing outcome link.png|center|thumb|Deleting the test outcome from the upload file assignment]]
#Follow the Grades link Administration block in the course.
#Select edit categories and items from the gradebook dropdown menu at the top-left of the page.
#Locate the assignment for which the outcome is to be removed. The outcome is listed directly below it.
#Click the delete icon opposite the outcome.

==Why can't my students see the response file I've posted to their assignment?==

At this time, Moodle does not show the teachers' response file if any of the following conditions are present:

*The students assignment submission has not been graded by the teacher.
*The teacher has not posted a comment to the student's assignment.

As a workaround, simply grade the assignment or provide a comment on the assignment submission and the corresponding response file will appear on the student's assignment submission page normally. For more information on this behavior, see [http://tracker.moodle.org/browse/MDL-16553 MDL 16553]

==Can students receive confirmation of submission via email?==
There is no way to do this in the standard installation of Moodle. However, students can return to the relevant Assignment and see confirmation in the Assignment's Settings > Assignment Submission.

N.b. it is currently (September 11) possible for students to accidentally make an empty submission and receive possibly misleading confirmation - they do need to check in the Assignment's Settings > Assignment submission that there is a file attached, or that they can otherwise view their submission.

==Can I download all submitted assignments at once?==

Users with the required permissions (e.g. those with a Teacher role) can access the 'View [n] Submitted Assignments' page, on which there is a link to 'Download All Assignments As A Zip'.

==Where are the submitted assignment files stored?==

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=117 Assignment module forum]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=138484 Set Assignments for Specific Groups] forum discussion
* University of Bath Moodle FAQs [http://moodle.bath.ac.uk/faq/category/8/1/assignment.html Assignment module FAQs]

[[Category:FAQ]]
[[de:Aufgaben FAQ]]
[[ja:課題モジュールFAQ]]

User:James Neill

2011-10-06T22:32:45Z

Jtneill: /* Currently working on */

==Currently working on==
# [[Using Quiz]]
# [[Moodleposium]]
## [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[Export]]
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

Using quiz

2011-10-06T22:32:32Z

Jtneill: Redirected page to Using Quiz

#REDIRECT [[Using Quiz]]

User:James Neill

2011-10-06T22:32:12Z

Jtneill: /* Currently working on */

==Currently working on==
# [[Using quiz]]
# [[Moodleposium]]
## [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[Export]]
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

Using Quiz

2011-10-06T22:31:03Z

Jtneill: /* See also */

{{Quiz}}{{Improve}}
This page contains general instructions for taking a quiz. Teachers may use different quiz settings, so these instructions are general.

=Student perspective=
This page contains general instructions for viewing a completed quiz and taking a quiz. Teachers
==Process of taking a quiz==
#Click on the quiz link on the course homepage
#Read the information about the quiz to make sure it is the correct quiz
#Click on "Attempt quiz now" button - you will start the attempt
#Click on the "Next" button at the bottom of the page to see the next page of questions
#Click on the "flag" in the box next to the question to put a temporary marker on it
#Notice the Quiz navigation block in the upper right corner
##You can jump to any question using it
##Any flagged questions will have a "red corner" in their box
##The question boxes for the current page are in bold
#To finish the exam
##Click "Finish attempt" in the Quiz navigation block
##Or click on the "Next" button on the last page of the exam
#The "Summary of attempt" page - reviews the questions
##It will tell you if you "have not yet answered" a question
##It will show you any questions that are still flagged
##Click on any question page number to return to the quiz
#Click on "Submit all and finish" to have your quiz scored
## A warning will pop up "Once you submit, you will no longer be able to change your answers for this attempt.
## There is a button to "Cancel"
## There is a button to "Submit all and finish".

Most quizzes will give a student some sort of review of what they did.
#Notice in the Quiz navigation block:
##Those questions that were scored as correct are in "green",
##Those missed are in "red".
##Any questions flagged, will probably still be marked.
##"Show all questions on one page" link
##"Finish review" link
#Questions answered correctly will have a green check mark next to your correct answer
#Questions missed will have a red X mark next to your answer
#The teacher may have the quiz
##Tell you the correct answer
##Give specific feedback to your answer on any question
##Give you general feedback on a question
##Give you overall feedback on your overall score

==Pictures of what students might see==
<gallery perrow=3 caption="Click to enlarge">
File:Quiz navigation plain.png|Navigation block, see flagged question
File:Quiz unanswered question.png|Unanswered question
File:Quiz missed question.png|Missed question
File:Quiz correct answered question.png|Correctly answered question
File:Question information box flagged.png|Question flagged
File:Quiz summary score time grade.png|Quiz score summary
</gallery >

=Teacher's perspective=
==Taking a Quiz==
After clicking on a quiz name the student will be taken to page that displays the quiz name and the quiz introduction. Usually the introduction will tell the student more about the purpose of the quiz and how it will be assessed. If applicable the page will also show the quiz opening and closing dates and times. The student will not be able to access the quiz questions until the opening time. The student must make sure that they submit all answers before the closing time. Late answers will not usually be marked.

==Retaking a Quiz==
If a student has already attempted the quiz, they will see a table listing all their previous attempts together with the time the student completed them and the marks and grades. Notice that there may be a difference between the "Marks" and "Grade" column. The teacher may have wanted the grade for the quiz to be out of a certain number of points and the Grade column therefore will contain a rescaling of the Marks column to achieve this.

==Continuing an uncompleted quiz==
A student may be allowed to return to a quiz or the quiz settings might be set to count the return as a new attempt. If there is no button for starting a new attempt then the student has used the maximum number of attempts allowed for the quiz.

==Submitting and saving a quiz==
The students have several options for saving a quiz. (These need updating for 2.0).

Students should also know that every time they change pages in a quiz, Moodle will store their answers. :Typically if their computer or the network crashes, they will be able to enter the quiz and Moodle will still have their answers and consider they are still on their first attempt.

# '''Save without submitting''' - which, as its name says, saves the answers without submitting them
# '''Submit all and finish''' - which saves the whole quiz

==Viewing a completed quiz==
See [[Quiz reports]] for more ways to view a completed quiz.

===Student viewing completed quiz===
The teacher may allow the student to go back into a completed quiz to see the quiz pages, questions, the student answers, the correct answer and the score the student received on each question. The teacher can also see each student's quiz.

Remember that in some quizzes, the answers and even the questions can appear in a different order for each students. For those who are used to paper tests, this could require some adjustment in discussing the quiz.

===Teacher viewing completed quiz===
Once the first student has attempted the quiz, the edit screen looks different. It will not be possible to add or delete questions from the quiz. The teacher can still edit questions.

[[Image:Quiz Edit 2 attempts.png‎|thumb|center|Here there have been 2 attempts on this quiz. The preview and edit icons for each question are available on the right.]]

::''Tip:'' After changing the marks on a question, the teacher can regrade a quiz after a student views it. For example, mark more than one answer as being correct. When a student views the quiz after a regrade, they will see the changes to their marks.

==What to do after a quiz==
It is a good practice to review the quiz after it has been given. Students may challenge a question, or ask about the meaning of a question during or after a quiz. After viewing student attempt scores, the result tab will assist the teacher in looking at questions answered by the class, changing scores for specific answers and regrading the quiz.

The Item Analysis link, on the Results tab, can assist the teacher in finding questions in the test that should be reviewed. Sorting on the Correct Facility will allow the teacher to quickly see the questions that were most missed or answered correctly. A question where every student missed it, could mean the teacher tagged the wrong answer as correct or made a typing error in the evaluation of the answer. Unintentional trick questions can often be found by sorting by the "Disc" columns. This might reveal where the worst quiz takers answered the question better than the best quiz takers. The item analysis might also reveal the material which was not presented well or perhaps not covered.

The analysis can also point out correct answers to short answer questions that were not included as a potential when the question was created. Teachers can even look for common misspellings in the correct response and, depending on his or her policy, can award partial or full credit to students for the misspelled response.

Questions needing correction can be edited by clicking on the question ID number on the item analysis page. While questions can be edited as students are taking the Quiz, it is not recommended. Understand what question you are editing. For example is it used in other courses or again in another Quiz in the same course? Do you want the edited question to be used in the future?

Clicking on regrade link, on the results tab, will immediately update the scores for all students on all questions for that one specific quiz. '''Do not''' use the regrade link if students are taking the quiz. Be sure you want to recalculate the quiz. You can regrade the quiz as many times as you want.

This method ensures fairness in scoring on the current quiz and future quizzes while it minimizes the need for “Make comment or override grade” in the individual overview of a students attempt.

Regrade is found on the Results Tab of a Quiz. Regrade is used to force Moodle to recalculate points awarded for correct and incorrect responses to quiz questions after the quiz has been taken by students. It is used when the teacher changes a score or evaluation of a question after the Quiz has been completed by one or more students.

==Email all students who haven't completed a quiz==
From: http://moodle.org/mod/forum/discuss.php?d=130266

Admin block
-> Reports
-> Participation report
-> Activity module : Choose : select the quiz you want to get reports on
-> Show only : Student
-> Show Actions: all actions
-> Go

In the results table, you can see the number of times that students have taken part in the activity. For the Quiz activity, the difference between the various actions mentioned in the Quiz Views: view, view all, report and Quiz Posts: attempt, editquestions, review, submit lists is pretty meaningless. Anyway, all it means it that those students who are marked No in the All actions column have not submitted their quiz. Click the Select all 'no' button at the bottom of the list, select in the drop-down list With selected users : Add/send message. (you don't need to click the OK button)

In the next screen, you will see the HTML editor to type your "reminder message" and you will see the list of students to which that message will be sent."

=See also=
* [[Effective quiz practices]]
* [[How to let teachers share questions between courses]]
* [[Quiz results]] for teachers reviewing an untaken quiz
* [[Quiz reports]] once students take a quiz, more tools are available
* [http://www.moodlenews.com/2011/friction-less-learning-with-quizzes-in-moodle/ Friction-less Learning with Quizzes in Moodle] by Joseph Thibault
*[http://en.wikiversity.org/wiki/User:Jtneill/Teaching/Online_Quizzes_and_Exams_with_Moodle Online Quizzes and Exams with Moodle] - reflections by [[User:James Neill|James Neill]]

[[de:Test ansehen]]

Using Quiz

2011-10-06T22:29:07Z

Jtneill: /* Quiz tips and tricks */

{{Quiz}}{{Improve}}
This page contains general instructions for taking a quiz. Teachers may use different quiz settings, so these instructions are general.

=Student perspective=
This page contains general instructions for viewing a completed quiz and taking a quiz. Teachers
==Process of taking a quiz==
#Click on the quiz link on the course homepage
#Read the information about the quiz to make sure it is the correct quiz
#Click on "Attempt quiz now" button - you will start the attempt
#Click on the "Next" button at the bottom of the page to see the next page of questions
#Click on the "flag" in the box next to the question to put a temporary marker on it
#Notice the Quiz navigation block in the upper right corner
##You can jump to any question using it
##Any flagged questions will have a "red corner" in their box
##The question boxes for the current page are in bold
#To finish the exam
##Click "Finish attempt" in the Quiz navigation block
##Or click on the "Next" button on the last page of the exam
#The "Summary of attempt" page - reviews the questions
##It will tell you if you "have not yet answered" a question
##It will show you any questions that are still flagged
##Click on any question page number to return to the quiz
#Click on "Submit all and finish" to have your quiz scored
## A warning will pop up "Once you submit, you will no longer be able to change your answers for this attempt.
## There is a button to "Cancel"
## There is a button to "Submit all and finish".

Most quizzes will give a student some sort of review of what they did.
#Notice in the Quiz navigation block:
##Those questions that were scored as correct are in "green",
##Those missed are in "red".
##Any questions flagged, will probably still be marked.
##"Show all questions on one page" link
##"Finish review" link
#Questions answered correctly will have a green check mark next to your correct answer
#Questions missed will have a red X mark next to your answer
#The teacher may have the quiz
##Tell you the correct answer
##Give specific feedback to your answer on any question
##Give you general feedback on a question
##Give you overall feedback on your overall score

==Pictures of what students might see==
<gallery perrow=3 caption="Click to enlarge">
File:Quiz navigation plain.png|Navigation block, see flagged question
File:Quiz unanswered question.png|Unanswered question
File:Quiz missed question.png|Missed question
File:Quiz correct answered question.png|Correctly answered question
File:Question information box flagged.png|Question flagged
File:Quiz summary score time grade.png|Quiz score summary
</gallery >

=Teacher's perspective=
==Taking a Quiz==
After clicking on a quiz name the student will be taken to page that displays the quiz name and the quiz introduction. Usually the introduction will tell the student more about the purpose of the quiz and how it will be assessed. If applicable the page will also show the quiz opening and closing dates and times. The student will not be able to access the quiz questions until the opening time. The student must make sure that they submit all answers before the closing time. Late answers will not usually be marked.

==Retaking a Quiz==
If a student has already attempted the quiz, they will see a table listing all their previous attempts together with the time the student completed them and the marks and grades. Notice that there may be a difference between the "Marks" and "Grade" column. The teacher may have wanted the grade for the quiz to be out of a certain number of points and the Grade column therefore will contain a rescaling of the Marks column to achieve this.

==Continuing an uncompleted quiz==
A student may be allowed to return to a quiz or the quiz settings might be set to count the return as a new attempt. If there is no button for starting a new attempt then the student has used the maximum number of attempts allowed for the quiz.

==Submitting and saving a quiz==
The students have several options for saving a quiz. (These need updating for 2.0).

Students should also know that every time they change pages in a quiz, Moodle will store their answers. :Typically if their computer or the network crashes, they will be able to enter the quiz and Moodle will still have their answers and consider they are still on their first attempt.

# '''Save without submitting''' - which, as its name says, saves the answers without submitting them
# '''Submit all and finish''' - which saves the whole quiz

==Viewing a completed quiz==
See [[Quiz reports]] for more ways to view a completed quiz.

===Student viewing completed quiz===
The teacher may allow the student to go back into a completed quiz to see the quiz pages, questions, the student answers, the correct answer and the score the student received on each question. The teacher can also see each student's quiz.

Remember that in some quizzes, the answers and even the questions can appear in a different order for each students. For those who are used to paper tests, this could require some adjustment in discussing the quiz.

===Teacher viewing completed quiz===
Once the first student has attempted the quiz, the edit screen looks different. It will not be possible to add or delete questions from the quiz. The teacher can still edit questions.

[[Image:Quiz Edit 2 attempts.png‎|thumb|center|Here there have been 2 attempts on this quiz. The preview and edit icons for each question are available on the right.]]

::''Tip:'' After changing the marks on a question, the teacher can regrade a quiz after a student views it. For example, mark more than one answer as being correct. When a student views the quiz after a regrade, they will see the changes to their marks.

==What to do after a quiz==
It is a good practice to review the quiz after it has been given. Students may challenge a question, or ask about the meaning of a question during or after a quiz. After viewing student attempt scores, the result tab will assist the teacher in looking at questions answered by the class, changing scores for specific answers and regrading the quiz.

The Item Analysis link, on the Results tab, can assist the teacher in finding questions in the test that should be reviewed. Sorting on the Correct Facility will allow the teacher to quickly see the questions that were most missed or answered correctly. A question where every student missed it, could mean the teacher tagged the wrong answer as correct or made a typing error in the evaluation of the answer. Unintentional trick questions can often be found by sorting by the "Disc" columns. This might reveal where the worst quiz takers answered the question better than the best quiz takers. The item analysis might also reveal the material which was not presented well or perhaps not covered.

The analysis can also point out correct answers to short answer questions that were not included as a potential when the question was created. Teachers can even look for common misspellings in the correct response and, depending on his or her policy, can award partial or full credit to students for the misspelled response.

Questions needing correction can be edited by clicking on the question ID number on the item analysis page. While questions can be edited as students are taking the Quiz, it is not recommended. Understand what question you are editing. For example is it used in other courses or again in another Quiz in the same course? Do you want the edited question to be used in the future?

Clicking on regrade link, on the results tab, will immediately update the scores for all students on all questions for that one specific quiz. '''Do not''' use the regrade link if students are taking the quiz. Be sure you want to recalculate the quiz. You can regrade the quiz as many times as you want.

This method ensures fairness in scoring on the current quiz and future quizzes while it minimizes the need for “Make comment or override grade” in the individual overview of a students attempt.

Regrade is found on the Results Tab of a Quiz. Regrade is used to force Moodle to recalculate points awarded for correct and incorrect responses to quiz questions after the quiz has been taken by students. It is used when the teacher changes a score or evaluation of a question after the Quiz has been completed by one or more students.

==Email all students who haven't completed a quiz==
From: http://moodle.org/mod/forum/discuss.php?d=130266

Admin block
-> Reports
-> Participation report
-> Activity module : Choose : select the quiz you want to get reports on
-> Show only : Student
-> Show Actions: all actions
-> Go

In the results table, you can see the number of times that students have taken part in the activity. For the Quiz activity, the difference between the various actions mentioned in the Quiz Views: view, view all, report and Quiz Posts: attempt, editquestions, review, submit lists is pretty meaningless. Anyway, all it means it that those students who are marked No in the All actions column have not submitted their quiz. Click the Select all 'no' button at the bottom of the list, select in the drop-down list With selected users : Add/send message. (you don't need to click the OK button)

In the next screen, you will see the HTML editor to type your "reminder message" and you will see the list of students to which that message will be sent."

==See also==
* [[Effective quiz practices]]
* [[How to let teachers share questions between courses]]
* [[Quiz results]] for teachers reviewing an untaken quiz
* [[Quiz reports]] once students take a quiz, more tools are available
* [http://www.moodlenews.com/2011/friction-less-learning-with-quizzes-in-moodle/ Friction-less Learning with Quizzes in Moodle] by Joseph Thibault
*[http://en.wikiversity.org/wiki/User:Jtneill/Teaching/Online_Quizzes_and_Exams_with_Moodle Online Quizzes and Exams with Moodle] - reflections by [[User:James Neill|James Neill]]

[[de:Test ansehen]]

Using Quiz

2011-10-06T22:22:21Z

Jtneill: /* Bulk email to all students who haven't completed a quiz */

{{Quiz}}{{Improve}}
This page contains general instructions for taking a quiz. Teachers may use different quiz settings, so these instructions are general.

=Student perspective=
This page contains general instructions for viewing a completed quiz and taking a quiz. Teachers
==Process of taking a quiz==
#Click on the quiz link on the course homepage
#Read the information about the quiz to make sure it is the correct quiz
#Click on "Attempt quiz now" button - you will start the attempt
#Click on the "Next" button at the bottom of the page to see the next page of questions
#Click on the "flag" in the box next to the question to put a temporary marker on it
#Notice the Quiz navigation block in the upper right corner
##You can jump to any question using it
##Any flagged questions will have a "red corner" in their box
##The question boxes for the current page are in bold
#To finish the exam
##Click "Finish attempt" in the Quiz navigation block
##Or click on the "Next" button on the last page of the exam
#The "Summary of attempt" page - reviews the questions
##It will tell you if you "have not yet answered" a question
##It will show you any questions that are still flagged
##Click on any question page number to return to the quiz
#Click on "Submit all and finish" to have your quiz scored
## A warning will pop up "Once you submit, you will no longer be able to change your answers for this attempt.
## There is a button to "Cancel"
## There is a button to "Submit all and finish".

Most quizzes will give a student some sort of review of what they did.
#Notice in the Quiz navigation block:
##Those questions that were scored as correct are in "green",
##Those missed are in "red".
##Any questions flagged, will probably still be marked.
##"Show all questions on one page" link
##"Finish review" link
#Questions answered correctly will have a green check mark next to your correct answer
#Questions missed will have a red X mark next to your answer
#The teacher may have the quiz
##Tell you the correct answer
##Give specific feedback to your answer on any question
##Give you general feedback on a question
##Give you overall feedback on your overall score

==Pictures of what students might see==
<gallery perrow=3 caption="Click to enlarge">
File:Quiz navigation plain.png|Navigation block, see flagged question
File:Quiz unanswered question.png|Unanswered question
File:Quiz missed question.png|Missed question
File:Quiz correct answered question.png|Correctly answered question
File:Question information box flagged.png|Question flagged
File:Quiz summary score time grade.png|Quiz score summary
</gallery >

=Teacher's perspective=
==Taking a Quiz==
After clicking on a quiz name the student will be taken to page that displays the quiz name and the quiz introduction. Usually the introduction will tell the student more about the purpose of the quiz and how it will be assessed. If applicable the page will also show the quiz opening and closing dates and times. The student will not be able to access the quiz questions until the opening time. The student must make sure that they submit all answers before the closing time. Late answers will not usually be marked.

==Retaking a Quiz==
If a student has already attempted the quiz, they will see a table listing all their previous attempts together with the time the student completed them and the marks and grades. Notice that there may be a difference between the "Marks" and "Grade" column. The teacher may have wanted the grade for the quiz to be out of a certain number of points and the Grade column therefore will contain a rescaling of the Marks column to achieve this.

==Continuing an uncompleted quiz==
A student may be allowed to return to a quiz or the quiz settings might be set to count the return as a new attempt. If there is no button for starting a new attempt then the student has used the maximum number of attempts allowed for the quiz.

==Submitting and saving a quiz==
The students have several options for saving a quiz. (These need updating for 2.0).

Students should also know that every time they change pages in a quiz, Moodle will store their answers. :Typically if their computer or the network crashes, they will be able to enter the quiz and Moodle will still have their answers and consider they are still on their first attempt.

# '''Save without submitting''' - which, as its name says, saves the answers without submitting them
# '''Submit all and finish''' - which saves the whole quiz

==Viewing a completed quiz==
See [[Quiz reports]] for more ways to view a completed quiz.

===Student viewing completed quiz===
The teacher may allow the student to go back into a completed quiz to see the quiz pages, questions, the student answers, the correct answer and the score the student received on each question. The teacher can also see each student's quiz.

Remember that in some quizzes, the answers and even the questions can appear in a different order for each students. For those who are used to paper tests, this could require some adjustment in discussing the quiz.

===Teacher viewing completed quiz===
Once the first student has attempted the quiz, the edit screen looks different. It will not be possible to add or delete questions from the quiz. The teacher can still edit questions.

[[Image:Quiz Edit 2 attempts.png‎|thumb|center|Here there have been 2 attempts on this quiz. The preview and edit icons for each question are available on the right.]]

::''Tip:'' After changing the marks on a question, the teacher can regrade a quiz after a student views it. For example, mark more than one answer as being correct. When a student views the quiz after a regrade, they will see the changes to their marks.

==Quiz tips and tricks==
===What to do after a quiz===
It is a good practice to review the quiz after it has been given. Students may challenge a question, or ask about the meaning of a question during or after a quiz. After viewing student attempt scores, the result tab will assist the teacher in looking at questions answered by the class, changing scores for specific answers and regrading the quiz.

The Item Analysis link, on the Results tab, can assist the teacher in finding questions in the test that should be reviewed. Sorting on the Correct Facility will allow the teacher to quickly see the questions that were most missed or answered correctly. A question where every student missed it, could mean the teacher tagged the wrong answer as correct or made a typing error in the evaluation of the answer. Unintentional trick questions can often be found by sorting by the "Disc" columns. This might reveal where the worst quiz takers answered the question better than the best quiz takers. The item analysis might also reveal the material which was not presented well or perhaps not covered.

The analysis can also point out correct answers to short answer questions that were not included as a potential when the question was created. Teachers can even look for common misspellings in the correct response and, depending on his or her policy, can award partial or full credit to students for the misspelled response.

Questions needing correction can be edited by clicking on the question ID number on the item analysis page. While questions can be edited as students are taking the Quiz, it is not recommended. Understand what question you are editing. For example is it used in other courses or again in another Quiz in the same course? Do you want the edited question to be used in the future?

Clicking on regrade link, on the results tab, will immediately update the scores for all students on all questions for that one specific quiz. '''Do not''' use the regrade link if students are taking the quiz. Be sure you want to recalculate the quiz. You can regrade the quiz as many times as you want.

This method ensures fairness in scoring on the current quiz and future quizzes while it minimizes the need for “Make comment or override grade” in the individual overview of a students attempt.

Regrade is found on the Results Tab of a Quiz. Regrade is used to force Moodle to recalculate points awarded for correct and incorrect responses to quiz questions after the quiz has been taken by students. It is used when the teacher changes a score or evaluation of a question after the Quiz has been completed by one or more students.

===Bulk email to all students who haven't completed a quiz===
From: http://moodle.org/mod/forum/discuss.php?d=130266

Admin block
-> Reports
-> Participation report
-> Activity module : Choose : select the quiz you want to get reports on
-> Show only : Student
-> Show Actions: all actions
-> Go

In the results table, you can see the number of times that students have taken part in the activity. For the Quiz activity, the difference between the various actions mentioned in the Quiz Views: view, view all, report and Quiz Posts: attempt, editquestions, review, submit lists is pretty meaningless. Anyway, all it means it that those students who are marked No in the All actions column have not submitted their quiz. Click the Select all 'no' button at the bottom of the list, select in the drop-down list With selected users : Add/send message. (you don't need to click the OK button)

In the next screen, you will see the HTML editor to type your "reminder message" and you will see the list of students to which that message will be sent."

==See also==
* [[Effective quiz practices]]
* [[How to let teachers share questions between courses]]
* [[Quiz results]] for teachers reviewing an untaken quiz
* [[Quiz reports]] once students take a quiz, more tools are available
* [http://www.moodlenews.com/2011/friction-less-learning-with-quizzes-in-moodle/ Friction-less Learning with Quizzes in Moodle] by Joseph Thibault
*[http://en.wikiversity.org/wiki/User:Jtneill/Teaching/Online_Quizzes_and_Exams_with_Moodle Online Quizzes and Exams with Moodle] - reflections by [[User:James Neill|James Neill]]

[[de:Test ansehen]]

Using Quiz

2011-10-06T22:20:23Z

Jtneill: /* Bulk email to all students who haven't completed a quiz? */ "Admin block -> Reports -> Participation report -> Activity module : Choose : select the quiz you want to get reports on -> Show only :

{{Quiz}}{{Improve}}
This page contains general instructions for taking a quiz. Teachers may use different quiz settings, so these instructions are general.

=Student perspective=
This page contains general instructions for viewing a completed quiz and taking a quiz. Teachers
==Process of taking a quiz==
#Click on the quiz link on the course homepage
#Read the information about the quiz to make sure it is the correct quiz
#Click on "Attempt quiz now" button - you will start the attempt
#Click on the "Next" button at the bottom of the page to see the next page of questions
#Click on the "flag" in the box next to the question to put a temporary marker on it
#Notice the Quiz navigation block in the upper right corner
##You can jump to any question using it
##Any flagged questions will have a "red corner" in their box
##The question boxes for the current page are in bold
#To finish the exam
##Click "Finish attempt" in the Quiz navigation block
##Or click on the "Next" button on the last page of the exam
#The "Summary of attempt" page - reviews the questions
##It will tell you if you "have not yet answered" a question
##It will show you any questions that are still flagged
##Click on any question page number to return to the quiz
#Click on "Submit all and finish" to have your quiz scored
## A warning will pop up "Once you submit, you will no longer be able to change your answers for this attempt.
## There is a button to "Cancel"
## There is a button to "Submit all and finish".

Most quizzes will give a student some sort of review of what they did.
#Notice in the Quiz navigation block:
##Those questions that were scored as correct are in "green",
##Those missed are in "red".
##Any questions flagged, will probably still be marked.
##"Show all questions on one page" link
##"Finish review" link
#Questions answered correctly will have a green check mark next to your correct answer
#Questions missed will have a red X mark next to your answer
#The teacher may have the quiz
##Tell you the correct answer
##Give specific feedback to your answer on any question
##Give you general feedback on a question
##Give you overall feedback on your overall score

==Pictures of what students might see==
<gallery perrow=3 caption="Click to enlarge">
File:Quiz navigation plain.png|Navigation block, see flagged question
File:Quiz unanswered question.png|Unanswered question
File:Quiz missed question.png|Missed question
File:Quiz correct answered question.png|Correctly answered question
File:Question information box flagged.png|Question flagged
File:Quiz summary score time grade.png|Quiz score summary
</gallery >

=Teacher's perspective=
==Taking a Quiz==
After clicking on a quiz name the student will be taken to page that displays the quiz name and the quiz introduction. Usually the introduction will tell the student more about the purpose of the quiz and how it will be assessed. If applicable the page will also show the quiz opening and closing dates and times. The student will not be able to access the quiz questions until the opening time. The student must make sure that they submit all answers before the closing time. Late answers will not usually be marked.

==Retaking a Quiz==
If a student has already attempted the quiz, they will see a table listing all their previous attempts together with the time the student completed them and the marks and grades. Notice that there may be a difference between the "Marks" and "Grade" column. The teacher may have wanted the grade for the quiz to be out of a certain number of points and the Grade column therefore will contain a rescaling of the Marks column to achieve this.

==Continuing an uncompleted quiz==
A student may be allowed to return to a quiz or the quiz settings might be set to count the return as a new attempt. If there is no button for starting a new attempt then the student has used the maximum number of attempts allowed for the quiz.

==Submitting and saving a quiz==
The students have several options for saving a quiz. (These need updating for 2.0).

Students should also know that every time they change pages in a quiz, Moodle will store their answers. :Typically if their computer or the network crashes, they will be able to enter the quiz and Moodle will still have their answers and consider they are still on their first attempt.

# '''Save without submitting''' - which, as its name says, saves the answers without submitting them
# '''Submit all and finish''' - which saves the whole quiz

==Viewing a completed quiz==
See [[Quiz reports]] for more ways to view a completed quiz.

===Student viewing completed quiz===
The teacher may allow the student to go back into a completed quiz to see the quiz pages, questions, the student answers, the correct answer and the score the student received on each question. The teacher can also see each student's quiz.

Remember that in some quizzes, the answers and even the questions can appear in a different order for each students. For those who are used to paper tests, this could require some adjustment in discussing the quiz.

===Teacher viewing completed quiz===
Once the first student has attempted the quiz, the edit screen looks different. It will not be possible to add or delete questions from the quiz. The teacher can still edit questions.

[[Image:Quiz Edit 2 attempts.png‎|thumb|center|Here there have been 2 attempts on this quiz. The preview and edit icons for each question are available on the right.]]

::''Tip:'' After changing the marks on a question, the teacher can regrade a quiz after a student views it. For example, mark more than one answer as being correct. When a student views the quiz after a regrade, they will see the changes to their marks.

==Quiz tips and tricks==
===What to do after a quiz===
It is a good practice to review the quiz after it has been given. Students may challenge a question, or ask about the meaning of a question during or after a quiz. After viewing student attempt scores, the result tab will assist the teacher in looking at questions answered by the class, changing scores for specific answers and regrading the quiz.

The Item Analysis link, on the Results tab, can assist the teacher in finding questions in the test that should be reviewed. Sorting on the Correct Facility will allow the teacher to quickly see the questions that were most missed or answered correctly. A question where every student missed it, could mean the teacher tagged the wrong answer as correct or made a typing error in the evaluation of the answer. Unintentional trick questions can often be found by sorting by the "Disc" columns. This might reveal where the worst quiz takers answered the question better than the best quiz takers. The item analysis might also reveal the material which was not presented well or perhaps not covered.

The analysis can also point out correct answers to short answer questions that were not included as a potential when the question was created. Teachers can even look for common misspellings in the correct response and, depending on his or her policy, can award partial or full credit to students for the misspelled response.

Questions needing correction can be edited by clicking on the question ID number on the item analysis page. While questions can be edited as students are taking the Quiz, it is not recommended. Understand what question you are editing. For example is it used in other courses or again in another Quiz in the same course? Do you want the edited question to be used in the future?

Clicking on regrade link, on the results tab, will immediately update the scores for all students on all questions for that one specific quiz. '''Do not''' use the regrade link if students are taking the quiz. Be sure you want to recalculate the quiz. You can regrade the quiz as many times as you want.

This method ensures fairness in scoring on the current quiz and future quizzes while it minimizes the need for “Make comment or override grade” in the individual overview of a students attempt.

Regrade is found on the Results Tab of a Quiz. Regrade is used to force Moodle to recalculate points awarded for correct and incorrect responses to quiz questions after the quiz has been taken by students. It is used when the teacher changes a score or evaluation of a question after the Quiz has been completed by one or more students.

===Bulk email to all students who haven't completed a quiz===
From: http://moodle.org/mod/forum/discuss.php?d=130266

"Admin block -> Reports -> Participation report -> Activity module : Choose : select the quiz you want to get reports on -> Show only : Student -> Show Actions: all actions -> Go

In the results table, you can see the number of times that students have taken part in the activity. For the Quiz activity, the difference between the various actions mentioned in the Quiz Views: view, view all, report and Quiz Posts: attempt, editquestions, review, submit lists is pretty meaningless. Anyway, all it means it that those students who are marked No in the All actions column have not submitted their quiz. Click the Select all 'no' button at the bottom of the list, select in the drop-down list With selected users : Add/send message. (you don't need to click the OK button)

In the next screen, you will see the HTML editor to type your "reminder message" and you will see the list of students to which that message will be sent."

==See also==
* [[Effective quiz practices]]
* [[How to let teachers share questions between courses]]
* [[Quiz results]] for teachers reviewing an untaken quiz
* [[Quiz reports]] once students take a quiz, more tools are available
* [http://www.moodlenews.com/2011/friction-less-learning-with-quizzes-in-moodle/ Friction-less Learning with Quizzes in Moodle] by Joseph Thibault
*[http://en.wikiversity.org/wiki/User:Jtneill/Teaching/Online_Quizzes_and_Exams_with_Moodle Online Quizzes and Exams with Moodle] - reflections by [[User:James Neill|James Neill]]

[[de:Test ansehen]]

User:James Neill

2011-10-06T11:14:46Z

Jtneill: /* Currently working on */ Quiz tips and tricks

==Currently working on==
# [[Quiz tips and tricks]]
# [[Moodleposium]]
## [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[Export]]
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

Quiz tips and tricks

2011-10-06T11:12:31Z

Jtneill: ==Bulk email to all students who haven't completed a quiz?== * http://moodle.org/mod/forum/discuss.php?d=130266

==What to do after a quiz==
It is a good practice to review the quiz after it has been given. Students may challenge a question, or ask about the meaning of a question during or after a quiz. After viewing student attempt scores, the result tab will assist the teacher in looking at questions answered by the class, changing scores for specific answers and regrading the quiz.

The Item Analysis link, on the Results tab, can assist the teacher in finding questions in the test that should be reviewed. Sorting on the Correct Facility will allow the teacher to quickly see the questions that were most missed or answered correctly. A question where every student missed it, could mean the teacher tagged the wrong answer as correct or made a typing error in the evaluation of the answer. Unintentional trick questions can often be found by sorting by the "Disc" columns. This might reveal where the worst quiz takers answered the question better than the best quiz takers. The item analysis might also reveal the material which was not presented well or perhaps not covered.

The analysis can also point out correct answers to short answer questions that were not included as a potential when the question was created. Teachers can even look for common misspellings in the correct response and, depending on his or her policy, can award partial or full credit to students for the misspelled response.

Questions needing correction can be edited by clicking on the question ID number on the item analysis page. While questions can be edited as students are taking the Quiz, it is not recommended. Understand what question you are editing. For example is it used in other courses or again in another Quiz in the same course? Do you want the edited question to be used in the future?

Clicking on regrade link, on the results tab, will immediately update the scores for all students on all questions for that one specific quiz. '''Do not''' use the regrade link if students are taking the quiz. Be sure you want to recalculate the quiz. You can regrade the quiz as many times as you want.

This method ensures fairness in scoring on the current quiz and future quizzes while it minimizes the need for “Make comment or override grade” in the individual overview of a students attempt.

Regrade is found on the Results Tab of a Quiz. Regrade is used to force Moodle to recalculate points awarded for correct and incorrect responses to quiz questions after the quiz has been taken by students. It is used when the teacher changes a score or evaluation of a question after the Quiz has been completed by one or more students.

==Bulk email to all students who haven't completed a quiz?==
* http://moodle.org/mod/forum/discuss.php?d=130266

[[Category:Quiz]]

GIFT format

2011-08-29T10:12:10Z

Jtneill: /* Word processors and Spreadsheets tools that create GIFTs */

'''GIFT format''' allows someone to use a text editor to write multiple-choice, true-false, short answer, matching missing word and numerical questions in a simple format that can be imported. The GIFT format is also an export file format available in Question bank. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

*When creating a large numbers of questions, GIFT can provide a quick way of bulk loading questions either into a [[Question bank|question category]], or into a [[Adding_a_question_page#Importing_questions|Lesson]].
*Sometimes it is easier proofing questions in a question category by viewing them in a GIFT file.

== General instructions ==
At least one blank line must be left between each question.

In the simple form, the question comes first, then the answers are set in between brackets, with an equal sign (=) indicating the correct answer(s) and tilde (~) the wrong answers. A hash (#) will insert a response. Questions can be weighted by placing percentage signs (%..%) around the weight. Comments are preceded by double slashes (//) and are not imported.

Here are some useful [http://moodle.org/pluginfile.php/134/mod_forum/attachment/236161/GIFT-examples.zip GIFT examples] than can be imported or used as rough template. Many of the examples below used the questions in the file as a starting point.

=== UTF-8 encoding ===
Any GIFT file '''must''' be correctly encoded in [[UTF8]]. You can use Microsoft's text editor Notepad which comes with Windows to save your file in UTF-8.

'''Note''': ANSI format will (only) work for languages without any special characters (like ä, ö, ü, æ, å, ø, œ or ß). And don't use "Unicode" as format as this is actually UTF-16 and won't work. See [[Converting files to UTF-8]] for further information.

===Format symbols===

Here are some common GIFT symbols and their use.

{|
! Symbols !! Use
|-
| // text || Comment until end of line (optional)
|-
| ::title:: || Question title (optional)
|-
| text || Question text (becomes title if no title specified)
|-
| [...format...] || The format of the following bit of text. Options are [html], [moodle], [plain] and [markdown]. The default is [moodle] for the question text, other parts of the question default to the format used for the question text.
|-
| { || Start answer(s) -- without any answers, text is a description of following questions
|-
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}
|-
| { ... =right ... } || Correct answer for multiple choice, (multiple answer? -- see page comments) or fill-in-the-blank
|-
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer
|-
| { ... =item -> match ... } || Answer for matching questions
|-
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers
|-
| {# || Start numeric answer(s)
|-
| answer:tolerance || Numeric answer accepted within ± tolerance range
|-
| low..high || Lower and upper range values of accepted numeric answer
|-
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer
|-
| } || End answer(s)
|-
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :
|-
| \n || Places a newline in question text -- blank lines delimit questions
|}

Here are some quick examples:

// true/false
::Q1:: 1+1=2 {T}

// multiple choice with specified feedback for right and wrong answers
::Q2:: What's between orange and green in the spectrum?
{ =yellow # right; good! ~red # wrong, it's yellow ~blue # wrong, it's yellow }

// fill-in-the-blank
::Q3:: Two plus {=two =2} equals four.

// matching
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }

// math range question
::Q5:: What is a number from 1 to 5? {#3:2}

// math range specified with interval end points
::Q6:: What is a number from 1 to 5? {#1..5}
// translated on import to the same as Q5, but unavailable from Moodle question interface

// multiple numeric answers with partial credit and feedback
::Q7:: When was Ulysses S. Grant born? {#
=1822:0 # Correct! Full credit.
=%50%1822:2 # He was born in 1822. Half credit for being close.
}

// essay
::Q8:: How are you? {}

===Format symbols explained===
The multiple choice format below as a comment line // for the question, when Moodle exports it the question unique id number will appear here.

The first set of :: precedes the question title.

The second :: precedes the actual question. The first { indicates the start of the answers. The correct answer is preceded by an = sign and wrong answers by a ~. Teacher responses have a # in front of them. The question ends with a } and then a blank line. NOTE it is { } not ( ) parenthesis! Usually these are obtained with help of the [AltGr] key.

//Comment line
::Question title
:: Question {
=A correct answer
~Wrong answer1
#A response to wrong answer1
~Wrong answer2
#A response to wrong answer2
~Wrong answer3
#A response to wrong answer3
~Wrong answer4
#A response to wrong answer4
}

The shortest format for a multiple choice question is:
Question{= A Correct Answer ~Wrong answer1 ~Wrong answer2 ~Wrong answer3 ~Wrong answer4 }

:''Tip:'' If you don't specify a question title the WHOLE question will be used as the title at the time of import into Moodle. There are pros and cons to allowing this to happen.
** Cons: This can add a lot of unnecessary words. This can include characters which might confuse the export GIFT process.
** Pros: On the other hand. if the start of each question is different, it can make finding a single question easier in a category list of questions. It will save you typing. Having the same title for every question is a very bad idea.

==Question format examples==
There are several ways to use a text editor to write a GIFT format. We will try to show the simple version for example and in some formats we will introduce some more complex features that can be imported into many Moodle Question formats.

===Multiple choice===
For multiple choice questions, wrong answers are prefixed with a tilde (~) and the correct answer is prefixed with an equal sign (=).

Here is a simple acceptable GIFT multiple choice format:
Who's buried in Grant's tomb?{=Grant ~no one ~Napoleon ~Churchill ~Mother Teresa }

Here is a longer format that uses most of the GIFT elements:

// question: 1 name: Grants tomb
::Grants tomb::Who is buried in Grant's tomb in New York City? {
=Grant
~No one
#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
~Napoleon
#He was buried in France
~Churchill
#He was buried in England
~Mother Teresa
#She was buried in India
}

===Multiple choice with multiple right answers===

That is, using checkboxes, not radio buttons:

What two people are entombed in Grant's tomb? {
~%-100%No one
~%50%Grant
~%50%Grant's wife
~%-100%Grant's father
}

===True-false===

In this question-type the answer indicates whether the statement is true or false. The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.

// question: 0 name: TrueStatement using {T} style
::TrueStatement about Grant::Grant was buried in a tomb in New York City.{T}

// question: 0 name: FalseStatement using {FALSE} style
::FalseStatement about sun::The sun rises in the West.{FALSE}

===Short answer===

Answers in Short Answer question-type are all prefixed by an equal sign (=), indicating that they are all correct answers. The answers must not contain a tilde.

Here are two examples using the simple method showing possible right answers for credit.
Who's buried in Grant's tomb?{=Grant =Ulysses S. Grant =Ulysses Grant}

Two plus two equals {=four =4}

If there is only one correct Short Answer, it may be written without the equal sign prefix, as long as it cannot be confused as True-False.

===Matching===
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.

Match the following countries with their corresponding capitals. {
=Canada -> Ottawa
=Italy -> Rome
=Japan -> Tokyo
=India -> New Delhi
}

Matching questions do not support feedback or percentage answer weights.

===Missing word===
The Missing Word format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence. To use the Missing Word format, place the answers where you want the line to appear in the sentence.
Moodle costd{~lots of money =nothing ~a small amount} to download from moodle.org.

If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted for the "missing word" format. All question types can be written in the Missing Word format.

There must be a blank line (double carriage return) separating questions. For clarity, the answers can be written on separate lines and even indented. Some examples:

Mahatma Gandhi birthday is an Indian holiday on {
~15th
~3rd
=2nd
} of October.

Since {
~495 AD
=1066 AD
~1215 AD
~ 43 AD
}
the town of Hastings England has been "famous with visitors".

===Numerical questions===

The answer section for Numerical questions must start with a number sign (#). Numerical answers can include an error margin, which is written following the correct answer, separated by a colon. So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows {#2:0.5}. This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5). If no error margin is specified, it will be assumed to be zero.

Here is a simple numerical format question. It will accept a range of 5 years.
When was Ulysses S. Grant born?{#1822:5}
It is a good idea to check the margins of the range, 3.141 is not counted as correct and 3.142 is considered in the range.
What is the value of pi (to 3 decimal places)? {#3.14159:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}

Note that since Moodle's browser GUI didn't support multiple answers for Numerical questions, there's no way in older Moodle versions to see them or edit them through Moodle. The only way to change a numerical answer beyond the first, is to delete the question and re-import it (or use something like phpMyAdmin). But better would be to upgrade your Moodle to at least 1.9.

===Essay===
An essay question is simply a question with an empty answer field. Nothing is permitted between the curly braces at all.

Write a short biography of Dag Hammarskjöld. {}

===Description===
A description "question" has no answer part at all

You can use your pencil and paper for these next math questions.

==Options==

In addition to these basic question types, this filter offers the following options: line comments, question name, feedback and percentage answer weight.

===Line Comments===
Comments that will not be imported into Moodle can be included in the text file. This can be used to provide headers or more information about questions. All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.

// Subheading: Numerical questions below
What's 2 plus 2? {#4}

Comments will be exported from Moodle and will include the unique question id. The above question after it was imported and then exported from Moodle:
// question: 914 name: What's 2 plus 2?
::What's 2 plus 2?::What's 2 plus 2?{#
=4:0#
}

===Question Name===
A question name can be specified by placing it first and enclosing it within double colons (::...::).

::Kanji Origins::Japanese characters originally
came from what country? {=China}

::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.

If no question name is specified, the entire question will be used as the name by default.

===Feedback===
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.

What's the answer to this multiple-choice question? {
~wrong answer#feedback comment on the wrong answer
~another wrong answer#feedback comment on this wrong answer
=right answer#Very good!
}

//From The Hitchhiker's Guide to the Galaxy
Deep Thought said " {
=forty two#Correct according to The Hitchhiker's Guide to the Galaxy!
=42#Correct, as told to Loonquawl and Phouchg
=forty-two#Correct!
} is the Ultimate Answer to the Ultimate Question of Life, The Universe, and Everything."

42 is the Absolute Answer to everything.{
FALSE#42is the Ultimate Answer.#You gave the right answer.}

For Multiple Choice questions, feedback is displayed only for the answer the student selected. For short answer, feedback is shown only when students input the corresponding correct answer. For true-false questions, there can be one or two feedback strings. The first is shown if the student gives the wrong answer. The second if the student gives the right answer.

===Percentage Answer Weights===
Percentage answer weights are available for both Multiple Choice and Short Answer questions. Percentage answer weights can be included by following the tilde (for Multiple Choice) or equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%). This option can be combined with feedback comments.

Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

::Jesus' hometown::Jesus Christ was from {
~Jerusalem#This was an important city, but the wrong answer.
~%25%Bethlehem#He was born here, but not raised here.
~%50%Galilee#You need to be more specific.
=Nazareth#Yes! That's right!
}.

::Jesus' hometown:: Jesus Christ was from {
=Nazareth#Yes! That's right!
=%75%Nazereth#Right, but misspelled.
=%25%Bethlehem#He was born here, but not raised here.
}

Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.

Note that it is possible to specify percentage answer weights that are NOT available through the browser interface. The Match Grades drop-down on the import page determines how these are handled. You can either request that an error be reported or that the answer weight be adjusted to the nearest valid answer weight.

Specify text-formatting for the question
The question text (only) may have an optional text format specified. Currently the available formats are moodle (Moodle Auto-Format), html (HTML format), plain (Plain text format) and markdown (Markdown format). The format is specified in square brackets immediately before the question text. See [[Formatting text]] for further information.

[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.

===Multiple Answers===
The Multiple Answers option is used for multiple choice questions when two or more answers must be selected in order to obtain full credit. The multiple answers option is enabled by assigning partial answer weight to multiple answers, while allowing no single answer to receive full credit.

What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}

Note that there is no equal sign (=) in any answer and the answers should total no more than 100%, otherwise Moodle will return an error. To avoid the problem of students automatically getting 100% by simply checking all of the answers, it is best to include negative answer weights for wrong answers.

What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}

===Special Characters ~ = # { }===
These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}

::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
~ \~ # \~ is a control character.
~ \= # \= is a control character.
~ \# # \# is a control character.
~ \{ # \{ is a control character.
~ \} # \} is a control character.
= \ # Correct! \ (backslash) is not a control character. BUT,
it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

===Specifying Categories===

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

===Making questions case sensitive===
Short Answer questions can be made case sensitive by changing "0" to "1" in the following line '''of your moodle/question/format/gift/format.php file''':
$question->usecase = 0; // Ignore case

==Hints and Tips==
* Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.

* You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
**Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
**In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write [[Image:Nbsp.png]] (without spaces between these characters).
* Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
**For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
* Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
$question->usecase = 1;
surrounded by blank lines.

==Word processor and spreadsheet tools that create GIFTs==
Several contributors have used macros to generate GIFT files from a more familiar popular programs.
* There are Word macros available for easily creating GIFT files. See [http://www.moodleschool.co.nz/mod/resource/view.php?id=83 Moodle4Teachers] for downloads and instructions for use.
* There are several Excel spreadsheets for generating GIFT files. Several people have built upon other contributors work.
**The latest version was posted on 10 April 2007 and can be found in this thread with this file name: [http://moodle.org/mod/forum/discuss.php?d=66660 Excel2GIFTv1.1.zip by Timothy Takemoto]. There is also a set of instructions Excel2GIFTv1.1_Instructions.rtf by Jeff Shek on the same day in that thread.
** [http://video.google.com/videoplay?docid=-6612645502883459334# video tutorial] for using Excel2GIFTv2.xls
**An earlier version of this Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245 initially created by Olga Forlani and improved by A. T. Wyatt].
*There are Open Office templates for generating GIFT files in Writer. These are located in the Quiz forum in the [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385 OOo template to write exams and convert to GIFT format thread].
**The most recent for OO 2.x is "OOo2GIFT_Template_05.zip" posted 17 December 2005 by Enrique Castro.
**An earlier version is "GIFT_template_OOo.zip" posted 22 March 2005 by Enrique Castro.
*There is an easy to use on line multiple question generator at [http://a4esl.org/c/qw.html a4esl.org]. Here you write your question(s) without formating marks, select Moodle and press the generate quiz button. This creates GIFT formatted text that can be pasted into a file for importing into Moodle.
**The initial format requires fewer keystrokes (it uses line position and returns) than the GIFT format, so you should save time and be less likely to create invalid data.
** Quiz authoring template for Microsoft Word [http://moodle.org/mod/data/view.php?d=13&rid=578 link]
** Moodle XML Converter [http://vletools.com]
** GIFT format parser library in Ruby [http://github.com/stuart/gift-parser]

==See also==

* Here is a 2-column PDF [http://buypct.com/gift_reference.pdf GIFT Reference Sheet]
*[[Export questions]]
*[[Import questions]]
*[[Import and export FAQ]]
*[[Aiken Format]]
*[[Moodle XML format]]

==External links==
*[http://www.kingsley.k12.mi.us/documents/gift_format.pdf Formatting quizzes in GIFT format]
*[http://en.wikiversity.org/wiki/Google_Summer_of_Code_2010_Proposal:_GIFT_Conversion Google Summer of Code 2010 Proposal: GIFT Conversion] (Wikiversity)

[[Category:Questions]]

[[de:GIFT]]
[[fr:Format GIFT]]
[[ja:GIFTフォーマット]]

GIFT format

2011-08-28T10:30:05Z

Jtneill: /* Question Name */

'''GIFT format''' allows someone to use a text editor to write multiple-choice, true-false, short answer, matching missing word and numerical questions in a simple format that can be imported. The GIFT format is also an export file format available in Question bank. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

*When creating a large numbers of questions, GIFT can provide a quick way of bulk loading questions either into a [[Question bank|question category]], or into a [[Adding_a_question_page#Importing_questions|Lesson]].
*Sometimes it is easier proofing questions in a question category by viewing them in a GIFT file.

== General instructions ==
At least one blank line must be left between each question.

In the simple form, the question comes first, then the answers are set in between brackets, with an equal sign (=) indicating the correct answer(s) and tilde (~) the wrong answers. A hash (#) will insert a response. Questions can be weighted by placing percentage signs (%..%) around the weight. Comments are preceded by double slashes (//) and are not imported.

Here are some useful [http://moodle.org/pluginfile.php/134/mod_forum/attachment/236161/GIFT-examples.zip GIFT examples] than can be imported or used as rough template. Many of the examples below used the questions in the file as a starting point.

=== UTF-8 encoding ===
Any GIFT file '''must''' be correctly encoded in [[UTF8]]. You can use Microsoft's text editor Notepad which comes with Windows to save your file in UTF-8.

'''Note''': ANSI format will (only) work for languages without any special characters (like ä, ö, ü, æ, å, ø, œ or ß). And don't use "Unicode" as format as this is actually UTF-16 and won't work. See [[Converting files to UTF-8]] for further information.

===Format symbols===

Here are some common GIFT symbols and their use.

{|
! Symbols !! Use
|-
| // text || Comment until end of line (optional)
|-
| ::title:: || Question title (optional)
|-
| text || Question text (becomes title if no title specified)
|-
| [...format...] || The format of the following bit of text. Options are [html], [moodle], [plain] and [markdown]. The default is [moodle] for the question text, other parts of the question default to the format used for the question text.
|-
| { || Start answer(s) -- without any answers, text is a description of following questions
|-
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}
|-
| { ... =right ... } || Correct answer for multiple choice, (multiple answer? -- see page comments) or fill-in-the-blank
|-
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer
|-
| { ... =item -> match ... } || Answer for matching questions
|-
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers
|-
| {# || Start numeric answer(s)
|-
| answer:tolerance || Numeric answer accepted within ± tolerance range
|-
| low..high || Lower and upper range values of accepted numeric answer
|-
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer
|-
| } || End answer(s)
|-
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :
|-
| \n || Places a newline in question text -- blank lines delimit questions
|}

Here are some quick examples:

// true/false
::Q1:: 1+1=2 {T}

// multiple choice with specified feedback for right and wrong answers
::Q2:: What's between orange and green in the spectrum?
{ =yellow # right; good! ~red # wrong, it's yellow ~blue # wrong, it's yellow }

// fill-in-the-blank
::Q3:: Two plus {=two =2} equals four.

// matching
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }

// math range question
::Q5:: What is a number from 1 to 5? {#3:2}

// math range specified with interval end points
::Q6:: What is a number from 1 to 5? {#1..5}
// translated on import to the same as Q5, but unavailable from Moodle question interface

// multiple numeric answers with partial credit and feedback
::Q7:: When was Ulysses S. Grant born? {#
=1822:0 # Correct! Full credit.
=%50%1822:2 # He was born in 1822. Half credit for being close.
}

// essay
::Q8:: How are you? {}

===Format symbols explained===
The multiple choice format below as a comment line // for the question, when Moodle exports it the question unique id number will appear here.

The first set of :: precedes the question title.

The second :: precedes the actual question. The first { indicates the start of the answers. The correct answer is preceded by an = sign and wrong answers by a ~. Teacher responses have a # in front of them. The question ends with a } and then a blank line. NOTE it is { } not ( ) parenthesis! Usually these are obtained with help of the [AltGr] key.

//Comment line
::Question title
:: Question {
=A correct answer
~Wrong answer1
#A response to wrong answer1
~Wrong answer2
#A response to wrong answer2
~Wrong answer3
#A response to wrong answer3
~Wrong answer4
#A response to wrong answer4
}

The shortest format for a multiple choice question is:
Question{= A Correct Answer ~Wrong answer1 ~Wrong answer2 ~Wrong answer3 ~Wrong answer4 }

:''Tip:'' If you don't specify a question title the WHOLE question will be used as the title at the time of import into Moodle. There are pros and cons to allowing this to happen.
** Cons: This can add a lot of unnecessary words. This can include characters which might confuse the export GIFT process.
** Pros: On the other hand. if the start of each question is different, it can make finding a single question easier in a category list of questions. It will save you typing. Having the same title for every question is a very bad idea.

==Question format examples==
There are several ways to use a text editor to write a GIFT format. We will try to show the simple version for example and in some formats we will introduce some more complex features that can be imported into many Moodle Question formats.

===Multiple choice===
For multiple choice questions, wrong answers are prefixed with a tilde (~) and the correct answer is prefixed with an equal sign (=).

Here is a simple acceptable GIFT multiple choice format:
Who's buried in Grant's tomb?{=Grant ~no one ~Napoleon ~Churchill ~Mother Teresa }

Here is a longer format that uses most of the GIFT elements:

// question: 1 name: Grants tomb
::Grants tomb::Who is buried in Grant's tomb in New York City? {
=Grant
~No one
#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
~Napoleon
#He was buried in France
~Churchill
#He was buried in England
~Mother Teresa
#She was buried in India
}

===Multiple choice with multiple right answers===

That is, using checkboxes, not radio buttons:

What two people are entombed in Grant's tomb? {
~%-100%No one
~%50%Grant
~%50%Grant's wife
~%-100%Grant's father
}

===True-false===

In this question-type the answer indicates whether the statement is true or false. The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.

// question: 0 name: TrueStatement using {T} style
::TrueStatement about Grant::Grant was buried in a tomb in New York City.{T}

// question: 0 name: FalseStatement using {FALSE} style
::FalseStatement about sun::The sun rises in the West.{FALSE}

===Short answer===

Answers in Short Answer question-type are all prefixed by an equal sign (=), indicating that they are all correct answers. The answers must not contain a tilde.

Here are two examples using the simple method showing possible right answers for credit.
Who's buried in Grant's tomb?{=Grant =Ulysses S. Grant =Ulysses Grant}

Two plus two equals {=four =4}

If there is only one correct Short Answer, it may be written without the equal sign prefix, as long as it cannot be confused as True-False.

===Matching===
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.

Match the following countries with their corresponding capitals. {
=Canada -> Ottawa
=Italy -> Rome
=Japan -> Tokyo
=India -> New Delhi
}

Matching questions do not support feedback or percentage answer weights.

===Missing word===
The Missing Word format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence. To use the Missing Word format, place the answers where you want the line to appear in the sentence.
Moodle costd{~lots of money =nothing ~a small amount} to download from moodle.org.

If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted for the "missing word" format. All question types can be written in the Missing Word format.

There must be a blank line (double carriage return) separating questions. For clarity, the answers can be written on separate lines and even indented. Some examples:

Mahatma Gandhi birthday is an Indian holiday on {
~15th
~3rd
=2nd
} of October.

Since {
~495 AD
=1066 AD
~1215 AD
~ 43 AD
}
the town of Hastings England has been "famous with visitors".

===Numerical questions===

The answer section for Numerical questions must start with a number sign (#). Numerical answers can include an error margin, which is written following the correct answer, separated by a colon. So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows {#2:0.5}. This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5). If no error margin is specified, it will be assumed to be zero.

Here is a simple numerical format question. It will accept a range of 5 years.
When was Ulysses S. Grant born?{#1822:5}
It is a good idea to check the margins of the range, 3.141 is not counted as correct and 3.142 is considered in the range.
What is the value of pi (to 3 decimal places)? {#3.14159:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}

Note that since Moodle's browser GUI didn't support multiple answers for Numerical questions, there's no way in older Moodle versions to see them or edit them through Moodle. The only way to change a numerical answer beyond the first, is to delete the question and re-import it (or use something like phpMyAdmin). But better would be to upgrade your Moodle to at least 1.9.

===Essay===
An essay question is simply a question with an empty answer field. Nothing is permitted between the curly braces at all.

Write a short biography of Dag Hammarskjöld. {}

===Description===
A description "question" has no answer part at all

You can use your pencil and paper for these next math questions.

==Options==

In addition to these basic question types, this filter offers the following options: line comments, question name, feedback and percentage answer weight.

===Line Comments===
Comments that will not be imported into Moodle can be included in the text file. This can be used to provide headers or more information about questions. All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.

// Subheading: Numerical questions below
What's 2 plus 2? {#4}

Comments will be exported from Moodle and will include the unique question id. The above question after it was imported and then exported from Moodle:
// question: 914 name: What's 2 plus 2?
::What's 2 plus 2?::What's 2 plus 2?{#
=4:0#
}

===Question Name===
A question name can be specified by placing it first and enclosing it within double colons (::...::).

::Kanji Origins::Japanese characters originally
came from what country? {=China}

::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.

If no question name is specified, the entire question will be used as the name by default.

===Feedback===
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.

What's the answer to this multiple-choice question? {
~wrong answer#feedback comment on the wrong answer
~another wrong answer#feedback comment on this wrong answer
=right answer#Very good!
}

//From The Hitchhiker's Guide to the Galaxy
Deep Thought said " {
=forty two#Correct according to The Hitchhiker's Guide to the Galaxy!
=42#Correct, as told to Loonquawl and Phouchg
=forty-two#Correct!
} is the Ultimate Answer to the Ultimate Question of Life, The Universe, and Everything."

42 is the Absolute Answer to everything.{
FALSE#42is the Ultimate Answer.#You gave the right answer.}

For Multiple Choice questions, feedback is displayed only for the answer the student selected. For short answer, feedback is shown only when students input the corresponding correct answer. For true-false questions, there can be one or two feedback strings. The first is shown if the student gives the wrong answer. The second if the student gives the right answer.

===Percentage Answer Weights===
Percentage answer weights are available for both Multiple Choice and Short Answer questions. Percentage answer weights can be included by following the tilde (for Multiple Choice) or equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%). This option can be combined with feedback comments.

Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

::Jesus' hometown::Jesus Christ was from {
~Jerusalem#This was an important city, but the wrong answer.
~%25%Bethlehem#He was born here, but not raised here.
~%50%Galilee#You need to be more specific.
=Nazareth#Yes! That's right!
}.

::Jesus' hometown:: Jesus Christ was from {
=Nazareth#Yes! That's right!
=%75%Nazereth#Right, but misspelled.
=%25%Bethlehem#He was born here, but not raised here.
}

Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.

Note that it is possible to specify percentage answer weights that are NOT available through the browser interface. The Match Grades drop-down on the import page determines how these are handled. You can either request that an error be reported or that the answer weight be adjusted to the nearest valid answer weight.

Specify text-formatting for the question
The question text (only) may have an optional text format specified. Currently the available formats are moodle (Moodle Auto-Format), html (HTML format), plain (Plain text format) and markdown (Markdown format). The format is specified in square brackets immediately before the question text. See [[Formatting text]] for further information.

[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.

===Multiple Answers===
The Multiple Answers option is used for multiple choice questions when two or more answers must be selected in order to obtain full credit. The multiple answers option is enabled by assigning partial answer weight to multiple answers, while allowing no single answer to receive full credit.

What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}

Note that there is no equal sign (=) in any answer and the answers should total no more than 100%, otherwise Moodle will return an error. To avoid the problem of students automatically getting 100% by simply checking all of the answers, it is best to include negative answer weights for wrong answers.

What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}

===Special Characters ~ = # { }===
These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}

::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
~ \~ # \~ is a control character.
~ \= # \= is a control character.
~ \# # \# is a control character.
~ \{ # \{ is a control character.
~ \} # \} is a control character.
= \ # Correct! \ (backslash) is not a control character. BUT,
it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

===Specifying Categories===

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

===Making questions case sensitive===
Short Answer questions can be made case sensitive by changing "0" to "1" in the following line '''of your moodle/question/format/gift/format.php file''':
$question->usecase = 0; // Ignore case

==Hints and Tips==
* Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.

* You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
**Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
**In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write [[Image:Nbsp.png]] (without spaces between these characters).
* Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
**For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
* Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
$question->usecase = 1;
surrounded by blank lines.

==Word processors and Spreadsheets tools that create GIFTs==
Several contributors have used macros to generate GIFT files from a more familiar popular programs.
* There are Word macros available for easily creating GIFT files. See [http://www.moodleschool.co.nz/mod/resource/view.php?id=83 Moodle4Teachers] for downloads and instructions for use.
* There are several Excel spreadsheets for generating GIFT files. Several people have built upon other contributors work.
**The latest version was posted on 10 April 2007 and can be found in this thread with this file name: [http://moodle.org/mod/forum/discuss.php?d=66660 Excel2GIFTv1.1.zip by Timothy Takemoto]. There is also a set of instructions Excel2GIFTv1.1_Instructions.rtf by Jeff Shek on the same day in that thread.
** [http://video.google.com/videoplay?docid=-6612645502883459334# video tutorial] for using Excel2GIFTv2.xls
**An earlier version of this Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245 initially created by Olga Forlani and improved by A. T. Wyatt].
*There are Open Office templates for generating GIFT files in Writer. These are located in the Quiz forum in the [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385 OOo template to write exams and convert to GIFT format thread].
**The most recent for OO 2.x is "OOo2GIFT_Template_05.zip" posted 17 December 2005 by Enrique Castro.
**An earlier version is "GIFT_template_OOo.zip" posted 22 March 2005 by Enrique Castro.
*There is an easy to use on line multiple question generator at [http://a4esl.org/c/qw.html a4esl.org]. Here you write your question(s) without formating marks, select Moodle and press the generate quiz button. This creates GIFT formatted text that can be pasted into a file for importing into Moodle.
**The initial format requires fewer keystrokes (it uses line position and returns) than the GIFT format, so you should save time and be less likely to create invalid data.
** Quiz authoring template for Microsoft Word [http://moodle.org/mod/data/view.php?d=13&rid=578 link]
** Moodle XML Converter [http://vletools.com]
** GIFT format parser library in Ruby [http://github.com/stuart/gift-parser]

==See also==

* Here is a 2-column PDF [http://buypct.com/gift_reference.pdf GIFT Reference Sheet]
*[[Export questions]]
*[[Import questions]]
*[[Import and export FAQ]]
*[[Aiken Format]]
*[[Moodle XML format]]

==External links==
*[http://www.kingsley.k12.mi.us/documents/gift_format.pdf Formatting quizzes in GIFT format]
*[http://en.wikiversity.org/wiki/Google_Summer_of_Code_2010_Proposal:_GIFT_Conversion Google Summer of Code 2010 Proposal: GIFT Conversion] (Wikiversity)

[[Category:Questions]]

[[de:GIFT]]
[[fr:Format GIFT]]
[[ja:GIFTフォーマット]]

GIFT format

2011-08-28T10:15:59Z

Jtneill: /* Word processors and Spreadsheets tools that create GIFTs */

'''GIFT format''' allows someone to use a text editor to write multiple-choice, true-false, short answer, matching missing word and numerical questions in a simple format that can be imported. The GIFT format is also an export file format available in Question bank. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

*When creating a large numbers of questions, GIFT can provide a quick way of bulk loading questions either into a [[Question bank|question category]], or into a [[Adding_a_question_page#Importing_questions|Lesson]].
*Sometimes it is easier proofing questions in a question category by viewing them in a GIFT file.

== General instructions ==
At least one blank line must be left between each question.

In the simple form, the question comes first, then the answers are set in between brackets, with an equal sign (=) indicating the correct answer(s) and tilde (~) the wrong answers. A hash (#) will insert a response. Questions can be weighted by placing percentage signs (%..%) around the weight. Comments are preceded by double slashes (//) and are not imported.

Here are some useful [http://moodle.org/pluginfile.php/134/mod_forum/attachment/236161/GIFT-examples.zip GIFT examples] than can be imported or used as rough template. Many of the examples below used the questions in the file as a starting point.

=== UTF-8 encoding ===
Any GIFT file '''must''' be correctly encoded in [[UTF8]]. You can use Microsoft's text editor Notepad which comes with Windows to save your file in UTF-8.

'''Note''': ANSI format will (only) work for languages without any special characters (like ä, ö, ü, æ, å, ø, œ or ß). And don't use "Unicode" as format as this is actually UTF-16 and won't work. See [[Converting files to UTF-8]] for further information.

===Format symbols===

Here are some common GIFT symbols and their use.

{|
! Symbols !! Use
|-
| // text || Comment until end of line (optional)
|-
| ::title:: || Question title (optional)
|-
| text || Question text (becomes title if no title specified)
|-
| [...format...] || The format of the following bit of text. Options are [html], [moodle], [plain] and [markdown]. The default is [moodle] for the question text, other parts of the question default to the format used for the question text.
|-
| { || Start answer(s) -- without any answers, text is a description of following questions
|-
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}
|-
| { ... =right ... } || Correct answer for multiple choice, (multiple answer? -- see page comments) or fill-in-the-blank
|-
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer
|-
| { ... =item -> match ... } || Answer for matching questions
|-
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers
|-
| {# || Start numeric answer(s)
|-
| answer:tolerance || Numeric answer accepted within ± tolerance range
|-
| low..high || Lower and upper range values of accepted numeric answer
|-
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer
|-
| } || End answer(s)
|-
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :
|-
| \n || Places a newline in question text -- blank lines delimit questions
|}

Here are some quick examples:

// true/false
::Q1:: 1+1=2 {T}

// multiple choice with specified feedback for right and wrong answers
::Q2:: What's between orange and green in the spectrum?
{ =yellow # right; good! ~red # wrong, it's yellow ~blue # wrong, it's yellow }

// fill-in-the-blank
::Q3:: Two plus {=two =2} equals four.

// matching
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }

// math range question
::Q5:: What is a number from 1 to 5? {#3:2}

// math range specified with interval end points
::Q6:: What is a number from 1 to 5? {#1..5}
// translated on import to the same as Q5, but unavailable from Moodle question interface

// multiple numeric answers with partial credit and feedback
::Q7:: When was Ulysses S. Grant born? {#
=1822:0 # Correct! Full credit.
=%50%1822:2 # He was born in 1822. Half credit for being close.
}

// essay
::Q8:: How are you? {}

===Format symbols explained===
The multiple choice format below as a comment line // for the question, when Moodle exports it the question unique id number will appear here.

The first set of :: precedes the question title.

The second :: precedes the actual question. The first { indicates the start of the answers. The correct answer is preceded by an = sign and wrong answers by a ~. Teacher responses have a # in front of them. The question ends with a } and then a blank line. NOTE it is { } not ( ) parenthesis! Usually these are obtained with help of the [AltGr] key.

//Comment line
::Question title
:: Question {
=A correct answer
~Wrong answer1
#A response to wrong answer1
~Wrong answer2
#A response to wrong answer2
~Wrong answer3
#A response to wrong answer3
~Wrong answer4
#A response to wrong answer4
}

The shortest format for a multiple choice question is:
Question{= A Correct Answer ~Wrong answer1 ~Wrong answer2 ~Wrong answer3 ~Wrong answer4 }

:''Tip:'' If you don't specify a question title the WHOLE question will be used as the title at the time of import into Moodle. There are pros and cons to allowing this to happen.
** Cons: This can add a lot of unnecessary words. This can include characters which might confuse the export GIFT process.
** Pros: On the other hand. if the start of each question is different, it can make finding a single question easier in a category list of questions. It will save you typing. Having the same title for every question is a very bad idea.

==Question format examples==
There are several ways to use a text editor to write a GIFT format. We will try to show the simple version for example and in some formats we will introduce some more complex features that can be imported into many Moodle Question formats.

===Multiple choice===
For multiple choice questions, wrong answers are prefixed with a tilde (~) and the correct answer is prefixed with an equal sign (=).

Here is a simple acceptable GIFT multiple choice format:
Who's buried in Grant's tomb?{=Grant ~no one ~Napoleon ~Churchill ~Mother Teresa }

Here is a longer format that uses most of the GIFT elements:

// question: 1 name: Grants tomb
::Grants tomb::Who is buried in Grant's tomb in New York City? {
=Grant
~No one
#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
~Napoleon
#He was buried in France
~Churchill
#He was buried in England
~Mother Teresa
#She was buried in India
}

===Multiple choice with multiple right answers===

That is, using checkboxes, not radio buttons:

What two people are entombed in Grant's tomb? {
~%-100%No one
~%50%Grant
~%50%Grant's wife
~%-100%Grant's father
}

===True-false===

In this question-type the answer indicates whether the statement is true or false. The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.

// question: 0 name: TrueStatement using {T} style
::TrueStatement about Grant::Grant was buried in a tomb in New York City.{T}

// question: 0 name: FalseStatement using {FALSE} style
::FalseStatement about sun::The sun rises in the West.{FALSE}

===Short answer===

Answers in Short Answer question-type are all prefixed by an equal sign (=), indicating that they are all correct answers. The answers must not contain a tilde.

Here are two examples using the simple method showing possible right answers for credit.
Who's buried in Grant's tomb?{=Grant =Ulysses S. Grant =Ulysses Grant}

Two plus two equals {=four =4}

If there is only one correct Short Answer, it may be written without the equal sign prefix, as long as it cannot be confused as True-False.

===Matching===
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.

Match the following countries with their corresponding capitals. {
=Canada -> Ottawa
=Italy -> Rome
=Japan -> Tokyo
=India -> New Delhi
}

Matching questions do not support feedback or percentage answer weights.

===Missing word===
The Missing Word format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence. To use the Missing Word format, place the answers where you want the line to appear in the sentence.
Moodle costd{~lots of money =nothing ~a small amount} to download from moodle.org.

If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted for the "missing word" format. All question types can be written in the Missing Word format.

There must be a blank line (double carriage return) separating questions. For clarity, the answers can be written on separate lines and even indented. Some examples:

Mahatma Gandhi birthday is an Indian holiday on {
~15th
~3rd
=2nd
} of October.

Since {
~495 AD
=1066 AD
~1215 AD
~ 43 AD
}
the town of Hastings England has been "famous with visitors".

===Numerical questions===

The answer section for Numerical questions must start with a number sign (#). Numerical answers can include an error margin, which is written following the correct answer, separated by a colon. So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows {#2:0.5}. This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5). If no error margin is specified, it will be assumed to be zero.

Here is a simple numerical format question. It will accept a range of 5 years.
When was Ulysses S. Grant born?{#1822:5}
It is a good idea to check the margins of the range, 3.141 is not counted as correct and 3.142 is considered in the range.
What is the value of pi (to 3 decimal places)? {#3.14159:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}

Note that since Moodle's browser GUI didn't support multiple answers for Numerical questions, there's no way in older Moodle versions to see them or edit them through Moodle. The only way to change a numerical answer beyond the first, is to delete the question and re-import it (or use something like phpMyAdmin). But better would be to upgrade your Moodle to at least 1.9.

===Essay===
An essay question is simply a question with an empty answer field. Nothing is permitted between the curly braces at all.

Write a short biography of Dag Hammarskjöld. {}

===Description===
A description "question" has no answer part at all

You can use your pencil and paper for these next math questions.

==Options==

In addition to these basic question types, this filter offers the following options: line comments, question name, feedback and percentage answer weight.

===Line Comments===
Comments that will not be imported into Moodle can be included in the text file. This can be used to provide headers or more information about questions. All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.

// Subheading: Numerical questions below
What's 2 plus 2? {#4}

Comments will be exported from Moodle and will include the unique question id. The above question after it was imported and then exported from Moodle:
// question: 914 name: What's 2 plus 2?
::What's 2 plus 2?::What's 2 plus 2?{#
=4:0#
}

===Question Name===
A question name can be specified by placing it first and enclosing it within double colons.

::Kanji Origins::Japanese characters originally
came from what country? {=China}

::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.

If no question name is specified, the entire question will be used as the name by default.

===Feedback===
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.

What's the answer to this multiple-choice question? {
~wrong answer#feedback comment on the wrong answer
~another wrong answer#feedback comment on this wrong answer
=right answer#Very good!
}

//From The Hitchhiker's Guide to the Galaxy
Deep Thought said " {
=forty two#Correct according to The Hitchhiker's Guide to the Galaxy!
=42#Correct, as told to Loonquawl and Phouchg
=forty-two#Correct!
} is the Ultimate Answer to the Ultimate Question of Life, The Universe, and Everything."

42 is the Absolute Answer to everything.{
FALSE#42is the Ultimate Answer.#You gave the right answer.}

For Multiple Choice questions, feedback is displayed only for the answer the student selected. For short answer, feedback is shown only when students input the corresponding correct answer. For true-false questions, there can be one or two feedback strings. The first is shown if the student gives the wrong answer. The second if the student gives the right answer.

===Percentage Answer Weights===
Percentage answer weights are available for both Multiple Choice and Short Answer questions. Percentage answer weights can be included by following the tilde (for Multiple Choice) or equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%). This option can be combined with feedback comments.

Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

::Jesus' hometown::Jesus Christ was from {
~Jerusalem#This was an important city, but the wrong answer.
~%25%Bethlehem#He was born here, but not raised here.
~%50%Galilee#You need to be more specific.
=Nazareth#Yes! That's right!
}.

::Jesus' hometown:: Jesus Christ was from {
=Nazareth#Yes! That's right!
=%75%Nazereth#Right, but misspelled.
=%25%Bethlehem#He was born here, but not raised here.
}

Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.

Note that it is possible to specify percentage answer weights that are NOT available through the browser interface. The Match Grades drop-down on the import page determines how these are handled. You can either request that an error be reported or that the answer weight be adjusted to the nearest valid answer weight.

Specify text-formatting for the question
The question text (only) may have an optional text format specified. Currently the available formats are moodle (Moodle Auto-Format), html (HTML format), plain (Plain text format) and markdown (Markdown format). The format is specified in square brackets immediately before the question text. See [[Formatting text]] for further information.

[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.

===Multiple Answers===
The Multiple Answers option is used for multiple choice questions when two or more answers must be selected in order to obtain full credit. The multiple answers option is enabled by assigning partial answer weight to multiple answers, while allowing no single answer to receive full credit.

What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}

Note that there is no equal sign (=) in any answer and the answers should total no more than 100%, otherwise Moodle will return an error. To avoid the problem of students automatically getting 100% by simply checking all of the answers, it is best to include negative answer weights for wrong answers.

What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}

===Special Characters ~ = # { }===
These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}

::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
~ \~ # \~ is a control character.
~ \= # \= is a control character.
~ \# # \# is a control character.
~ \{ # \{ is a control character.
~ \} # \} is a control character.
= \ # Correct! \ (backslash) is not a control character. BUT,
it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

===Specifying Categories===

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

===Making questions case sensitive===
Short Answer questions can be made case sensitive by changing "0" to "1" in the following line '''of your moodle/question/format/gift/format.php file''':
$question->usecase = 0; // Ignore case

==Hints and Tips==
* Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.

* You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
**Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
**In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write [[Image:Nbsp.png]] (without spaces between these characters).
* Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
**For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
* Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
$question->usecase = 1;
surrounded by blank lines.

==Word processors and Spreadsheets tools that create GIFTs==
Several contributors have used macros to generate GIFT files from a more familiar popular programs.
* There are Word macros available for easily creating GIFT files. See [http://www.moodleschool.co.nz/mod/resource/view.php?id=83 Moodle4Teachers] for downloads and instructions for use.
* There are several Excel spreadsheets for generating GIFT files. Several people have built upon other contributors work.
**The latest version was posted on 10 April 2007 and can be found in this thread with this file name: [http://moodle.org/mod/forum/discuss.php?d=66660 Excel2GIFTv1.1.zip by Timothy Takemoto]. There is also a set of instructions Excel2GIFTv1.1_Instructions.rtf by Jeff Shek on the same day in that thread.
** [http://video.google.com/videoplay?docid=-6612645502883459334# video tutorial] for using Excel2GIFTv2.xls
**An earlier version of this Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245 initially created by Olga Forlani and improved by A. T. Wyatt].
*There are Open Office templates for generating GIFT files in Writer. These are located in the Quiz forum in the [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385 OOo template to write exams and convert to GIFT format thread].
**The most recent for OO 2.x is "OOo2GIFT_Template_05.zip" posted 17 December 2005 by Enrique Castro.
**An earlier version is "GIFT_template_OOo.zip" posted 22 March 2005 by Enrique Castro.
*There is an easy to use on line multiple question generator at [http://a4esl.org/c/qw.html a4esl.org]. Here you write your question(s) without formating marks, select Moodle and press the generate quiz button. This creates GIFT formatted text that can be pasted into a file for importing into Moodle.
**The initial format requires fewer keystrokes (it uses line position and returns) than the GIFT format, so you should save time and be less likely to create invalid data.
** Quiz authoring template for Microsoft Word [http://moodle.org/mod/data/view.php?d=13&rid=578 link]
** Moodle XML Converter [http://vletools.com]
** GIFT format parser library in Ruby [http://github.com/stuart/gift-parser]

==See also==

* Here is a 2-column PDF [http://buypct.com/gift_reference.pdf GIFT Reference Sheet]
*[[Export questions]]
*[[Import questions]]
*[[Import and export FAQ]]
*[[Aiken Format]]
*[[Moodle XML format]]

==External links==
*[http://www.kingsley.k12.mi.us/documents/gift_format.pdf Formatting quizzes in GIFT format]
*[http://en.wikiversity.org/wiki/Google_Summer_of_Code_2010_Proposal:_GIFT_Conversion Google Summer of Code 2010 Proposal: GIFT Conversion] (Wikiversity)

[[Category:Questions]]

[[de:GIFT]]
[[fr:Format GIFT]]
[[ja:GIFTフォーマット]]

GIFT format

2011-08-28T10:13:19Z

Jtneill: /* General instructions */ copyedits

'''GIFT format''' allows someone to use a text editor to write multiple-choice, true-false, short answer, matching missing word and numerical questions in a simple format that can be imported. The GIFT format is also an export file format available in Question bank. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

*When creating a large numbers of questions, GIFT can provide a quick way of bulk loading questions either into a [[Question bank|question category]], or into a [[Adding_a_question_page#Importing_questions|Lesson]].
*Sometimes it is easier proofing questions in a question category by viewing them in a GIFT file.

== General instructions ==
At least one blank line must be left between each question.

In the simple form, the question comes first, then the answers are set in between brackets, with an equal sign (=) indicating the correct answer(s) and tilde (~) the wrong answers. A hash (#) will insert a response. Questions can be weighted by placing percentage signs (%..%) around the weight. Comments are preceded by double slashes (//) and are not imported.

Here are some useful [http://moodle.org/pluginfile.php/134/mod_forum/attachment/236161/GIFT-examples.zip GIFT examples] than can be imported or used as rough template. Many of the examples below used the questions in the file as a starting point.

=== UTF-8 encoding ===
Any GIFT file '''must''' be correctly encoded in [[UTF8]]. You can use Microsoft's text editor Notepad which comes with Windows to save your file in UTF-8.

'''Note''': ANSI format will (only) work for languages without any special characters (like ä, ö, ü, æ, å, ø, œ or ß). And don't use "Unicode" as format as this is actually UTF-16 and won't work. See [[Converting files to UTF-8]] for further information.

===Format symbols===

Here are some common GIFT symbols and their use.

{|
! Symbols !! Use
|-
| // text || Comment until end of line (optional)
|-
| ::title:: || Question title (optional)
|-
| text || Question text (becomes title if no title specified)
|-
| [...format...] || The format of the following bit of text. Options are [html], [moodle], [plain] and [markdown]. The default is [moodle] for the question text, other parts of the question default to the format used for the question text.
|-
| { || Start answer(s) -- without any answers, text is a description of following questions
|-
| {T} or {F} || True or False answer; also {TRUE} and {FALSE}
|-
| { ... =right ... } || Correct answer for multiple choice, (multiple answer? -- see page comments) or fill-in-the-blank
|-
| { ... ~wrong ... } || Incorrect answer for multiple choice or multiple answer
|-
| { ... =item -> match ... } || Answer for matching questions
|-
| #feedback text || Answer feedback for preceding multiple, fill-in-the-blank, or numeric answers
|-
| {# || Start numeric answer(s)
|-
| answer:tolerance || Numeric answer accepted within ± tolerance range
|-
| low..high || Lower and upper range values of accepted numeric answer
|-
| =%n%answer:tolerance || n percent credit for one of multiple numeric ranges within tolerance from answer
|-
| } || End answer(s)
|-
| \character || Backslash escapes the special meaning of ~, =, #, {, }, and :
|-
| \n || Places a newline in question text -- blank lines delimit questions
|}

Here are some quick examples:

// true/false
::Q1:: 1+1=2 {T}

// multiple choice with specified feedback for right and wrong answers
::Q2:: What's between orange and green in the spectrum?
{ =yellow # right; good! ~red # wrong, it's yellow ~blue # wrong, it's yellow }

// fill-in-the-blank
::Q3:: Two plus {=two =2} equals four.

// matching
::Q4:: Which animal eats which food? { =cat -> cat food =dog -> dog food }

// math range question
::Q5:: What is a number from 1 to 5? {#3:2}

// math range specified with interval end points
::Q6:: What is a number from 1 to 5? {#1..5}
// translated on import to the same as Q5, but unavailable from Moodle question interface

// multiple numeric answers with partial credit and feedback
::Q7:: When was Ulysses S. Grant born? {#
=1822:0 # Correct! Full credit.
=%50%1822:2 # He was born in 1822. Half credit for being close.
}

// essay
::Q8:: How are you? {}

===Format symbols explained===
The multiple choice format below as a comment line // for the question, when Moodle exports it the question unique id number will appear here.

The first set of :: precedes the question title.

The second :: precedes the actual question. The first { indicates the start of the answers. The correct answer is preceded by an = sign and wrong answers by a ~. Teacher responses have a # in front of them. The question ends with a } and then a blank line. NOTE it is { } not ( ) parenthesis! Usually these are obtained with help of the [AltGr] key.

//Comment line
::Question title
:: Question {
=A correct answer
~Wrong answer1
#A response to wrong answer1
~Wrong answer2
#A response to wrong answer2
~Wrong answer3
#A response to wrong answer3
~Wrong answer4
#A response to wrong answer4
}

The shortest format for a multiple choice question is:
Question{= A Correct Answer ~Wrong answer1 ~Wrong answer2 ~Wrong answer3 ~Wrong answer4 }

:''Tip:'' If you don't specify a question title the WHOLE question will be used as the title at the time of import into Moodle. There are pros and cons to allowing this to happen.
** Cons: This can add a lot of unnecessary words. This can include characters which might confuse the export GIFT process.
** Pros: On the other hand. if the start of each question is different, it can make finding a single question easier in a category list of questions. It will save you typing. Having the same title for every question is a very bad idea.

==Question format examples==
There are several ways to use a text editor to write a GIFT format. We will try to show the simple version for example and in some formats we will introduce some more complex features that can be imported into many Moodle Question formats.

===Multiple choice===
For multiple choice questions, wrong answers are prefixed with a tilde (~) and the correct answer is prefixed with an equal sign (=).

Here is a simple acceptable GIFT multiple choice format:
Who's buried in Grant's tomb?{=Grant ~no one ~Napoleon ~Churchill ~Mother Teresa }

Here is a longer format that uses most of the GIFT elements:

// question: 1 name: Grants tomb
::Grants tomb::Who is buried in Grant's tomb in New York City? {
=Grant
~No one
#Was true for 12 years, but Grant's remains were buried in the tomb in 1897
~Napoleon
#He was buried in France
~Churchill
#He was buried in England
~Mother Teresa
#She was buried in India
}

===Multiple choice with multiple right answers===

That is, using checkboxes, not radio buttons:

What two people are entombed in Grant's tomb? {
~%-100%No one
~%50%Grant
~%50%Grant's wife
~%-100%Grant's father
}

===True-false===

In this question-type the answer indicates whether the statement is true or false. The answer should be written as {TRUE} or {FALSE}, or abbreviated to {T} or {F}.

// question: 0 name: TrueStatement using {T} style
::TrueStatement about Grant::Grant was buried in a tomb in New York City.{T}

// question: 0 name: FalseStatement using {FALSE} style
::FalseStatement about sun::The sun rises in the West.{FALSE}

===Short answer===

Answers in Short Answer question-type are all prefixed by an equal sign (=), indicating that they are all correct answers. The answers must not contain a tilde.

Here are two examples using the simple method showing possible right answers for credit.
Who's buried in Grant's tomb?{=Grant =Ulysses S. Grant =Ulysses Grant}

Two plus two equals {=four =4}

If there is only one correct Short Answer, it may be written without the equal sign prefix, as long as it cannot be confused as True-False.

===Matching===
Matching pairs begin with an equal sign (=) and are separated by this symbol "->". There must be at least three matching pairs.

Match the following countries with their corresponding capitals. {
=Canada -> Ottawa
=Italy -> Rome
=Japan -> Tokyo
=India -> New Delhi
}

Matching questions do not support feedback or percentage answer weights.

===Missing word===
The Missing Word format automatically inserts a fill-in-the-blank line (like this _____) in the middle of the sentence. To use the Missing Word format, place the answers where you want the line to appear in the sentence.
Moodle costd{~lots of money =nothing ~a small amount} to download from moodle.org.

If the answers come before the closing punctuation mark, a fill-in-the-blank line will be inserted for the "missing word" format. All question types can be written in the Missing Word format.

There must be a blank line (double carriage return) separating questions. For clarity, the answers can be written on separate lines and even indented. Some examples:

Mahatma Gandhi birthday is an Indian holiday on {
~15th
~3rd
=2nd
} of October.

Since {
~495 AD
=1066 AD
~1215 AD
~ 43 AD
}
the town of Hastings England has been "famous with visitors".

===Numerical questions===

The answer section for Numerical questions must start with a number sign (#). Numerical answers can include an error margin, which is written following the correct answer, separated by a colon. So for example, if the correct answer is anything between 1.5 and 2.5, then it would be written as follows {#2:0.5}. This indicates that 2 with an error margin of 0.5 is correct (i.e., the span from 1.5 to 2.5). If no error margin is specified, it will be assumed to be zero.

Here is a simple numerical format question. It will accept a range of 5 years.
When was Ulysses S. Grant born?{#1822:5}
It is a good idea to check the margins of the range, 3.141 is not counted as correct and 3.142 is considered in the range.
What is the value of pi (to 3 decimal places)? {#3.14159:0.0005}.

Optionally, numerical answers can be written as a span in the following format {#MinimumValue..MaximumValue}.

What is the value of pi (to 3 decimal places)? {#3.141..3.142}.

Moodle's browser interface does not support multiple numerical answers, but Moodle's code can and so does GIFT. This can be used to specify numerical multiple spans, and can be particularly usefully when combined with percentage weight grades. If multiple answers are used, they must be separated by an equal sign, like short answer questions.

When was Ulysses S. Grant born? {#
=1822:0
=%50%1822:2
}

Note that since Moodle's browser GUI didn't support multiple answers for Numerical questions, there's no way in older Moodle versions to see them or edit them through Moodle. The only way to change a numerical answer beyond the first, is to delete the question and re-import it (or use something like phpMyAdmin). But better would be to upgrade your Moodle to at least 1.9.

===Essay===
An essay question is simply a question with an empty answer field. Nothing is permitted between the curly braces at all.

Write a short biography of Dag Hammarskjöld. {}

===Description===
A description "question" has no answer part at all

You can use your pencil and paper for these next math questions.

==Options==

In addition to these basic question types, this filter offers the following options: line comments, question name, feedback and percentage answer weight.

===Line Comments===
Comments that will not be imported into Moodle can be included in the text file. This can be used to provide headers or more information about questions. All lines that start with a double backslash (not counting tabs or spaces) will be ignored by the filter.

// Subheading: Numerical questions below
What's 2 plus 2? {#4}

Comments will be exported from Moodle and will include the unique question id. The above question after it was imported and then exported from Moodle:
// question: 914 name: What's 2 plus 2?
::What's 2 plus 2?::What's 2 plus 2?{#
=4:0#
}

===Question Name===
A question name can be specified by placing it first and enclosing it within double colons.

::Kanji Origins::Japanese characters originally
came from what country? {=China}

::Thanksgiving Date::The American holiday of Thanksgiving is
celebrated on the {~second ~third =fourth} Thursday of November.

If no question name is specified, the entire question will be used as the name by default.

===Feedback===
Feedback can be included for each answer by following the answer with a number sign (# also known as a hash mark) and the feedback.

What's the answer to this multiple-choice question? {
~wrong answer#feedback comment on the wrong answer
~another wrong answer#feedback comment on this wrong answer
=right answer#Very good!
}

//From The Hitchhiker's Guide to the Galaxy
Deep Thought said " {
=forty two#Correct according to The Hitchhiker's Guide to the Galaxy!
=42#Correct, as told to Loonquawl and Phouchg
=forty-two#Correct!
} is the Ultimate Answer to the Ultimate Question of Life, The Universe, and Everything."

42 is the Absolute Answer to everything.{
FALSE#42is the Ultimate Answer.#You gave the right answer.}

For Multiple Choice questions, feedback is displayed only for the answer the student selected. For short answer, feedback is shown only when students input the corresponding correct answer. For true-false questions, there can be one or two feedback strings. The first is shown if the student gives the wrong answer. The second if the student gives the right answer.

===Percentage Answer Weights===
Percentage answer weights are available for both Multiple Choice and Short Answer questions. Percentage answer weights can be included by following the tilde (for Multiple Choice) or equal sign (for Short Answer) with the desired percent enclosed within percent signs (e.g., %50%). This option can be combined with feedback comments.

Difficult question.{~wrong answer ~%50%half credit answer =full credit answer}

::Jesus' hometown::Jesus Christ was from {
~Jerusalem#This was an important city, but the wrong answer.
~%25%Bethlehem#He was born here, but not raised here.
~%50%Galilee#You need to be more specific.
=Nazareth#Yes! That's right!
}.

::Jesus' hometown:: Jesus Christ was from {
=Nazareth#Yes! That's right!
=%75%Nazereth#Right, but misspelled.
=%25%Bethlehem#He was born here, but not raised here.
}

Note that the last two examples are essentially the same question, first as multiple choice and then as short answer.

Note that it is possible to specify percentage answer weights that are NOT available through the browser interface. The Match Grades drop-down on the import page determines how these are handled. You can either request that an error be reported or that the answer weight be adjusted to the nearest valid answer weight.

Specify text-formatting for the question
The question text (only) may have an optional text format specified. Currently the available formats are moodle (Moodle Auto-Format), html (HTML format), plain (Plain text format) and markdown (Markdown format). The format is specified in square brackets immediately before the question text. See [[Formatting text]] for further information.

[markdown]The *American holiday of Thanksgiving* is celebrated on the {
~second
~third
=fourth
} Thursday of November.

===Multiple Answers===
The Multiple Answers option is used for multiple choice questions when two or more answers must be selected in order to obtain full credit. The multiple answers option is enabled by assigning partial answer weight to multiple answers, while allowing no single answer to receive full credit.

What two people are entombed in Grant's tomb? {
~No one
~%50%Grant
~%50%Grant's wife
~Grant's father
}

Note that there is no equal sign (=) in any answer and the answers should total no more than 100%, otherwise Moodle will return an error. To avoid the problem of students automatically getting 100% by simply checking all of the answers, it is best to include negative answer weights for wrong answers.

What two people are entombed in Grant's tomb? {
~%-50%No one
~%50%Grant
~%50%Grant's wife
~%-50%Grant's father
}

===Special Characters ~ = # { }===
These symbols ~ = # { } : control the operation of this filter and cannot be used as normal text within questions. Since these symbols have a special role in determining the operation of this filter, they are called "control characters." But sometimes you may want to use one of these characters, for example to show a mathematical formula in a question. The way to get around this problem is "escaping" the control characters. This means simply putting a backslash (\) before a control character so the filter will know that you want to use it as a literal character instead of as a control character. For example:

Which answer equals 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4
}

::GIFT Control Characters::
Which of the following is NOT a control character for the GIFT import format? {
~ \~ # \~ is a control character.
~ \= # \= is a control character.
~ \# # \# is a control character.
~ \{ # \{ is a control character.
~ \} # \} is a control character.
= \ # Correct! \ (backslash) is not a control character. BUT,
it is used to escape the control characters.
}

When the question is processed, the backslash is removed and is not saved in Moodle.

===Specifying Categories===

It is possible to change the category into which the questions are added within the GIFT file. You can change the category as many times as you wish within the file. All questions after the modifier up to the next modifier or the end of the file will be added to the specified category. Up to the first category modifier the category specified on the import screen will be used. Note that for this to work the from file: box must be ticked on the import screen.

To include a category modifier include a line like this (with a blank line before and after):

$CATEGORY: tom/dick/harry

or simply

$CATEGORY: mycategory

...the first example specifies a path of nested categories. In this case the questions will go into harry. The categories are created if they do not exist.

===Making questions case sensitive===
Short Answer questions can be made case sensitive by changing "0" to "1" in the following line '''of your moodle/question/format/gift/format.php file''':
$question->usecase = 0; // Ignore case

==Hints and Tips==
* Use the ::title:: at the beginning of every question to organize your questions when Moodle presents a list or exports them as another GIFT file. When the title is left blank, Moodle will put the beginning of the question as the title. Some teachers want to see something like "001 LIT101 Poe ref Purloin Letter" or "The Purloin Letter was written by (AmLit pg 254)" in the title.

* You can specify markup if you need to format the question by setting [html], [moodle], [plain] or [markdown] just before the question text. See more about this in the reference pdf below.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1.
**Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.)
**In case you want no visible message displayed then enter a non-breaking space as feedback. Moodle will not put it's automatic response because it sees the blank space. To do this, put a # after the answer and write [[Image:Nbsp.png]] (without spaces between these characters).
* Need to use a special GIFT character in your question or answer? Put a \ in front of the GIFT character.
**For example if you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* Want to change T/F type questions to multiple choice? Consider exporting the T/F questions as a GIFT file, then using a text editor to replace the (T) with (=True ~False). Perhaps change the title slightly so you will recognize the new questions.
* Alphabetic case-sensitive comparison is disabled by default. If you need case-sensitive comparison for short answer questions (an unusual need), precede them with:
$question->usecase = 1;
surrounded by blank lines.

==Word processors and Spreadsheets tools that create GIFTs==
Several contributors have used macros to generate GIFT files from a more familiar popular programs.
* There are Word macros available for easily creating GIFT files. See [http://www.moodleschool.co.nz/mod/resource/view.php?id=83 Moodle4Teachers] for downloads and instructions for use.
* There are several Excel spreadsheets for generating GIFT files. Several people have built upon other contributors work.
**The latest version was posted on 10 April 2007 and can be found in this thread with this file name: [http://moodle.org/mod/forum/discuss.php?d=66660 Excel2GIFTv1.1.zip by Timothy Takemoto]. There is also a set of instructions Excel2GIFTv1.1_Instructions.rtf by Jeff Shek on the same day in that thread.
** [http://video.google.com/videoplay?docid=-6612645502883459334# video tutorial] for using Excel2GIFTv2.xls
**An earlier version of this Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245 initially created by Olga Forlani and improved by A. T. Wyatt].
*There are Open Office templates for generating GIFT files in Writer. These are located in the Quiz forum in the[http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385 OOo template to write exams and convert to GIFT format thread].
**The most recent for OO 2.x is "OOo2GIFT_Template_05.zip" postes 17 December 2005 by Enrique Castro.
**An earlier version is "GIFT_template_OOo.zip" posted 22 March 2005 by Enrique Castro.
*There is an easy to use on line multiple question generator at [http://a4esl.org/c/qw.html a4esl.org]. Here you write your question(s) without formating marks, select Moodle and press the generate quiz button. This creates GIFT formatted text that can be pasted into a file for importing into Moodle.
**The initial format requires fewer keystrokes (it uses line position and returns) than the GIFT format, so you should save time and be less likely to create invalid data.
** Quiz authoring template for Microsoft Word [http://moodle.org/mod/data/view.php?d=13&rid=578 link]
** Moodle XML Converter [http://vletools.com]
** GIFT format parser library in Ruby [http://github.com/stuart/gift-parser]

==See also==

* Here is a 2-column PDF [http://buypct.com/gift_reference.pdf GIFT Reference Sheet]
*[[Export questions]]
*[[Import questions]]
*[[Import and export FAQ]]
*[[Aiken Format]]
*[[Moodle XML format]]

==External links==
*[http://www.kingsley.k12.mi.us/documents/gift_format.pdf Formatting quizzes in GIFT format]
*[http://en.wikiversity.org/wiki/Google_Summer_of_Code_2010_Proposal:_GIFT_Conversion Google Summer of Code 2010 Proposal: GIFT Conversion] (Wikiversity)

[[Category:Questions]]

[[de:GIFT]]
[[fr:Format GIFT]]
[[ja:GIFTフォーマット]]

Export

2011-08-02T10:49:45Z

Jtneill:

How can activities and resources be exported and imported between sites?

These export resources relate to [[quiz]]:
* [[Export questions]]
* [[Import and export FAQ]]

Export

2011-08-02T10:49:15Z

Jtneill:

How can activities be exported and imported?

These export resources relate to [[quiz]]:
* [[Export questions]]
* [[Import and export FAQ]]

Export

2011-08-02T10:48:06Z

Jtneill: Created page with "{{uncat}} * Export questions * Import and export FAQ"

{{uncat}}
* [[Export questions]]
* [[Import and export FAQ]]

User:James Neill

2011-08-02T10:47:12Z

Jtneill: /* I'm reading/learning/trying */

==Currently working on==
# [[Moodleposium]]
## [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[Export]]
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

User:James Neill/Moodleposium/2010

2010-10-08T13:01:43Z

Jtneill: /* Take-away messages */ # [http://agimo.govspace.gov.au/2010/10/07/government-2-0-update-%E2%80%93-amended-ip-principles-released/ The Australian Government announced that public sector information w

Main page: [[Moodleposium/2010]]

=Notes by [[User:James Neill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]] (Oct 7-8, 2010), so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I bookmarked on Delicious - [http://www.delicious.com/jtneill/mpos10 jtneill/mpos10]. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]
# [[User:James Neill/Moodleposium/2010/Neill]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

==Take-away messages==
# Moodle 2.0 is pretty much ready to go - it offers improved security and involves major rewrites of significant functionality e.g., Files system and Messaging, new features such as better capacity for bringing in external social media
# [[University of Canberra]], [[Australian National University]], and [[CIT]], the three major tertiary providers in the ACT, are now all on Moodle (1.9) - which is facilitating valuable cross-institutional collaboration - they will all be migrating to v2 in 2011.
# [http://agimo.govspace.gov.au/2010/10/07/government-2-0-update-%E2%80%93-amended-ip-principles-released/ The Australian Government announced that public sector information was to have a default creative commons attribution license].

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Neill

2010-10-08T12:57:15Z

Jtneill: New page: See Moodleposium/2010/Neill. Category:User:James Neill/Moodleposium/2010

See [[Moodleposium/2010/Neill]].

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010

2010-10-08T12:52:58Z

Jtneill: /* Day 1 */

User:James Neill/Moodleposium/2010

2010-10-08T12:16:48Z

Jtneill:

Main page: [[Moodleposium/2010]]

=Notes by [[User:James Neill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]] (Oct 7-8, 2010), so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I bookmarked on Delicious - [http://www.delicious.com/jtneill/mpos10 jtneill/mpos10]. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

==Take-away messages==
# Moodle 2.0 is pretty much ready to go - it offers improved security and involves major rewrites of significant functionality e.g., Files system and Messaging, new features such as better capacity for bringing in external social media
# [[University of Canberra]], [[Australian National University]], and [[CIT]], the three major tertiary providers in the ACT, are now all on Moodle (1.9) - which is facilitating valuable cross-institutional collaboration - they will all be migrating to v2 in 2011.

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010

2010-10-08T12:16:22Z

Jtneill: /* Notes by James Neill */ A couple of key overall points: # Moodle 2.0 is pretty much ready to go - it offers improved security and involves major rewrites of significant functionality e.g., Files sy

Main page: [[Moodleposium/2010]]

=Notes by [[User:James Neill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]] (Oct 7-8, 2010), so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I bookmarked on Delicious - [http://www.delicious.com/jtneill/mpos10 jtneill/mpos10]. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

A couple of key overall points:
# Moodle 2.0 is pretty much ready to go - it offers improved security and involves major rewrites of significant functionality e.g., Files system and Messaging, new features such as better capacity for bringing in external social media
# [[University of Canberra]], [[Australian National University]], and [[CIT]], the three major tertiary providers in the ACT, are now all on Moodle (1.9) - which is facilitating valuable cross-institutional collaboration - they will all be migrating to v2 in 2011.

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010

2010-10-08T12:05:05Z

Jtneill: /* Notes by James Neill */

Main page: [[Moodleposium/2010]]

=Notes by [[User:James Neill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I bookmarked on Delicious - [http://www.delicious.com/jtneill/mpos10 jtneill/mpos10]. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill

2010-10-08T12:02:49Z

Jtneill: /* Currently working on */ [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]

==Currently working on==
# [[Moodleposium]]
## [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

User:James Neill/Moodleposium/2010

2010-10-08T12:00:53Z

Jtneill: /* Notes by James Neill */

Main page: [[Moodleposium/2010]]

=Notes by [[User:James Neill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010

2010-10-08T12:00:32Z

Jtneill:

Main page: [[Moodleposium/2010]]

=Notes by [[User:Jtneill|James Neill]]=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill

2010-10-08T11:44:33Z

Jtneill: /* Current */

==Currently working on==
# [[Moodleposium]]
## [[Moodleposium/2010]]
## [[User:James Neill/Moodleposium/2010]]
## [[Moodleposium/2009]]
## [[User:James Neill/Moodleposium/2009]]

==I'm reading/learning/trying==
# [[GIFT format]]
# [[Gradebook improvements in Moodle 1.9.5]]
# [[Student tutorials]]
# [[MoodleDocs:Transclusion]] - trying to figure out how to transclude content e.g., across multiple pages and sites
# [[HTML editor]]
# [[HTML linking]]
# [[Course homepage]]
# [[Course formats]]
# [[Shared activities course format]]
# [[Hot Potatoes]]
# Inserting css to create a new header/banner (Robson)
# Embedded screen case videos in slide presentations (Ridden)
# [[OU wiki]]

=== [[Usability]] ===
# [[Course formats]]
# [[Development:Quiz Usability portal]]
# [http://moodle.org/mod/forum/view.php?f=1027 Usability Forum]
# [[Development:Moodle User Interface Guidelines]]
# [[Usability FAQ]]
# [http://tracker.moodle.org/browse/MDL/component/10309?selected=com.atlassian.jira.plugin.system.project:component-openissues-panel Usability tracker]
# [http://moodle.org/mod/forum/discuss.php?d=132184 Users should be able to toggle centre column sections open/closed]

{{/Banner}}
{{TOCright}}
{{/Bio}}
{{/My Moodle}}
{{/People}}

==Related apps==
# [[Equella]]
# [[Mahara]]
# [[Wimba]]

{{/See also}}
{{/External links}}

User:James Neill/Bio

2010-10-08T11:43:37Z

Jtneill: /* Bio */ update

==[[User:James Neill/Bio|Bio]]==
# Been using Moodle as a teacher moderately extensively since 2008 and a Moodle Mentor at the [[University of Canberra]] - but still learning about how to [[User:James Neill/Using Moodle|use Moodle]].
# Lecturer in psychology, [[University of Canberra]] (UC), Australia -- UC switched from [[WebCT]] to [[Moodle]] in 2009. I'm a "Moodle Mentor" (helping staff in my discipline to adopt/adapt to Moodle)
# Advocate of open academic principles and practices.
# Interested in [http://en.wikiversity.org/wiki/Disruptive_technology disruptive technologies], [http://en.wikiversity.org/wiki/Open_educational_resources open educational resources], and [http://en.wikipedia.org/w/index.php?title=Usability usability].
# Generally, I'm most active over at Wikiversity: [http://en.wikiversity.org/wiki/User:Jtneill my Wikiversity user page]. Also see [http://twitter.com/jtneill twitter] and [http://www.linkedin.com/in/jtneill linkedin].

User:James Neill/Moodleposium

2010-10-08T11:41:45Z

Jtneill:

[[../|I]] attended [[Moodleposium/2009|Moodleposium 2009]] and attended and presented at [[Moodleposium/2010|Moodleposium 2010]] on [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity].

Here's my notes about the Moodleposium sessions on MoodleDocs:
* [[/2009/]]
* [[/2010/]]

[[Category:Moodleposium]]
[[Category:User:James Neill]]

User:James Neill/Moodleposium

2010-10-08T11:41:24Z

Jtneill: New page: ../I attended Moodleposium 2009 and attended and presented at Moodleposium 2010 on [http://en.wikiversity.org/wiki/User:Jtneill/Presentation...

[[../I]] attended [[Moodleposium/2009|Moodleposium 2009]] and attended and presented at [[Moodleposium/2010|Moodleposium 2010]] on [http://en.wikiversity.org/wiki/User:Jtneill/Presentations/Open_education_with_Moodle_and_Wikiversity Open education with Moodle and Wikiversity].

Here's my notes about the Moodleposium sessions on MoodleDocs:
* [[/2009/]]
* [[/2010/]]

[[Category:Moodleposium]]
[[Category:User:James Neill]]

User:James Neill/Moodleposium/2010

2010-10-08T04:10:32Z

Jtneill: /* Day 1 */

Main page: [[Moodleposium/2010]]

=Notes by James Neill=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I also typed wiki-notes and have organised them here:

==Day 1==

# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Alam

2010-10-08T04:09:59Z

Jtneill: New page: <big>'''Mashing up social media with Moodle'''</big> - Lubna Alam, UC Lubna described her approach to teaching Social Informatics which discusses Gov 2.0 and teaches social media skills. ...

<big>'''Mashing up social media with Moodle'''</big> - Lubna Alam, UC

Lubna described her approach to teaching Social Informatics which discusses Gov 2.0 and teaches social media skills.

Slides: http://www.slideshare.net/lalam/moodleposium-2010-v1

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010

2010-10-08T04:08:02Z

Jtneill:

Main page: [[Moodleposium/2010]]

=Notes by James Neill=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I also typed wiki-notes and have organised them here:

==Day 1==
# [[User:James Neill/Moodleposium/2010/Chubb]]
# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]
# [[User:James Neill/Moodleposium/2010/Alam]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Dreschler

2010-10-08T03:47:49Z

Jtneill:

<big>'''The Moodle 2.0 workshop activity — Peer reviewing in action'''</big> - Mark Dreschler
# [[Workshop]] module - allows assignments to be submitted - then graded by peers - with students receiving marks for their submission and for their assessment, which is then pushed to gradebook
# Also use Comments block

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Dreschler

2010-10-08T03:44:34Z

Jtneill:

User:James Neill/Moodleposium/2010/Dreschler

2010-10-08T03:26:04Z

Jtneill:

Peer-assessment - [[Workshop]]
# Workshop module - allows assignments to be submitted - then graded by peers - with students receiving marks for their submission and for their assessment, which is then pushed to gradebook
# Also use Comments block

[[Category:User:James Neill/Moodleposium/2010/Dreschler]]

User:James Neill/Moodleposium/2010/Dreschler

2010-10-08T03:25:20Z

Jtneill: New page: Peer-assessment - Workshop # Workshop module - allows assignments to be submitted - then graded by peers - with students receiving marks for their submission and for their assessment, ...

Peer-assessment - [[Workshop]]
# Workshop module - allows assignments to be submitted - then graded by peers - with students receiving marks for their submission and for their assessment, which is then pushed to gradebook

[[Category:User:James Neill/Moodleposium/2010/Dreschler]]

User:James Neill/Moodleposium/2010

2010-10-08T02:54:03Z

Jtneill: # User:James Neill/Moodleposium/2010/Dreschler

Main page: [[Moodleposium/2010]]

=Notes by James Neill=
I had wireless connectivity during [[Moodleposium/2010]], so I micro-blogged on Twitter (http://twitter.com/jtneill) with the #mpos10 tag. I also typed wiki-notes and have organised them here:

==Day 1==
# [[User:James Neill/Moodleposium/2010/Chubb]]
# [[User:James Neill/Moodleposium/2010/Dearn]]
# [[User:James Neill/Moodleposium/2010/Evans]]
# [[User:James Neill/Moodleposium/2010/Tuckfield]]
# [[User:James Neill/Moodleposium/2010/Dougiamas]]
# [[User:James Neill/Moodleposium/2010/Schuhmacher]]
# [[User:James Neill/Moodleposium/2010/Dreschler]]

==Day 2==
# [[User:James Neill/Moodleposium/2010/Ridden]]

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:22:34Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples to make more dynamic, powerful, searchable/queryable, constructivist Moodle sites.

# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossary
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
## Can be used for assignment submission (so that other students can see it)
# [[Podcasting]]
## Can use [[forums]] (they are podcast enabled)
## POD = personal on demand
## Create forum - just RSS feed with audio
# [[Mashing]]
## Bloom taxonomy Web 2.0 version diagram (organisation of tools)
## Photos ([http://flickr.com Flickr], iStockPhoto), iTunes, YouTube, Delicious, Twitter, Prezi, Slideshare etc.
## RSS feed import e.g. Delicious, Twitter

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:21:54Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples to make more dynamic, powerful, searchable/queryable, constructivist Moodle sites.

# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossay
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
# [[Podcasting]]
## Can use [[forums]] (they are podcast enabled)
## POD = personal on demand
## Create forum - just RSS feed with audio
# [[Mashing]]
## Bloom taxonomy Web 2.0 version diagram (organisation of tools)
## Photos ([http://flickr.com Flickr], iStockPhoto), iTunes, YouTube, Delicious, Twitter, Prezi, Slideshare etc.
## RSS feed import e.g. Delicious, Twitter

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:19:38Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples to more dynamic, powerful, searchable/queryable, constructivist Moodle sites.

# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossay
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
# [[Podcasting]]
## Can use [[forums]] (they are podcast enabled)
## POD = personal on demand
## Create forum - just RSS feed with audio
# [[Mashing]]
## Bloom taxonomy Web 2.0 version diagram (organisation of tools)
## Photos ([http://flickr.com Flickr], iStockPhoto), iTunes, YouTube, Delicious, Twitter, Prezi, Slideshare etc.
## RSS feed import e.g. Delicious, Twitter

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:16:00Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples
# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossay
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
# [[Podcasting]]
## Can use [[forums]] (they are podcast enabled)
## POD = personal on demand
## Create forum - just RSS feed with audio
# [[Mashing]]
## Bloom taxonomy Web 2.0 version diagram (organisation of tools)
## Photos ([http://flickr.com Flickr], iStockPhoto), iTunes, YouTube, Delicious, Twitter, Prezi, Slideshare etc.
## RSS feed import e.g. Delicious, Twitter

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:11:44Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples
# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossay
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
# [[Podcasting]]
## Can use [[forums]] (they are podcast enabled)
## POD = personal on demand
## Create forum - just RSS feed with audio
# [[Mashing]]
## Bloom taxonomy Web 2.0 version diagram (organisation of tools)
## Photos ([http://flickr.com Flickr], iStockPhoto), iTunes, YouTube, Delicious, Twitter, Prezi etc.

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:06:45Z

Jtneill:

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:05:06Z

Jtneill:

<big>'''Keynote: Bag it and Tag it'''</big> - Julian Ridden ‘The Moodle-man’, moodle.org

Julian's presented lots of practical examples
# [[Database]] tool e.g.,
## Study notes database: For students to contribute study notes (in order to access the next part of the course) - can then use search tool esp. advanced search
## Book review database
## Lost property database
## GIS database - location and links through to Google Maps
## Weblinks database
# [[Glossary]]
## Usually text-based, but can also include audio (e.g., pronunciation) or video (students can upload)
## Can be used for [[autolink]]s
## Can get RSS feed from glossay
## [http://twitter.com/#!/nguyenmt/status/26692766679 "UC uses glossary & random glossary block for announcements and system messages"]
## [http://twitter.com/#!/moodler/status/26693017085 The (older) glossary module is actually just a special case of the database module and totally redundant.]
# [[Podcasting]]
## Can use forums (they are podcast enabled)

[[Category:User:James Neill/Moodleposium/2010]]

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T23:01:48Z

Jtneill:

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T22:59:36Z

Jtneill:

User:James Neill/Moodleposium/2010/Ridden

2010-10-07T22:58:05Z

Jtneill: