Help Guide
Test Master: Overview
Setting Up Students
Before you set up a Test, if you will be using the "authorized users" feature,
you should add your students to the system. This will make it easier when adding a Test,
since the Test creation sequence will give you the opportunity to select the students you
wish to be able to take the Test.
Adding Students
To add a student to the system, first log in to the Administration menu, and follow these
steps:
Deleting Students
To delete a student from the system, first log in to the Administration menu, and follow
these steps:
Editing Students
To edit a student's name, ID, password, or to modify which Tests a student is allowed to
take, first log in to the Administration menu, and follow these steps:
Multiple Instructors Overview
If you have chosen the "multiple_instructors" option, you may choose to add any
number of instructors to the system. These instructors, once set up, may log in and add
their own students and may create their own Tests. While the Administrator of the system
may view, modify, and delete all Tests, Instructors may only delete or modify their own
Tests.
Adding Instructors
To add an instructor to the system, first log in to the Administration menu, and follow
these steps:
Deleting Instructors
To delete an instructor from the system, first log in to the Administration menu, and
follow these steps:
Editing Instructors
To modify an instructor's name, email address, or password, first log in to the
Administration menu, and follow these steps:
Test Management
Through the administration interface, you may create, edit, or delete Tests. Tests have no
hard-set limits as to length, number of questions, number of distractors per question, or
length of instructions. However, please keep in mind that the web format may make
extremely long Tests (50 - 100 or more questions) harder for the student to load into a
web browser, and complete in a reasonable amount of time.
Adding Tests
To add a Test, log into the Administration main menu and click the "Add Test"
button.
In the first screen, you will be asked two questions: One is how many questions you would
like on this Test, and one is the maximum number of "distractors" (possible
answers) that you wish to appear for any one question.
or as a multi-line text field like this
.
To create a short-answer question with a one-line text field, type the question as usual
in the question slot. In the answer slot, type %SAQ% and then your answer. Be sure
to mark that answer as correct. For example:
To create a short-answer question with a multi-line text field, type the question as usual
in the question slot. In the answer slot, type %SAT% and then your answer. Be sure
to mark that answer as correct. For example:
In this screen, you'll be asked to configure the following options:
General Configuration Options
Turn on debugging: If set to Yes, this will cause the program to print out
debugging messages which may be helpful in troubleshooting problems with Test Master. If
set to No, no such messages are printed. It is recommended that you set this to No
unless you are having problems.
Allow remote debugging: If set to Yes, this will allow you to tell Test Master to
allow you to turn on debugging by calling the Test Master.cgi program like this:
http://www.your.site/cgi-bin/Test Master.cgi?debugging=1
If set to No, is does not allow this. It is recommended that you set this to No
unless you are having problems.
Email results of Test to instructor: If set to Yes, this will email you the results
of the Tests. If set to No, it will not email you the results.
Allow students to take this Test more than once? If set to Yes, allows all students
to take the Test as many times as they like. If set to No, does not allow students to take
the Test more than once. If set to "Yes, but only email the first one", it will
allow students to take the Test over, but it will only email the results of the first one
to the instructor.
Accept *only* fully completed Tests? If set to Yes, Test Master will not allow a
student to submit a Test unless all the questions have been answered. If set to No, Test
Master will allow students to submit partially completed Tests.
Only authorized users can take Test: If set to Yes, Test Master will require
students to have their own login and password in order to take the Test. This means that
you will need to add the student through the Administrative
Interface and allow them to take this Test. If set to No, Test Master will not require
authorization, and will let anyone take the Test.
Use single password for this Test If set to Yes, this will allow you to set up a
password for this Test. If you do not wish to add all your students to the Test Master
system, you may choose a single password and give it to everyone in the class. If set to
No, Test Master will either require students to login individually, or (if you have set
"Only authorized users can take the Test" to "No") will not require
any authorization.
Password: If you chose "Yes" for "Use single password for this
Test," then type an appropriate password in this slot.
Score Display Options
What should I show after Test completion? In this first field, the possible values
are "All," "StatusOnly," "ScoreOnly," and "None".
These options are explained in the screen.
Mail Score to student as above, but do not show on the web: If set to Yes, this
will give the student an opportunity to enter his or her email address to receive whatever
results you chose to show them in the previous section. (E.g. "ScoreOnly,"
"StatusOnly," etc.) It will not display the Test results on the web page. If set
to No, it will simply display the results of the Test to the student.
Show scores of other students: If set to Yes, Test Master will display a certain
number of previous Test takers' scores. If set to No, it will not display the scores of
any other Test taker.
Number of scores to show: If you have set "Show scores of other students"
to Yes, enter a number representing how many scores you wish to show. Test Master will
display the top scorers on this Test up to the number you enter.
Allow students to receive score by email: If set to Yes, Test Master will allow
students to enter their email addresses to be mailed a copy of their Test results. If set
to No, Test Master will not give the students this opportunity.
Show the grading scale: If set to Yes, Test Master will show students a grading
scale after the Test, so that they can see which letter grade (or other status such as
"Pass/Fail") corresponds to their score. If set to No, Test Master will not show
a grading scale.
In the textarea, you may modify the grading scale: Here, you will see a textarea
field which you may edit so that it represents your own grading scale. You may use HTML,
or simply edit the default. Tip: if you wish the grading scale to display on the
students' screen just as it looks in the text box, do not remove the <pre> and
</pre> tags.
Text for the "Grade Test" button on this Test: You may type whatever you
wish in this slot, but you may not use HTML. This is the text that will appear on the
button students click to submit their Tests, and can be anything from "Go!" to
"Go ahead, grade that bad boy!"
Short-Answer Question Scoring Options
Ignore case? If set to Yes, Test Master will not pay attention to the case of a
student's answer when determining whether it is correct or not. For example, if the
correct answer is "Kristina Harris," the student will be marked as correct for
the answers "kristina harris" or "KRISTINA HARRIS" or even
"kRiStInA hARrIs". If set to No, then Test Master will mark an answer wrong
unless the case exactly matches.
Ignore punctuation? If set to Yes, Test Master will ignore any punctuation
characters in a student's answer when determining whether or not it is correct. For
example, if the correct answer is "Yes, we always go there." the student will be
marked as correct for the answer "Yes we always go there". Please note that you
should set this to No for any short answer which includes punctuation, such as
"1/4" or ".45%" since the answers "14" and "45"
would be considered correct.
Ignore spaces? If set to Yes, Test Master will ignore any spaces in a student's
answer when determining whether or not it is correct. For example, if the correct answer
is "Internet Email", the student would be marked as correct for the answer
"InternetEmail". This may be a helpful option to avoid students being marked as
incorrect if they accidentally put an extra space at the beginning or end of their
answers.
Ignore non-word characters This option is a combination of "Ignore
punctuation" and "Ignore spaces." If set to Yes, it is the same as setting
both of these to Yes. If set to No, then this option is ignored.
Use multiple answers? If set to Yes, you enable Test Master to check for multiple
correct answers. If you have entered "Yes//Yep//Yeah//Yessir" (notice the // in
between the possible answers) as the answer for a question, and set this to Yes, Test
Master will mark as correct any one of those answers.
Accept partially correct answer? If set to Yes, Test Master will mark an answer
correct if it is part of, or contained within the correct answer. This is extremely
lenient, since if the correct answer is "There are four people", the student
would be marked correct for "There are four," "four,"
"people," or even "are four".
A screen will appear with a link to the Test you have just created. You may click on this
link, or click "Go to Administration Main Menu" to return to the main menu.
Note: If you click on the Test link, you must log in as a student in order to view the
Test. If you do not wish to have to log in as a student, return to the main menu, and
click "View Test." The "View Test" function of the main menu will
allow you to view and even take a Test for testing purposes without logging in.
Editing Tests
To edit a Test, log into the Administration main menu and click the "Edit Test"
button.
In this screen, you'll be asked to configure the following options:
General Configuration Options
Turn on debugging: If set to Yes, this will cause the program to print out
debugging messages which may be helpful in troubleshooting problems with Test Master. If
set to No, no such messages are printed. It is recommended that you set this to No
unless you are having problems.
Allow remote debugging: If set to Yes, this will allow you to tell Test Master to
allow you to turn on debugging by calling the Test Master.cgi program like this:
http://www.your.site/cgi-bin/Test Master.cgi?debugging=1
If set to No, is does not allow this. It is recommended that you set this to No
unless you are having problems.
Email results of Test to instructor: If set to Yes, this will email you the results
of the Tests. If set to No, it will not email you the results.
Allow students to take this Test more than once? If set to Yes, allows all students
to take the Test as many times as they like. If set to No, does not allow students to take
the Test more than once. If set to "Yes, but only email the first one", it will
allow students to take the Test over, but it will only email the results of the first one
to the instructor.
Accept *only* fully completed Tests? If set to Yes, Test Master will not allow a
student to submit a Test unless all the questions have been answered. If set to No, Test
Master will allow students to submit partially completed Tests.
Only authorized users can take Test: If set to Yes, Test Master will require
students to have their own login and password in order to take the Test. This means that
you will need to add the student through the Administrative
Interface and allow them to take this Test. If set to No, Test Master will not require
authorization, and will let anyone take the Test.
Use single password for this Test If set to Yes, this will allow you to set up a
password for this Test. If you do not wish to add all your students to the Test Master
system, you may choose a single password and give it to everyone in the class. If set to
No, Test Master will either require students to login individually, or (if you have set
"Only authorized users can take the Test" to "No") will not require
any authorization.
Password: If you chose "Yes" for "Use single password for this
Test," then type an appropriate password in this slot.
Score Display Options
What should I show after Test completion? In this first field, the possible values
are "All," "StatusOnly," "ScoreOnly," and "None".
These options are explained in the screen.
Mail Score to student as above, but do not show on the web: If set to Yes, this
will give the student an opportunity to enter his or her email address to receive whatever
results you chose to show them in the previous section. (E.g. "ScoreOnly,"
"StatusOnly," etc.) It will not display the Test results on the web page. If set
to No, it will simply display the results of the Test to the student.
Show scores of other students: If set to Yes, Test Master will display a certain
number of previous Test takers' scores. If set to No, it will not display the scores of
any other Test taker.
Number of scores to show: If you have set "Show scores of other students"
to Yes, enter a number representing how many scores you wish to show. Test Master will
display the top scorers on this Test up to the number you enter.
Allow students to receive score by email: If set to Yes, Test Master will allow
students to enter their email addresses to be mailed a copy of their Test results. If set
to No, Test Master will not give the students this opportunity.
Show the grading scale: If set to Yes, Test Master will show students a grading
scale after the Test, so that they can see which letter grade (or other status such as
"Pass/Fail") corresponds to their score. If set to No, Test Master will not show
a grading scale.
In the textarea, you may modify the grading scale: Here, you will see a textarea
field which you may edit so that it represents your own grading scale. You may use HTML,
or simply edit the default. Tip: if you wish the grading scale to display on the
students' screen just as it looks in the text box, do not remove the <pre> and
</pre> tags.
Text for the "Grade Test" button on this Test: You may type whatever you
wish in this slot, but you may not use HTML. This is the text that will appear on the
button students click to submit their Tests, and can be anything from "Go!" to
"Go ahead, grade that bad boy!"
Short-Answer Question Scoring Options
Ignore case? If set to Yes, Test Master will not pay attention to the case of a
student's answer when determining whether it is correct or not. For example, if the
correct answer is "Kristina Harris," the student will be marked as correct for
the answers "kristina harris" or "KRISTINA HARRIS" or even
"kRiStInA hARrIs". If set to No, then Test Master will mark an answer wrong
unless the case exactly matches.
Ignore punctuation? If set to Yes, Test Master will ignore any punctuation
characters in a student's answer when determining whether or not it is correct. For
example, if the correct answer is "Yes, we always go there." the student will be
marked as correct for the answer "Yes we always go there". Please note that you
should set this to No for any short answer which includes punctuation, such as
"1/4" or ".45%" since the answers "14" and "45"
would be considered correct.
Ignore spaces? If set to Yes, Test Master will ignore any spaces in a student's
answer when determining whether or not it is correct. For example, if the correct answer
is "Internet Email", the student would be marked as correct for the answer
"InternetEmail". This may be a helpful option to avoid students being marked as
incorrect if they accidentally put an extra space at the beginning or end of their
answers.
Ignore non-word characters This option is a combination of "Ignore
punctuation" and "Ignore spaces." If set to Yes, it is the same as setting
both of these to Yes. If set to No, then this option is ignored.
Use multiple answers? If set to Yes, you enable Test Master to check for multiple
correct answers. If you have entered "Yes//Yep//Yeah//Yessir" (notice the // in
between the possible answers) as the answer for a question, and set this to Yes, Test
Master will mark as correct any one of those answers.
Accept partially correct answer? If set to Yes, Test Master will mark an answer
correct if it is part of, or contained within the correct answer. This is extremely
lenient, since if the correct answer is "There are four people", the student
would be marked correct for "There are four," "four,"
"people," or even "are four".
A screen will appear with a link to the Test you have just created. You may click on this
link, or click "Go to Administration Main Menu" to return to the main menu.
Note: If you click on the Test link, you must log in as a student in order to view the
Test. If you do not wish to have to log in as a student, return to the main menu, and
click "View Test." The "View
Test" function of the main menu will allow you to view and even take a Test for
testing purposes without logging in.
Copying Tests
To edit a Test, log into the Administration main menu and click the "Edit Test"
button.
Deleting Tests
To delete a Test, log in to the administration main menu, and click the "Delete
Test" button.
Resetting Test Results
If, at some point, you wish to clear out the results, score statistics, and student data
for a Test, you may use the Reset Test function. The Reset Test function will remove all
students' authorizations to take the Test, and will reset the results, emptying out the
scores databases for that Test so that you may begin again with a new group of students.
To reset a Test, log in to the administration screen, and click "Reset Test."
Viewing or Testing a Test
Once you have created a Test, you may view it and test it by logging into the
administration menu, and clicking "View Test."
Viewing Detailed Test Statistics
Test Master will save detailed results on all Tests so that you may get reports on the
Test at a later time. Statistical information includes the Mean, Median, Mode and Highest
and Lowest scores for a particular Test, total number of students taking the Test, and
detailed reports of how many students chose a particular answer for a Test question, as
well as a listing by student of each student's answers.
To view these reports, log into the administrative menu, and click "Get
Statistics."
Editing or Deleting Individual Scores
To view, edit, or delete individual score reports from a particular Test, log into the
administration menu, and click "View/Edit/Delete Results."
Select the Test for which you'd like to view score reports, and click
"View Results."
Using uploaded files in questions
Only master account users can upload files.
Picture example - replace yourschoolname with your school log in name and mypicture.jpeg with your picture file you uploaded. You can specify your own height and width of the picture.
What is this <scr="http://testmaster.hypermart.net/yourschoolname/files/mypicture.jpg" width="100" height="84"> picture?
Sound example - replace yourschoolname with your site ID and mysound.wav with your sound file.
What is this
<EMBED SRC="http://testmaster.hypermart.net/yourschoolname/files/mysound.wav"
LOOP=0 VOLUME=5 PANEL="TRUE" HEIGHT=20 WIDTH=100
AUTOPLAY="TRUE"> word into English