Lesson settings: Difference between revisions

Latest revision as of 14:52, 25 April 2012

This page explains the settings involved when first creating a lesson. To add a lesson to your Moodle course page:

As an editing teacher for a course, click "Turn Editing On", and go to the topic or week section in which you want to create the Lesson.
From the dropdown menu labeled "Add an activity", select "Lesson". This will take you to the Lesson settings page titled "Adding a new Lesson" page.

Lesson administration settings

General

Note: Click the "Show Advanced" button to the right if you don't see all the options below.

Name

The name you add here will be the link the students click on to get to your Lesson.

Time limit

This allows you to set a time limit on the lesson. Students will see a count down counter as they work.The timer does not stop them doing the the lesson when the time is up, but correct answers are no longer scored.

Available from/Deadline

Here you can set a start and end date and time for your Lesson.

Maximum Number of Answers

Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.

Password protected

Change to "Yes" and enter the password if you want students only to access it when they know the password.

Grade

Set a grade and grade category here.

Grade options

Practice lesson

Use this if you don't need the lesson to be scored/graded but just need students to work through some pages.

Custom Scoring

Use this to give a particular number score (negative or positive) to each answer

Re-takes allowed

Choose this if you want your students to be able to do the lesson more than once.

Handling of re-takes

If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.

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

Display ongoing score

Choose this to let students see their score as they work through the lesson.

Flow Control

Note: Click the "Show Advanced" toggle button to the right if you don't see all the options below.
Using Lesson gives examples of how these settings may be put to best effect.

Allow Student Review

This puts a "Review Lesson" button on the last screen of the lesson to encourage the student to navigate through the lesson again from the start. Be sure to check other settings to allow them to change their answers.

Provide option to try a question again

This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)

TIP: Leave this off if you are using essay questions.

Maximum Number of Attempts

Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.

Action after a Correct Answer

Choose here where you want a student to be sent to if they get a question right. See Using Lesson for more details on this setting. The options are:
- the next part of the Lesson (default setting)
- a random, unexpected page
- a random page which they have not yet answered.

Display default feedback

Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.

Progress bar

Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.

*Note: There are currently some issues with the lesson progress bar not displaying as expected. MDL-26016

Display left menu

Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.

Display left menu only if grade greater than ...%

Choose this if you want the student to go through the lesson (and get a grade) once and then, on review, to be able to see and navigate through all the different pages.

Number of pages to show

You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen.

Minimum Number of Questions

Set here the minimum number of questions that will be used to calculate a student's score.Students will be told how many they have answered and how many more they need to answer.
If you are using Content pages, then set this to 0.
If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.

Slideshow

Choose this if you want your Lesson displayed as a slideshow with fixed width, height and custom background colour. The administrator sets the defaults for these in Settings>Site Administration>Plugins>Activity modules>Lesson.

Link to an activity

Choose this to give students a link to another activity when they reach the end of the lesson. (Note: this can also be achieved using Conditional activities)

Pop-up to file or web page

If you want to include a link to a file on the lesson page for students to refer to, upload it here.

Dependent on

This allows access to the lesson to be dependent on students' performance in another lesson in the same course. (Note: this can also be achieved with Conditional activities)

Other settings

There are the usual Common module settings and - if admin has enabled them - the Restrict access settings and Activity Completion settings in Conditional activities.

Site administration settings

The lesson module has additional settings which may be changed by an administrator in Settings > Site administration > Plugins > Activity modules > Lesson.

Slideshow width

Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".

Variable name: lesson_slideshowwidth, Default 640.

Slideshow height

Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".

Variable name: lesson_slideshowheight, Default 480.

Slideshow background colour

Background colour to for the slideshow if it is enabled.

Variable name: lesson_slideshowbgcolor, Default #FFFFFF.

Popup window width

Sets the width of the popup displayed for a linked media file

Variable name: lesson_mediawidth, Default 640.

Popup window height

Sets the height of the popup displayed for a linked media file

Variable name: lesson_mediaheight, Default 480.

Show close button:

Displays a close button as part of the popup generated for a linked media file

Variable name: lesson_mediaclose, Default No.

Number of high scores displayed

Sets the number of high scores to display

