Please note that this documentation is for the most recent version of this extension. It may not be relevant for older versions. Related documentation can be found in the documentation directory of the extension.
Quiz results
Quiz results (QuizResults) are records that define which feedback a participant receives at the end of a quiz. Depending on how many points (score) a participant has achieved, a suitable result is selected and displayed.
What are quiz results?
A quiz result record serves to provide individual feedback to the user based on their performance. This can range from simple congratulations to detailed explanations or further links.
- A quiz can have any number of different results.
- Results are selected based on the number of correct questions.
- If a question has multiple correct answers, all correct answers must be selected to receive the point for the score.
- A range is specified in the result record (e.g.,
0-5). - When the quiz is completed, the first matching result is output based on the achieved "score".
Definition of fields
The definition of the fields can be found in the file vendor/codingms/quiz/Configuration/TCA/tx_quiz_domain_model_quizresult.php.
- Score range (score_range): This defines the point range for which this result applies (e.g.,
0-3,4-7,8-10). - Title (title): The title of the result (e.g., "Well done!").
- Description (description): A detailed text displayed to the participant. This field supports Rich-Text (RTE).
Logic of result selection
After a participant has answered all questions, the system calculates the total score. A point is only awarded if a question has been answered completely correctly.
The system then searches the assigned quiz results for the first record whose score_range covers the achieved score.
Example of a set of results
Here is a fictional example of how a set of results could be configured:
| Range | Title | Description |
|---|---|---|
0-3 |
That wasn't quite it... | Unfortunately, you only answered very few questions correctly. Have another close look at the topic and try again! |
4-7 |
Not bad! | You showed a solid basic knowledge. A few details are still missing, but you're on the right track. |
8-10 |
Absolute professional! | Congratulations! You answered almost all or even all questions correctly. You are a true expert in this field. |
In addition to these texts, quiz results can also be used to display a feedback form, for example to request contact details from the participant.
