MoodleDocs - User contributions [en]

Teacher documentation

2007-07-24T10:13:57Z

Allbhatias:

==Getting started==
If you are a new user and would like a list of all teacher documentation articles, please see [[:Category:Teacher]].

We are assuming that your site administrator has set up Moodle, you are a user with teacher privileges and the administrator has assigned you to a new, blank course. Don't forget, [http://demo.moodle.org/ demo.moodle.org] will let you play an hour at a time for free.

You will need to be [[Log in | logged into]] the course as a user who has been assigned [[Teacher|a role as a teacher]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections|course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]], including using [[HTML editor|HTML in Moodle]]. There are different ways to enroll [[Students]] and assign them to one or more [[Groups]] in a course.

The example below shows a new course set up with topic sections, edit is on. There are a few of Moodle's many [[:Category:Block|blocks]] on the right and left sides of the topics, such as "Latest News" or "[[Administration block|Administration]]". The teacher is all ready to add resources and activities or a few new blocks to their brand new course.
[[Image:Course edit on new 2.jpg|thumb|center|500px|Getting started image - a new course]]

==Editing course section==
[[Image:Turn_edit_on_Student_on_buttons.JPG]] 
To add or alter activities or resources a teacher will need to [[Turn editing on|turn editing on]] and off with a button on the course homepage. The student view/change roles option allows the teacher to get a general idea of what students will see. There is also an "editing on" link in the [[Administration block|administration block]]. The turn editing option toggles between on and off, and when on, shows a variety of editing icons next to all editable objects in the course. Here are some common editing icons, for more details about them [[Adding/editing_a_course#Editing_a_course|go to adding/editing a course]]. To ADD items you must use the appropriate drop-downs for them.

{| border="1" cellpadding="2" cellspacing="0"
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="140"|Effect
|-
|[[Image:Edit.gif]]|| Edit item ||[[Image:Open.gif]]* || Close/Hide item||[[Image:Delete.gif]]* || Delete/Remove ||[[Image:Move.gif]] ||Move (up/down)
|-
||[[Image:All.gif]] ||See all weeks/topics||[[Image:Closed.gif]]* || Open/Show Item ||[[Image:Right.gif]] || Indent/shift right ||[[Image:Movehere.gif]] || Move here
|-
||[[Image:One.gif]] || See one week/topic||[[Image:Help.gif]] ||Help || || ||[[Image:Marker.gif]] ||Make Current (highlight) week/topic
|}
 
*(Note that the open eye indicates that the resource is visible, while clicking it changes it to be invisible (to students), and vice versa with the closed eye. Note that the X deletes resources and activities (with a warning) whereas it only removes blocks (which can be added at any time later)

==Activity modules==

[[Image:Activity_dropdown.JPG|frame|right|Add an activity drop-down menu]]
There are a number of robust interactive learning [[:Category:Modules|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

Communication and collaboration may take place using [[Chats]] and [[Forums]] for conversational activities and [[Choices]] to gain group feedback. Adding [[Wikis]] to your courses is an excellent way to allow students to work together on a project.

Work can be submitted by students and marked by teachers using [[Assignments]] or [[Workshops]]. The [[Quizzes]] offer several options for automatic scoring. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

[[Lessons]] and [[SCORM]] activities deliver content and offer ways of individualizing your presentation based upon a student's choices. Key words can be added to [[Glossaries]] by yourself or, if you allow it, your students.

[[Surveys]] and [[Database module|Databases]] are also very powerful additions to any course.

If all of that isn't enough for you then you can also add [[:Category:Modules (non-standard)|non-standard modules]] that are not part of the official Moodle release!

==Resources==

[[Image:Resource_pulldown_menu.JPG|frame|left|Add a resource drop-down menu]]

Moodle supports a range of different [[Resources|resource types]] that allow you to include almost any kind of digital content into your courses. These can be added by using the [[Adding_resources_and_activities | add a resource]] dropdown box when editing is turned on.

A [[Text page]] is a simple page written using plain text. Text pages aren't pretty, but they're a good place to put some information or instructions. If you are after more options for your new page then you should be thinking about adding a [[Web page]] and making use of Moodle's WYSIWYG editor.

Of course the resource may already exist in electronic form so you may want to [[File or website link|link to an uploaded file or external website]] or simply display the complete contents of a [[Directory|directory]] in your course files and let your users pick the file themselves. If you have an [[IMS content package]] then this can be easily added to your course.

Use a [[Label|label]] to embed instructions or information in the course section.

==Blocks==
[[Image:Block_add_dropdown_list2.JPG |thumb|150px|right|Add Block drop-down menu]]
Each course homepage generally contains [[Blocks_%28teacher%29|blocks]] on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on. Examples of blocks can be seen in the Getting Starting image above. [[Latest News block|"Latest News"]], "[[Blogs]]", [[Upcoming Events block|"Upcoming Events"]], and [[Recent Activity block|"Recent Activity"]] are a few examples.

A wide range of [[Blocks_%28teacher%29#Block_types|over 16 different block types]] can provide additional information or functionality to the learner by the teacher. The standard blocks that come with Moodle are shown on the right. There are also many [[:Category:Block (non-standard)|non-standard blocks]] developed by Moodlers that an administrator can add to this list.

A teacher with editing rights will also have a course [[Administration_block|administration block]]. This block has sub menus for course: backup/restore, enrollments, format, reports, grades, activity logs, files and other useful tools.

==General advice==

* Subscribe yourself to all of the [[forum]]s in your course so that you can keep in touch with your class activity.
* Encourage all of the students to fill out their [[Edit profile|user profile]] (including photos) and read them all - this will help provide some context to their later writings and help you to respond in ways that are tailored to their own needs.
* Keep notes to yourself in the private "Teacher's Forum" (under Administration). This is especially useful when team teaching.
* Use the [[Logs]] link (under Administration) to get access to complete, raw logs. In there you'll see a link to a popup window that updates every sixty seconds and shows the last hour of activity. This is useful to keep open on your desktop all day so you can feel in touch with what's going on in the course.
* Use many reports. [[Reports]] in the Administration block, [[Recent_activity|Activity Reports]] (next to each name in the list of all people, or from any user profile page). These provide a great way to see what any particular person has been up to in the course.
* Respond quickly to students. Don't leave it for later - do it right away. Not only is it easy to become overwhelmed with the volume that can be generated, but it's a crucial part of building and maintaining a community feel in your course.
*Don't be afraid to experiment: feel free to poke around and change things. It's hard to break anything in a Moodle course, and even if you do it's usually easy to fix it.
* Use the [[Navigation bar|navigation bar]] at the top of each page - this should help remind you where you are and prevent getting lost

== See also ==
*[[Blogs]] - blogs in Moodle
*[[Teaching with Moodle]] - inspiring links
*[[http://moodle.org/mod/forum/discuss.php?d=66854 Moodle and elearning intro]] - Written by Martin Langhoff
*[[Teaching do's and don'ts]] - hints
*[[Moodle manuals]] - a list of links to manuals and books
*[[Using Moodle book]] - a real book you can reprint!
*[[Teaching FAQ]] - common questions
*[http://moodle.tokem.fi/mod/book/view.php?id=5116&chapterid=256 Example of a course teaching checklist],
*One example of a site specific [[http://moodle.tokem.fi/mod/book/view.php?id=5116 Teacher's Moodle Manual]], done in Moodle with the book module
*[[Tips and tricks]]
*[[Student FAQ]] - students have questions about technology?

[[Category:Teacher]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[nl:Documentatie voor leraren]]
[[fi:Opettajan opas]]
[[ru:Учителям]]
[[zh:教师文档]]
[[ja:教師ドキュメント]]

Teacher documentation

2007-07-24T10:13:14Z

Allbhatias:

==Getting started==
If you are a new user and would like a DeveLopers list of all teacher documentation articles, please see [[:Category:Teacher]].

We are assuming that your site administrator has set up Moodle, you are a user with teacher privileges and the administrator has assigned you to a new, blank course. Don't forget, [http://demo.moodle.org/ demo.moodle.org] will let you play an hour at a time for free.

You will need to be [[Log in | logged into]] the course as a user who has been assigned [[Teacher|a role as a teacher]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections|course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]], including using [[HTML editor|HTML in Moodle]]. There are different ways to enroll [[Students]] and assign them to one or more [[Groups]] in a course.

The example below shows a new course set up with topic sections, edit is on. There are a few of Moodle's many [[:Category:Block|blocks]] on the right and left sides of the topics, such as "Latest News" or "[[Administration block|Administration]]". The teacher is all ready to add resources and activities or a few new blocks to their brand new course.
[[Image:Course edit on new 2.jpg|thumb|center|500px|Getting started image - a new course]]

==Editing course section==
[[Image:Turn_edit_on_Student_on_buttons.JPG]] 
To add or alter activities or resources a teacher will need to [[Turn editing on|turn editing on]] and off with a button on the course homepage. The student view/change roles option allows the teacher to get a general idea of what students will see. There is also an "editing on" link in the [[Administration block|administration block]]. The turn editing option toggles between on and off, and when on, shows a variety of editing icons next to all editable objects in the course. Here are some common editing icons, for more details about them [[Adding/editing_a_course#Editing_a_course|go to adding/editing a course]]. To ADD items you must use the appropriate drop-downs for them.

{| border="1" cellpadding="2" cellspacing="0"
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="140"|Effect
|-
|[[Image:Edit.gif]]|| Edit item ||[[Image:Open.gif]]* || Close/Hide item||[[Image:Delete.gif]]* || Delete/Remove ||[[Image:Move.gif]] ||Move (up/down)
|-
||[[Image:All.gif]] ||See all weeks/topics||[[Image:Closed.gif]]* || Open/Show Item ||[[Image:Right.gif]] || Indent/shift right ||[[Image:Movehere.gif]] || Move here
|-
||[[Image:One.gif]] || See one week/topic||[[Image:Help.gif]] ||Help || || ||[[Image:Marker.gif]] ||Make Current (highlight) week/topic
|}
 
*(Note that the open eye indicates that the resource is visible, while clicking it changes it to be invisible (to students), and vice versa with the closed eye. Note that the X deletes resources and activities (with a warning) whereas it only removes blocks (which can be added at any time later)

==Activity modules==

[[Image:Activity_dropdown.JPG|frame|right|Add an activity drop-down menu]]
There are a number of robust interactive learning [[:Category:Modules|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

Communication and collaboration may take place using [[Chats]] and [[Forums]] for conversational activities and [[Choices]] to gain group feedback. Adding [[Wikis]] to your courses is an excellent way to allow students to work together on a project.

Work can be submitted by students and marked by teachers using [[Assignments]] or [[Workshops]]. The [[Quizzes]] offer several options for automatic scoring. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

[[Lessons]] and [[SCORM]] activities deliver content and offer ways of individualizing your presentation based upon a student's choices. Key words can be added to [[Glossaries]] by yourself or, if you allow it, your students.

[[Surveys]] and [[Database module|Databases]] are also very powerful additions to any course.

If all of that isn't enough for you then you can also add [[:Category:Modules (non-standard)|non-standard modules]] that are not part of the official Moodle release!

==Resources==

[[Image:Resource_pulldown_menu.JPG|frame|left|Add a resource drop-down menu]]

Moodle supports a range of different [[Resources|resource types]] that allow you to include almost any kind of digital content into your courses. These can be added by using the [[Adding_resources_and_activities | add a resource]] dropdown box when editing is turned on.

A [[Text page]] is a simple page written using plain text. Text pages aren't pretty, but they're a good place to put some information or instructions. If you are after more options for your new page then you should be thinking about adding a [[Web page]] and making use of Moodle's WYSIWYG editor.

Of course the resource may already exist in electronic form so you may want to [[File or website link|link to an uploaded file or external website]] or simply display the complete contents of a [[Directory|directory]] in your course files and let your users pick the file themselves. If you have an [[IMS content package]] then this can be easily added to your course.

Use a [[Label|label]] to embed instructions or information in the course section.

==Blocks==
[[Image:Block_add_dropdown_list2.JPG |thumb|150px|right|Add Block drop-down menu]]
Each course homepage generally contains [[Blocks_%28teacher%29|blocks]] on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on. Examples of blocks can be seen in the Getting Starting image above. [[Latest News block|"Latest News"]], "[[Blogs]]", [[Upcoming Events block|"Upcoming Events"]], and [[Recent Activity block|"Recent Activity"]] are a few examples.

A wide range of [[Blocks_%28teacher%29#Block_types|over 16 different block types]] can provide additional information or functionality to the learner by the teacher. The standard blocks that come with Moodle are shown on the right. There are also many [[:Category:Block (non-standard)|non-standard blocks]] developed by Moodlers that an administrator can add to this list.

A teacher with editing rights will also have a course [[Administration_block|administration block]]. This block has sub menus for course: backup/restore, enrollments, format, reports, grades, activity logs, files and other useful tools.

==General advice==

* Subscribe yourself to all of the [[forum]]s in your course so that you can keep in touch with your class activity.
* Encourage all of the students to fill out their [[Edit profile|user profile]] (including photos) and read them all - this will help provide some context to their later writings and help you to respond in ways that are tailored to their own needs.
* Keep notes to yourself in the private "Teacher's Forum" (under Administration). This is especially useful when team teaching.
* Use the [[Logs]] link (under Administration) to get access to complete, raw logs. In there you'll see a link to a popup window that updates every sixty seconds and shows the last hour of activity. This is useful to keep open on your desktop all day so you can feel in touch with what's going on in the course.
* Use many reports. [[Reports]] in the Administration block, [[Recent_activity|Activity Reports]] (next to each name in the list of all people, or from any user profile page). These provide a great way to see what any particular person has been up to in the course.
* Respond quickly to students. Don't leave it for later - do it right away. Not only is it easy to become overwhelmed with the volume that can be generated, but it's a crucial part of building and maintaining a community feel in your course.
*Don't be afraid to experiment: feel free to poke around and change things. It's hard to break anything in a Moodle course, and even if you do it's usually easy to fix it.
* Use the [[Navigation bar|navigation bar]] at the top of each page - this should help remind you where you are and prevent getting lost

== See also ==
*[[Blogs]] - blogs in Moodle
*[[Teaching with Moodle]] - inspiring links
*[[http://moodle.org/mod/forum/discuss.php?d=66854 Moodle and elearning intro]] - Written by Martin Langhoff
*[[Teaching do's and don'ts]] - hints
*[[Moodle manuals]] - a list of links to manuals and books
*[[Using Moodle book]] - a real book you can reprint!
*[[Teaching FAQ]] - common questions
*[http://moodle.tokem.fi/mod/book/view.php?id=5116&chapterid=256 Example of a course teaching checklist],
*One example of a site specific [[http://moodle.tokem.fi/mod/book/view.php?id=5116 Teacher's Moodle Manual]], done in Moodle with the book module
*[[Tips and tricks]]
*[[Student FAQ]] - students have questions about technology?

[[Category:Teacher]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[nl:Documentatie voor leraren]]
[[fi:Opettajan opas]]
[[ru:Учителям]]
[[zh:教师文档]]
[[ja:教師ドキュメント]]

User:Dr S Bhatia

2006-11-26T03:38:06Z

Allbhatias:

[About Dr Bhatia][http://www.as16.com/moodle/user/view.php?id=2&course=1]

[Read what he writes][http://tsmindbend.blogspot.com/]

[Even more interesting][http://drbhatia.blogspot.com/]

User:Dr S Bhatia

2006-11-26T03:37:16Z

Allbhatias:

[About Dr Bhatia][http://www.as16.com/moodle/user/view.php?id=2&course=1
]

[Read what he writes][http://tsmindbend.blogspot.com/
]

[Even more interesting][http://drbhatia.blogspot.com/]

Adding/editing a lesson

2006-11-26T03:31:44Z

Allbhatias: /* Display default feedback */

{{Lessons}}
This page is about lesson settings that can be changed by the teacher when they view the lesson in edit mode. There are excellent help files once Lesson settings window has been open. In creating a new lesson, Moodle will first show the lesson settings page. At any point in the design or compliation of the lesson, it is possible (almost desirable in some cases) to edit the lesson settings.

After reviewing the lesson settings and saving them, you(the teacher) will jump back to the page list with its insert, edit, move or delete potentials.

There is some difference between Moodle 1.5 and 1.6 with additional settings. Please note that the settings group catagory is shown.

== General ==

===Name===

First of all, you decide about the '''name''' of your lesson.

===Timed===

This puts a time limit on the lesson. Students are shown a JavaScript counter and the time is recorded in the database. Due to the inconsistent nature of JavaScript, the timer does not evict a student from the lesson when the time is up, however a question answered after the time limit is not counted. The time in the database is checked each time a student submits a question.

===The Maximum Number of Answers / Branches in a Lesson===

This value determines the maximum number of answers the teacher can see and use when editing a lesson or a page. The default value is 4. This is a useful feature in older versions of Moodle that have no collapsed view. This value can reduce the number of screens a teacher might see in the lesson edit mode.

This parameter also sets the maximum number of Branches that can be seen by the teacher in a Branch Table.

It is safe to change the value of this parameter at any time. It only effects what the teacher sees, not the data. For example, a teacher starting to enter a series of multiple choice questions with 6 answers, might set this value to 6. Then when the teacher starts to enter a series of questions with 2 answers, they might set this value to 2 because they don't need to see 4 blank answers for every question in the design phase.

In a similar manner, changing the value does not effect what the student sees when they view a branch page, nor does it change previous information put in by the teacher.

== Grade Options ==

===Practice Lesson===

A practice lesson will not show up in the Gradebook.

===Custom Scoring===

This will allow you to put a numerical point value on each answer. Answers may have negative values or positive values. Imported questions will automatically be assigned 1 point for correct answers and 0 for incorrect, though you may change this after the import.

===Maximum Grade===

This value determines the maximum grade which can be awarded in the lesson. The range is 0 to 100%. This value can be changed at any time during the lesson. Any change has an immediate effect in the Grades page and on the grades shown to the students in various lists. If the grade is set to 0 the Lesson does not appear in any of the Grades pages.

===User can re-take===

This setting determines whether the students can take the lesson more than once or only once. The teacher may decide that the lesson contains material which the students ought to know thoroughly. In which case repeated viewing of the lesson should be allowed. If, however, the material is used more like an exam then the students should not be allowed to re-take the lesson.

When the students are allowed to re-take the lesson, the grades shown in the Grades page are either their average grade over the re-takes or their best grade for the lesson. The next parameter determines which of these two grading alternatives is used.

Note that the Question Analysis always uses the answers from the first tries of the lesson, subsequent re-takes by students are ignored.

By default this option is Yes, meaning that students are allowed to re-take the lesson. It is expected that only in exceptional circumstances will this option be set to No.

===Handling of Re-takes===

When students are allowed to re-take the lesson, this option allows the teacher to show the grade for the lesson in, for example, the Grades page, as either the mean, this is average, of the grades over the first and subsequent tries or as the grade from the students' best tries.

This option can be changed at any time.

===Display ongoing score===

under construction

== Flow Control ==

===Allow Student Review===

This will let the student navigate back through the lesson to change their answers.

===Display Review Button===

This will display a button after an incorrectly answered question, allowing a student to re-attempt it. It is not compatible with essay questions, so leave this off if you are using essay questions.

===The Maximum Number of Attempts (by a Student)===

This value determines the maximum number of attempts a Student has in answering any of the questions in the lesson. Once reached, the student does not see the question again.

The default value is 5. Smaller values may discourage the student from trying different answers about a question. Larger values may lead to frustration when the student "does not get it". For example with a short answer or numerical question, the student is not given an opportunity to try different answer choices. This value provides an escape route to the next page in the lesson.

Setting this value to 1 gives the students just single chance to answer each question. This would be similar to a question in the Quiz module.

Note: this value is student global parameter and that it applies to all the questions in the lesson regardless of their type. However it does not apply to teachers checking of questions or navigating through the lesson. Checking the number of attempts relies on values stored in the database and question attempts by teachers are not recorded. The teacher should after all know the answers!

===Action after a Correct Answer===

The usual action is to follow the jump as specified in the answer. In most cases this will probably show the Next Page of the lesson. The student is taken through the lesson in a logical way, beginning at the start and ending at the end.

However, the lesson module can also be used as a type of Flash Card assignment. The student is shown some information (optional) and a question in basically a random order. There is no set beginning and no set end. Just a set of Cards shown one after another in no particular order.

This option allows two very similar variants of Flash Card behaviour. The option "Show an unseen page" never shows the same page twice (even if the student did not answer the question associated with the Card/Page correctly). The other non-default option "Show an unanswered page" allows the student to see pages that may have appeared before but only if they answered the associated question wrongly.

In either of these Flash Card-type lessons the teacher can decide to use either all the Cards/Pages in the lesson or just a (random) sub-set. This is done through the "Number of Pages (Cards) to show" parameter.

'''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 feeback, so you'll have to put a # after the answer which may be ~3 and write & n b s p ; after that.(without spaces between these characters) To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

===Display default feedback ===
{{Moodle 1.7}}
When this Version 1.7 option is set to No, the lesson page will not show the student any automatic feed back, when the teacher has not entered a responce. If this is set to the default of Yes, the next page will tell the student if they answered the question correctly or not, and give the teachers response if any, along with the question and the student's answer.

===The Minimum Number of Questions in a Lesson===
This value determines the '''minimum''' number of questions that will be used to calculate a student's score. It does not force students to answer that many questions in the lesson. When a lesson contains one or more [[Adding a branch table| branches]], the teacher should normally set this parameter.

For example, setting this parameter to 20, will ensure that grades are given as though the students have seen at least this number of questions. Take the case of a student who only looks at a single branch in a lesson with 5 pages and answers all the associated questions correctly. This student then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter was set to 0 their grade would be 5 out of 5, that is 100%. However, with it set to 20 their grade would be reduced to 5 out of 20, that is 25%. In the case of another student who goes through all the branches and sees, say, 25 pages and answers all but two of the questions correctly, then their grade would be 23 out of 25, that is 92%.

If this parameter is used, the teacher might want to add a statement on the opening page of the lesson. For example, if the teacher set the value to 20 they might say:

:In this lesson you are expected to attempt at least ''20'' questions. You can attempt more if you wish. However, if you attempt less than ''20'' questions your grade will be calculated as though you attempted ''20''.

When this parameter is set to a value more than 0, students are told how many questions they have attempted and how many they are expected to attempt.

===Number of Pages (Cards) to Show===

This parameter is only used in Flash Card type lessons. The default value is zero which means that all the Pages/Cards are shown in a lesson. Setting this parameter to a non-zero value shows that number of pages. After that number of Page/Cards have been shown the end of lesson is reached and the student is shown their grade.

If this parameter is set to a number greater than the number of pages in the lesson then the end of the lesson is reached when all the pages have been shown.

== Lesson formatting ==

===Slide Show===

This enables the display of the lesson as a slide show, with a fixed width, height, and custom background color. A CSS based scroll bar will be displayed if the width or height of the slide is exceeded by the content of a page. Questions will 'break out' of the slide show mode, only pages (branch tables) will be shown in a slide by default. Buttons labeled with the lang default for "Next" and "Back" will be shown at the far right and left of the slide if that option is chosen on the page. Other buttons will be centered below the slide. You can also decide on the width, height and the background colour of the slide show.

===Display Left Menu===

This will show a list of the pages (Branch Tables) in the lesson. Question pages, cluster pages, etc. will not be shown by default (you may choose to show question pages by checking that option on the question).

== Access control ==

===Password Protected Lesson===

This will not allow a student to access the lesson unless they type the password.

=== Dependent on ===
{{Moodle 1.6}}
In Version 1.6 a lesson can be dependent upon another lesson. There are 3 possible dependencies which can be use seperately or in combination with each other. Time Spent (minutes) refers to how long the student was in the lesson on their last attempt (it is not cumulative). Completion means the student has attempted one question. Grade as a percentage of a specific lesson means just that.

===Available from & deadline dates===

Here you can decide on the dates for the opening and deadline of the lesson.

== Other ==
===Link to activity===
Upon completion of the lesson, use the pull down menu to offer a choice for the student to go to another activity.

===Pop-up to file or web page===
At the start of the lesson, this creates a popup window. For example this might be a music file or an agreement.

===Tree View===
Found in pre 1.6 versions of Moodle. Similar to the setting under Lesson Formating, display left menu in Moodle 1.6 and later.

===Display High Scores===

A list of the high scores for the lesson will be shown. Students who get a high score can choose a custom name to list their score by. There is a 'badwords' filter which checks for naughty names.

High scores do not display if the "Practice lesson" option is turned On.

===Number of High Scores Displayed===

Type a number to limit how many of the top scores are displayed.

===Use this lesson's settings as defaults===

Select yes before Saving the lesson, and the settings you have chosen for this lesson will be the default settings for the next time you create a lesson for this course.

===Visible to users===

Allows you to show to, or to hide the lesson from students.

----

==Adding the first page in a Lesson==

After you decide on the lesson settings (above), you are taken to the lesson and you are asked which of the following you want to do now: import questions, add a Branch Table or add a Question Page. To read more about adding pages go to: [[Viewing_a_lesson]]. If you would like more information about lesson pages in general go to [[Lesson Pages]] or select something from the index at the top of this page or one of the overall indexes below.

==See also==
[[Lesson module]] for an overview of a lesson.

[[Category:Teacher]]
[[Category:Lesson]]

Lesson Pages

2006-11-23T14:38:46Z

Allbhatias: /* Jumps in Questions */

{{Lessons}}
== Overview Lesson Pages ==

{{Moodle 1.6}}

The intent of this page is to give a slightly different context for teachers concerning lesson pages. There will be links in each section to other MoodleDoc pages that go into more details. This was written for Moodle 1.6 but it should be helpful for earlier versions.

There are two basic types of Lesson pages: Choice and Navigation. Most pages offer the student choices, "question pages" (related to [[Quizzes]]) are the most common. Moodle calls another type of choice page "branch tables". Navigation pages create additional robust features that impact a student's choices. "End of Branch", "Start Cluster" and "End Cluster" are the Navigational pages can use special relative jumps selected by the teacher but they have no content seen by the student.

In this section will cover the generic format for these types. We will focus upon the Choice pages format as seen by the teacher. A question page has all the elements of a Branch Table, plus the question pages has a few more features.

The number of choices editable by the teacher can be set under lesson settings, general, Maximum number of answers/branches. The default is 4 but it can be increased or decreased depending upon the current editing needs of the teacher.

== Branch (Branch Table)- Choice Pages ==

Branch (we will simply call it Branch) pages have content and buttons at the bottom that students can select. Branch pages can serve as neutral content pages that don't count as a question page in grade or lesson completion calculations.

The basic parts of a Branch page are: Page Title, Page Content, Description(#) and Jump(#). In the edit mode there is an edit toolbar filled with icons directly below the Page Title. At the bottom of the edit mode screen are buttons to redisply, save or cancel. Small yellow buttons with question marks are help links.

[[Image:Lesson_branch_edit_expanded1.GIF]]
==== Page Title ====
In general, the Page Title is used to located the page. For example, it can be used in jumps or seen in edit modes by the teacher. The title can also be seen by the student in any choice page.

==== Page Content ====
Page Content is where material is going to be presented to the student. Editing Page content will offer a more complete description for those not familiar with basic formating icons. Perhaps the simpliest form of content is text. Moodle also allows insertion of pictures of various types, links to documents or webpages. Not to mention blank tables, emoticons, and special text characters. And for the brave and HTML savy, there is a toggle that switches between HTML code and WYSIWYG (what you see it what you get) which allows the teacher to use tags to embed audio or quicktime video.

In other pages you will read that Branch pages serve as an initial Table of Contents. You will read more about that in Descriptions and Jumps below.

==== Descriptions ====
Descriptions are the choices the student must make. In a branch page these show up as buttons below the page. They can be arranged vertically or horizontally in any branch page.

Leaving description 1 blank, will automatically give the student one choice: "continue" with the flow set to next page. This is a Moodle default setting.

==== Jumps in General====
Jumps determine what happens after a student makes a choice.

Jumps can be divided into two types - Relative Jumps and Absolute Jumps. The default navigation using the relative jumps is Next Page and Same Page. The destination of the Next Page jump is the next page in the logical order of the lesson. Absolute jumps specify the actual page to show next by specifying of the page's Title.

There is a pull down menu which lists the relative jumps like "next page", "this page" "previous page" and some special navigation pages we will discuss later. There will probably be many absolute page jumps listed in a nearly completed lesson. The teacher selects the page listed in the pull down menu that the student will jump to after their choice, and after seeing the responce. See [[Jumps]] for more details.

== Questions - Choice Pages ==
Question pages have content and something for the student to answer or select. There can be a specific text responce for each specific answer. Question pages can be scored/graded [https://docs.moodle.org/en/Lesson#Grading (see lesson grading)] in several ways. These last two features make them different from Branch pages.

There are many question types to select. [[Lesson#Types_of_questions_available_within_a_lesson ]] goes into each type in more detail. The help button next to Question type gives a good description of each. In Version 1.6, the question types are on tabs. Be sure to select the question type before starting your question or you could lose your work when you try to change it later. TIP: Often you can start a question, save it, then change it's type without losing your content section. 
[[Image:Question_multiplechoice_expanded_med.gif| question in expanded lesson view ]]

==== Title & Content ====
The title and content sections are the same as for a branch page. Again, the page title can be important, don't give away the answer!

In some learning situtations, the teacher will put lesson material in the content. At the bottom of the content section, they put the question the student must answer. In other lessons, the question will be the content.

==== Answer ====
Answers are the choices the student must make. In a question, these can take different forms and show up below the content section page. Each of the question types has its own type of answer. The help button next to Answer offers a good description of each type. The most common is mutiple choice. We will use this type in our examples.

The order of the answers will appear to be random to the students. In other words, two students looking at the same question, will see the answers in a different order.

There is also the ability to use all the content editing tools in each of the responces. For example, one answer could be a picture, another text. Normally it is turned off, but checking the box and pressing the redisplay button at the bottom of the page in edit mode, will turn it on.

The default for a question with all blank answers is "continue". When form permits, a good practice is to always enter the correct answer(s) first. Moodle does not like skipped answers.

==== Jumps in Questions ====
Jumps determine what happens after a student makes a choice. See [https://docs.moodle.org/en/Jumps Jumps] for more details. Their use is the same as a Branch page jump. Make sure you check lesson settings and flow control to see what will happen if you don't put in an answer or jump for a correct answer.

Usually the presentation mode default for a question with all blank answers is "Next Page". The default for Correct answer is "Next Page. For a wrong answer the default is "This Page." See [https://docs.moodle.org/en/Lesson_module#The_Flash_card_lesson Lesson Flash Card] for lesson setting that create a different random navigational order for the student.

'''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 feeback, so you'll have to put a # after the answer which may be ~3 and write & n b s p ; after that.(without spaces between these characters) To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

==== Score ====
The score is used with "custom scoring". It serves as the basis for grading each specific answer. It can be a positive or negative number. The default is 1 for a correct answer and 0 for a wrong answer. It is possible to use other scoring methods which ignore this value. See - link- for a better description of grading and scoring a lesson.

==== Other ====
There are several buttons at the bottom. Save and Cancel should explain themselves. Redisplay is used after the "use HTML Editor" box is checked on the answer.

= Navigation Pages =
There are 3 navigational pages which can be added by the teacher. These provide special special effects and are discussed elsewhere in MoodleDocs. They are not seen by the students and are only used by the teacher.

==Cluster Pages - Start and End ==
Clusters are used by relative jumps for special effects. "A cluster" is defined by the pages that appear between the Start Cluster page and End Cluster page in the logical order. Typically, the pages in "a cluster" are question pages. The page content for a Start and End Cluster are not visible to the student. Using an End Cluster page by itself can act as a hidden redirect page from the students perspective.

See also [https://docs.moodle.org/en/Clusters Clusters]

==End of Branch Page ==
An end of branch page actually defines a series of pages that are within "a branch". The series is located/defined in the logical order. The branch table page that immediately preceeds the end of branch page, is the first page in "a branch". The end of branch is the last page in the series. For example there might be a branch table page, followed by several question pages and then an end of branch page. Defined branches are used by relative jumps mentioned above.

End of Branch pages are not visible to students and if the teacher wants to have a concluding message at the end of a branch, then it is necessary to add a question page (with no answers) just before the End of Branch page. Essentially End of Branch pages are also redirection pages that are not visible to the student.

Branch Table pages do not require an End of Branch page. End of Branch pages are really only needed when special jumps are used in the lesson that refer to "a branch". See also [https://docs.moodle.org/en/Adding_a_branch_table adding branch pages]

==End of Lesson Page==
This is virtual page (not seen by either student or teacher) used by the relative jump called "End of Lesson". It follows the last physical logical page and ends the lesson. Often a teacher will add a branch table page in this position with this title.

= Tips & Suggestions =
Planning is important, in presenting a classroom lesson or in Moodle lesson.
We suggest to check your work from the students perspective available in Moodle. There are several ways to do this [[Viewing_a_lesson]]. For those new to Moodle, we strongly suggest to learn the way you teach. Start simple and build upon your successes.

= See Also =
*[[Jumps]] More details
*[[Lesson_module]]
*[http://moodle.org/mod/lesson/view.php?id=2321 Demo Lesson] - One demonstration of a Moodle Course, all about Moodle of course
*[http://download.moodle.org/docs/using_moodle/ch10_lessons.pdf Using Moodle Chapter 10: Lessons] - a PDF document which could be a little outdated but still useful
*[https://docs.moodle.org/en/Adding_a_question_page Adding a question page]
*[http://moodle.org/help.php?file=index.html Index of Help Files] - Very Useful, organized by grouping topics with similar uses. For example "Reading and Writing" contains text formatting.

[[Category:Teacher]]
[[Category:Lesson]]

Adding/editing a lesson

2006-11-23T14:38:06Z

Allbhatias: /* Action after a Correct Answer */

{{Lessons}}
This page is about lesson settings that can be changed by the teacher when they view the lesson in edit mode. There are excellent help files once Lesson settings window has been open. In creating a new lesson, Moodle will first show the lesson settings page. At any point in the design or compliation of the lesson, it is possible (almost desirable in some cases) to edit the lesson settings.

After reviewing the lesson settings and saving them, you(the teacher) will jump back to the page list with its insert, edit, move or delete potentials.

There is some difference between Moodle 1.5 and 1.6 with additional settings. Please note that the settings group catagory is shown.

== General ==

===Name===

First of all, you decide about the '''name''' of your lesson.

===Timed===

This puts a time limit on the lesson. Students are shown a JavaScript counter and the time is recorded in the database. Due to the inconsistent nature of JavaScript, the timer does not evict a student from the lesson when the time is up, however a question answered after the time limit is not counted. The time in the database is checked each time a student submits a question.

===The Maximum Number of Answers / Branches in a Lesson===

This value determines the maximum number of answers the teacher can see and use when editing a lesson or a page. The default value is 4. This is a useful feature in older versions of Moodle that have no collapsed view. This value can reduce the number of screens a teacher might see in the lesson edit mode.

This parameter also sets the maximum number of Branches that can be seen by the teacher in a Branch Table.

It is safe to change the value of this parameter at any time. It only effects what the teacher sees, not the data. For example, a teacher starting to enter a series of multiple choice questions with 6 answers, might set this value to 6. Then when the teacher starts to enter a series of questions with 2 answers, they might set this value to 2 because they don't need to see 4 blank answers for every question in the design phase.

In a similar manner, changing the value does not effect what the student sees when they view a branch page, nor does it change previous information put in by the teacher.

== Grade Options ==

===Practice Lesson===

A practice lesson will not show up in the Gradebook.

===Custom Scoring===

This will allow you to put a numerical point value on each answer. Answers may have negative values or positive values. Imported questions will automatically be assigned 1 point for correct answers and 0 for incorrect, though you may change this after the import.

===Maximum Grade===

This value determines the maximum grade which can be awarded in the lesson. The range is 0 to 100%. This value can be changed at any time during the lesson. Any change has an immediate effect in the Grades page and on the grades shown to the students in various lists. If the grade is set to 0 the Lesson does not appear in any of the Grades pages.

===User can re-take===

This setting determines whether the students can take the lesson more than once or only once. The teacher may decide that the lesson contains material which the students ought to know thoroughly. In which case repeated viewing of the lesson should be allowed. If, however, the material is used more like an exam then the students should not be allowed to re-take the lesson.

When the students are allowed to re-take the lesson, the grades shown in the Grades page are either their average grade over the re-takes or their best grade for the lesson. The next parameter determines which of these two grading alternatives is used.

Note that the Question Analysis always uses the answers from the first tries of the lesson, subsequent re-takes by students are ignored.

By default this option is Yes, meaning that students are allowed to re-take the lesson. It is expected that only in exceptional circumstances will this option be set to No.

===Handling of Re-takes===

When students are allowed to re-take the lesson, this option allows the teacher to show the grade for the lesson in, for example, the Grades page, as either the mean, this is average, of the grades over the first and subsequent tries or as the grade from the students' best tries.

This option can be changed at any time.

===Display ongoing score===

under construction

== Flow Control ==

===Allow Student Review===

This will let the student navigate back through the lesson to change their answers.

===Display Review Button===

This will display a button after an incorrectly answered question, allowing a student to re-attempt it. It is not compatible with essay questions, so leave this off if you are using essay questions.

===The Maximum Number of Attempts (by a Student)===

This value determines the maximum number of attempts a Student has in answering any of the questions in the lesson. Once reached, the student does not see the question again.

The default value is 5. Smaller values may discourage the student from trying different answers about a question. Larger values may lead to frustration when the student "does not get it". For example with a short answer or numerical question, the student is not given an opportunity to try different answer choices. This value provides an escape route to the next page in the lesson.

Setting this value to 1 gives the students just single chance to answer each question. This would be similar to a question in the Quiz module.

Note: this value is student global parameter and that it applies to all the questions in the lesson regardless of their type. However it does not apply to teachers checking of questions or navigating through the lesson. Checking the number of attempts relies on values stored in the database and question attempts by teachers are not recorded. The teacher should after all know the answers!

===Action after a Correct Answer===

The usual action is to follow the jump as specified in the answer. In most cases this will probably show the Next Page of the lesson. The student is taken through the lesson in a logical way, beginning at the start and ending at the end.

However, the lesson module can also be used as a type of Flash Card assignment. The student is shown some information (optional) and a question in basically a random order. There is no set beginning and no set end. Just a set of Cards shown one after another in no particular order.

This option allows two very similar variants of Flash Card behaviour. The option "Show an unseen page" never shows the same page twice (even if the student did not answer the question associated with the Card/Page correctly). The other non-default option "Show an unanswered page" allows the student to see pages that may have appeared before but only if they answered the associated question wrongly.

In either of these Flash Card-type lessons the teacher can decide to use either all the Cards/Pages in the lesson or just a (random) sub-set. This is done through the "Number of Pages (Cards) to show" parameter.

'''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 feeback, so you'll have to put a # after the answer which may be ~3 and write & n b s p ; after that.(without spaces between these characters) To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

===Display default feedback ===
{{Moodle 1.7}}
When this Version 1.7 option is set to No, the lesson page will not show the student any automatic feed back, when the teacher has not entered a responce. If this is set to the default of Yes, the next page will tell the student if they answered the question correctly or not, and give the teachers responce if any, along with the question and the student's answer.

===The Minimum Number of Questions in a Lesson===
This value determines the '''minimum''' number of questions that will be used to calculate a student's score. It does not force students to answer that many questions in the lesson. When a lesson contains one or more [[Adding a branch table| branches]], the teacher should normally set this parameter.

For example, setting this parameter to 20, will ensure that grades are given as though the students have seen at least this number of questions. Take the case of a student who only looks at a single branch in a lesson with 5 pages and answers all the associated questions correctly. This student then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter was set to 0 their grade would be 5 out of 5, that is 100%. However, with it set to 20 their grade would be reduced to 5 out of 20, that is 25%. In the case of another student who goes through all the branches and sees, say, 25 pages and answers all but two of the questions correctly, then their grade would be 23 out of 25, that is 92%.

If this parameter is used, the teacher might want to add a statement on the opening page of the lesson. For example, if the teacher set the value to 20 they might say:

:In this lesson you are expected to attempt at least ''20'' questions. You can attempt more if you wish. However, if you attempt less than ''20'' questions your grade will be calculated as though you attempted ''20''.

When this parameter is set to a value more than 0, students are told how many questions they have attempted and how many they are expected to attempt.

===Number of Pages (Cards) to Show===

This parameter is only used in Flash Card type lessons. The default value is zero which means that all the Pages/Cards are shown in a lesson. Setting this parameter to a non-zero value shows that number of pages. After that number of Page/Cards have been shown the end of lesson is reached and the student is shown their grade.

If this parameter is set to a number greater than the number of pages in the lesson then the end of the lesson is reached when all the pages have been shown.

== Lesson formatting ==

===Slide Show===

This enables the display of the lesson as a slide show, with a fixed width, height, and custom background color. A CSS based scroll bar will be displayed if the width or height of the slide is exceeded by the content of a page. Questions will 'break out' of the slide show mode, only pages (branch tables) will be shown in a slide by default. Buttons labeled with the lang default for "Next" and "Back" will be shown at the far right and left of the slide if that option is chosen on the page. Other buttons will be centered below the slide. You can also decide on the width, height and the background colour of the slide show.

===Display Left Menu===

This will show a list of the pages (Branch Tables) in the lesson. Question pages, cluster pages, etc. will not be shown by default (you may choose to show question pages by checking that option on the question).

== Access control ==

===Password Protected Lesson===

This will not allow a student to access the lesson unless they type the password.

=== Dependent on ===
{{Moodle 1.6}}
In Version 1.6 a lesson can be dependent upon another lesson. There are 3 possible dependencies which can be use seperately or in combination with each other. Time Spent (minutes) refers to how long the student was in the lesson on their last attempt (it is not cumulative). Completion means the student has attempted one question. Grade as a percentage of a specific lesson means just that.

===Available from & deadline dates===

Here you can decide on the dates for the opening and deadline of the lesson.

== Other ==

===Tree View===
Found in pre 1.6 versions of Moodle. Similar to Lesson Formating, display left menu in Moodle 1.6 and later.

===Display High Scores===

A list of the high scores for the lesson will be shown. Students who get a high score can choose a custom name to list their score by. There is a 'badwords' filter which checks for naughty names.

High scores do not display if the "Practice lesson" option is turned On.

===Number of High Scores Displayed===

Type a number to limit how many of the top scores are displayed.

===Use this lesson's settings as defaults===

Select yes before Saving the lesson, and the settings you have chosen for this lesson will be the default settings for the next time you create a lesson for this course.

===Visible to users===

Allows you to show to, or to hide the lesson from students.

----

==Adding the first page in a Lesson==

After you decide on the lesson settings (above), you are taken to the lesson and you are asked which of the following you want to do now: import questions, add a Branch Table or add a Question Page. To read more about adding pages go to: [[Viewing_a_lesson]]. If you would like more information about lesson pages in general go to [[Lesson Pages]] or select something from the index at the top of this page or one of the overall indexes below.

==See also==
[[Lesson module]] for an overview of a lesson.

[[Category:Teacher]]
[[Category:Lesson]]

Adding/editing a lesson

2006-11-23T14:37:35Z

Allbhatias: /* Action after a Correct Answer */

{{Lessons}}
This page is about lesson settings that can be changed by the teacher when they view the lesson in edit mode. There are excellent help files once Lesson settings window has been open. In creating a new lesson, Moodle will first show the lesson settings page. At any point in the design or compliation of the lesson, it is possible (almost desirable in some cases) to edit the lesson settings.

After reviewing the lesson settings and saving them, you(the teacher) will jump back to the page list with its insert, edit, move or delete potentials.

There is some difference between Moodle 1.5 and 1.6 with additional settings. Please note that the settings group catagory is shown.

== General ==

===Name===

First of all, you decide about the '''name''' of your lesson.

===Timed===

This puts a time limit on the lesson. Students are shown a JavaScript counter and the time is recorded in the database. Due to the inconsistent nature of JavaScript, the timer does not evict a student from the lesson when the time is up, however a question answered after the time limit is not counted. The time in the database is checked each time a student submits a question.

===The Maximum Number of Answers / Branches in a Lesson===

This value determines the maximum number of answers the teacher can see and use when editing a lesson or a page. The default value is 4. This is a useful feature in older versions of Moodle that have no collapsed view. This value can reduce the number of screens a teacher might see in the lesson edit mode.

This parameter also sets the maximum number of Branches that can be seen by the teacher in a Branch Table.

It is safe to change the value of this parameter at any time. It only effects what the teacher sees, not the data. For example, a teacher starting to enter a series of multiple choice questions with 6 answers, might set this value to 6. Then when the teacher starts to enter a series of questions with 2 answers, they might set this value to 2 because they don't need to see 4 blank answers for every question in the design phase.

In a similar manner, changing the value does not effect what the student sees when they view a branch page, nor does it change previous information put in by the teacher.

== Grade Options ==

===Practice Lesson===

A practice lesson will not show up in the Gradebook.

===Custom Scoring===

This will allow you to put a numerical point value on each answer. Answers may have negative values or positive values. Imported questions will automatically be assigned 1 point for correct answers and 0 for incorrect, though you may change this after the import.

===Maximum Grade===

This value determines the maximum grade which can be awarded in the lesson. The range is 0 to 100%. This value can be changed at any time during the lesson. Any change has an immediate effect in the Grades page and on the grades shown to the students in various lists. If the grade is set to 0 the Lesson does not appear in any of the Grades pages.

===User can re-take===

This setting determines whether the students can take the lesson more than once or only once. The teacher may decide that the lesson contains material which the students ought to know thoroughly. In which case repeated viewing of the lesson should be allowed. If, however, the material is used more like an exam then the students should not be allowed to re-take the lesson.

When the students are allowed to re-take the lesson, the grades shown in the Grades page are either their average grade over the re-takes or their best grade for the lesson. The next parameter determines which of these two grading alternatives is used.

Note that the Question Analysis always uses the answers from the first tries of the lesson, subsequent re-takes by students are ignored.

By default this option is Yes, meaning that students are allowed to re-take the lesson. It is expected that only in exceptional circumstances will this option be set to No.

===Handling of Re-takes===

When students are allowed to re-take the lesson, this option allows the teacher to show the grade for the lesson in, for example, the Grades page, as either the mean, this is average, of the grades over the first and subsequent tries or as the grade from the students' best tries.

This option can be changed at any time.

===Display ongoing score===

under construction

== Flow Control ==

===Allow Student Review===

This will let the student navigate back through the lesson to change their answers.

===Display Review Button===

This will display a button after an incorrectly answered question, allowing a student to re-attempt it. It is not compatible with essay questions, so leave this off if you are using essay questions.

===The Maximum Number of Attempts (by a Student)===

This value determines the maximum number of attempts a Student has in answering any of the questions in the lesson. Once reached, the student does not see the question again.

The default value is 5. Smaller values may discourage the student from trying different answers about a question. Larger values may lead to frustration when the student "does not get it". For example with a short answer or numerical question, the student is not given an opportunity to try different answer choices. This value provides an escape route to the next page in the lesson.

Setting this value to 1 gives the students just single chance to answer each question. This would be similar to a question in the Quiz module.

Note: this value is student global parameter and that it applies to all the questions in the lesson regardless of their type. However it does not apply to teachers checking of questions or navigating through the lesson. Checking the number of attempts relies on values stored in the database and question attempts by teachers are not recorded. The teacher should after all know the answers!

===Action after a Correct Answer===

The usual action is to follow the jump as specified in the answer. In most cases this will probably show the Next Page of the lesson. The student is taken through the lesson in a logical way, beginning at the start and ending at the end.

However, the lesson module can also be used as a type of Flash Card assignment. The student is shown some information (optional) and a question in basically a random order. There is no set beginning and no set end. Just a set of Cards shown one after another in no particular order.

This option allows two very similar variants of Flash Card behaviour. The option "Show an unseen page" never shows the same page twice (even if the student did not answer the question associated with the Card/Page correctly). The other non-default option "Show an unanswered page" allows the student to see pages that may have appeared before but only if they answered the associated question wrongly.

In either of these Flash Card-type lessons the teacher can decide to use either all the Cards/Pages in the lesson or just a (random) sub-set. This is done through the "Number of Pages (Cards) to show" parameter.

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 feeback, so you'll have to put a # after the answer which may be ~3 and write & n b s p ; after that.(without spaces between these characters) To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

===Display default feedback ===
{{Moodle 1.7}}
When this Version 1.7 option is set to No, the lesson page will not show the student any automatic feed back, when the teacher has not entered a responce. If this is set to the default of Yes, the next page will tell the student if they answered the question correctly or not, and give the teachers responce if any, along with the question and the student's answer.

===The Minimum Number of Questions in a Lesson===
This value determines the '''minimum''' number of questions that will be used to calculate a student's score. It does not force students to answer that many questions in the lesson. When a lesson contains one or more [[Adding a branch table| branches]], the teacher should normally set this parameter.

For example, setting this parameter to 20, will ensure that grades are given as though the students have seen at least this number of questions. Take the case of a student who only looks at a single branch in a lesson with 5 pages and answers all the associated questions correctly. This student then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter was set to 0 their grade would be 5 out of 5, that is 100%. However, with it set to 20 their grade would be reduced to 5 out of 20, that is 25%. In the case of another student who goes through all the branches and sees, say, 25 pages and answers all but two of the questions correctly, then their grade would be 23 out of 25, that is 92%.

If this parameter is used, the teacher might want to add a statement on the opening page of the lesson. For example, if the teacher set the value to 20 they might say:

:In this lesson you are expected to attempt at least ''20'' questions. You can attempt more if you wish. However, if you attempt less than ''20'' questions your grade will be calculated as though you attempted ''20''.

When this parameter is set to a value more than 0, students are told how many questions they have attempted and how many they are expected to attempt.

===Number of Pages (Cards) to Show===

This parameter is only used in Flash Card type lessons. The default value is zero which means that all the Pages/Cards are shown in a lesson. Setting this parameter to a non-zero value shows that number of pages. After that number of Page/Cards have been shown the end of lesson is reached and the student is shown their grade.

If this parameter is set to a number greater than the number of pages in the lesson then the end of the lesson is reached when all the pages have been shown.

== Lesson formatting ==

===Slide Show===

This enables the display of the lesson as a slide show, with a fixed width, height, and custom background color. A CSS based scroll bar will be displayed if the width or height of the slide is exceeded by the content of a page. Questions will 'break out' of the slide show mode, only pages (branch tables) will be shown in a slide by default. Buttons labeled with the lang default for "Next" and "Back" will be shown at the far right and left of the slide if that option is chosen on the page. Other buttons will be centered below the slide. You can also decide on the width, height and the background colour of the slide show.

===Display Left Menu===

This will show a list of the pages (Branch Tables) in the lesson. Question pages, cluster pages, etc. will not be shown by default (you may choose to show question pages by checking that option on the question).

== Access control ==

===Password Protected Lesson===

This will not allow a student to access the lesson unless they type the password.

=== Dependent on ===
{{Moodle 1.6}}
In Version 1.6 a lesson can be dependent upon another lesson. There are 3 possible dependencies which can be use seperately or in combination with each other. Time Spent (minutes) refers to how long the student was in the lesson on their last attempt (it is not cumulative). Completion means the student has attempted one question. Grade as a percentage of a specific lesson means just that.

===Available from & deadline dates===

Here you can decide on the dates for the opening and deadline of the lesson.

== Other ==

===Tree View===
Found in pre 1.6 versions of Moodle. Similar to Lesson Formating, display left menu in Moodle 1.6 and later.

===Display High Scores===

A list of the high scores for the lesson will be shown. Students who get a high score can choose a custom name to list their score by. There is a 'badwords' filter which checks for naughty names.

High scores do not display if the "Practice lesson" option is turned On.

===Number of High Scores Displayed===

Type a number to limit how many of the top scores are displayed.

===Use this lesson's settings as defaults===

Select yes before Saving the lesson, and the settings you have chosen for this lesson will be the default settings for the next time you create a lesson for this course.

===Visible to users===

Allows you to show to, or to hide the lesson from students.

----

==Adding the first page in a Lesson==

After you decide on the lesson settings (above), you are taken to the lesson and you are asked which of the following you want to do now: import questions, add a Branch Table or add a Question Page. To read more about adding pages go to: [[Viewing_a_lesson]]. If you would like more information about lesson pages in general go to [[Lesson Pages]] or select something from the index at the top of this page or one of the overall indexes below.

==See also==
[[Lesson module]] for an overview of a lesson.

[[Category:Teacher]]
[[Category:Lesson]]

Short-Answer question type

2006-10-07T03:49:48Z

Allbhatias: /* Question set-up */

{{Questions}}
In response to a question (that may include a image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case.

==Question set-up==
*Give your question a descriptive name.
*Create the question stem. If you want students to fill in a blank, use the underscore to indicate where the blank is.
*Select an image to display if you want to add a picture to the question (see step 3 in [[Multiple Choice question type]] for more detail).
*Choose whether capitalization is important. Case sensitivity can be tricky. Will you accept george washingtion as well as George Washington as an answer?
*Next, fill in the answers you will accept. You can give each answer a percentage of the grade as well. You could give common misspellings partial credit with this option. If the "Case sensitive" option is selected, then you can have different scores for "Word" or "word".
*Create feedback for each acceptable answer.
*Click Save Changes to add the question to the category.

You can use the asterisk character (*) as a wildcard to match any series of characters. For example, use ran*ing to match any word or phrase starting with "ran" and ending with "ing". If you really do want to match an asterisk then use a backslash like this: \*

If you want one question with the two answers fuel and oxygen, you ought to be able to limit the number of variants by writing:
fuel*oxygen 100%
would accept "fuel oxygen" "fuel, oxygen" "fuel; oxygen" "fuel and oxygen" "fuel oxygen" {two spaces} "fuel & oxygen" "fuel oxygen" "fuel und oxygen" "fuel&&oxygen" it would even accept "fuel or oxygen" "fuel but not oxygen" "fuel|oxygen" which might not be so good but you can never be completely safe!
oxygen*fuel 100%
*fuel* 50%
(the order of the answers is important since it stops checking with the first alternative that is satisfied)
*oxygen* 50%
*air* 40% maybe etc

Without wildcards the answers are compared exactly, so be careful with your spelling!

'''Feedback for wrong answers'''

When you wish to have short answer type questions, you naturally have a limited number of variations that would be acceptable. So in case you wish to give a feedback in case of a wrong answer, you must spell out the right answers exactly and then use * as another answer which will have grade as zero and feedback will be the one for wrong answer.
Effectively, ANYTHING other than the specific answers mentioned by you will be treated as this option due to wildcard and will be deemed wrong; it'll give 0 marks and show the feedback for a wrong answer.
here is an example:

ques: what is a rabbit?

right answers

answer1: animal
feedback: right
grade: 100%

answer2: mammal
feedback: right
grade: 100%

answer3: vertebrate
feedback: right
grade: 100%

answer4: *
feedback: ouch! that was wrong
grade: none

Remember: you cannot do negative marking in this type and ANYTHING other than your right answer will be treated as option 4 due to the wildcard and given that feedback and zero marks.

You may like to prototype your short answer questions to catch common acceptable answers you hadn't thought of. Start out by creating a few acceptable answers, then include the question in a quiz for no points. Be sure to tell students you are testing a new question. Once the quiz is over, review students' answers and add their acceptable answers to the list.

{{Moodle 1.6}}
Starting with Moodle 1.6, there are two different student answer analysis systems available for the Short Answer type of question: the ''simple system ''is used by default; the ''Regular Expressions system'' is used if the "Use Regular Expressions" option box has been checked on the Edit Question Page screen. See [[Short answer analysis]] for a description of the new type, with examples.

[[Category:Teacher]]
[[Category:Question]]
[[Category:Quiz]]

Short-Answer question type

2006-10-07T03:48:03Z

Allbhatias: /* Question set-up */

{{Questions}}
In response to a question (that may include a image), the respondent types a word or phrase. There may several possible correct answers, with different grades. Answers may or may not be sensitive to case.

==Question set-up==
*Give your question a descriptive name.
*Create the question stem. If you want students to fill in a blank, use the underscore to indicate where the blank is.
*Select an image to display if you want to add a picture to the question (see step 3 in [[Multiple Choice question type]] for more detail).
*Choose whether capitalization is important. Case sensitivity can be tricky. Will you accept george washingtion as well as George Washington as an answer?
*Next, fill in the answers you will accept. You can give each answer a percentage of the grade as well. You could give common misspellings partial credit with this option. If the "Case sensitive" option is selected, then you can have different scores for "Word" or "word".
*Create feedback for each acceptable answer.
*Click Save Changes to add the question to the category.

You can use the asterisk character (*) as a wildcard to match any series of characters. For example, use ran*ing to match any word or phrase starting with "ran" and ending with "ing". If you really do want to match an asterisk then use a backslash like this: \*

If you want one question with the two answers fuel and oxygen, you ought to be able to limit the number of variants by writing:
fuel*oxygen 100%
would accept "fuel oxygen" "fuel, oxygen" "fuel; oxygen" "fuel and oxygen" "fuel oxygen" {two spaces} "fuel & oxygen" "fuel oxygen" "fuel und oxygen" "fuel&&oxygen" it would even accept "fuel or oxygen" "fuel but not oxygen" "fuel|oxygen" which might not be so good but you can never be completely safe!
oxygen*fuel 100%
*fuel* 50%
(the order of the answers is important since it stops checking with the first alternative that is satisfied)
*oxygen* 50%
*air* 40% maybe etc

Without wildcards the answers are compared exactly, so be careful with your spelling!

'''Feedback for wrong answers'''

When you wish to have short answer type questions, you naturally have a limited number of variations that would be acceptable. So in case you wish to give a feedback in case of a wrong answer, you must spell out the right answers exactly and then use * as another answer which will have grade as zero and feedback will be the one for wrong answer.
Effectively, ANYTHING other than the specific answers mentioned by you will be treated as this option due to wildcard and will be deemed wrong; it'll give 0 marks and show the feedback for a wrong answer.
here is an example:

ques: what is a rabbit?

right answers

answer1: animal
feedback: right
grade: 100%

answer2: mammal
feedback: right
grade: 100%

answer3: vertebrate
feedback: right
grade: 100%

answer4: *
feedback: ouch! that was wrong
grade: none

Remember: you cannot do negative marking in this type and ANYTHING other than you right answer will be treated as option 4 due to the wildcard and given that feedback and zero marks.

You may like to prototype your short answer questions to catch common acceptable answers you hadn't thought of. Start out by creating a few acceptable answers, then include the question in a quiz for no points. Be sure to tell students you are testing a new question. Once the quiz is over, review students' answers and add their acceptable answers to the list.

{{Moodle 1.6}}
Starting with Moodle 1.6, there are two different student answer analysis systems available for the Short Answer type of question: the ''simple system ''is used by default; the ''Regular Expressions system'' is used if the "Use Regular Expressions" option box has been checked on the Edit Question Page screen. See [[Short answer analysis]] for a description of the new type, with examples.

[[Category:Teacher]]
[[Category:Question]]
[[Category:Quiz]]

Import questions

2006-09-27T06:40:35Z

Allbhatias: /* GIFT */

{{Questions}}

If you have questions from a textbook question bank, or if you don’t want to use the web interface to create your questions, you can import them from a text file. Moodle supports eight formats natively, and provides an easy way of creating new importers if you know a little PHP.

Once you get to know a format, it may be easier to simply type them into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The formats available by default include:

== GIFT ==

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] Please note that the blank lines between questions are required when loading a text file from Windows. (maybe unix as well)

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

Hint: use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title ...

For UTF8 be careful: dont upload special signs (german ü,ä,.. and other stuff like that), without converting it on your local pc to utf8! notepad2 [http://www.flos-freeware.ch/notepad2.html notepad2] may be helpful in that case.

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 feeback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

With GIFT its easy to organize a questions catalogue at your local pc and change and share questions

== Aiken ==

Aiken format is an easy way of writing multiple-choice questions for import. It’s a very easy, readable format.[[Image:Aiken_format.gif|frame|left|screen shot from quiz help file documentation]] 

== Missing Word ==

If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
[[Image:Missing_word.jpg|frame|left|screen shot from quiz help file documentation]] 

== AON ==

The same as the missing word format, except it creates matching questions from the multiple choice questions.

==Blackboard==
If you’re converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard format.

== WebCT ==

Currently, the WebCT format only supports importing multiple-choice and short answers questions

== Course Test Manager ==

This will enable you to import questions from the Course Test Manager from Course Technology

== Embedded Answers (Cloze) ==

The Cloze format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion

[[Category:Teacher]]
[[Category:Question]]
[[Category:Quiz]]
[[Category:Lesson]]

Import questions

2006-09-27T06:30:27Z

Allbhatias: /* GIFT */

{{Questions}}

If you have questions from a textbook question bank, or if you don’t want to use the web interface to create your questions, you can import them from a text file. Moodle supports eight formats natively, and provides an easy way of creating new importers if you know a little PHP.

Once you get to know a format, it may be easier to simply type them into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The formats available by default include:

== GIFT ==

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] Please note that the blank lines between questions are required when loading a text file from Windows. (maybe unix as well)

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

Hint: use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title ...

For UTF8 be careful: dont upload special signs (german ü,ä,.. and other stuff like that), without converting it on your local pc to utf8! notepad2 [http://www.flos-freeware.ch/notepad2.html notepad2] may be helpful in that case.

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:

* enter your own feedback message (i.e. "continue", "---", etc.)
* no visible message displayed: enter a non-breaking space as feeback, so your example
would become: {~a# ~b# ~c# ~d# =e# ~f# ~g# ~h# }

To find out how moodle works - you may export a sample of your questions with GIFT and check them out!

With GIFT its easy to organize a questions catalogue at your local pc and change and share questions

== Aiken ==

Aiken format is an easy way of writing multiple-choice questions for import. It’s a very easy, readable format.[[Image:Aiken_format.gif|frame|left|screen shot from quiz help file documentation]] 

== Missing Word ==

If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
[[Image:Missing_word.jpg|frame|left|screen shot from quiz help file documentation]] 

== AON ==

The same as the missing word format, except it creates matching questions from the multiple choice questions.

==Blackboard==
If you’re converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard format.

== WebCT ==

Currently, the WebCT format only supports importing multiple-choice and short answers questions

== Course Test Manager ==

This will enable you to import questions from the Course Test Manager from Course Technology

== Embedded Answers (Cloze) ==

The Cloze format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion

[[Category:Teacher]]
[[Category:Question]]
[[Category:Quiz]]
[[Category:Lesson]]