MoodleDocs - User contributions [en]

Quiz settings

2005-09-17T10:59:22Z

Sylvia: /* Students may review */

===Name/Introduction===

These are the descriptive fields in your quiz. In the Name field, write the name of the quiz that you wish it to be identified by. In the Introduction field, write the description of the quiz that students will see before attempting the quiz.

===Open/Close the quiz===

You can specify times when the quiz is accessible for people to make attempts. Before the opening time, and after the closing time, the quiz will be unavailable.

===Time limit===

By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:

# Javascript support in the browser becomes mandatory - this allows the timer to work correctly.
# A floating timer window is shown with a countdown
# When the timer has run out, the quiz is submitted automatically with whatever answers have been filled in so far
# If a student manages to cheat and spends more than 60 seconds over the allotted time then the quiz is automatically graded zero

===Questions per page===

For longer quizzes it makes sense to stretch the quiz over several pages by limiting the number of questions per page. When adding questions to the quiz page breaks will automatically be inserted according to the setting you choose here. However you will also be able to move page breaks around by hand later on the editing page.

===Shuffle questions===

If you enable this option, then the order of questions in the quiz will be randomly shuffled each time a student attempts the quiz. This is not related to the use of Random Questions, this is only about the displayed order of questions. The intention is to make it a little harder for students to copy from each other.

===Shuffle answers===

If you enable this option, then the order of answers within each question will be randomly shuffled each time a student attempts this quiz. Of course, this only applies to questions that have multiple answers displayed, such as Multiple Choice or Matching Questions. The intention is simply to make it a little harder for students to copy from each other. This option is not related to the use of Random Questions.

===Attempts allowed===

Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment.

===Each attempt builds on the last===

If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows a quiz to be completed over several attempts. To show a fresh quiz on every attempt, select No for this setting.

===Grading method===

When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.

* Highest grade

The final grade is the highest (best) grade in any attempt.

* Average grade

The final grade is the average (simple mean) grade of all attempts.

* First grade

The final grade is the grade gained on the first attempt (other attempts are ignored).

* Last grade

The final grade is the grade gained on the most recent attempt only.

===Adaptive mode===

If you choose Yes for this option then the student will be allowed multiple responses to a question even within the same attempt at the quiz. So for example if the student's response is marked as incorrect the student will be allowed to try again immediately. However a penalty will usually be subtracted from the students score for each wrong attempt (the amount of penalty is determined by the penalty factor, set by the next option).

This mode also allows adaptive questions that can change themselves in response to a student's answer. Here is how the IMS QTI specification defines adaptive questions (items):

An adaptive item is an item that adapts either its appearance, its scoring (Response Processing) or both in response to each of the candidate's attempts. For example, an adaptive item may start by prompting the candidate with a box for free-text entry but, on receiving an unsatisfactory answer, present a simple choice interaction instead and award fewer marks for subsequently identifying the correct response. Adaptivity allows authors to create items for use in formative situations which both help to guide candidates through a given task while also providing an outcome that takes into consideration their path
In adaptive mode an additional Submit button is shown for each question. If the student presses this button then the response to that particular question is submitted to be scored and the mark achieved is displayed to the student. If the question is an adaptive question then it is displayed in its new state that takes the student's answer into account and will in many cases ask the student for another input. In the simplest adaptive questions this new state may differ only in the feedback text and prompt the student to try again; in more complicated question also the question text and even the interaction elements can change.

===Apply penalties===

If a quiz is run in adaptive mode then a student is allowed to try again after a wrong response. In this case you may want to impose a penalty for each wrong response to be subtracted from the final mark for the question. The amount of penalty is chosen individually for each question when setting up or editing the question.

This setting has no effect unless the quiz is run in adaptive mode.

===Decimal points===

By using this setting you can select the number of decimals to be showed in the grade of every attempt.

===Students may review===

This option controls whether and when students will be able to review their past attempts at this quiz.

Students may review (see) their own responses, scores for their responses, feedback from the teachre (if any) or answers (correct answers) immediately after the attempt, later but while the quiz is still open or after even the quiz is closed.

Currently, the setting "students can see answers" works differently depending on the question type in a particular quiz. If the question type used is 'matching' then students get to see which of their responses are in fact correct answers. If the question type used is 'short answer' then students see their responses plus all correct answers to all questions.

===Show quiz in a "secure" window===

The "secure" window tries to provide a little more security for quizzes (making copying and cheating more difficult) by restricting some of the things that students can do with their browsers.

What happens is that:

# Javascript is made a requirement.
# The quiz appears in a new fullscreen window.
# Some mouse actions on the text are prevented.
# Some keyboard commands are prevented.

NOTE: This security is NOT watertight. Do NOT rely on these protections as your sole strategy. It is impossible to implement complete protection of quizzes in a web environment so please do not rely on this option if you are really worried about students cheating. Other strategies you can try are to create really large databases of questions from which you randomly choose questions, or even better, rethink your overall assessment to put more value on constructive forms of activity such as forum discussions, glossary building, wiki writing, workshops, assignments etc.

===Require password===

This field is optional.

If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz.

===Require network address===

This field is optional.

You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

There are three types of numbers you can use (you can not use text based domain names like example.com):

# Full IP addresses, such as 192.168.10.1 which will match a single computer (or proxy).
# Partial addresses, such as 192.168 which will match anything starting with those numbers.
# CIDR notation, such as 231.54.211.0/20 which allows you to specify more detailed subnets.

Spaces are ignored.

===Group mode===

The group mode can be one of three levels:

* No groups

There are no sub groups, everyone is part of one big community

* Separate groups

Each group can only see their own group, others are invisible

* Visible groups

Each group works in their own group, but can also see other groups

The group mode can be defined at two levels:

* Course level

The group mode defined at the course level is the default mode for all activities defined within that course

* Activity level

Each activity that supports groups can also define its own grouping mode. If the course is set to [[Force group mode|"force group mode"]] then the setting for each activity is ignored.

===Visible to students===

You can also decide on whether or not the quiz will be seen by the students. You can hide the activity from students selecting "Hide" in the Visible to students field. It is useful if you wouldn't like to make the activity available immediately.

More about creating quiz questions you will find [[Mod/quiz/question|here]].

Using Quiz

2005-07-14T16:43:33Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/course/mod/quiz.view.php page

