Quiz Widget

The Quiz widget shows a quiz on a page so users can take it directly in the app. Use it when you've created a quiz in the Quiz plugin and want to present it to users.

When to use this

• You've built a quiz and want users to take it
• You want to control how feedback is given — after every question or only on the final result
• You want to send users to different pages depending on whether they passed or failed
• You also want to be able to list a user's previous quiz responses

How it works

The widget binds to a quiz from the applet. When the user opens the page, the widget can show the quiz in two modes:

• Take the quiz — the user steps through the questions page by page and gets a result at the end.
• List responses — instead of letting the user take the quiz, the widget shows the user's previous responses.

You control the mode with the List responses setting. For taking the quiz, you can also control whether feedback is shown per page and whether the user can retry incorrect answers.

TIP

The Quiz plugin must be enabled in the applet. If it isn't, no quizzes appear in the widget's dropdown.

Add a quiz

1. Enable the Quiz plugin in the applet's Plugin Settings.
2. Open the Design editor for your applet.
3. Add the Quiz widget to the page.
4. Open the widget settings.
5. Pick a quiz under Select quiz.
6. Configure Correct each page and Confirmation as needed.
7. Save your changes.

Widget settings

Select quiz

Pick which quiz the widget should show. The list contains every quiz in the applet, sorted alphabetically.

WARNING

If the list is empty, you haven't created a quiz yet. Go to the Quiz plugin and create one first.

List responses

Turn this on to show the user's previous quiz responses instead of letting them take the quiz. When it's on, all feedback and confirmation settings are hidden — the widget becomes a pure result list.

Use this on a separate "My results" page where the user can look back at past attempts.

Correct each page

When on, the user gets feedback after each page of the quiz — correct answers are shown immediately and wrong answers are highlighted. When off, the result is only shown after the whole quiz is submitted.

With Correct each page on, you get two extra settings:

Setting	Description
Show retry	Shows a button that lets the user redo the page if any answer was wrong.
Disallow incorrect answers	The user cannot continue with wrong answers — they must correct themselves first. Automatically turns on Show retry.

TIP

Correct each page + Disallow incorrect answers suits training quizzes where the goal is learning, not assessment. The user can't move on with wrong answers and is forced to reflect until they get it right.

Confirmation

The confirmation settings control where the user is sent after submitting the quiz. They're only shown when List responses is off.

Redirect to

Pick a page in the applet the user should be sent to after submitting. Leave empty to send the user back to the previous page (default).

Redirect to on failed result

Pick a page the user is sent to if they fail. Only shown when the selected quiz is graded (has Enable limit for passed result turned on).

If the quiz isn't graded, only Redirect to is used — there's no fail outcome to send the user toward.

TIP

Send passing users to a diploma page or the next chapter, and failing users to a review page with relevant material. It creates a natural next-step experience whichever way the result lands.

Example

Scenario: You want to run a web quiz where the user gets feedback after every question and lands on different pages depending on the result.

1. Create the Web knowledge quiz in the Quiz plugin with graded mode and 70% passing score.
2. Add a Quiz widget to the Test page.
3. Pick Web knowledge under Select quiz.
4. Turn on Correct each page and Show retry so the user can retry incorrect answers.
5. Set Redirect to = Diploma page.
6. Set Redirect to on failed result = Review page.

On a separate My results page, add another Quiz widget pointing to the same quiz and turn on List responses — there the user can browse past attempts.

Common mistakes

WARNING

Redirect to on failed result only appears when the selected quiz is graded. If you don't see the setting, the quiz's Enable limit for passed result is probably off.

WARNING

List responses and Correct each page are two different modes — when List responses is on, no feedback settings are visible. Place the widget on two different pages if you want both quiz-taking and result history.

WARNING

The quiz's confirmation texts (header and body for pass/fail) are set on the quiz itself, not on the widget. To change them, open the quiz's properties in the Quiz plugin.