Advanced Leaderboard Documentation

The Advanced Leaderboard addon for Quiz and Survey Master will give you 4 new leaderboard shortcodes and 2 new widgets that you can customize per use. You can edit how many results are listed, the name of the leaderboard, and the order the results are listed in.

Installation/Setup

Once you have purchased the addon, you will have access to download the addon. To install, simply upload the addon as a normal WordPress plugin. To do so, go to the Plugins page and click Add New. Then, click Upload. From there, upload the zip file that you downloaded when downloading the addon. Once the addon has uploaded, you should now have the plugin MLW Advanced Leaderboard listed in your list of plugins. Activate that plugin. Once activated, the plugin will add an option in the Quizzes/Surveys list labeled Advanced Leaderboard.

Screen Shot 2016-05-25 at 12.39.38 PM

Shortcode Settings/Configure

In the new Advanced Leaderboard option, you will see the Advanced Leaderboard page. This page will list the 4 new leaderboard shortcodes that you can customize along with an explanation on how to use them. To use the shortcodes, simply copy and paste them into any post or page. If the leaderboard is for one quiz, then replace the quiz_id value with the ID of your quiz. The ID can be found on the Quizzes page. You can replace the ranks number of 4 with the number of ranks you would like the leaderboard to display and you can replace the name Title with any title you would like the leaderboard to have. If the shortcode has an order option, you can use either ‘latest’ to have the leaderboard display the most recent results first or you can use ‘score’ to have the leaderboard display the highest score first.

An example of the Advanced Leaderboard;

Screen Shot 2016-05-25 at 1.27.25 PM

An example of the Advanced Leaderboard with the graph shortcode;

 

Screen Shot 2016-05-25 at 1.08.53 PM

 

It is also possible to change the color of the graph. In the Graph Color option, you can replace the light blue color with any other color to match the theme of your WordPress site!

Widget Settings/Configure

The Advanced Leaderboard addon also comes with two customizable widgets. These widgets can be found in the WordPress dashboard under Appearance and then under Widgets. Once the Widgets page is selected, you will see two Advanced Leaderboard widgets.

Screen Shot 2016-05-26 at 9.14.32 PM

Select where you want these widgets to appear by clicking on them and dragging them to the labeled location on the right side of the Widgets page. Once put in the desired location, you will see a list of options you will need to fill out.

Screen Shot 2016-05-26 at 9.19.51 PM

The Widget Title is the title that will be displayed on the widget. The Quiz ID needs to be filled out if you want only one particular quiz’s leaderboard to show. You can find the Quiz ID number on the Quizzes/Surveys main page. Also, select the amount of results you would like shown on the leaderboard. Once these options are filled out and you save the widget, the widget should appear on the page.

Screen Shot 2016-05-26 at 9.18.08 PM

The other widget option includes a graph image, the setup is the same as the widget above.

Screen Shot 2016-05-26 at 9.19.29 PM

 

If you have any trouble implementing the Advanced Leaderboard shortcodes or have more questions about the process, please fill out a support ticket by going to the WordPress dashboard and selecting ‘Help’ in the QSM plugin and our Support Guru will be able to help you.