From cdf4e4066876e7072566118f2d7a38b3de39c075 Mon Sep 17 00:00:00 2001 From: gbateson Date: Fri, 16 Sep 2005 07:57:56 +0000 Subject: [PATCH] some changes to hellp files for HotPot v2.1 --- lang/en/help/hotpot/addquizchain.html | 16 ++ lang/en/help/hotpot/analysistable.html | 28 +- lang/en/help/hotpot/forceplugins.html | 31 ++- lang/en/help/hotpot/index.html | 17 +- lang/en/help/hotpot/mediaplayers.html | 72 ++--- lang/en/help/hotpot/mods.html | 12 +- lang/en/help/hotpot/navigation.html | 178 ++++++------ lang/en/help/hotpot/outputformat.html | 126 ++++----- lang/en/help/hotpot/reportcontent.html | 105 +++++++ lang/en/help/hotpot/reportformat.html | 61 ++++ lang/en/help/hotpot/reportselector.html | 336 +++++++++++------------ lang/en/help/hotpot/responsestable.html | 82 +++--- lang/en/help/hotpot/studentfeedback.html | 39 +++ lang/en/help/hotpot/updatequizchain.html | 12 + 14 files changed, 696 insertions(+), 419 deletions(-) create mode 100644 lang/en/help/hotpot/addquizchain.html create mode 100644 lang/en/help/hotpot/reportcontent.html create mode 100644 lang/en/help/hotpot/reportformat.html create mode 100644 lang/en/help/hotpot/studentfeedback.html create mode 100644 lang/en/help/hotpot/updatequizchain.html diff --git a/lang/en/help/hotpot/addquizchain.html b/lang/en/help/hotpot/addquizchain.html new file mode 100644 index 00000000000..8d8dc0780b6 --- /dev/null +++ b/lang/en/help/hotpot/addquizchain.html @@ -0,0 +1,16 @@ +

Add quiz chain

+
+
No
+
Only one quiz will be added to the course
+
+
+
Yes
+
+ If the "File name" is a file, it is treated as the start of a chain + of Hot Potatoes quizzes and all quizzes in the chain will be added to the course + with identical settings.
+
+ If the "File name" is a folder, all Hot Potatoes quizzes in the folder + will be added to the course as a chain of quizzes with identical settings. +
+
diff --git a/lang/en/help/hotpot/analysistable.html b/lang/en/help/hotpot/analysistable.html index 71dadf35020..57112ecff3a 100644 --- a/lang/en/help/hotpot/analysistable.html +++ b/lang/en/help/hotpot/analysistable.html @@ -1,14 +1,14 @@ -

Item Response Analysis

- -

This table lists the responses to each question and the frequency of each response.

- - - - +

Item Response Analysis

+ +

This table lists the responses to each question and the frequency of each response.

+ + + + diff --git a/lang/en/help/hotpot/forceplugins.html b/lang/en/help/hotpot/forceplugins.html index be89594d25a..dd897195c9d 100644 --- a/lang/en/help/hotpot/forceplugins.html +++ b/lang/en/help/hotpot/forceplugins.html @@ -1 +1,30 @@ -

Force Moodle to use Moodle-compatible media players

No
Moodle will not change the settings of any media players in the quiz
Yes
Moodle will force the quiz to use Moodle-compatible media players to play files like:
  • avi
  • mpeg
  • mpg
  • mp3
  • mov
  • wmv

More information: Relative URLs, media players and Hot Potatoes

\ No newline at end of file +

Force Moodle to use Moodle-compatible media players

+ +
+ +
No
+ +
Moodle will not change the settings of any media players in the quiz
+ +
+ +
+ +
Yes
+ +
Moodle will force the quiz to use Moodle-compatible media players + + to play files like: + +
  • avi
  • mpeg
  • mpg
  • mp3
  • mov
  • wmv
+ +
+ +

+ + More information: + + Relative URLs, media players and Hot Potatoes + +

+ diff --git a/lang/en/help/hotpot/index.html b/lang/en/help/hotpot/index.html index 3dada99b477..0ad6eccf5fd 100644 --- a/lang/en/help/hotpot/index.html +++ b/lang/en/help/hotpot/index.html @@ -1 +1,16 @@ -

