Ultimate

The QSM Ultimate Add-On enhances quiz and survey functionality with advanced customization and user-friendly features. It allows you to improve participant engagement through real-time progress tracking, quiz retake customization, email signups, and interactive polls.

It also offers advanced role-based access control, enabling administrators to assign permissions for editing, publishing, and managing quizzes at both individual and global levels. Designed for users who require greater flexibility and control, the QSM Ultimate Add-On brings a new level of precision to quiz and survey management.

Installation and Setup

To install the QSM Ultimate Add-On, begin by downloading the plugin file from your QSM account after purchase. Once you have the zip file on your device, navigate to Plugins > Add New. From there, upload the downloaded zip file, click Install Now, and once the installation is complete, press Activate to enable the add-on on your site.

After activation, you need to enter the license key to fully activate the plugin. Go to Extensions > Installed Add-ons, then navigate to the Ultimate Add-on settings. Enter the license key that was provided with your purchase, which you can copy from your QSM account. 

Installing via QSM Addon Installer 

If you use the QSM Bundle Plan, installing the Ultimate Add-On becomes even easier with the QSM Add-on Installer. First, download the QSM Addon Installer from the QSM website and upload it to your WordPress site. After activation, go to the Extensions tab > Add-on Installer and enter your bundle plan license key. Then, from the ‘All Addons” section, locate the Ultimate Add-On, and install it to set up instantly. 

For a more detailed guide on installing add-ons, refer to the Installation of Addons section

Setup Ultimate Add-On Features 

Once activation is complete, you can start by configuring and using individual features offered by the add-on.

Note – The add-on organizes its features into different sections within QSM, with each setting placed in the most relevant tab. 

1. Add Answers in Bulk

The Add Answers in Bulk feature allows you to quickly add multiple answer choices instead of entering them one by one.

To use this feature, go to the “Questions” tab, add a question, and click the “Add answers in bulk” option in the answer section.

In the “Enter Multiple Answers” pop-up box, type in your answer options, separating each in a new line. 

Click the “Insert Answers,” button and your options will appear as entered.

2. Input Custom Answers in Multiple Choice

The Input Custom Answer feature allows participants to enter their own responses when none of the multiple-choice options apply.

1. To set it up, in the Questions tab, add a Multiple Choice question and its answer options.
2. Click on Input Custom Answer and enable Let Participants Input Custom Answers.
3. Enter a label for the option, such as “Other” or “Enter Your Response”.

When participants select this option, a text box will appear for them to type their answer.

Note – The “input custom answer” feature is only available for Survey and Simple Form Type.

3. Add Poll Type in Questions

With this feature, participants can see how others have answered each question through polls, and their final results will include a graphical analysis.

To enable this feature, navigate to the Questions tab and open a question. Within the question field, enable the “Add Poll Type” option. 

Once enabled, you will see the Select Chart option, where you can choose to display the poll results as either a bar graph or a pie chart.

Additionally, you can configure the following settings:

• Show Count – Display or hide the number of responses.
• Present Live Results – Show real-time poll results as participants answer.
• Set Skip Value – Define how many participants skipped the question. You can also customize the label for skipped responses (e.g., “No Answer” or “Skipped”). If left blank, skipped values will not be displayed.

Note: This feature is only available for the following question types:

• Multiple Choice (Vertical & Horizontal)
• Multiple Response (Vertical & Horizontal)
• Polar Options

4. Show Progress Bar Based on Questions Attempted

By default, QSM provides a progress bar based on the number of quiz pages. The Ultimate Add-On enhances this by offering a progress bar that updates with each answered question, giving participants a clearer view of their progress.

To enable this feature:

1. Navigate to the Options tab and open the Display Settings section.
2. Under Progress Controls, select Progress Bar Based on the Number of Questions Responded.
3. The progress bar will now update in real time as participants answer each question.

This feature works for both single-page and multi-page quizzes, ensuring an improved user experience.

5. Show Results After Collecting Email

The QSM Ultimate Add-On allows you to collect participant email addresses before displaying or sending quiz results. 

To set up this feature:

1. Go to the Contact tab and create a contact form.
2. In the Options section under the Contact tab, enable Use Shortcode (Interim).
3. Copy the generated shortcode and customize the “Submit Contact” label if needed.

4. Open the Results tab and paste the shortcode into the text editor.
5. Click on the settings icon in the result box and check “Use as an Interim Result Page” to mark it as an interim results page.
6. Navigate to the Email tab and set up an email template to send quiz results to participants.

This feature helps collect and manage participant data efficiently while ensuring that your non-logged-in users receive their quiz results as well.

6. Customize the Default Theme

The Ultimate Add-On provides customization options for the default QSM theme, enabling you to modify the quiz’s default appearance to match your website’s design.