'''

Using Quiz

2005-07-14T16:34:54Z

Sylvia:

Note for contributors:
This page should explain what can be seen on page:moo

Lesson clusters

2005-07-14T09:05:33Z

Sylvia:

Note for Contributors: This page should explain what clusters are and what they can be used for.

== What are clusters? ==

A cluster represents a set of questions from which one or more may be randomly chosen. Clusters should be completed with an End of Cluster page for best results (otherwise they treat the End of Lesson as the EOC). Questions within a cluster are randomly selected by choosing "Random Question within a Cluster" as a jump. Questions within a cluster may either link to the EOC to exit the cluster, or jump to an unseen question within the cluster, or jump to any other page in the lesson. This also enables the creation of scenarios with a random element using the lesson module.

==When to use a cluster?==

A cluster in the lesson works as if you had a random question quiz inside your lesson. If you have for example a set of 6 questions / a set of 6 pages inside your lesson AND you would like each student to go through ONLY two of these 6 pages, then you can use Cluster to arrange that.

==How to add a cluster?==

Lesson clusters

2005-07-14T09:01:50Z

Sylvia:

Adding a question page

2005-07-14T08:56:45Z

Sylvia:

Note for Contributors
This page should explain what can be seen on the moodlesite.com/mod/lesson/lesson.php page ( a page where you can add a question to your lesson).

To add a question to your lesson you need to go to the All-Pages View of your lesson. Above each existing page you will see a link '''Add a Question Page here.'''This link will take you to a page where you can create your question.

'''Before you type in any information, you should decide about the kind of question which will end your question page.''' The defualt type is mutiple choice. You can easily change that to any of the following: True/ False, Short Answer, Numerical, Matching or Essay question. To find out more about question types available in the lesson, click on the name of the question.
If you decide to choose a multiple choice question, you will need to decide if you want your question to be multianswer as well. If you decide to choose a Short Answer question, you will have to decide if the answer will be case sensitive or not.

Next, you decide about the name of your page (Page title) and the page contents.
Finally, you add a question at the end of your page. Depending on the question type you chose at the beginning, the layout of the answres and responses will vary.

After writing your answers and responses to them, you will have to specify the jumps after each answer. To learn more about jumps click here.

Remember to click on '''Add a Question Page''' to save your page.

Adding a question page

2005-07-14T08:55:23Z

Sylvia:

Lesson clusters

2005-07-14T07:23:53Z

Sylvia:

Lesson clusters

2005-07-14T07:10:24Z

Sylvia:

Note for Contributors: This page should explain what clusters are and what they can be used for.

== What are clusters? ==

A cluster represents a set of questions from which one or more may be randomly chosen. Clusters should be completed with an End of Cluster page for best results (otherwise they treat the End of Lesson as the EOC). Questions within a cluster are randomly selected by choosing "Random Question within a Cluster" as a jump. Questions within a cluster may either link to the EOC to exit the cluster, or jump to an unseen question within the cluster, or jump to any other page in the lesson. This also enables the creation of scenarios with a random element using the lesson module.

==When to use a cluster?==

A cluster in the lesson can be compared to a random question quiz put inside your lesson.

Lesson clusters

2005-07-14T07:10:01Z

Sylvia:

Note for Contributors: This page should explain what clusters are and what they can be used for.

== What clusters are ==

A cluster represents a set of questions from which one or more may be randomly chosen. Clusters should be completed with an End of Cluster page for best results (otherwise they treat the End of Lesson as the EOC). Questions within a cluster are randomly selected by choosing "Random Question within a Cluster" as a jump. Questions within a cluster may either link to the EOC to exit the cluster, or jump to an unseen question within the cluster, or jump to any other page in the lesson. This also enables the creation of scenarios with a random element using the lesson module.

==When to use a cluster?==

A cluster in the lesson can be compared to a random question quiz put inside your lesson.

Moodle in education

2005-07-14T07:06:15Z

Sylvia:

'''Note for Contributors'''
You can help the documentation grow by writing one (or more) of the topics below.
I will keep adding topics here.
If you'd like to add some other topics yourself, please contact [[User:Stencel|me]]
Asterisk indicates documentation pages which correspond to particular pages in Moodle

==Managing your course==
# [[course/view|The course homepage]] *
# [[Course sections]]
# [[Blocks]]
#* [[Activities]]
#* [[Administration]]
#** [[course/edit|Course settings]] *
#** [[user/edit|Editing your user profile]] *
#** [[course/teacher|Assigning teachers to the course]] *
#** [[course/student|Enrolling students in the course]] *
#** [[backup/backup|Backing up the course]] *
#** [[files/index/backupdata|Restoring a backup of a course]] *
#** [[course/import|Importing data from other courses]] *
#** [[course/scales|Defining custom scales]] *
#** [[grade/index|Using the gradebook]] *
#** [[course/log|Viewing the course logs]] *
#** [[files/index|Browsing the course files]] *
#* [[Calendar]]
#* [[Courses]]
#* [[Course/Site Description]]
#* [[HTML]]
#* [[Latest News]]
#* [[Messages]]
#* [[Online Users]]
#* [[People]]
#* [[Quiz Results]]
#* [[Random Glossary Entry]]
#* [[Recent Activity]]
#* [[Remote RSS Feeds]]
#* [[Search Forums]]
#** [[mod/forum/search|Advanced Forum Search]] *
#* [[Section Links]]
#* [[Upcoming Events]]
# [[Editing the course homepage]]
# [[Working with groups]]

==Moodle Resources and Activities==

# [[Adding resources and activities|Adding resources and activities to your course]]

===Resources===
# [[About Resources]]
# [[mod/resource/index|The Resources page]] *
# [[course/mod/text|Creating a text page]] *
# [[course/mod/html|Creating a web page]] *
# [[course/mod/file|Creating a link to a file or web site]] *
# [[course/mod/directory|Displaying a directory]] *
# [[course/mod/label|Creating a label]] *

===Assignments===
# [[About Assignments]]
# [[mod/assignment/index|The Assignments page]] *
# [[course/mod/assignment|Creating an assignment]] *
# [[mod/assignment/view|Submitting an assignment]] *
# [[mod/assignment/submissions|Viewing and grading submissions]] *

===Chats===
# [[About Chats]]
# [[mod/chat/index|The Chats page]] *
# [[course/mod/chat|Creating a chat]] *
# [[mod/chat/view|Viewing a chat page]] *
# [[mod/chat/gui_header_js/index|Inside a chat-room]] *
# [[mod/chat/report|Viewing past chat sessions]] *

===Choices===
# [[About Choices]]
# [[mod/choice/index|The Choices page]] *
# [[course/mod/choice|Creating a choice]] *
# [[mod/choice/view|Viewing a choice page]] *
# [[mod/choice/report|Viewing choice responses]] *

===Forums===
# [[About Forums]]
# [[mod/forum/index|The Forums page]] *
# [[course/mod/forum|Creating a forum]] *
# [[mod/forum/view|Viewing a forum]] *
# [[mod/forum/discuss|Viewing a discussion]] *
# [[mod/forum/post|Writing a message in a forum]] *
# [[mod/forum/subscribers|Subscribing students to a forum]] *

===Glossary===
# [[About Glossaries]]
# [[mod/glossary/index|The Glossaries page]] *
# [[course/mod/glossary|Creating a glossary]] *
# [[mod/glossary/view|Viewing a glossary]] *
# [[mod/glossary/edit|Adding or Editing a glossary entry]] *

===Lesson===
# [[About Lessons]]
# [[mod/lesson/index|The Lessons page]] *
# [[course/mod/lesson|Creating a lesson]] *
# [[mod/lesson/view|Viewing a lesson]] *
# [[mod/lesson/lesson/addbranchtable|Creating a branch table]] *
# [[mod/lesson/lesson/addpage|Adding a question page]] *
# [[About clusters]]

===Quiz===
# [[About Quizzes]]
# [[mod/quiz/index|The Quizzes page]] *
# [[course/mod/quiz|Creating a quiz]] *
# [[mod/quiz/view|Viewing a quiz]] *
# [[mod/quiz/report|Viewing quiz reports]] *
# [[mod/quiz/edit|Editing a quiz]] *
# [[mod/quiz/attempt|Taking (or previewing) a quiz]] *
# [[mod/quiz/question|Creating or editing a quiz question]] *

===SCORM===
# [[About SCORM]]

===Survey===
# [[About Surveys]]
# The survey page
# Creating a survey
# Viewing a survey
# Viewing survey results

===Wiki===
# [[About Wikis]]
# The wiki page
# Creating a wiki

===Workshop===
# [[About Workshop]]
# The workshop page
# Creating a workshop
# Viewing a workshop

===Add-on Activities===
Apart from the standard modules, there is also a number of optional modules in Moodle (which you need to download separately). Documentation regarding those modules can be found [[Add-on Activities|here]].

==Other topics==
# [[Using the richtext editor]]
# [[Formatting options]]
#* [[Moodle auto-formatting]]
#* [[HTML in Moodle]]
#* [[Markdown format]]

Adding a question page

2005-07-14T07:03:57Z

Sylvia:

Adding a branch table

2005-07-14T06:44:35Z

Sylvia:

Note for Contributors:
This page should explain what can be seen on the page where you can add a branch moodlesite.com/mod/lesson/lesson.php).

== Branches in a nutshell ==
# Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents.
# Each link in a branch table has two components, a description and the title of the page to jump to.
# A branch table effectively divides the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic). The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceding branch table. (The "return" jump in an End of Branch page can be changed, if required, by editing the page.)
# There can be more than one branch table in a lesson. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches.

== The Jump-to Link ==

Each Answer (for questions) or Description (for Branch pages) has a Jump-to link. When this answer is chosen, the answer's response is shown to the student. After that the student sees the page given in the Jump-to link. This link can be either relative or absolute. Relative links are This page and Next page. This page means that the student sees the current page again. Next page shows the page which follows this page in the logical order of pages. An absolute page link is specified by choosing the page's title.

Note that a (relative) Next page Jump-to link may show a different page after pages have been moved. Whereas Jump-to links which use page titles always show the same page after pages have been moved.

===Special Jumps===

====Unseen Question within a Branch====

This will link to a randomly chosen unseen (by the student in this attempt) question between this branch table and the End of the Lesson or the next End of Branch.

====Random Question within a Branch====

This will link to a randomly chosen question between the current branch table and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown.

====Random Branch Table====

This will jump to a random Branch Table between the current Branch Table and the End of Lesson or the next End of Branch.

== Creating a branch table ==
It is best to create a branch table after you have created pages in your lesson.
You should go to All-Pages View of your lesson. Above each page of your lesson you will see a link: Add a Branch Table. Decide where you want to create your branch table and click on the link. You will need to specify the name of your branch table (for example: Contents) and then write a few words introducing the topic/ topics covered in your branches.

Next, you specify the name of each link and the page to which each link will jump.

Adding a branch table

2005-07-14T06:40:56Z

Sylvia:

Note for Contributors:
This page should explain what can be seen on the page where you can add a branch moodlesite.com/mod/lesson/lesson.php).

== Branches in a nutshell ==
# Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents.
# Each link in a branch table has two components, a description and the title of the page to jump to.
# A branch table effectively divides the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic). The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceding branch table. (The "return" jump in an End of Branch page can be changed, if required, by editing the page.)
# There can be more than one branch table in a lesson. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches.

== The Jump-to Link ==

Each Answer (for questions) or Description (for Branch pages) has a Jump-to link. When this answer is chosen, the answer's response is shown to the student. After that the student sees the page given in the Jump-to link. This link can be either relative or absolute. Relative links are This page and Next page. This page means that the student sees the current page again. Next page shows the page which follows this page in the logical order of pages. An absolute page link is specified by choosing the page's title.

Note that a (relative) Next page Jump-to link may show a different page after pages have been moved. Whereas Jump-to links which use page titles always show the same page after pages have been moved.

Special Jumps

Unseen Question within a Branch

This will link to a randomly chosen unseen (by the student in this attempt) question between this branch table and the End of the Lesson or the next End of Branch.

Random Question within a Branch

This will link to a randomly chosen question between the current branch table and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown.

Random Branch Table

This will jump to a random Branch Table between the current Branch Table and the End of Lesson or the next End of Branch.

== Creating a branch table ==
It is best to create a branch table after you have created pages in your lesson.
You should go to All-Pages View of your lesson. Above each page of your lesson you can see a link: Add a Branch Table. Decide where you want to craete your branch table and click on the link. You will need to specify the name of your branch table (for example: Contents) and then write a few words introducing the topic/ topics covered in your branches.

Next, you specify the name of each link and the pade to which each link will jump.

Adding a branch table

2005-07-14T05:34:58Z

Sylvia:

Note for Contributors:
This page should explain what can be seen on the page where you can add a branch.

== Branches in a nutshell ==
# Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents.
# Each link in a branch table has two components, a description and the title of the page to jump to.
# A branch table effectively divides the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic). The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceding branch table. (The "return" jump in an End of Branch page can be changed, if required, by editing the page.)
# There can be more than one branch table in a lesson. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches.

== The Jump-to Link ==

Each Answer (for questions) or Description (for Branch pages) has a Jump-to link. When this answer is chosen, the answer's response is shown to the student. After that the student sees the page given in the Jump-to link. This link can be either relative or absolute. Relative links are This page and Next page. This page means that the student sees the current page again. Next page shows the page which follows this page in the logical order of pages. An absolute page link is specified by choosing the page's title.

Note that a (relative) Next page Jump-to link may show a different page after pages have been moved. Whereas Jump-to links which use page titles always show the same page after pages have been moved.

Special Jumps

Unseen Question within a Branch

This will link to a randomly chosen unseen (by the student in this attempt) question between this branch table and the End of the Lesson or the next End of Branch.

Random Question within a Branch

This will link to a randomly chosen question between the current branch table and the End of Lesson or the next End of Branch. If the student has already seen the question and attempts are greater than 1, they will get another chance to earn the point(s) for that question. If attempts are set to 1, the question will be skipped and another random question shown.

Random Branch Table

This will jump to a random Branch Table between the current Branch Table and the End of Lesson or the next End of Branch.

Adding a branch table

2005-07-14T05:32:40Z

Sylvia:

Adding a branch table

2005-07-13T09:51:31Z

Sylvia:

Note for Contributors:
This page should explain what can be seen on the page where you can add a branch.

Lesson activity

2005-07-13T09:49:49Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/index.php page
(the page which aggregates all lessons in a course)

The lessons page can be accessed from the main page of a course. On the left handside, in the menu '''Activities''', click on the link '''Lessons''' to go to the lessons page.

The lessons page shows you the list of all lessons in your course. Apart from the title of the lesson, there is the number of the topic in which the lesson is used, the grade for the lesson and its deadline.
You can access each lesson from the lessons page.

If a lesson is visible to students, its name in the lesson page appears in full colour. If the lesson is not visible to students, its name is in grey.

Lesson activity

2005-07-13T09:44:32Z

Sylvia:

Lesson settings

2005-07-13T08:37:12Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/course/mod/lesson.php page
(the page where you add a lesson to a course)

__TOC__

On the lesson page, you can choose from a number of settings,which will make your lesson run smoothly.

Below you can see all the settings available and the description of their functions:

==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 use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

==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

==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. In the case of questions which do not provide the answer, for example Short Answer and Numerical questions, this value provides a necessary escape routine to the next page in the lesson.

The default value is 5. Smaller values may discourage the student from thinking about the questions. Larger values may lead to more frustration.

Setting this value to one gives the students just one chance to answer each question. This gives a similar type of assignment to the Quiz module except that the questions are presented on individual pages.

Note that this value is global parameter and that it applies to all the questions in the lesson regardless of their type.

Note that this parameter 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.

==The Minimum Number of Questions in a Lesson==

When a lesson contains one or more Branch Tables the teacher should normally set this parameter. Its value sets a lower limit on the number of questions seen when a grade is calculated. It does not force students to answer that many questions in the lesson

For example, setting this parameter to, say, 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, say, 5 pages and answers all the associated questions correctly. They then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter were left unset 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, then the opening page of the lesson should say something like:

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

Where obviously "n" is replaced by the actual value this parameter has been given.

When this parameter is set 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.

==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).

==Password Protected Lesson==

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

==Available from / Deadline==

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

==Tree View==

This will show a list of the pages and questions in the lesson as links. Pages will be in blue and questions in red. This is handy for navigating lessons with many pages.

==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.

----
After you decide on the 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 on, go to: Viewing the lesson).

Using Lesson

2005-07-05T07:22:50Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

What the teacher can see on the page depends on whether the lesson already has some content.

== When the lesson has no content: ==

When you are creating a new lesson, you first decide on the settings of the lesson [[course/mod/lesson|Creating a lesson]] and then you are taken to a moodlesite.com/mod/lesson/view/php page. Here you asked which of the following you would like to do now: import questions, add a Branch Table or add a Question Page.
''NOTE!! It is much more convenient to create Question Pages first and then to create a Branch Table.''

== When the lesson already has content: ==

There are three main ways in which the teacher can view a lesson. They are: all pages view, navigation view and tree view.

=== All pages view ===
You see all pages after pressing the '''View All Pages''' button.
This is the usual teacher view of a lesson. It shows all the text in the lesson and can thus be quite a long page. You see all pages in their logical order. Between the pages, you see and can use commands such as:
Import questions | Add a Cluster | Add an End of Cluster | Add a Branch Table
Add an End of Branch | Add a Question Page here.
In questions, the correct answers have underlined Answer Labels.

A useful tip:
If you want to see only page titles in their logical order (without the content of the pages)just press one of the "Move Page" links. You will then see a list of the page titles(without the page title that is intended to move of course). It's an easy way of checking the structure of the lesson.

===Navigation View===
That is another way of viewing a lesson. Here the teacher can see how a lesson's navigation "works", in other words, the theacher can see the lesson from a student's perspective: page by page. You get that view by using Check Question button at the end of each page or by using the Check Navigation link at the very end, or the very beginning, of the lesson. The Check Question button "launches" the lesson at that page. The Check Navigation link starts the lesson at the first page, the way a student would see the lesson initially.

A useful tip: If, in the lesson settings, you have chosen to '''display the left menu''', you will see that menu on the left handside. This menu is visible only when you are in the navigation view. You don't see the menu if you are cuurently using the All Pages View or the Tree View.

===Tree View===
The lesson can be viewed in that way only if you have activated the option in the settings of the lesson.

The Tree View shows you the structure of the lesson: it shows the page titles (in the logical order of the pages). Additionally, you can see how the branches are structured, thanks to the different colours used to highlight them. If you are in the tree view, you can edit, move and delete the pages.

Using Lesson

2005-07-05T07:18:39Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

What the teacher can see on the page depends on whether the lesson already has some content.

== When the lesson has no content: ==

When you are creating a new lesson, you first decide on the settings of the lesson [[course/mod/lesson|Creating a lesson]] and then you are taken to a moodlesite.com/mod/lesson/view/php page. Here you asked which of the following you would like to do now: import questions, add a Branch Table or add a Question Page.
''NOTE!! It is much more convenient to create Question Pages first and then to create a Branch Table.''

== When the lesson already has content: ==

There are three main ways in which the teacher can view a lesson. They are: all pages view, navigation view and tree view.

=== All pages view ===
You see all pages after pressing the '''View All Pages''' button.
This is the usual teacher view of a lesson. It shows all the text in the lesson and can thus be quite a long page. You see all pages in their logical order. Between the pages, you see and can use commands such as:
Import questions | Add a Cluster | Add an End of Cluster | Add a Branch Table
Add an End of Branch | Add a Question Page here.
In questions, the correct answers have underlined Answer Labels.

A useful tip:
If you want to see only page titles in their logical order (without the content of the pages)just press one of the "Move Page" links. You will then see a list of the page titles(without the page title that is intended to move of course). It's an easy way of checking the structure of the lesson.

===Navigation View===
That is another way of viewing a lesson. Here the teacher can see how a lesson's navigation "works", in other words, which page jumps to which page. You get that view by using Check Question button at the end of each page or by using the Check Navigation link at the very end, or the very beginning, of the lesson. The Check Question button "launches" the lesson at that page. The Check Navigation link starts the lesson at the first page, the way a student would see the lesson initially.

A useful tip: If, in the lesson settings, you have chosen to '''display the left menu''', you will see that menu on the left handside. This menu is visible only when you are in the navigation view. You don't see the menu if you are cuurently using the All Pages View or the Tree View.

===Tree View===
The lesson can be viewed in that way only if you have activated the option in the settings of the lesson.

The Tree View shows you the structure of the lesson: it shows the page titles (in the logical order of the pages). Additionally, you can see how the branches are structured, thanks to the different colours used to highlight them. If you are in the tree view, you can edit, move and delete the pages.

Using Lesson

2005-07-05T06:59:53Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

What the teacher can see on the page depends on whether the lesson already has some content.

== When the lesson has no content: ==

When you are creating a new lesson, you first decide on the settings of the lesson [[course/mod/lesson|Creating a lesson]] and then you are taken to a moodlesite.com/mod/lesson/view/php page. Here you asked which of the following you would like to do now: import questions, add a Branch Table or add a Question Page.
''NOTE!! It is much more convenient to create Question Pages first and then to create a Branch Table.''

== When the lesson already has content: ==

There are three main ways in which the teacher can view a lesson. They are: all pages view, navigation view and tree view.

=== All pages view ===
You see all pages after pressing the '''View All Pages''' button.
This is the usual teacher view of a lesson. It shows all the text in the lesson and can thus be quite a long page. You see all pages in their logical order. Between the pages, you see and can use commands such as:
Import questions | Add a Cluster | Add an End of Cluster | Add a Branch Table
Add an End of Branch | Add a Question Page here.
In questions, the correct answers have underlined Answer Labels.

A useful tip:
If you want to see only page titles in their logical order (without the content of the pages)just press one of the "Move Page" links. You will then see a list of the page titles(without the page title that is intended to move of course). It's an easy way of checking the structure of the lesson.

===Navigation View===
That is another way of viewing a lesson. Here the teacher can see how a lesson's navigation "works", in other words, which page jumps to which page. You get that view by using Check Question button at the end of each page or by using the Check Navigation link at the very end, or the very beginning, of the lesson. The Check Question button "launches" the lesson at that page. The Check Navigation link starts the lesson at the first page, the way a student would see the lesson initially.

===Tree View===
The lesson can be viewed in that way only if you have activated the option in the settings of the lesson.

The Tree View shows you the structure of the lesson.

Using Lesson

2005-07-05T06:49:44Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

What the teacher can see on the page depends on whether the lesson already has some content.

== When the lesson has no content: ==

When you are creating a new lesson, you first decide on the settings of the lesson [[course/mod/lesson|Creating a lesson]] and then you are taken to a moodlesite.com/mod/lesson/view/php page. Here you asked which of the following you would like to do now: import questions, add a Branch Table or add a Question Page.
''NOTE!! It is much more convenient to create Question Pages first and then to create a Branch Table.''

== When the lesson already has content: ==

There are three main ways in which the teacher can view a lesson. They are: all pages view, navigation view and tree view.

=== All pages view ===
You see all pages after cliking on '''View All Pages''' button.
This is the usual teacher view of a lesson. It shows all the text in the lesson and can thus be quite a long page. You see all pages in their logical order. Between the pages, you see and can use commands such as:
Import questions | Add a Cluster | Add an End of Cluster | Add a Branch Table
Add an End of Branch | Add a Question Page here.

Useful tips:
If you want to see only page titles in their logical order (without the content of the pages)just press one of the "Move Page" links. You will then see a list of the page titles(without the page title that is intended to move of course). It's an easy way of cheking the structure of the lesson.

----
The teacher can see how a lesson's navigation "works" by using Check Question button at the end of each page or by using the Check Navigation link at the very end of the lesson. The Check button "launches" the lesson at that page. The Check Navigation links starts lesson the lesson at the first page, the way a student would see the lesson initially.

----
In the teacher's view of the lesson the correct answers have underlined Answer Labels.

Using Lesson

2005-06-21T08:05:09Z

Sylvia:

Using Lesson

2005-06-21T08:04:36Z

Sylvia:

Using Lesson

2005-06-21T07:36:51Z

Sylvia:

Using Lesson

2005-06-21T07:33:26Z

Sylvia:

Using Lesson

2005-06-21T07:28:18Z

Sylvia:

Lesson settings

2005-06-21T07:20:33Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/course/mod/lesson.php page
(the page where you add a lesson to a course)

__TOC__

On the lesson page, you can choose from a number of settings,which will make your lesson run smoothly.

Below you can see all the settings available and the description of their functions:

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 use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

==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

==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. In the case of questions which do not provide the answer, for example Short Answer and Numerical questions, this value provides a necessary escape routine to the next page in the lesson.

The default value is 5. Smaller values may discourage the student from thinking about the questions. Larger values may lead to more frustration.

Setting this value to one gives the students just one chance to answer each question. This gives a similar type of assignment to the Quiz module except that the questions are presented on individual pages.

Note that this value is global parameter and that it applies to all the questions in the lesson regardless of their type.

Note that this parameter 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.

==The Minimum Number of Questions in a Lesson==

When a lesson contains one or more Branch Tables the teacher should normally set this parameter. Its value sets a lower limit on the number of questions seen when a grade is calculated. It does not force students to answer that many questions in the lesson

For example, setting this parameter to, say, 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, say, 5 pages and answers all the associated questions correctly. They then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter were left unset 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, then the opening page of the lesson should say something like:

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

Where obviously "n" is replaced by the actual value this parameter has been given.

When this parameter is set 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.

==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).

==Password Protected Lesson==

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

==Available from / Deadline==

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

==Tree View==

This will show a list of the pages and questions in the lesson as links. Pages will be in blue and questions in red. This is handy for navigating lessons with many pages.

==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.

----
After you decide on the 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 on, go to: Viewing the lesson).

Using Lesson

2005-06-20T15:15:32Z

Sylvia:

Using Lesson

2005-06-20T14:31:19Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

The normal teacher view of a lesson shows all the text in the lesson and can be quite a long page. For a much more compact view of the lesson just press one of the "Move Page" links. That lists just the page titles and gives a useful view to check the structure of the lesson. Note that the page you click on is not shown in the list .

== The Flash Card Lesson ==

The Lesson module can 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.

In the Lesson module the cards are pages. Correct answers jump to the Next Page, wrong answers stay on the same page.

There are 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 option is "Show an unanswered page" which shows the student pages that may have appeared before but only if they answered the associated question wrongly.

When using either of these Flash Card 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 when setting up the lesson.

In fact, this type of lesson is very similar to a random ordered Quiz, the difference is that the questions are shown one page at a time. Further extra text can be included with each question.

== Types of questions available within a lesson ==

== Multichoice Questions ==

This is the default question type. Multichoice questions are popular questions where the student is asked to choose one answer from a set of alternatives. The correct answer takes the student further into the lesson, the wrong answers do not. The wrong answers are sometimes called the distractors and the utility of these questions often rely more on the quality of the distractors than either the questions themselves or their correct answers.

Each answer can optionally have a response. If no response is entered for an answer then the default reponse "That's the Correct Answer" or "That's the Wrong Answer" is shown to the student.

It is possible to have more than one correct answer to a multichoice question. The different correct answers may give the student different responses and jump to different (forward) pages in the lesson but do not vary in their grades, (that is, some answers are not more correct than others, at least in terms of grade.) It is possible for all the answers to be correct and they might take the student to different (forward) parts of the lesson depending on which one is chosen. (Although it's probably neater to use a Branch Table to accomplish this).

== Multichoice Multianswer ==

There is variant of Multichoice questions called Multichoice Multianswer questions. These require the student to select all the correct answers from the set of answers. The question may or may not tell the student how many correct answers there are. For example "Which of the following were US Presidents?" does not, while "Select the two US presidents from the following list." does. The actual number of correct answers can be from one up to the number of choices. (A Multichoice Multianswer question with one correct answer is different from a Multichoice question as the former allows the student the possibility of choosing more than one answer while the latter does not.)

Again the correct answers are flagged using forward jumps, the wrong answers by same page or backward jumps. When there is more than one correct answer the jumps should all go to the same page, similarily with the wrong answers. If that is not the case a warning is given on the teacher's view of the lesson. The correct response, if required, should be given on the first correct answer and the wrong response, if required, should be on the first wrong answer. Responses on the other answers are ignored (without warning).

Here's an example, Which of the following are Mammals?
[This question uses the "default" responses]

answer[0] A Dog

answer[1] An Ant

answer[2] A Buttercup

answer[3] A Cow

== Short Answer ==

In a Short Answer question the student is prompted for a short piece of text. This is checked against one or more answers. Answers can be either correct or wrong. Each answer can optionally have a response. If no response is entered for an answer then the default reponse "That's the Correct Answer" or "That's the Wrong Answer" is shown to the student. If the text entered does not match any of the answers then the answer is wrong and the student is shown the default wrong response.

By default the comparisons ignore the case of the text. There is an option to make the comparisons case sensitive.

There is a fundemental problem with this type of question. If you ask a question like "Who wrote Elergy written in a Country Churchyard?" as a Short Answer question it's fine for the students who know the anwser. But how about those who do not? To avoid those students getting stuck in a loop the Lesson module has a "Maximum number of Attempts" parameter which sets an upper limit on the number of times a student can attempt a question. The default value is 5 times. (This can be reduced to 1 if you wanted students to have only one attempt at each question.)

There is a slight complication here . The "Maximum number of Attempts" mechanism relies on looking at the record of attempts. That is fine for students as their attempts are all recorded. However, when a teacher looks at a lesson their attempts are not recorded. (The attempts are used to calculate grades and as teachers aren't interested in their own grades...) So teachers are not subject to the number of answers limit. But they should know the answers, shouldn't they!

== True / False ==

The True/False question is a special case of the Multichoice question.The student is prompted to choose which is the correct option. With this type of question you should be able to average 50% by guessing

== Matching Questions ==

Matching questions are much more interesting than the last type of question. They can make quite powerful and flexible questions. They consist of a list of names or statements which must be correctly matched against other list of names or statements. For example "Match the Capital with the Country" with the two lists Japan, Canada, Italy and Tokyo, Ottawa, Rome. It is possible to have repeated entries in one of the lists but care should be taken to make the repeats identical. For example "Identify the type of these creatures" with the lists Sparrow, Cow, Ant, Dog and Bird, Animal, Insect, Animal.

When creating this type of question the items for the first list go into the Answer boxes and items for the second list go into the Response boxes. Once created a more sensible labelling scheme is shown. When the student successfully matches the items the jump on the first answer is used. An unsuccessful answer jumps to the page on the second answer. The question does not support custom responses, the student is told how many matches are correct or if all the matches are correct.

== Numerical Question ==

This type of question requires a number as the answer. In it's simplest form it requires just one answer to be specified. For example "What is 2 plus 2?" with the answer 4 given a forward jump. However, it is better to specify a range because the internal rounding of numerical values can make single numeric comparisons rather hit or miss. Thus, if the question were "What is 10 divided by 3" it would be necessary to give the answer as Minimum:Maximum, that is two values separated by a colon. Thus if 3.33:3.34 is given as the acceptible range for the answer, then the answers 3.33, 3.333, 3.3333... would all be taken as correct answers. "Wrong" answers would include 3.3 (less than the minimum) and 3.4 (greater than the maximum).

More than one correct answer is allowed and the answers can be either single or pair of values. Note that the order in which the answers are tested is Answer 1, Answer 2... so some care needs to taken if the desired response is to appear. For example the question "When was Larkin born?" could have the single value of 1922, the exact answer, and the pair of values 1920:1929, the 20's, as the less exact answer.The order in which these values should be tested is, obviously, 1922 then 1920:1929. The first answer might have the response "That's exactly right" while the other answer's response might be "That's close, you've got the right decade, it is was actually 1922."

Wrong answers can be given but depending on their actual range, care should be taken to place them after the correct answers. For example in adding the wrong answer 3:4 to the "10 divided by 3" question it needs to come after the correct answer. That is the answers are ordered 3.33:3.34 (the "correct" answer) then 3:4 (the "wrong" answer, but not wildly wrong answer!).

== Branch Tables ==

Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents. Each link in a branch table has two components, a description and the title of the page to jump to. A branch table effectively divides the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic).

The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceeding branch table. (The "return" jump in an End of Branch page can be changed, if required, by editing the page.)

There can be more than one branch table in a lesson. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches. (Thus the name used is Branch Table rather than Table of Contents page.)

The number of links shown when setting up or editting a branch table is set by the "Number of Answers/Branches". This parameter can be changed on the fly by simply clicking on the Update the Lesson button at the top of the teacher's page and changing the value.

It is important to give students a means of ending the lesson. This might be done by including an "End Lesson" link in the main branch table. This jumps to the (imaginary) End of Lesson page. Another option is for the last branch in the lesson (here "last" is used in the logical ordering sense) to simply continue to the end of the lesson, that is, it is not terminated by an End of Branch page.

When a lesson includes one or more branch tables it is advisable to set the "Minimum number of Questions" parameter to some reasonable value. This sets a lower limit on the number of pages seen when the grade is calculated. Without this parameter a student might visit a single branch in the lesson, answer all its questions correctly and leave the lesson with the maximum grade!

Further, when a branch table is present a student has the opportunity of re-visiting the same branch more than once. However, the grade is calculated using the number of unique questions answered. So repeatedly answering the same set of questions does not increase the grade. (In fact, the reverse is true, it lowers the grade as the count of the number of pages seen is used in the denominator when calculating grades does include repeats.) In order to give students a fair idea of their progress in the lesson, they are shown details of how many questions they are answered correctly, number of pages seen, and their current grade on every branch table page. (This is one other thing teachers don't get to see - sorry!)

Using Lesson

2005-06-20T14:18:52Z

Sylvia: /* The Flash Card Lesson */

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/mod/lesson/view.php page
(the page where the teacher views the lesson)

== The Flash Card Lesson ==

The Lesson module can 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.

In the Lesson module the cards are pages. Correct answers jump to the Next Page, wrong answers stay on the same page.

There are 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 option is "Show an unanswered page" which shows the student pages that may have appeared before but only if they answered the associated question wrongly.

When using either of these Flash Card 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 when setting up the lesson.

In fact, this type of lesson is very similar to a random ordered Quiz, the difference is that the questions are shown one page at a time. Further extra text can be included with each question.

== Types of questions available within a lesson ==

== Multichoice Questions ==

This is the default question type. Multichoice questions are popular questions where the student is asked to choose one answer from a set of alternatives. The correct answer takes the student further into the lesson, the wrong answers do not. The wrong answers are sometimes called the distractors and the utility of these questions often rely more on the quality of the distractors than either the questions themselves or their correct answers.

Each answer can optionally have a response. If no response is entered for an answer then the default reponse "That's the Correct Answer" or "That's the Wrong Answer" is shown to the student.

It is possible to have more than one correct answer to a multichoice question. The different correct answers may give the student different responses and jump to different (forward) pages in the lesson but do not vary in their grades, (that is, some answers are not more correct than others, at least in terms of grade.) It is possible for all the answers to be correct and they might take the student to different (forward) parts of the lesson depending on which one is chosen. (Although it's probably neater to use a Branch Table to accomplish this).

== Multichoice Multianswer ==

There is variant of Multichoice questions called Multichoice Multianswer questions. These require the student to select all the correct answers from the set of answers. The question may or may not tell the student how many correct answers there are. For example "Which of the following were US Presidents?" does not, while "Select the two US presidents from the following list." does. The actual number of correct answers can be from one up to the number of choices. (A Multichoice Multianswer question with one correct answer is different from a Multichoice question as the former allows the student the possibility of choosing more than one answer while the latter does not.)

Again the correct answers are flagged using forward jumps, the wrong answers by same page or backward jumps. When there is more than one correct answer the jumps should all go to the same page, similarily with the wrong answers. If that is not the case a warning is given on the teacher's view of the lesson. The correct response, if required, should be given on the first correct answer and the wrong response, if required, should be on the first wrong answer. Responses on the other answers are ignored (without warning).

Here's an example, Which of the following are Mammals?
[This question uses the "default" responses]

answer[0] A Dog

answer[1] An Ant

answer[2] A Buttercup

answer[3] A Cow

== Short Answer ==

In a Short Answer question the student is prompted for a short piece of text. This is checked against one or more answers. Answers can be either correct or wrong. Each answer can optionally have a response. If no response is entered for an answer then the default reponse "That's the Correct Answer" or "That's the Wrong Answer" is shown to the student. If the text entered does not match any of the answers then the answer is wrong and the student is shown the default wrong response.

By default the comparisons ignore the case of the text. There is an option to make the comparisons case sensitive.

There is a fundemental problem with this type of question. If you ask a question like "Who wrote Elergy written in a Country Churchyard?" as a Short Answer question it's fine for the students who know the anwser. But how about those who do not? To avoid those students getting stuck in a loop the Lesson module has a "Maximum number of Attempts" parameter which sets an upper limit on the number of times a student can attempt a question. The default value is 5 times. (This can be reduced to 1 if you wanted students to have only one attempt at each question.)

There is a slight complication here . The "Maximum number of Attempts" mechanism relies on looking at the record of attempts. That is fine for students as their attempts are all recorded. However, when a teacher looks at a lesson their attempts are not recorded. (The attempts are used to calculate grades and as teachers aren't interested in their own grades...) So teachers are not subject to the number of answers limit. But they should know the answers, shouldn't they!

== True / False ==

The True/False question is a special case of the Multichoice question.The student is prompted to choose which is the correct option. With this type of question you should be able to average 50% by guessing

== Matching Questions ==

Matching questions are much more interesting than the last type of question. They can make quite powerful and flexible questions. They consist of a list of names or statements which must be correctly matched against other list of names or statements. For example "Match the Capital with the Country" with the two lists Japan, Canada, Italy and Tokyo, Ottawa, Rome. It is possible to have repeated entries in one of the lists but care should be taken to make the repeats identical. For example "Identify the type of these creatures" with the lists Sparrow, Cow, Ant, Dog and Bird, Animal, Insect, Animal.

When creating this type of question the items for the first list go into the Answer boxes and items for the second list go into the Response boxes. Once created a more sensible labelling scheme is shown. When the student successfully matches the items the jump on the first answer is used. An unsuccessful answer jumps to the page on the second answer. The question does not support custom responses, the student is told how many matches are correct or if all the matches are correct.

== Numerical Question ==

This type of question requires a number as the answer. In it's simplest form it requires just one answer to be specified. For example "What is 2 plus 2?" with the answer 4 given a forward jump. However, it is better to specify a range because the internal rounding of numerical values can make single numeric comparisons rather hit or miss. Thus, if the question were "What is 10 divided by 3" it would be necessary to give the answer as Minimum:Maximum, that is two values separated by a colon. Thus if 3.33:3.34 is given as the acceptible range for the answer, then the answers 3.33, 3.333, 3.3333... would all be taken as correct answers. "Wrong" answers would include 3.3 (less than the minimum) and 3.4 (greater than the maximum).

More than one correct answer is allowed and the answers can be either single or pair of values. Note that the order in which the answers are tested is Answer 1, Answer 2... so some care needs to taken if the desired response is to appear. For example the question "When was Larkin born?" could have the single value of 1922, the exact answer, and the pair of values 1920:1929, the 20's, as the less exact answer.The order in which these values should be tested is, obviously, 1922 then 1920:1929. The first answer might have the response "That's exactly right" while the other answer's response might be "That's close, you've got the right decade, it is was actually 1922."

Wrong answers can be given but depending on their actual range, care should be taken to place them after the correct answers. For example in adding the wrong answer 3:4 to the "10 divided by 3" question it needs to come after the correct answer. That is the answers are ordered 3.33:3.34 (the "correct" answer) then 3:4 (the "wrong" answer, but not wildly wrong answer!).

== Branch Tables ==

Branch tables are simply pages which have a set of links to other pages in the lesson. Typically a lesson may start with a branch table which acts as a Table of Contents. Each link in a branch table has two components, a description and the title of the page to jump to. A branch table effectively divides the lesson into a number of branches (or sections). Each branch can contain a number of pages (probably all related to the same topic).

The end of a branch is usually marked by an End of Branch page. This is a special page which, by default, returns the student back to the preceeding branch table. (The "return" jump in an End of Branch page can be changed, if required, by editing the page.)

There can be more than one branch table in a lesson. For example, a lesson might usefully be structured so that specialist points are sub-branches within the main subject branches. (Thus the name used is Branch Table rather than Table of Contents page.)

The number of links shown when setting up or editting a branch table is set by the "Number of Answers/Branches". This parameter can be changed on the fly by simply clicking on the Update the Lesson button at the top of the teacher's page and changing the value.

Using Lesson

2005-06-20T13:54:50Z

Sylvia:

Lesson settings

2005-06-18T10:27:51Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/course/mod/lesson.php page
(the page where you add a lesson to a course)

On the lesson page, you can choose from a number of settings,which will make your lesson run smoothly.

Below you can see all the settings available and the description of their functions:

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 use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

'''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

