Learndash Quiz Import/Export - Overview


Installation / Setup Instruction:

Following is the step by step instructions to setup LearnDash quiz import/export Addon.


How To Export Quiz:

When Learndash Quiz Import/Export addon is activated then-new Import & Export buttons are listed in the quiz columns. To export the quiz we can simply click on the export button, it will download the quiz in the .xls file, which we can use to import in the other site with the help of this addon.



LD Quiz Import:

This tab shows the input area for the quiz file to be imported. Select the Microsoft Excel .xls file and click on the import quiz button.

Note: Only a single sheet will be imported. See the video tutorial below of "How to Import Quiz".


License Settings:

The license key can be configured from here. License keys will be sent to your email address when you purchase the addon.

Place your Email address and license key in the field and click on Activate.



Import/Export Settings:

All the default LearnDash quiz options are present here in different sorted tabs. Any new imported quiz will adopt these quiz options settings. 

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 created course with the newly imported quiz.

Associated Lesson:

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

Quiz Prerequisites:

The admin can use this option to set a prerequisites quiz/quizzes for a newly imported quiz.

Allowed Users:

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 score for a newly imported quiz to award the certificate.

Restrict Quiz Retakes:

By enabling this option the admin can restrict the quiz retake.

  • The Number of Retakes Allowed: This option allows the admin to select the number of retries allowed. If the admin select 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 or Registered users only or Anonymous user only) to allow them only to retake the quiz.

Question Completion:

If this option is checked, then the user must have to complete all the questions of the quiz.

Time Limit:

This option allows the admin to add a time limit (HH-MM-SS) for the quiz. The quiz will automatically be submitted after the select time period.

Display and Content

Quiz Materials:

The admin can add the list and display support materials for the quiz. This is visible to any user having 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 set the question Display setting here. This drop-down has two options: One question at a time and All question at once.

You can further set these options as per your requirement.

Question Overview Table:

This option allows the admin to show a Question Overview Table at quiz page.

If the user answered the question, The question cell from the table will turn green. The user can also jump to the specific question by clicking on the question cell from the table.

Backend:

Frontend:

  • Quiz Summary:

If this option is enabled, a Quiz Summary button will be visible at the quiz page. On clicking this button the user can view his/her quiz summary.

  • 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.

Additional Question Options:

If this option is enabled, the admin can show (Point Value, Question Category, Question Position, Question Numbering, Number Answers) all or any of these at the user end at quiz page.

The admin can also randomize the answers by enabling the Randomize Answers option under the Additional Question Options.

Quiz Title:

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

Result Page Display

Result Message(s):

When enabled, the first message will be displayed to all users once the quiz ends.

To customize the message based on the earned score, Click at Add field button, add new graduation levels and set the 'from' field to the desired grade.

Restart Quiz button:

If this option is enabled, a quiz restart button will be shown on the quiz page. On clicking the user can restart the quiz. 

Custom Results Display:

Enable the items (such as Average Score, Category Score, Overall Score, No. of Correct Answers and Time Spent) you wish to display on the Result Page.

Custom Answer Feedback:

If this option is enabled, the admin can select which data (for example Correct / Incorrect Messages, Correct / Incorrect Answer Marks, View Questions Button) users should be able to view when reviewing their submitted questions.

Administrative and Data Handling

Custom Fields:

Enable this option to gather data from your users before or after the quiz. All data is stored in the Quiz Statistics.

You can add multiple fields. You can also select the display postion (i.e On the quiz start page or At the end of the quiz) of that form.

Leaderboard:

Enable this option if you want to display the Leaderboard. You can also configure further options for the leaderboard here.

Quiz Statistics:

Enable this option if you want to display the quiz statistics.

  • Front-end Profile Display:
  • Statistics IP-lock:

Protect the statistics from spam. Results will only be saved every X minutes.

Email Notifications:

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

Advanced Settings:

  • Browser Cookie Answer Protection: Enable this option if you want to save answer as browser cookies for selected seconds.
  • Associated Settings:

Via this option, you can associate these settings with any LearnDash quiz.

Status

This tab shows the count of imported and exported quizzes.

Plugin Option

Discard Old Questions in Import:

If you enable this option, questions will be discarded if the quiz already exists.

If we import a quiz, let’s call it Final Quiz,with questions A, B, C and D, and if we want to import more questions  E, F and G of this quiz with the Discard Old Questions in Import option aschecked,after importing the questions, the old questions i.e A, B, C, and D will be discarded and only new questions i.e E, F and G will remain.

If the Discard Old Questions in Import optionisunchecked, then all questions will be there in the quiz i.e A, B, C, D, E, F, and G.

How to Import Quiz:


Latex Text:

Added the latex text support for math equations in LearnDash quiz questions.

 There are three steps to use latex in your learndash quiz.

  1. Install the free MathJax LaTeX plugin
  2. Add some code snippet to your theme’s functions.php file
  3. Create a quiz with latex text