Hot Potatoes

\ No newline at end of file +

Hot Potatoes

+ + diff --git a/lang/en/help/hotpot/mediaplayers.html b/lang/en/help/hotpot/mediaplayers.html index 85e0fc44bc5..01aeb8d6142 100644 --- a/lang/en/help/hotpot/mediaplayers.html +++ b/lang/en/help/hotpot/mediaplayers.html @@ -1,36 +1,36 @@ -

- - Relative URLs, media players and Hot Potatoes

- -

Definitions

- -
- -
URL
- -
the address of an internet resource, such as a webpage, image or sound file.
- -
absolute URL
- -
a URL that begins with "http://" is called an absolute URL. Wherever it is used, it always refers to the same target resource.
- -
relative URL
- -
a URL that does not begin with "http://" is called a relative URL. It can be combined with the absolute URL of a "base" page, to get the absolute URL of the target resource.
- -
- -

Relative URLs in Hot Potatoes quizzes

- -

Relative URLs are a convenient way to specify images, sounds and videos in a Hot Potatoes quiz, because they allow the quiz to be viewed and tested on a local PC, before being uploaded to a Moodle site. When the quiz is uploaded to the Moodle site, the multimedia files must also be uploaded, so that they are available when the quiz is administered via Moodle.

- -

For security reasons, Moodle does not allow direct access to course files. All requests for files in a given course go through a guardian script which verfies that the person requesting the file is enrolled in the course. However, this mechanism can break relative links used in the quiz, because the normal rules for deriving an absolute URL from a relative URL do not work.

- -

The solution is simple enough: all relative URLs must be converted to absolute URLs by the time the quiz reaches the browser. In the case of Hot Potatoes quizzes, the URLs will be converted by Moodle, so content creators do not have to bother with this tedious and error-prone task.

- -

Media players in Hot Potatoes quizzes

- -

Some media players will not accept the media file if it comes via the script which guards the course files. In this situation, it is necessary to replace the media player with one that is known to be compatible with Moodle. You can do this yourself by modifying the reference to the media player in the quiz, or you can force Moodle to do it by setting the "Force media plugins" option on the quiz's settings page to "Yes".

- - - +

+ + Relative URLs, media players and Hot Potatoes

+ +

Definitions

+ +
+ +
URL
+ +
the address of an internet resource, such as a webpage, image or sound file.
+ +
absolute URL
+ +
a URL that begins with "http://" is called an absolute URL. Wherever it is used, it always refers to the same target resource.
+ +
relative URL
+ +
a URL that does not begin with "http://" is called a relative URL. It can be combined with the absolute URL of a "base" page, to get the absolute URL of the target resource.
+ +
+ +

Relative URLs in Hot Potatoes quizzes

+ +

Relative URLs are a convenient way to specify images, sounds and videos in a Hot Potatoes quiz, because they allow the quiz to be viewed and tested on a local PC, before being uploaded to a Moodle site. When the quiz is uploaded to the Moodle site, the multimedia files must also be uploaded, so that they are available when the quiz is administered via Moodle.

+ +

For security reasons, Moodle does not allow direct access to course files. All requests for files in a given course go through a guardian script which verfies that the person requesting the file is enrolled in the course. However, this mechanism can break relative links used in the quiz, because the normal rules for deriving an absolute URL from a relative URL do not work.

+ +

The solution is simple enough: all relative URLs must be converted to absolute URLs by the time the quiz reaches the browser. In the case of Hot Potatoes quizzes, the URLs will be converted by Moodle, so content creators do not have to bother with this tedious and error-prone task.

+ +

Media players in Hot Potatoes quizzes

+ +

Some media players will not accept the media file if it comes via the script which guards the course files. In this situation, it is necessary to replace the media player with one that is known to be compatible with Moodle. You can do this yourself by modifying the reference to the media player in the quiz, or you can force Moodle to do it by setting the "Force media plugins" option on the quiz's settings page to "Yes".