'''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. In the case of questions which do not provide the answer, for example Short Answer and Numerical questions, this value provides a necessary escape routine to the next page in the lesson.

The default value is 5. Smaller values may discourage the student from thinking about the questions. Larger values may lead to more frustration.

Setting this value to one gives the students just one chance to answer each question. This gives a similar type of assignment to the Quiz module except that the questions are presented on individual pages.

Note that this value is global parameter and that it applies to all the questions in the lesson regardless of their type.

Note that this parameter 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.

'''The Minimum Number of Questions in a Lesson'''

When a lesson contains one or more Branch Tables the teacher should normally set this parameter. Its value sets a lower limit on the number of questions seen when a grade is calculated. It does not force students to answer that many questions in the lesson

For example, setting this parameter to, say, 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, say, 5 pages and answers all the associated questions correctly. They then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter were left unset 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, then the opening page of the lesson should say something like:

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

Where obviously "n" is replaced by the actual value this parameter has been given.

When this parameter is set 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.

'''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).

'''Password Protected Lesson'''

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

'''Available from / Deadline'''

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

'''Tree View'''

This will show a list of the pages and questions in the lesson as links. Pages will be in blue and questions in red. This is handy for navigating lessons with many pages.

'''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.

Lesson settings

2005-06-18T09:45:15Z

Sylvia:

'''Note for Contributors'''
This page should explain what can be seen on the moodlesite.com/course/mod/lesson.php page
(the page where you add a lesson to a course)

In the lesson page, you will have to decide the following:
the '''name''' of the lesson;
the '''maximum grade''' a student can get for doing the lesson;
the '''maximum number of branches''' a student will be required to give in the lesson(also called '''the maximum number of branches''' (you can have 20 branches maximum). You will also have to decide the following: if the lesson is '''timed''' (if you choose to time the lesson, you need to decide how much time students will have for the lesson);if students can '''retake''' the lesson or not (if you allow students to retake the lesson, you can choose one the two scoring methods: '''mean''' - average - or the max grade; AND between what dates the lesson is available to students.
Also, you can make your lesson '''a practice lesson''', which means that the lesson will not show up in the Gradebook.

'''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 in a Lesson'''
This value determines the maximum number of answers the teacher can use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

'''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.