To customize the default theme, go to the Styles Tab, under Appearance, and click the enable the default theme customizer checkbox. This will display all customization settings, as follows;

General Settings – Adjust background color, font style, border color, and thickness.

Buttons – Allows you to customize button colors, border, radius, and positioning to match your quiz design.

Answer Choices – Customize text colors, polar answer type background colors & matching answer choice colors.

Timer – Change the timer color, position, and alignment.

Page Number – Adjust the text color, position, and alignment.

Progress Bar – Adjust the progress bar’s color, height, border radius, and position.

Advanced Options – Enable the page labels for each page and customize label colors & positions.

After customizing the theme settings, save your changes.

Note – For optimal layout, set the progress bar and button positions on opposite sides (e.g., buttons at the bottom and progress bar at the top).

7. Manage User Roles and Permissions

With the Ultimate Add-On, you can control user roles and permissions for your quizzes, setting them globally for all quizzes.

To manage user access across all quizzes, you can set global permissions for different roles.

1. To set the global settings, navigate to QSM > Settings from the side panel and open the User Permissions tab.
   
2. Here, you’ll find different roles for which you can set permissions like delete quiz, view quiz, or edit quiz. Then there are advanced settings you can grant role permissions to:
   • Delete Others’ Quizzes
   • Edit Quiz Categories
   • Edit Answer Labels
   • Delete Quiz Categories
   • Manage Options in the QSM Quiz 

{By enabling Manage Options in QSM Quiz, you ensure that specific roles have full access to Global Settings, allowing them to configure essential quiz-related functionalities across your site.}

3. Check the boxes under each role (e.g., Contributor, Editor) to grant specific permissions such as Edit, Delete, View, Duplicate, or Publish Quiz.
   • For example, if you want Contributors to edit, delete, and publish quizzes, enable these permissions under the Contributor column.
     
4. After configuring the required permissions for each role, click Save to apply the changes.

Note – Additional roles may appear if third-party integrations are enabled, such as a “Customer” role for WooCommerce users. Only roles with granted permissions will have access to specified actions.

Configuring Features in QSM Ultimate Settings

The features in the Quiz Settings tab are configured in Ultimate Settings > Addons Tab, allowing you to manage additional quiz behaviors and user interactions.

8. Advanced Quiz Settings 

Let’s first go through configuring the “Quiz Settings” tab.

1. Response Settings

The Response Settings allow you to control how participants navigate through the quiz.

If you enable the “Automatically Move to Next Page After Answering All Questions” option, the quiz will automatically proceed to the next page once all questions on the current page are completed.

This removes the need for participants to manually click the Next button, creating a smoother quiz experience.

Note: This feature works only with multiple-choice questions.

The “Prevent Quiz Progression if Question is Answered Incorrectly” feature prevents participants from moving forward in the quiz if they answer any question incorrectly and will not lead them to the next page until they answer it correctly. 

To enable this, go to “Response Settings” and tick the “prevent quiz progression if any question is answered incorrectly” checkbox.

Once enabled, a text field will appear where you can customize the message that participants will see when they attempt to proceed without answering correctly.

This feature is compatible with the following question types:

• Multiple Choice (Vertical & Horizontal)
• Multiple Response (Vertical & Horizontal)
• Drop Down
• Number
• Short Answer
• Paragraph
• Date
• Fill in the Blank
• Grid (Radio & Checkbox)
• Matching Pairs

Note: To help participants see which questions they have answered correctly or incorrectly, enable the “Show the results of each question’s response in real-time” option in Progress Controls.

2. Quiz Retake Alternative

During a quiz retake, the Show Only Incorrect Answered Questions on Retake feature allows participants to reattempt only the questions they previously answered incorrectly or did not attempt. 

To enable this, in the Quiz Settings under Addons > Ultimate Settings, tick the checkbox next to the “Quiz Retake Alternative” option.

Note: This feature will only be available if the “Allow Users to Retake the Quiz” option is enabled which you will get in the Options tab > Quiz Submissions > Quiz Controls.

You can also provide a number of the Limit Attempts or Submissions Done by Respondents to control the maximum number of quiz retakes allowed.

Once participants submit their responses, you can review their attempts on the Results page. By default, the main results from their first attempt will be displayed. 

To view their retake attempts, click on the “Select Revision” dropdown to switch between different attempts and track their progress.

3. Custom CSS Classes for Buttons

The Custom CSS Classes for Buttons Custom feature allows you to monitor tracking and user interactions with quiz buttons by applying custom CSS classes to the buttons.

To use this feature, go to “Custom CSS Classes for Buttons” in Ultimate Quiz Settings. In this section, enter custom classes for the Start, Next, Previous, and Submit buttons. 

You can add a single class or multiple classes (separated by commas), which will be applied to the buttons on the front end.

Once you’ve added the desired classes, click Save to apply the changes.