K&L Quiz Builder provides a friendly interface for creating and editing quiz data files. It also allows testing of the quiz before incorporating it into a web page.
The Quiz Builder is divided into several functional areas presented by tab interface:
Quiz Setup tab contains controls for creating a new quiz, loading existing quiz data, and setting the quiz up.
Questions tab provides an interface for adding and editing quiz questions.
Results tab contains controls for editing quiz results.
Data File contains controls for creating the quiz data object and quiz data file.
Quiz Setup
When the K&L Quiz Builder page loads, the Quiz Setup tab contains two buttons, New Quiz and Load Quiz. To create a new quiz, click New Quiz button. This will initialize the quiz data structure. Clicking on the Load Quiz button will bring up the file input control that allows browsing through the content of computer drives to find the quiz data file. Once file is selected, click Load button. This will cause the K&L Quiz Builder page to reload with the selected data file. Click Cancel to go back to the previous Quiz Setup tab layout.
When a new quiz is created, or existing quiz is loaded, the Quiz Setup tab provides controls to define the following quiz parameters:
Quiz Name
the name of the quiz that will be displayed in the klQuizName element on the HTML page.
Quiz Data Variable Name
the name of the variable for the quizData object that will contain the quiz data. This variable is passed to the setData method of the klQuiz object.
Quiz Data File Name
the name of the file for storing the quiz data.
Quiz Start
sets the manner in which the quiz starts when data is set, or the quiz is reset:
Manual
the quiz name is displayed, question and answer areas are blank. The quiz control button is set to "Start Quiz".
Automatic
the quiz starts with the first question displayed.
Question Presentation Order
sets the order in which the quiz questions are presented to the user:
Sequential
the questions are presented in the same order as they are entered in the "Questions" tab.
Random
the questions are presented in random order.
Quiz Flow
sets the quiz flow options:
Grade and review each question when submitted
In this mode, when the answers to a question are sumbitted, they are immideately graded and the screen showing correct/incorrect answers along with answer choice explanations (when present) is displayed. The user has to click "Next Question" button to advance to the next question. Number of correct answers, percent of correct answers and quiz score are updated in the statistics string with each question
Grade and review all questions after the quiz is complete
In this mode all the questions are presented to the user before the grading of the quiz takes place. Once all the questions are answered the quiz is graded and the results are displayed, when available. After the quiz results are displayed, the user is given an opportunity to go over the answers he/she gave to quiz questions, unless the following flag is set:
Skip Quiz Review
when set the Quiz Review is omitted from the quiz flow.
Continue with wrong answers at the end of the quiz
allows users to continue answering the questions they got wrong at the end of the quiz.
The following MS PowerPoint file contains the quiz flow diagram that shows how different quiz option settings affect the K&L Quiz Flow.
Quiz Pictures Path
is used when testing quizzes that contain pictures. Picture paths are entered relative to the location of quiz file on the web server. In order for the K&L Quiz Builder page to locate the images, the path to the images should be entered in the Quiz Pictures Path. It can be either a path to the local computer folder (if one contains a copy of the images) or web site URL.
Questions
Questions tab provides an interface for entering quiz questions data. It is divided into three areas. To the left is the list of all the quiz questions. The top one, [New], is used to add new questions to the quiz. Controls to enter the question data are displayed in the center area. Action buttons at the bottom of the page are used to change question data, add/delete answer choices, and delete questions.
Question data consists of the following:
Question text
the text of the question that will be displayed in the klQuizQuestion element of the HTML page
Question picture
optional path to the image file associated with the question. The path should be relative to the location of the HTML file containing the K&L Quiz Script.
Picture location
this option is shown, when the question picture is specified. It allows selection of the desired placement of the quiz question picture relative to the question text. When the location of the image is specified to the side of the text and the question element is not wide enough to accommodate both image and text the text is placed below the image.
Answer presentation order
sets the presentation of the answer choices:
Sequential
the answer choices are presented in the order they are displayed in the question data editing area.
Random
the answer choices are presented in random order.
Answer choice control
sets the presentation option for the answer choice selection control.
Auto
when the question contains only one correct answer, the radio button is used to present answer choices. In this case user is able to select only one answer. Check box is used to present answer choices when more than one answer can be correct. This allows user to select more than one answer choice.
Checkbox
allows to select multiple answers, regardless of the number of correct answers to the question.
Radio Button
restricts selection to a single answer, regardless of the number of correct answers to the question.
Question grading
selects the grading option for the question. The available grading options are:
Strict
counts the answer correct only if all correct and no incorrect choices were selected. The score is calculated as an average of grading values of all correct answers.
Sum of selected answers
sums the grading values of all selected choices. Positive grade signifies correct answer. Such grading scheme can be applied to questions which answer choice value can have a "scale" by itself.
Following the question options is the list of question answer choices. Answer choices can be added by clicking Add Answer button. In order to delete an answer choice, select it by clicking anywhere within the answer choice area and click the Delete Answer button.
Each answer choice has the following fields:
Answer text
the text of the answer choice that is displayed next to the answer choice selection control.
Grading value
integer value representing the answer grading value. Positive value signifies correct answer, zero and negative - incorrect.
Answer choice explanation
text that is displayed below the answer choice after the answer was graded. It can be used to explain why the answer choice was correct/incorrect.
Once all the desired changes to the question data have been made, click Submit Changes , or Add Question button when adding a new question, to apply changes/additions. When a new question is created, it is put at the end of the question list. To delete a question, select it by pressing the question tab in the question list and click Delete Question button.
Results
Results presentation is optional in K&L Quiz Script. In order to enable the quiz results functionality, select the Use default quiz results prompt or Use custom quiz result ranges radio button.
The quiz result is presented at the end of the quiz. The quiz result consists of the result caption that is displayed in place of the question text, and result text that is displayed in place of question answer choices.
When the ,Use default quiz results prompt is selected, the results text is specified in K&L Quiz configuration file (Please see K&L Quiz Script Manual for more information). Use custom quiz result ranges option allows to specify two or more result ranges specific to the particular quiz. The result text is selected based on the user score and the defined results ranges.
The results caption and results range text can contain the following pseudo-codes that are substituted by the script before being displayed:
[[NEWLINE]]
Breaks text into paragraphs.
[[QTOTAL]]
Replaced with the number of total questions in the quiz.
[[QCORRECT]]
Replaced with the number of questions answered correctly.
[[PERCENTCORRECT]]
Replaced with the percent of questions answered correctly.
[[SCORE]]
Replaced with the quiz score.
[[SPAN=className]]Span element content[[/SPAN]]
Used to encapsulate inline content within a span element with class attribute set to className. This feature can be used for custom styling of the results text. [[NEWLINE]] pseudo-code is not allowed within the [[SPAN]] pseudo-code.
Creates a link to a resource within the results text. Can be used to direct users to further pages depending on results.
Besides the result range text, each result range includes the range high score. Ranges can be added by clicking the Add Results Range button. To delete results range, select it by clicking anywhere inside the result range box and then click Delete Results Range button. Quiz results must have at least two results ranges.
Once all the desired changes to quiz results data have been made, click the Update Results button for the changes to take effect.
Unchecking the Use quiz results box disables the quiz results functionality and all result ranges data is deleted.
Test
The Test tab gives the ability test the quiz behavior prior to putting it in a web page. Every time the tab is selected the quiz is reset. The quiz can also be reset by pressing the Reset Quiz button.
The Test tab contains all the HTML elements supported by K&L Quiz Script, required and optional.
Data File
The Data File tab contains controls for generating quiz data object and saving it to file.
First you must click the Create Data Object button. This will generate the quiz data object and display it in the text area on the page. Code generation may take some time especially for lengthy quizzes. If any errors are encountered, they will be displayed in the status bar.
Once the quiz data object is generated, click the Create Data File button. This will send the quiz data object to the server where the quiz data file is created. When the page reloads, there is a link next to the file name input box that can be used to download the quiz data file.