'''The Grade of the Lesson'''
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.

'''Allowing the Students to Re-take the Lesson'''
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

'''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. In the case of questions which do not provide the answer, for example Short Answer and Numerical questions, this value provides a necessary escape routine to the next page in the lesson.

The default value is 5. Smaller values may discourage the student from thinking about the questions. Larger values may lead to more frustration.

Setting this value to one gives the students just one chance to answer each question. This gives a similar type of assignment to the Quiz module except that the questions are presented on individual pages.

Note that this value is global parameter and that it applies to all the questions in the lesson regardless of their type.

Note that this parameter 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!

'''The Minimum Number of Questions in a Lesson'''
When a lesson contains one or more Branch Tables the teacher should normally set this parameter. Its value sets a lower limit on the number of questions seen when a grade is calculated. It does not force students to answer that many questions in the lesson

For example, setting this parameter to, say, 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, say, 5 pages and answers all the associated questions correctly. They then choose to end the lesson (assuming there is that option in the "top level"Branch Table, a reasonable enough assumption). If this parameter were left unset 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, then the opening page of the lesson should say something like:

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

Where obviously "n" is replaced by the actual value this parameter has been given.

When this parameter is set students are told how many questions they have attempted and how many they are expected to attempt.

Lesson activity

2005-06-16T18:11:47Z

Sylvia:

In the lesson page, you will have to decide the following:
the '''name''' of the lesson;
the '''maximum grade''' a student can get for doing the lesson;
the '''maximum number of branches''' a student will be required to give in the lesson(also called '''the maximum number of branches''' (you can have 20 branches maximum). You will also have to decide the following: if the lesson is '''timed''' (if you choose to time the lesson, you need to decide how much time students will have for the lesson);if students can '''retake''' the lesson or not (if you allow students to retake the lesson, you can choose one the two scoring methods: '''mean''' - average - or the max grade; AND between what dates the lesson is available to students.
Also, you can make your lesson '''a practice lesson''', which means that the lesson will not show up in the Gradebook.

''The Maximum Number of Answers in a Lesson''
This value determines the maximum number of answers the teacher can use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

Lesson activity

2005-06-16T17:48:08Z

Sylvia:

In the lesson page, you type in the following information:
the '''name''' of the lesson, the '''maximum grade''' a student can get for doing the lesson, the '''maximum number of branches''' a student will be required to give in the lesson(also called '''the maximum number of branches''' (you can have 20 branches maximum). You will also have to decide the following: if the lesson is '''timed''' (if you choose to time the lesson, you need to decide how much time students will have for the lesson);if students can retake the lesson or not (if you allow students to retake the lesson, you can choose one the two scoring methods: mean - average - or the max grade; AND between what dates the lesson is available to students.
Also you can make your lesson '''a practice lesson'''

''The Maximum Number of Answers in a Lesson''
This value determines the maximum number of answers the teacher can use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

Lesson activity

2005-06-16T17:47:45Z

Sylvia:

In the lesson page, you type in the following information:
the '''name''' of the lesson, the '''maximum grade''' a student can get for doing the lesson, the '''maximum number of branches''' a student will be required to give in the lesson(also called '''the maximum number of branches''' (you can have 20 branches maximum). You will also have to decide the following: if the lesson is '''timed''' (if you choose to time the lesson, you need to decide how much time students will have for the lesson);if students can retake the lesson or not (if you allow students to retake the lesson, you can choose one the two scoring methods: mean - average - or the max grade; AND between what dates the lesson is available to students.
Also you can make your lesson '''a practice lesson'''
''The Maximum Number of Answers in a Lesson''
This value determines the maximum number of answers the teacher can use. The default value is 4. If the lesson uses only, say, TRUE or FALSE questions throughout then it is sensible to set this value to 2.

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

It is safe to change the value of this parameter in a lesson with existing content. In fact if you want to add a question with many choices or a long Branch table changing this parameter will be necessary. After the (unusual) question or BranchTable has been added this parameter can be reduced to a more "standard" value.

Lesson activity

2005-06-16T17:34:06Z

Sylvia:

In the lesson page, you type in the following information:
the '''name''' of the lesson, the '''maximum grade''' a student can get for doing the lesson, the '''maximum number of answers''' a student will be rquired to give in the lesson(also called '''the maximum number of branches''' (you can have 20 branches maximum). You will also have to decide the following: if the lesson is '''timed''' (if you choose to time the lesson, you need to decide how much time students will have for the lesson);if students can retake the lesson or not (if you allow students to retake the lesson, you can choose one the two scoring methods: mean - average - or the max grade; AND between what dates the lesson is available to students.

Lesson activity

2005-06-16T17:17:16Z

Sylvia:

In the lesson page, you type in the following information:
the '''name''' of the lesson, the '''maximum grade''' a student can get for doing the lesson, the '''maximum number of answers''' a student will be rquired to give in the lesson. You will also have to decide the following: if students can retake the lesson or not AND between what dates the lesson is available to students.

Lesson activity

2005-06-16T17:16:50Z

Sylvia:

In the lesson page, you type in the following information:
the '''name'''of the lesson, the '''maximum grade'''a student can get for doing the lesson, the '''maximum number of answers''' a student will be rquired to give in the lesson. You will also have to decide the following: if students can retake the lesson or not AND between what dates the lesson is available to students.

Lesson activity

2005-06-16T17:15:59Z

Sylvia:

In the lesson page, you type in teh following information:
the '''name'''of the lesson, the '''maximum grade'''a student can get for doing the lesson, the '''maximum number of naswers'''a student will be rquired to give in the lesson. You will also have to decide the following: if students can retake the lesson or not AND between what dates the lesson is available to students.