Variable name: lesson_maxhighscores, Default: 10

Maximum number of answers

Default maximum number of answers per page for site

Variable name: lesson_maxanswers, Default: 4.

Action after correct answer

The default action to take after a correct answer

Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path

@@ Line 1: / Line 1: @@
- '''Note for Contributors'''
+{{Lesson}}
- This page should explain what can be seen on the <u>moodlesite.com/course/mod/lesson.php</u> page
- (the page where you add a lesson to a course)
-In the lesson page, you will have to decide the following:
+This page explains the settings involved when first creating a lesson.
-the '''name''' of the lesson;
+To add a lesson to your Moodle course page:
-the '''maximum grade''' a student can get for doing the lesson;
+*As an editing teacher for a course, click "Turn Editing On", and go to the topic or week section in which you want to create 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.
+*From the dropdown menu labeled "Add an activity", select "Lesson". This will take you to the Lesson settings page titled "Adding a new Lesson" page.
-Also, you can make your lesson '''a practice lesson''', which means that the lesson will not show up in the Gradebook.
-'''Timed'''
+==Lesson administration settings==
-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.
+===General===
+*''Note: Click the "Show  Advanced"  button to the right if you don't see all the options below.''
+====Name====
+*The name you add here will be the link the students click on to get to your Lesson.
+====Time limit====
+[[Image:Lesson Timer.png|right]]
+*This allows you to set a time limit on the lesson. Students will see a count down counter as they work.The timer does not stop them doing the the lesson when the time is up, but  correct answers are no longer scored.
+====Available from/Deadline====
+*Here you can set a start and end date and time for your Lesson.
+====Maximum Number of Answers====
+*Here you can set the default number of answer boxes available when you add your question or content pages. For instance, if you are only going to use True/False, you would only need 2. You can change this at any time so it's not crucial.
-'''The Maximum Number of Answers in a Lesson'''
+====Password protected====
-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.
+*Change to "Yes"  and enter the password if you want students only to access it when they know the password.
-This parameter also sets the maximum number of Branches that can be used in a Branch Table.
+===Grade===
+*Set a grade and grade category here.
-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.
+===Grade options===
+====Practice lesson====
+*Use this if you don't need the lesson to be scored/graded but just need students to work through some pages.
-'''Custom Scoring'''
+====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.
+*Use this to give a particular number score (negative or positive) to each answer
-'''The Grade of the Lesson'''
+====Re-takes allowed====
-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.
+*Choose this if you want your students to be able to do the lesson more than once.
-'''Allowing the Students to Re-take the Lesson'''
+====Handling of re-takes====
-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.
+*If you allow your students to re-take the lesson, then decide here if the grade for all lesson attempts is the mean or the maximum.
-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. Re-takes by students are ignored.
-Note that the Question Analysis always uses the answers from the first tries of the lesson, subsequent re-takes by students are ignored.
+====Display ongoing score====
+*Choose this to let students see their score as they work through the lesson.
-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.
+===Flow Control===
-'''Handling of Re-takes'''
+*''Note: Click the "Show  Advanced" toggle button to the right if you don't see all the options below.''
-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.
+*[[Using Lesson]] gives examples of how these settings may be put to best effect.
+====Allow Student Review====
+*This puts a "Review Lesson" button on the last screen of the lesson to encourage the student to navigate through the lesson again from the start.  Be sure to check other settings to allow them to change their answers.
-This option can be changed at any time.
+====Provide option to try a question again====
+*This displays a button after an incorrectly answered question so that the student can try again (but not get credit for it)
-'''Display ongoing score'''
+:''TIP:'' Leave this off if you are using essay questions.
-under construction
+====Maximum Number of Attempts====
+*Decide here how many times you want students to be able to attempt each question. When they reach the maximum, they will be taken automatically to the next page.
-'''Allow Student Review'''
+====Action after a Correct Answer====
-This will let the student navigate back through the lesson to change their answers.
+*Choose here where you want a student to be sent to if they get a question right. See [[Using Lesson]] for more details on this setting. The options are:
+**the next part of the Lesson (default setting)
+**a random, unexpected page
+**a random page which they have not yet answered.
-'''Display Review Button'''
+====Display default feedback====
-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.
+*Choose this if you want to show a set phrase regardless of their answer. If you have set your own default feedback such as "well done; correct" or "never mind; better luck next time" etc it will appear. If you have not, then Moodle's default feedback will appear.
+====Progress bar====
+*Choose this to show a bar at the bottom of the page showing how far into the lesson the student has got.
+''*Note: There are currently some issues with the lesson progress bar not displaying as expected. MDL-26016''
-'''The Maximum Number of Attempts (by a Student)'''
+====Display left menu====
-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.
+*Choose this if you want to show a list of the pages in the Lesson so a student can see what is coming up.
+====Display left menu only if grade greater than ...%====
+*Choose this if you want the student to go through the lesson (and get a grade) once and then, on review, to be able to see and navigate through all the different pages.
+====Number of pages to show====
+*You only need this if you have set "Action after a correct answer" to show an unseen or unanswered page. Otherwise, all pages will be seen.
+====Minimum Number of Questions====
+*Set here the minimum number of questions that will be used to calculate a student's score.Students will  be told how many they have answered and how many more they need to answer.
+*If you are using Content pages, then set this to 0.
+*If you use this setting, then add some explanatory text at the start of the lesson so the student knows how many questions they must answer as a minimum. (They may answer more.
+====Slideshow====
+*Choose this if you want your Lesson displayed as a slideshow with fixed width, height and custom background colour. The administrator sets the defaults for these in ''Settings>Site Administration>Plugins>Activity modules>Lesson.''
-The default value is 5. Smaller values may discourage the student from thinking about the questions. Larger values may lead to more frustration.
+====Link to an activity====
+*Choose this to give students a link to another activity when they reach the end of the lesson. ''(Note: this can also be achieved using [[Conditional activities]])''
-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.
+===Pop-up to file or web page===
+*If you want to include a link to a file on the lesson page for students to refer to, upload it here.
-Note that this value is global parameter and that it applies to all the questions in the lesson regardless of their type.
+===Dependent on===
+*This allows access to the lesson to be dependent on students' performance in another lesson in the same course. ''(Note: this can also be achieved with [[Conditional activities]])''
-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!
+==Other settings==
+There are the usual [[Common module settings]] and  - if admin has enabled them - the Restrict access settings and Activity Completion settings in  [[Conditional activities]].
-'''The Minimum Number of Questions in a Lesson'''
+==Site administration settings==
-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%.
+The lesson module has additional settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Activity modules > Lesson''.
-If this parameter is used, then the opening page of the lesson should say something like:
+===Slideshow width===
+Sets the width of the slideshow only when this feature is enabled in a Lesson's "Change settings".
+*Variable name: lesson_slideshowwidth, Default 640.
+===Slideshow height===
+Sets the height of the slideshow only when this feature is enabled in a Lesson's "Change settings".
+*Variable name: lesson_slideshowheight, Default 480.
-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.
+===Slideshow background colour===
+Background colour to for the slideshow if it is enabled.
+*Variable name: lesson_slideshowbgcolor, Default #FFFFFF.
-Where obviously "n" is replaced by the actual value this parameter has been given.
+===Popup window width===
+Sets the width of the popup displayed for a linked media file
+*Variable name: lesson_mediawidth, Default 640.
-When this parameter is set students are told how many questions they have attempted and how many they are expected to attempt.
+===Popup window  height===
+Sets the height of the popup displayed for a linked media file
+*Variable name: lesson_mediaheight, Default 480.
+===Show close button:===
+Displays a close button as part of the popup generated for a linked media file
+*Variable name: lesson_mediaclose, Default No.
+===Number of high scores displayed===
+Sets the number of high scores to display
+*Variable name: lesson_maxhighscores, Default: 10
+===Maximum number of answers===
+Default maximum number of answers per page for site
+*Variable name: lesson_maxanswers, Default: 4.
+===Action after correct answer===
+The default action to take after a correct answer
+*Variable name: lesson_defaultnextpage, Default: Normal - follow lesson path
+==See also==
+[[de:Lektion konfigurieren]]
+[[fr:Ajouter/modifier une leçon]]

Documentation