Table of Contents
Quiz Leaderboard
The Cyatl LMS quiz leaderboard provides a way for you to display user’s scores to everyone who takes a quiz. Users can see where they stack up against one another, and ideally, they’ll feel more inclined to excel at the quiz and see their name atop the leaderboard.
Enable the Leaderboard
Quiz leaderboards are enabled on a quiz-by-quiz basis.
- Navigate to Cyatl LMS > QUIZZES
- Click on the quiz you’d like to enable the leaderboard for
- Click on the Settings tab
- Scroll down to the Administrative and Data Handling Settings section
- Enable the toggle for Leaderboard
Leaderboard Settings
Who Can Apply?: This determines who can submit their score to the leaderboard.
- All users
- Registered users only
- Anonymous users only (for “Open” courses where users don’t need to be logged in). Anonymous users are required to enter their name & email.
Multiple Applications per user: Enable this option to allow the same user to submit multiple scores to the leaderboard.
- Enter the number of minutes the user has to wait before they can submit another score
Automatic user entry: Enable this option to automatically submit the user’s score to the leaderboard. If left disabled, a button will be available for the user to click to submit their score.
Number of displayed entries: This refers to the number of entries that are present in the leaderboard when it is displayed to the users.
Sort list by?: This determines the sort order when the leaderboard is displayed to the users.
- Best user (top score)
- Newest entry
- Oldest entry
Display on Quiz results page: Enable this option to display the leaderboard on the quiz results page. You have two options for how it is displayed:
- Below the result text: The leaderboard is displayed on the page by default.
- In a button: A “Show Leaderboard” button is displayed at the bottom of the quiz results, and must be clicked to display the leaderboard.
There is also the option to insert the leaderboard onto any page or post by using a shortcode:
- Navigate to Cyatl LMS > QUIZZES
- Locate the desired quiz
- In the Shortcode column, copy the leaderboard shortcode
(example:[PTArvQuiz_list 283]) - Paste the shortcode into the text editor of the desired page
What the User Sees
Here’s what the user sees after completing a quiz. This example displays the leaderboard after the “Show Leaderboard” button is clicked.