+ + + diff --git a/lang/en/help/hotpot/mods.html b/lang/en/help/hotpot/mods.html index 426f8bb67b3..43c7b75eed5 100644 --- a/lang/en/help/hotpot/mods.html +++ b/lang/en/help/hotpot/mods.html @@ -1,6 +1,6 @@ -

 Hot Potatoes

-
-This module, the "HotPot" module, allows teachers to administer Hot Potatoes quizzes via Moodle. The quizzes are created on the teacher's computer and then uploaded to the Moodle course. - -
After students have attempted the quizzes, a number of reports are available which show how individual questions were answered and some statistical trends in the scores. -
+

 Hot Potatoes

+
+This module, the "HotPot" module, allows teachers to administer Hot Potatoes quizzes via Moodle. The quizzes are created on the teacher's computer and then uploaded to the Moodle course. + +
After students have attempted the quizzes, a number of reports are available which show how individual questions were answered and some statistical trends in the scores. +
diff --git a/lang/en/help/hotpot/navigation.html b/lang/en/help/hotpot/navigation.html index 6363a12c6b8..d56fc610747 100644 --- a/lang/en/help/hotpot/navigation.html +++ b/lang/en/help/hotpot/navigation.html @@ -1,89 +1,89 @@ -

Navigation

- -

- You can specify different navigation aids for a Hot Potatoes Quiz. -

- -
- -
Moodle navigation bar
- -
- - The standard Moodle navigation bar will be displayed in the same - - window as the quiz at the top of the page.
- -
- - - -
Moodle navigation frame
- -
- - The standard Moodle navigation bar will be displayed in a separate - - frame at the top of the quiz. - -
- - - -
Embedded <IFRAME>
- -
- - The standard Moodle navigation bar will be displayed in the same - - window as the quiz and the quiz will be embedded in an <IFRAME>. - -
- - - -
Hot Potatoes quiz buttons
- -
- - The quiz will be displayed with the navigation buttons, if any, - - defined in the quiz. - -
- - - -
A single "Give Up" button
- -
- - The quiz will be displayed with a single "Give Up" button - - at the top of the page. - -
- - - -
None
- -
- - The quiz will be displayed with no navigation aids. i.e. neither - - a Moodle navigation bar nor any Hot Potatoes navigation buttons. - - - - When all questions on the current quiz have been answered correctly, - - Moodle will either return to the course page or display the next quiz, - - depending on the setting of the "Show next quiz?" field - - for the current quiz. - -
- -
+

Navigation

+ +

+ You can specify different navigation aids for a Hot Potatoes Quiz. +

+ +
+ +
Moodle navigation bar
+ +
+ + The standard Moodle navigation bar will be displayed in the same + + window as the quiz at the top of the page.
+ +
+ + + +
Moodle navigation frame
+ +
+ + The standard Moodle navigation bar will be displayed in a separate + + frame at the top of the quiz. + +
+ + + +
Embedded <IFRAME>
+ +
+ + The standard Moodle navigation bar will be displayed in the same + + window as the quiz and the quiz will be embedded in an <IFRAME>. + +
+ + + +
Hot Potatoes quiz buttons
+ +
+ + The quiz will be displayed with the navigation buttons, if any, + + defined in the quiz. + +
+ + + +
A single "Give Up" button
+ +
+ + The quiz will be displayed with a single "Give Up" button + + at the top of the page. + +
+ + + +
None
+ +
+ + The quiz will be displayed with no navigation aids. i.e. neither + + a Moodle navigation bar nor any Hot Potatoes navigation buttons. + + + + When all questions on the current quiz have been answered correctly, + + Moodle will either return to the course page or display the next quiz, + + depending on the setting of the "Show next quiz?" field + + for the current quiz. + +
+ +
diff --git a/lang/en/help/hotpot/outputformat.html b/lang/en/help/hotpot/outputformat.html index 17fdd30906c..d34296436a8 100644 --- a/lang/en/help/hotpot/outputformat.html +++ b/lang/en/help/hotpot/outputformat.html @@ -1,63 +1,63 @@ -

Output Format

- -

- - You can specify different formats to display the quiz - -

