Adding the Lesson module to the main CVS. Nice job Ray!

Still needs PostgreSQL support and wider testing
This commit is contained in:
moodler 2004-02-16 05:41:13 +00:00
parent fd9521f6d4
commit bbcbc0fecc
18 changed files with 2370 additions and 0 deletions

View file

@ -0,0 +1,7 @@
<p align="center"><b>The Grade of the Lesson</b></p>
<p>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.</p>

View file

@ -0,0 +1,13 @@
<p align="center"><b>The Jump-to Link</b></p>
<p>Each answer has a Jump-to link. When this answer is chosen, the answer's response
is shown to the student. Atfer that the student sees the page given in the Jump-to
link. This link can be either relative or absolute. Relative links are <b>This
page</b> and <b>Next page</b>. <b>This page</b> means that the student sees the
current page again. <b>Next page</b> shows the page which follows this page in the
logical order of pages. An absolute page link is specified by choosing the page's
<b>title</b>.</p>
<p>Note that a (relative) <b>Next page</b> Jump-to link may show a different page
after pages have been moved. Whereas Jump-to links which use page <b>titles</b>
always show the same page after pages have been moved.</p>

View file

@ -0,0 +1,7 @@
<p align="center"><b>The Maximum Number of Answers in a Lesson</b></p>
<p>This value determines the maximum number of answers the teacher can use.
The default value is 4. If the lesson uses only TRUE or FALSE
questions throughout then it is sensible to set this value to 2.</p>
<p>It is safe to change this value in a lesson with existing content.</p>

View file

@ -0,0 +1,11 @@
<IMG VALIGN=absmiddle SRC="<?php echo $CFG->wwwroot?>/mod/lesson/icon.gif">&nbsp;<B>Lesson</B>
<UL>
<P>A lesson delivers content in an interesting and flexible way. It consists of a
number of pages. Each page normally ends with a question and a number of
possible answers. Depending on the student's choice of answer they either
progress to the next page or are taken back to a previous page. Navigation
through the lesson can be straight forward or complex, depending largely
on the structure of the material being presented.</p>
</UL>

View file

@ -0,0 +1,55 @@
<p align="center"><b>Overview</b></p>
<ol>
<li>A lesson is made up of a number of <b>pages</b>.
<li>A page contains some <b>content</b> and it normally ends with a <b>question</b>.
<li>Each page normally has a set of <b>answers</b>.
<li>Each answer can have a short piece of text which is displayed if the answer is
chosen. This piece of text is called the <b>response</b>.
<li>Also associated with each answer is a <b>jump</b>. The jump can be relative -
this page, next page - or absolute - specifying any one of the pages in the
lesson or the end of the lesson.
<li>By default, the first answer jumps to the <b>next page</b> in the lesson.
The subsequent answers jump to the same page. That is, the student is shown
the same page of the lesson again if they do not chose the first answer.
<li>The next page is determined by the lesson's <b>logical order</b>. This is
the order of the pages as seen by the teacher. This order can be altered
by moving pages within the lesson.
<li>The lesson also has a <b>navigation order</b>. This is the order of the
pages as seen by the students. This is determined by the jumps specified
for individual answers and it can be very different from the logical order.
(Although if the jumps are <i>not</i> changed from their default values
the two are strongly related.) The teacher has the option to check the
navigation order.
<li>When displayed to the students, the answers are always shuffled. That is, the
first answer from the teacher's point of view will not necessarily be the
first answer in the list shown to the students. (Further, each time the same
set of answers is displayed they are likely to appear in a different order.)
<li>The number of answers can vary from page to page. For example, it is allowed
that some pages can end with a true/false question while others have questions
with one correct answer and three, say, distractors.
<li>It is possible to set up a page without any answers. The students are shown
a <b>Continue</b> link instead of the set of shuffled answers.
<li>For the purposes of grading the lessons, <b>correct</b> answers are ones which
jump to a page which is further <i>down</i> the logical order than the current page.
<b>Wrong</b> answers are ones which either jump to the same page or to a page
further <i>up</i> the logical order than the current page. Thus, if the jumps are
<i>not</i> changed, the first answer is a correct answer and the other answers are
wrong answers.
<li>Questions can have more than one correct answer. For example, if two of the answers
jump to the next page then either answer is taken as a correct answer. (Although
the same destination page is shown to the students, the responses shown on the way
to that page may well be different for the two answers.)
<li>In the teacher's view of the lesson the correct answers have underlined Answer
Labels.
<li>The <b>end of the lesson</b> is reached by either jumping to that location explicitly
or by jumping to the next page from the last (logical) page of the lesson. When the
end of the lesson is reached, the student receives a congratulations message and is
shown their grade. The grade is (the number of correct answers checked / number of
pages seen) * the grade of the lesson.
<li>If the end of the lesson is <i>not</i> reached, when the student goes into the
lesson they are given the choice of starting at the begining or picking up the lesson
where they answered their last correct answer.
<li> For a lesson which allow re-takes, students are allowed to re-take the lesson until
they have achieved the maximum grade.
</ol>

View file

@ -0,0 +1,16 @@
<p align="center"><b>Allowing the Students to Re-take the Lesson</b></p>
<p>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 throughly. In which case repeated viewings 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.</p>
<p>When the students are allowed to re-take the lesson, the <b>grades</b> shown
in the Grades page are the grades from their <b>best</b> attempts of the lesson.
However, the <b>Question Analysis</b> always uses the answers from the
first attempts of the lesson, subsequent attempts are ignored.</p>
<p>By default this option is <b>Yes</b>, meaning that students are allowed to re-take
the lesson. It is expected that only in exceptional circumstances will this
option be set to <b>No</b>.

39
lang/en/lesson.php Normal file
View file

@ -0,0 +1,39 @@
<?PHP // $Id$
// lesson.php - created with Moodle 1.2 development (2003111400)
$string['addanewpage'] = "Add a new page";
$string['addpagehere'] = "Add page Here";
$string['answer'] = "Answer";
$string['attempt'] = "Attempt: \$a";
$string['attempts'] = "Attempts";
$string['available'] = "Available from";
$string['canretake'] = "\$a can re-take";
$string['checknavigation'] = "Check navigation";
$string['confirmdeletionofthispage'] = "Confirm deletion of this page";
$string['congratulations'] = "Congratulations - end of lesson reached";
$string['deadline'] = "Deadline";
$string['deletingpage'] = "Deleting page: \$a";
$string['displayofgrade'] = "Display of grade (for student)";
$string['endoflesson'] = "End of lesson";
$string['gradeis'] = "Grade is \$a";
$string['jumpto'] = "Jump to";
$string['maximumnumberofanswers'] = "Maximum number of answers";
$string['modulename'] = "Lesson";
$string['modulenameplural'] = "Lessons";
$string['moving'] = "Moving page: \$a";
$string['nextpage'] = "Next page";
$string['noanswer'] = "No answer given";
$string['numberofcorrectanswers'] = "Number of correct answers: \$a";
$string['numberofpagesviewed'] = "Number of pages viewed: \$a";
$string['outof'] = "Out of \$a";
$string['page'] = "Page: \$a";
$string['pagecontents'] = "Page contents";
$string['pagetitle'] = "Page title";
$string['pleasecheckoneanswer'] = "Please check one answer";
$string['response'] = "Response";
$string['savepage'] = "Save page";
$string['thispage'] = "This page";
$string['youhaveseen'] = "You have seen more than one page of this lesson already.<br />Do you want to start at the last page you saw?";
?>