Extra Shortcodes

The Quiz and Survey Master Extra Shortcodes addon gives you more shortcodes to use with the Quiz and Survey Master Plugin.

INSTALLATION/SETUP

Once you have purchased the add-on, you will have access to download the add-on. To install it, simply upload the add-on 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 installing the add-on. Once the add-on has been uploaded, you should have the QSM—Extra Shortcodes listed in your list of plugins. Activate that plugin.  Once activated, the plugin will add a new tab to your Addon Settings page.

If you have a QSM Add-on Installer, then you can quickly install and activate the Extra Shortcode plugin from there.

Refer to this documentation to understand how you can install add-ons through QSm Add-on Installer – How to Install Add-ons.

Adding Your License Key & Addon Settings

Enter your license key from your account into the “Addon License Key” field on the “Extra Shortcodes” tab of the “Addon Settings.”

Once you have entered your license key, be sure to click the “Validate” button to validate your license key.

Manage QSM Shortcodes

On the Extra Shortcodes settings page, you will see a list of shortcodes with an explanation of how to use them. To use the shortcodes, simply hit the copy button and paste them into the results or emails tab or any post or page of your website.

• Replace the quiz_id value with your quiz’s specific ID. Use the settings icon in each shortcode to add quizzes for the shortcode variable.
• If the shortcode includes a score or point value, update it with your quiz’s pass/fail score. Adjust these variables in each shortcode’s settings options.

Following are all the extra shortcodes you get with the add-on:

Show participants with high scores [ qsm_passed quiz_id=1 score=90 ] – It will display the number of users who passed the quiz with a score higher than the value provided.

Show participants with high points [ qsm_passed_points quiz_id=1 score=90 ]  – It will display the number of participants who passed the quiz with points higher than the value provided.

Show participants with low scores [ qsm_failed quiz_id=1 score=90 ]  – It will display the number of users who scored below the value provided.

Show participants with low points [ qsm_failed_points quiz_id=1 score=90 ]  – It will display the number of users who failed the quiz with a point score below the value provided.

Average Score Shortcode [ qsm_average quiz_id=1 decimal=2] – It will display the average score earned by the users in quizzes. Here, decimal is the decimal place to display. For example, If the shortcode is customized as [ qsm_average quiz_id=1 decimal=5 ] it displays value as - 85.12564

Average Point Shortcode [ qsm_average_points quiz_id=1 decimal=2] – It will display the average point score the users earned in quizzes. Here, decimal is the decimal place to display. For example, if its [ qsm_average_points quiz_id=1 decimal=3 ] it displays 47.236

Total Attempts Shortcode [ qsm_taken quiz_id=1 ] – It will display the number of times the quiz has been taken.

Show list of recently added quizzes [ qsm_recent amount=1 ] – It will display the most recent quizzes with links to the quiz. Set the amount limit from the shortcode settings.

Show list of all quizzes [qsm_all_quizzes button_text=”Preview” limit=90 date_range=””] – It will display a list of created quizzes filtered by a date range. You can customize the following variables in the shortcode settings:

• date_range: Filters quizzes by their last activity date using comma-separated dates (YYYY-MM-DD format, e.g., 2023-01-01, 2023-12-31).
• button_text: Sets the text for the action button (e.g., “Take Quiz,” “Preview”) that lets users start the quiz.
• limit: Determines how many quizzes appear in the list.

Show list of popular quizzes [ qsm_popular amount=1 ] – It will display the quizzes that have been taken the most. Set the amount limit to display the most popular quizzes from the settings option in the shortcode.

Display user assessment percentage in chart [ qsm_assessment_compare value1=’10’ value2=’20’ label1=’Label1′ lebel2=’Label2′ color=’#2880B9′] – The shortcode generates a comparison chart (bar or pie) based on the provided values and labels, styled according to the specified color.

The following are the values to be used; you can customize them from the settings option of the shortcode:

• Value 1: Any integer-returning variable such as:
  • Assessment label points score
  • Category points and score
  • Question points and score
  • Other integer-based variables (e.g., %POINT_SCORE%, %MAXIMUM_POINTS%, %MINIMUM_POINTS%, %AVERAGE_POINT%, %AMOUNT_CORRECT%, %AMOUNT_INCORRECT%, %AMOUNT_ATTEMPTED%, %TOTAL_QUESTIONS%, %CORRECT_SCORE%, %CATEGORY_POINTS_X%, %CATEGORY_SCORE_X%, %CATEGORY_AVERAGE_POINTS%, %ANSWER_LABEL_POINTS_X%, %ANSWER_LABEL_COUNTS_X%, etc.)
• Value 2: Similar to Value 1.
• Label 1: Text to display on the left side of the bar.
• Label 2: Text to display on the right side of the bar.
• Color: Choose from the color panel or color code to change the chart color.

Quiz Score Shortcode [qsm_display_score scoreby=average mlw_quiz=] – It will display all the scores earned by a user in the quizzes. You can customise the “scoreby” variable based on average scores, lowest scores, or top scores from the settings option in the shortcode.

Example of the extra shortcodes addon in action

If you have any trouble implementing the Extra Shortcodes Addon 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.