- -
- -
best
- -
The quiz will be displayed in the best format for the browser.
- - - -
v6+
- -
The quiz will be displayed in a drag and drop format for v6+ browsers
- - - -
v6
- -
The quiz will be displayed in format for v6 browsers
- - - -
v5
- -
The quiz will be displayed in a format for v5 browsers
- - - -
v4
- -
The quiz will be displayed in a format for v4 browsers
- - - -
v3
- -
The quiz will be displayed in a format for v3 browsers
- - - -
Flash
- -
The quiz will be displayed in using Flash
- - - -
mobile
- -
- - The quiz will be displayed in a format suitable for viewing on - - small mobile devices such as cell phones - -
- -
+

Output Format

+ +

+ + You can specify different formats to display the quiz + +

+ +
+ +
best
+ +
The quiz will be displayed in the best format for the browser.
+ + + +
v6+
+ +
The quiz will be displayed in a drag and drop format for v6+ browsers
+ + + +
v6
+ +
The quiz will be displayed in format for v6 browsers
+ + + +
v5
+ +
The quiz will be displayed in a format for v5 browsers
+ + + +
v4
+ +
The quiz will be displayed in a format for v4 browsers
+ + + +
v3
+ +
The quiz will be displayed in a format for v3 browsers
+ + + +
Flash
+ +
The quiz will be displayed in using Flash
+ + + +
mobile
+ +
+ + The quiz will be displayed in a format suitable for viewing on + + small mobile devices such as cell phones + +
+ +
diff --git a/lang/en/help/hotpot/reportcontent.html b/lang/en/help/hotpot/reportcontent.html new file mode 100644 index 00000000000..5bd1eb9b4a6 --- /dev/null +++ b/lang/en/help/hotpot/reportcontent.html @@ -0,0 +1,105 @@ + +

+ Report Content +

+

+ You can specify different content for the Hot Potatoes reports. +

+
+
Selecting the type of report
+
Overview
+ This report is a list of attempts at this quiz. + "abandoned" attempts are included, + but "in progress" attempts are not shown. + + It shows the picture and name of each user, along with their + grade for the quiz and the score, time and duration of each attempt. + + Attempts may be selected and then deleted if required. +
+
Simple statistics
+ This report is a list of all completed attempts at this quiz. + + Attempts marked as "abandoned" or + "in progress" are not included. + + It shows the picture and name of each user, along with their + grade for the quiz, and the score of each question in each attempt. + + It also gives the average scores of the individual + questions and the quiz as a whole. +
+
Detailed statistics
+ This report shows full details of all completed attempts at this quiz, + + Attempts marked as "abandoned" or + "in progress" are not included. + + The report contains the following tables: +
    +
  • + the responses table, which shows how each user responded + to each question in each of their attempts at the quiz. +
    • +
  • + the item analysis table, which lists the responses to each + question and the frequency of each response. +
    • +
+
+ +
Click trail report
+ This report shows details of every click by every student during completed attempts at the Hot Potatoes quiz. + The report can be very large and is intended to be downloaded and viewed in a spreadsheet program, such as Microsoft Excel. + Details of the columns in this report are available in the + click trail table + help file +
+
+
+
Selecting a course
+ +
This course
+ The report will show responses by participants in the current course +
+ +
All my courses
+ The report will show responses by participants for all courses which + use this quiz and in which you are a teacher. + To be used in several courses, the quiz must be located in the Site + files directory. + This option is only available to site administrators. +
+
+
+
Selecting users
+ +
Students
+ The report will show responses by students taking this course. + Teacher's responses will not be included in the report +
+ +
All participants
+ The report will show responses by students, teachers, course creators and administrators. + Responses by the "guest" user, if any, will also be included. +
+
+
+
Selecting grades
+ +
All attempts
+ The report will include the responses from all the attempts by each user
+ +
Best attempt
+ The report will only include the responses from the highest scoring attempt by each user
+ +
First attempt
+ The report will only include the responses from the first attempt by each user
+ +
Last attempt
+ The report will only include the responses from the most recent attempt by each user
+
diff --git a/lang/en/help/hotpot/reportformat.html b/lang/en/help/hotpot/reportformat.html new file mode 100644 index 00000000000..43a158857ce --- /dev/null +++ b/lang/en/help/hotpot/reportformat.html @@ -0,0 +1,61 @@ + +

