# Learndash Quiz Import/Export - Overview

## Installation / Setup Instruction:

The following are the step by step instructions to setup LearnDash quiz import/export Addon.

# How To Export Quiz:

When the Learndash Quiz Import/Export addon is active on your site, the new Import & Export buttons will appear in the quizzes table, under the “Quiz Export” column. To export the quiz, simply click on the export button. The quiz will be downloaded in a .xls file, which can be imported to another site with the help of this addon.

## LD Quiz Import:

To import a quiz, go to the LD Quiz Import menu located under the main add-on menu.  Here, you will find the input area for the quiz file to be imported. To complete the import, select the Microsoft Excel .xls file and click on the import quiz button.

Note: Only a single sheet will be imported. For additional guidance, see the video tutorial on How to Import A Quiz.

Insert your license key in the field and then click on Activate.

# Import/Export Settings:

To modify the plugin settings, go to the Import/Export Settings from the main LD Quiz Import menu. All the default LearnDash quiz options are listed here in different sorted tabs. Any new imported quiz will adopt these quiz option settings, which can be modified by the admin according to requirements.

### General Option

Description:

Here the admin can add the quiz description for the imported quiz.

### Quiz Access

Associated Course:

The admin can use this option to associate any course with the newly imported quiz.

Associated Lesson:

The admin can use this option to associate any lesson with the newly imported quiz.

Quiz Prerequisites:

The admin can use this option to set a prerequisite quiz or quizzes for the newly imported quiz.

Allowed Users:

The admin can use this option to protect quiz content by selecting which users can view the imported quiz.This option is especially useful if administering quizzes via shortcodes on non-course pages, or if your course is open but you wish only authenticated users to take the quiz.

### Progression and Restriction

Passing Score:

The admin can use this option to set a passing score for a newly imported quiz.

Quiz Certificate:

The admin can use this option to associate any created certificate with the newly imported quiz.

Certificate Awarded for:

The admin can use this option to set the minimum quiz score required for the certificate to be earned for the newly imported quiz.

Restrict Quiz Retakes:

By enabling this option the admin can restrict the number of times a user can retake the newly imported quiz.

The Number of Retakes Allowed:

This option allows the admin to select the number of quiz retakes allowed. If the admin selects 1, the user can take this quiz 2 times.

Retries Applicable to:

This option allows the admin to select the users (i.e  All users, Registered users only or Anonymous users only) that are allowed to retake the quiz.

Question Completion:

If this option is checked, the user will be required to complete all the questions in the imported quiz.

Time Limit:

This option allows the admin to add a time limit (in an HH-MM-SS format) for the quiz to be completed. The quiz will automatically be submitted after the selected time period is over.

### Display and Content

Quiz Materials:

The admin can add a quiz material list and display support materials for the quiz. This content will be visible to any user that has access to the quiz.

Auto Start:

If you enable this option, the quiz will start automatically after the page is loaded.

Question Display:

The admin can select how to display quiz questions from the options in the Question Display section. The drop-down menu has two options: to display “One question at a time” or to show “All questions at once”.

When the “One question at a time” option is selected, you can additionally customize the way your quiz is displayed by adding a back button and displaying results either only at the end or after each submitted answer.

When the “All questions at one” option is selected, you can further customize the quiz page by selecting the number of questions that will be displayed per page.

Question Overview Table:

This option allows the admin to display a “Question Overview Table” on the quiz page. The table includes an individual question cell for all of the questions in the quiz.

If the user has answered the question, the question cell from the table will be colored in. The user can also jump to the specific question using the overview table by clicking on any question cell.

Backend:Frontend:

Quiz Summary:

If this option is enabled, a “Quiz Summary” button will be visible on the quiz page. By clicking this button, users can view their quiz summary. The quiz summary includes the quiz questions, correct answers, total points, and points awarded.

Skip Question:

If this option is enabled, the user can skip any question of the quiz.

Custom Question Ordering:

This option allows the admin to customize the order of the quiz questions.

Sort by Category:

If this option is checked, the questions will be ordered by their category type.

Randomize Order:

If this option is enabled, the admin can randomize the order of the questions. Additionally, the admin can choose to display all questions or only display a subset of them. If the latter option is selected, the admin can specify the number of questions to be displayed in the bottom field.

If this option is enabled, the admin can display any of the following types of information at the end of the quiz page: Point Value, Question Category, Question Position, Question Numbering, Number Answers.

Quiz Title:

By enabling this option, the second quiz title will be displayed on the quiz post. This option is recommended if displaying quizzes on any given page using Shortcode.

### Result Page Display

Result Message(s):

When enabled, the message added in the “Result Text” field will be displayed to all users once the quiz is completed.

To customize the message that is displayed based on the obtained quiz score, click on the “Add field” button located on the bottom left, and then add new graduation levels, and set the 'from' field to the desired grade requirement.

Restart Quiz button:

If this option is enabled, a  “Restart Quiz” button will be shown on the quiz page. By clicking on this button the user can restart the quiz at any time.

Custom Results Display:

With this option, you can selectively enable the items that you wish to display on the Result Page. The items you can show or hide include the following: Average Score, Category Score, Overall Score, Number of Correct Answers, and Time Spent.

If this option is enabled, the admin can select which data types the user can view when reviewing their submitted questions. Data that can be displayed include the following: Correct / Incorrect Messages, Correct / Incorrect Answer Marks, View Questions Button.

Custom Fields:

Enable this option to gather data from your users before or after the quiz. All gathered data is stored in the “Quiz Statistics”. You can add multiple fields according to your needs. You can also select the display position for the custom fields either on the quiz start page or the end page of the quiz.

Enable this option if you want to display a  Leaderboard of results. You can also configure further options for the leaderboard in this section.

Quiz Statistics:

Enable this option if you want to display the quiz statistics i.e total score, total points, correct or wrong answers, etc.

• Front-end Profile Display:

This option will enable the quiz statistics report on the user profile page.

Upon clicking the reports, there will be a popup containing the detailed statistics.

• Statistics IP-lock:

Enabling this option protects the statistics from spam. Results will only be saved every X minutes. The time limit (in minutes) can be set in the blank field.

Enable this option if you want to enable email notifications for the quiz. You can enable email notifications for both admin and users.

• Associated Settings: Via this option, you can associate these settings with any LearnDash quiz.

### Status

In this tab, you can find the count of imported and exported quizzes.

### Minimum Role To Administer Plugin

This dropdown menu allows the admin to select what type of user role can access and use this plugin. If you want any teacher or Instructor to be able to import and export quizzes, you should select their respective role.

### Remove Questions on Quiz Delete

When this option is enabled,  quiz questions will be discarded automatically when the associated quiz is deleted by the admin.

### Discard Old Questions in Import

With this option enabled, previously imported questions from the same quiz will be discarded. This helps prevent previously imported questions from being repeated again and again in the same quiz.

If you import a quiz, let’s call it Final Quiz, with questions A, B, C and D, and you want to import the additional questions  E, F and G into the same quiz, with the “Discard Old Questions in Import” option enabled, after all the questions are imported, the old questions i.e A, B, C, and D will be discarded and only new questions i.e E, F and G will be added. If the Discard Old Questions in Import option is unchecked, then all questions will remain, i.e A, B, C, D, E, F, and G.

### Allow Import of Existing Questions

With this option enabled, you can add an additional step to the import process that allows you to select which existing questions you want to be imported.

How to Import Quiz: