Quiz component

Create the Component

Quiz components are a little complex, but once you get the hang of how to create them it shouldn't be too hard.

1. Name: enter a name for your component here. (This field does not display anywhere on your website, but is used to organize files within Tridion.)
2. Schema: select Quiz
3. The title of your quiz: enter a title for your quiz here. 
4. The instructions for your quiz: enter one or two paragraphs describing the quiz and any instructions the user may need. This is a rich-text field that accepts links, bullets, and some formatting.
5. End headline: enter a headline that users will be greeted with when they complete the quiz.
6. End content: enter any additional content that you'd like to display to users upon completing the quiz. This is a rich-text field that accepts links, bullets, and some formatting.
7. Question/Answer set: you'll need to complete a question/answer set for each question that you plan to ask in your quiz. To create a new question/answer set, click the green plus sign that is furthest to the left.
   • Question: enter the quiz question here.
   • Answer option: enter the answers that the user can select from, when answering the question. The field for your first answer is provided, but you will need to click the green plus sign to add fields for additional answers. You can add up to 9 answers.
   • Select the answer number corresponding to the correct answer: from the drop-down, choose the number of the correct answer.
   • Optional supplemental solution text that will be displayed under the correct answer: enter up to one paragraph of optional text that you would like to display when the user selects the correct answer.
8. How many questions do you want displayed?:
   • 0:  if you enter zero (0), the quiz will display all of the questions you've entered.
   • 1 - MaxNum: this stands for "1 through maximum number of questions." The number you enter in this field will set the number of randomly selected questions that will display on the quiz. For example, if you have a quiz with 5 questions, and put 3 in this field, the quiz will only display 3 questions. It will randomly select from the 5 question options which 3 questions to display.
9. Do you want the user to fail the quiz on their first incorrect answer?: select "True" or "False" from the drop-down. False means the user will continue even if they answer incorrectly. True means the quiz will come to a halt.
10. Do you want the user to fail the question on an incorrect answer?: select "True" or "False" from the drop-down. False means the user will have the opportunity to answer again until they find the correct answer. True means the user will not be allowed to answer again and the quiz will move on.
11. Do you want to display "correct" or "incorrect" next to the answers that are chosen?: select "True" or "False" from the drop-down. True means the quiz will display correct/incorrect next to selected answers, False means they user gets no feedback on whether they've chosen correctly or not.
12. Do you wish to display the optional solution text under each answer?: select "True" or "False" from the drop-down menu. True means they will see the optional text you entered for each answer (see item 7 above), False means they'll receive no additional feedback.
13. What ordered list type do you want the answers to display as? (1 = numeric, A = capitalized letters, a = lowercase letters, 1 = uppercase Roman numerals, i = lowercase Roman numerals): from the drop-down, select the way you'd like your quiz answers to display, using the guide provided.
14. Would you like the score progress indicator to appear beneath the quiz questions?: select "True" or "False" from the drop-down. True will add a progress indicator bar to the quiz, which shows the user how well they are doing. False omits the bar.
15. Start button text: enter the text that should display in the button the user clicks to kick off the quiz.
16. Restart button text: enter the text that should display in the button the user clicks to retake the quiz.   
17. Would you like to grade on a pass/fail?: Leave this blank if you don't wish to grade on a pass/fail. Otherwise, enter the decimal equivalent to the percentage point at which the user would fail the quiz.

When you have filled out the fields as needed, save and close your component.

Component Template

The Quiz component has just one component template option, which is also called Quiz. The Quiz component template renders content in the ways described below:

Intro slide

• The title of your quiz (#3) is displayed at the top of the slide.
• Underneath that is the instructions for your quiz (#4).
• At the bottom is the button users click to launch the quiz, and the button contains the Start button text (#15) that you entered.
  
  

Quiz slides

The image above shows an example of what a slide might look like once the quiz is launched. Here are some of the fields that are rendered:

• The first thing on a quiz slide with be the Question (#7.a) in a quiz Question/Answer set.
• Next will be the Answer options (#7.b) that were provided in the Question/Answer set.
• If a user selects an incorrect answer, and if you have selected "True" for Do you want to display "correct" or "incorrect" next to the answers that are chosen? (#11), then the answer will turn red with strikethrough formatting, and the word "Incorrect" will appear next to the choice.
• The correct answer (set with the select the answer number corresponding to the correct answer (#7.c)) will turn green and the word "Correct!" will display alongside it. If you entered the Optional supplemental solution text (#7.d), and if you selected "True" for Do you wish to display the optional solution text under each answer? (#12), then an explanation for the correct answer will appear underneath it.
• You can also set how the quiz answers are numbered, using the What ordered list type do you want the answers to display as? (#13) option. In the screencap above, the Numeric option was used.
• If you selected True for Would you like the score progress indicator to appear beneath the quiz questions? (#14), then a bar displaying how many questions the user has got correct/incorrect will appear at the bottom of the quiz screen, as shown above. 
  
  

Final Screen

On the final slide of the quiz:

• The End headline (#5) entered will display at the top.
• If you entered a decimal number for Would you like to grade on a pass/fail? (#17), the quiz will score the user on how well they did.
• Below that, the End content (#6) entered will display.
• The content entered in the Restart button text (#16) field will display in a button, prompting the user to retake the quiz.
• The total number of questions shown in the quiz is controlled by the How many questions do you want displayed? (#8) field.