LearnDash Multi Quiz Import Export - Overview


Installation / Setup Instruction:

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



How To Export Quiz:

When Learndash Multi Quiz Import/Export addon is activated then options of Export as XLS and Export as XLSX become available in the Quizzes columns. To export the quiz we can simply click on the export button and it will download the quiz. With the help of the add-on, we can import it to another site.

We can also bulk export quizzes in .xls or in .xlsx format.

How to Export Quiz Tutorial:



LD Quiz Import:

This tab shows the input area for the quiz file to be imported. Select the Microsoft Excel .xls or .xlsx file and click on the import quiz button. Multiple quizzes can be imported at once.

Note: Multiple quizzes (sheets) can be imported in a single import. Check the "How to Import Quiz" video tutorial for importing quizzes.



License Settings:

The license key can be configured from here. License keys can be found at your email address when you purchased the addon.

Place your License key in the field and click on Activate.



Import/Export Settings:

All the default LearnDash quiz options are present here in different tabs. So the new imported quiz will adopt the quiz options settings from here.

General Option

Description:

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

Quiz Access


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

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

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 position (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 Options: 

Discard Old Questions in Import

This tab shows the option to discard previously imported questions of the same quiz.

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 as checked, 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 Importoptionisunchecked, 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 Multiple Quiz Import/Export Template Guide

LearnDash Multiple Quiz Import/Export uses two standard templates to import and export all LearnDash question types. These templates should be followed in order to create your own templates for import/export. The two Standard Templates (one for .xls and other for .xlsx) can be found in the plugin folder:

Learndash-multi-quiz-import-export > Documentation > Standard Template

The template contains the standard LearnDash question field names as columns.

It contains the following columns which would translate to a LearnDash quiz question:

1. Quiz Title

This column represents the quiz title. If this column is empty then the quiz will adopt the title from the sheet name.

2. Question Type 

This 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

3. Category

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

4. Title

This represents the question title for a LearnDash quiz question.

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

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

7. Question Text

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

8. 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, otherwise else set the value as text.

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

9. 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]

10. 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 choice

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

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

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

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

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

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

14. Hint

Here you can enter solution hint, for the answer.

15. Materials

Here you can enter text material, for the quiz.

16. Repeats

Here you can enter how many numbers of time a user can take this quiz e.g if you enter 1, the user can take this quiz 2 times.

17. Certificate Threshold

Here you can enter how much percentage is compulsory to earn the associated certificate. 

18. Passing Percentage

Here you can enter the quiz passing percentage.

19. Course

In this column, you have to enter the course id of the course to whom you want to associate that quiz.

20. Lesson or Topic

In this column, you have to enter the id of the lesson or topic to whom you want to associate that quiz.

21. Certificate

Here you can enter the certificate id of the certificate you wants to associate with that quiz.