This format should be needed to use the latex text [latex]E=mc^2[/latex]

Note: Follow this article Using LaTeX in LearnDash to use the latex text in learndash quiz questions.


LearnDash Quiz Import/Export Template Guide

LearnDash Quiz Import/Export uses a standard template to import and export all

LearnDash question types. This template should be followed in order to create

your own templates for import/export.The standard template can be found in the plugin folder:

LearnDash-quiz-import-export > Documentation > Standard Template

The template contains the standard LearnDash question field names as columns

names. It contains the following columns which would translate to LearnDash quiz questions:

1. Question Type

The column represents the type of LearnDash question. This column can have the following values corresponding to the LearnDash question types.

Single =>Single choice

Multiple=>Multiple choice

Sort_answer=> Sorting choice

cloze_answer=> Fill in the blank

free_answer=> Free choice

matrix_sort_answer=> Matrix Sorting choice

assessment_answer=> Assessment

essay => Essay / Open Answer

2. Category

The column should contain the value for the LearnDash question category field.

3. Title

This represents the question title for a LearnDash quiz question.

4. Total Points

The column represents total points for each answer. It can be left empty for all question types except the essay type questions. For all other question types, the total points are calculated from their individual answers. This column is only significant for essay type questions since it is used to assign points to each essay question.

5. Different Points for each answer

It should be set to yes if you need to set different points for each answer and no If you want to set a standard point for all answers.

6. Question Text

This column would fill up the question text area field for the question.

7. Answer Type

In LearnDash, there is an option to add media to the answers for some question types. If you want to display your answer with image and text then set the value as Html for this column else set the value as text.

Note: If we select the value as Html on matrix sorting question, then it will apply on both fields i.e element and criterion.

8. Answer # and Point # Columns

These columns should be set according to the maximum number of answers

present in any of the questions for the particular quiz import.

If a quiz contains 13 answers for a particular question inside it, there should be 13 columns in the template.

From:

Answer 1 – Answer 13

Point 1 – Point 13

This column will contain all the answers which are available for a question. If a question has less number of answers than the maximum answer # column, then simply leave that column as empty. The point # column associates points with each answer (If different points for each answer is enabled).

Note:

1. For a matrix sort answer, the value inside these answer columns should be in

this format {criterion}{element}

2. To put an image as an answer, the value inside these answer columns should be

in this format [image_url]

9. Answer Column

After the individual answer and points column, there is again a column named Answer. This column serves multiple purposes.

Single choice

→ For a single choice answer, it represents the correct answer from all the choices.

Multiple choices

→ For a multiple-choice answer, It represents the correct answer(s) from all the choices. The pattern to indicate the correct choice is as follows:

The pipe (|) sign is used to indicate the answer number and if the answer is not correct there is no value between the pipes. For the correct answer, answer # should be entered.

For.eg :

||2||4||6 → This indicates that answer # 2,4 and 6 are correct for this multiple choice question and answer # 1,3 and 5 are not correct.

Free choice

→ For a free choice answer, it represents the single answer for this question type, as there can only be one answer. The answers can, however, be separated through line break. To add multiple answers for a free choice using this column, you need to add line breaks in the cell for this column.

For.eg:

value1

value2

value3

(To add a line break in excel file use ALT + Enter to selected column cell)

Assessment

→ For an assessment answer, It represents the values for the single answer for this question type. The answer should be in the following format:

{[ans1][ans2][ans3]}

Fill In the Blank

→ For a close (fill in the blanks) answer, it represents value for the single answer for this question type. The answer should be in the following format:

This is a sample {cloze|5} question and It represents a sample cloze {type} question.

Note: A blank answer should be enclosed in {} and to enable separate points for each blank answer, the point has to be added after the pipe (|). If there is no separate point for each blank then there is no need to add the pipe (|) symbol.

Essay

→ For an essay answer, it represents the answer submit method and the grading criteria. The following combination of values can be added to set the above values for this answer type.

Text submit, not graded and full points

awarded (text | not-graded-full)

Text submit, graded and full points

awarded (text | graded-full)

Text submit, not graded and no points

awarded (text | not-graded-none)

Upload submit, not graded and full points

awarded (upload | not-graded-full)

Upload submit, graded and full points

awarded (upload | graded-full)

Upload submit, not graded and no points

awarded upload | not-graded-none

10. Total Answer

This corresponds to the total number of answer columns in the sheet. Set this column value according to the maximum number of answers present in the sheet.

11. Message with correct answer

This text will be visible if a question is answered correctly. It can be used as an explanation for complex questions.

12. Message with incorrect answer

This text will be visible if a question is answered incorrectly. It can be used as an explanation for complex questions.

13. Hint

Here you can enter solution hint, for the answer.

Note: You can also use latex for Learndash quiz question. Follow this article