+ Report Format +

+

+ You can specify different output formats for the Hot Potatoes reports. +

+
+
Report Format
+
HTML
+ the report will be generated in HTML format suitable for displaying in a web browser +
+
Excel
+ the report will be generated as an ".xls" file which can be opened by + a spreadsheet program, such as Microsoft Excel +
+
Text
+ the report will be generated a text file which can be opened by a text editor +
+
+
+
Encoding
+ +
+ A list of encodings may be offered which allows you to force the report values + into a specific encoding if your spreadsheet program requires it. + + For example, Microsoft Excel requires the "SJIS" encoding for Japanese. + + The list of possible encodings can be adjusted by the site administrator on the + "Settings" page for the HotPot module +
+
+
+
Wrap data
+ +
Yes
+ long data values will be wrapped to fit into table cells. + This may make some rows very tall +
+ +
No
+ data values will not be wrapped +
+
+
+
Show legend
+ +
Yes
+ in the main report, questions and answers will be represented by letters. + A legend will be generated which shows which letters represent which questions or answers +
+ +
No
+ questions and answers will appear in full in the report and no legend will be generated +
+
diff --git a/lang/en/help/hotpot/reportselector.html b/lang/en/help/hotpot/reportselector.html index fed1422e699..0d2a082e06b 100644 --- a/lang/en/help/hotpot/reportselector.html +++ b/lang/en/help/hotpot/reportselector.html @@ -1,168 +1,168 @@ -

Selecting a Report

- -

- - You can specify different selection criteria and different output formats for the - - Hot Potatoes reports. - -

- -
- -
Selecting a course (Only for admins)
- -
this course
- - The report will show responses by participants in the current course
- -
all my courses
- - The report will show responses by participants for all courses which - - use this quiz and in which you are a teacher. - - To be used in several courses, the quiz must be located in the Site - - files directory. - - This option is only available to site administrators. - -
- - - -
- -
- -
Selecting users
- -
Students
- - The report will show responses by students taking this course. - - Teacher's responses will not be included in the report - -
- - - -
All participants
- - The report will show responses by students, teachers, course creators and administrators. - - Responses by the "guest" user, if any, will also be included. - -
- -
- -
- -
Selecting grades
- -
best attempt
- - The report will only include the responses from the best attempt by each user
- - - -
all attempts
- - The report will include the responses from all attempts by each user
- -
- -
- -
Selecting an output format
- -
Overview
- - This report is a list of attempts at this quiz. - - "abandoned" attempts are included, - - but "in progress" attempts are not shown. - - - - It shows the picture, name and best score for each user, - - and the score, time and duration of each attempt. - - - - Attempts may be selected and then deleted if required. - -
- -
Simple statistics
- - This report is a list of all completed attempts at this quiz. - - - - Attempts marked as "abandoned" or - - "in progress" are not included. - - - - The report shows the name and best score for each user, and the score - - of each question in each attempt. - - - - It also gives the averages scores of the individual - - questions and the quiz as a whole. - - - - Details of the attempts may be downloaded in Excel or text format. - -
- -
Detailed statistics
- - This report shows full details of all completed attempts at this quiz, - - - - Attempts marked as "abandoned" or - - "in progress" are not included. - - - - The report contains the following tables: - -
    - -
  • - - the responses table, which shows how each user responded - - to each question in each of their attempts at the quiz. - -
    • - -
  • - - the item analysis table, which lists the responses to each - - question and the frequency of each response. - -
    • - -
- - The details shown in this report may be downloaded in Excel or text format. - -
- -
- +

Selecting a Report

+ +

+ + You can specify different selection criteria and different output formats for the + + Hot Potatoes reports. + +

