Quick Start Guide

This guide provides a concise overview of the Quiz and Survey Master (QSM) plugin. It is intended for users who are already familiar with WordPress, plugins, and plugin administration.

In this guide, you will learn how to install the QSM plugin, create a quiz, add questions, set up result pages, and embed the quiz into a post or page.

INSTALLING THE PLUGIN

1. In your WordPress admin panel, go to Plugins.
2. Click Add New and search for Quiz and Survey Master (QSM).
3. Click Install Now, then select Activate.
4. Once the plugin is activated, the QSM menu will appear in the admin panel.

CREATING A QUIZ OR SURVEY

After installing the plugin, follow these steps to create your first quiz or survey:

1. In the WordPress admin panel, click QSM to open the dashboard.
2. Click Get Started to begin creating a quiz or survey.
3. Select a form type: Quiz, Survey, Exam, Personality Assessment, or Poll template, and then click Proceed.
4. Choose a theme from the recommended options or click on “See More Themes” (at the bottom) to expand the full QSM Themes selection. (Optional Step)
5. Next, proceed to explore recommended add-ons or click on “See More Add-ons” to expand the list of all the QSM Add-ons. (Optional Step)
6. Then, give your quiz a name and configure the additional form settings.

For further information, please consult our complete documentation on creating a quiz.

1. Adding and Editing Questions

Let’s start adding the questions.

• Click the edit icon. In the blank field, enter your question. If needed, add a description by clicking on the ‘Edit description.’
• Select the Question Type and choose from the 15 available options in QSM. Along with that, you also get five advanced question types if you purchase the add-on.
• Enter the answer(s) in the answer field. The input format will vary based on the selected question type. You can also choose the preferred answer input type from the Answers Type option. 
• To add a limit to the number of answers that will be displayed to quiz takers, you can add the Answer Limit.
• You can also include correct answer info, enable a comment box for user input, and provide hint text to guide users.
• Assign a question category and upload a feature image if required.
• Repeat the process to add multiple questions. To organize them into different pages, click Create New Page.

For more details, refer to the Questions Tab section in our documentation.

2. Add Contact form

The contact form tab allows you to collect your users’ contact information either at the start or end of the quiz. To configure, go to the Contact tab.

• Enable the contact fields that you want to add to the form
• Add the placeholder label name for your contact fields
• You can also reorder the contact fields’ positions.

From the ‘Options’ tab in the contact form section, you can further configure the positioning of the contact form and customize the required error messages.

For more details, refer to our complete documentation on the How to add a Contact Form

3. Setting up the Results Pages

The Result Page tab allows you to customize what quiz takers see after completing a quiz. Follow these steps to configure your Results Pages:

• Click on the Results Pages tab.
• You will see a default result page box that can be customized based on your requirements. Both sections (on the right & left sides) of the result page can be adjusted to display tailored results.

Start by setting up the Conditions (When) section.

• Select a suitable condition to determine when a specific result page should be shown. You can customize the conditions based on total points or correct percentage.

Next, move to configure the Then section on the right side of the tab.

This defines the actual result page that will be displayed to participants when the set conditions are met. There are two choices that you can select that will be shown if the set conditions are met.

• Choose how to display results:
  • Create a custom result template.
  • Select from pre-built templates.
• Redirect participants to a specific URL (e.g., a website or webpage).

📌 The results of a quiz or survey will not be displayed if the quiz is in draft mode. Ensure the quiz is published to view the results.

For more details, refer to our complete documentation on the Results Pages Tab.

Adding Your Quiz or Survey to Your Post or Page

Once your quiz, survey, or form is published, you can embed it into a post or page by following these steps:

1. Go to the Quizzes & Surveys menu from QSM.
2. Click the Shortcode icon beside your created quiz.
3. Copy the Embed Shortcode from the pop-up window.
4. Paste the shortcode into the post or page where you want the quiz or survey to appear.