+ +
+ +
Selecting a course (Only for admins)
+ +
this course
+ + The report will show responses by participants in the current course
+ +
all my courses
+ + The report will show responses by participants for all courses which + + use this quiz and in which you are a teacher. + + To be used in several courses, the quiz must be located in the Site + + files directory. + + This option is only available to site administrators. + +
+ + + +
+ +
+ +
Selecting users
+ +
Students
+ + The report will show responses by students taking this course. + + Teacher's responses will not be included in the report + +
+ + + +
All participants
+ + The report will show responses by students, teachers, course creators and administrators. + + Responses by the "guest" user, if any, will also be included. + +
+ +
+ +
+ +
Selecting grades
+ +
best attempt
+ + The report will only include the responses from the best attempt by each user
+ + + +
all attempts
+ + The report will include the responses from all attempts by each user
+ +
+ +
+ +
Selecting an output format
+ +
Overview
+ + This report is a list of attempts at this quiz. + + "abandoned" attempts are included, + + but "in progress" attempts are not shown. + + + + It shows the picture, name and best score for each user, + + and the score, time and duration of each attempt. + + + + Attempts may be selected and then deleted if required. + +
+ +
Simple statistics
+ + This report is a list of all completed attempts at this quiz. + + + + Attempts marked as "abandoned" or + + "in progress" are not included. + + + + The report shows the name and best score for each user, and the score + + of each question in each attempt. + + + + It also gives the averages scores of the individual + + questions and the quiz as a whole. + + + + Details of the attempts may be downloaded in Excel or text format. + +
+ +
Detailed statistics
+ + This report shows full details of all completed attempts at this quiz, + + + + Attempts marked as "abandoned" or + + "in progress" are not included. + + + + The report contains the following tables: + +
    + +
  • + + the responses table, which shows how each user responded + + to each question in each of their attempts at the quiz. + +
    • + +
  • + + the item analysis table, which lists the responses to each + + question and the frequency of each response. + +
    • + +
+ + The details shown in this report may be downloaded in Excel or text format. + +
+ +
+ diff --git a/lang/en/help/hotpot/responsestable.html b/lang/en/help/hotpot/responsestable.html index daa7c8bf9bc..c68cc4e9355 100644 --- a/lang/en/help/hotpot/responsestable.html +++ b/lang/en/help/hotpot/responsestable.html @@ -1,41 +1,41 @@ -

Individual Responses

- -

- This table shows how each user responded to each - question in each of their attempts at the quiz. -

- -

- The responses are color-coded as follows: - -

- -

- - +

Individual Responses

+ +

+ This table shows how each user responded to each + question in each of their attempts at the quiz. +

+ +

+ The responses are color-coded as follows: + +

+ +

+ + diff --git a/lang/en/help/hotpot/studentfeedback.html b/lang/en/help/hotpot/studentfeedback.html new file mode 100644 index 00000000000..56c792a6102 --- /dev/null +++ b/lang/en/help/hotpot/studentfeedback.html @@ -0,0 +1,39 @@ +

+ Student feedback +

+

+ If this option is enabled, a link to a popup feedback window will be displayed + whenever the student clicks on the "Check" button. The feedback window + allows students to send feedback to the teacher regarding the quiz. + + This option can have the following settings: +

+
+
None
+
no feedback window will be displayed
+ +
Web page
+
+ a web page will be displayed in the feedback window. + You will need to enter the URL of the web page, for example: + http://myserver.com/feedbackform.html +
+ +
Feedback form
+
+ a form suitable for sending to a standard form-to-email script, + such as formmail.pl, will be displayed in the feedback window. + You should also enter the URL of the form script, for example: + http://myserver.com/cgi-bin/formmail.pl +
+ +
Moodle forum
+
the forum index for this Moodle course will be displayed
+ +
Moodle messaging
+
+ the Moodle instant messaging window will be displayed. + If the course has several teachers, the student will be + prompted to select a teacher before the messaging page appears. +
+
diff --git a/lang/en/help/hotpot/updatequizchain.html b/lang/en/help/hotpot/updatequizchain.html new file mode 100644 index 00000000000..ecc0da21499 --- /dev/null +++ b/lang/en/help/hotpot/updatequizchain.html @@ -0,0 +1,12 @@ +

Update next quiz

+
+
No
+
Only the current quiz will be updated
+
+
+
Yes
+
+ If this quiz is part of a chain of Hot Potatoes quizzes, then all quizzes + in the chain will be assigned identical settings to the current quiz. +
+