Quiz Answers Extender & Bulk Import for LearnDash

By Saqib K.

0+ active installationsVersion 1.0.28

Explain every answer of LearnDash Single Choice questions, bulk import questions from CSV, and add conditional quiz chains.

Description

Quiz Answers Extender & Bulk Import for LearnDash lets you explain why each answer of a quiz question is right or wrong. After finishing a quiz, students click View Questions on the results screen and see the explanation printed directly under every answer.

Features

  • An “Answer Explanation” field under every answer in the LearnDash question editor (works with the classic editor, the block editor and the legacy LearnDash question editor).
  • An “Answer explanations” panel on every question in the LearnDash Quiz Builder.
  • A settings page (LearnDash LMS > Quiz Answers Extender) with switches to turn each feature on or off.
  • Conditional quiz progression: quiz chains that decide where a student goes after passing or failing a quiz, in three types (lesson, topic and cross-lesson chains), with optional round limits. See “Conditional quiz progression” below.
  • Per-quiz control: an “Answer explanations” box on every quiz lets it follow the site defaults, use LearnDash’s default behavior, or choose its own feedback.
  • Optional explanations right after the student clicks “Check” (with LearnDash’s “Display results after each submitted answer” option).
  • Explanations shown on the quiz results “View Questions” review, with a heading that reflects the answer: “Why this is correct”, “Why your answer is incorrect” or “Explanation”.
  • Explanations are loaded only after the quiz is completed, so students cannot read them in the page source before answering.
  • A “Loading…” indicator while explanations are fetched, and prefetching as soon as the results screen appears so they usually show instantly.
  • Bulk CSV importer (LearnDash LMS > Import Questions) that creates Single Choice questions, their answers and explanations, and adds them to the selected quiz.
  • Duplicate detection by question title (within the quiz or across the whole site).
  • Limited, safe inline HTML in explanations: links, bold, italic, underline, line breaks, code, subscript and superscript.

Conditional quiz progression

Conditional quiz progression turns a group of quizzes into a quiz chain. Instead of retaking the same quiz until they pass, students move through the chain: failing a quiz sends them to the next quiz (or topic, or lesson) to study and try again, and passing any quiz of the chain completes the whole group for them. Pass or fail always comes from LearnDash, using each quiz’s own passing score.

There are three chain types, one for each way a course can be built. Pick the one that matches where your quizzes are placed. Each type has its own switch in LearnDash LMS > Quiz Answers Extender, and is then switched on per lesson in that lesson’s edit screen. The settings page and each lesson box show a “How this chain works” guide with the same diagrams as below.

1. Lesson quiz chain (setting: “Use quiz chains in lessons”). Use it when the quizzes are placed directly in the lesson:

Lesson
 ├─ Quiz 1
 └─ Quiz 2
  • Fail Quiz 1: the student continues to Quiz 2.
  • Fail the last quiz: back to the lesson; a new round starts with Quiz 1.
  • Pass any quiz: the other quizzes and the lesson are completed, and the student moves on to the next lesson.

2. Topic quiz chain (setting: “Enable Topic-Based Conditional Quiz Progression”). Use it when each topic of the lesson has its own quiz:

Lesson
 ├─ Topic 1
 │   └─ Quiz 1
 └─ Topic 2
     └─ Quiz 2
  • Fail Quiz 1: the student continues to Topic 2.
  • Fail the last topic’s quiz: back to Topic 1 for a new round.
  • Pass any quiz: every topic, its quizzes and the lesson are completed, and the student moves on to the next lesson.

3. Cross-lesson quiz chain (setting: “Enable Cross-Lesson Conditional Quiz Progression”). Use it when consecutive lessons each have a quiz:

Lesson 1
 └─ Topic 1
     └─ Quiz 1
Lesson 2
 └─ Topic 2
     └─ Quiz 2
  • Fail Quiz 1: the student continues to Lesson 2.
  • Fail the last lesson’s quiz: back to Lesson 1 for a new round.
  • Pass any quiz: every lesson, topic and quiz of the chain is completed, and the student moves on to the lesson after the chain.
  • A lesson with no quiz in its topics can use a quiz placed directly in the lesson instead. Lessons after the chain stay locked until the student passes.

Each lesson uses one chain type only: a lesson with a lesson or topic quiz chain is never part of a cross-lesson chain.

During a round, only the student’s current quiz can be opened. Other quizzes of the chain redirect to it, and a notice on the page tells the student where they are and what to do next. After each attempt the quiz results screen shows what happened and a button to the next step.

Rounds and retakes. A round ends when the student fails the last quiz of the chain. You can limit the rounds per chain type in the settings (0 = unlimited, the default), and override the limit per lesson with the “Maximum rounds” field in the lesson’s chain box.

  • When a student fails the last quiz of their final round, the chain locks: its quizzes can’t be taken until an administrator unlocks it.
  • In cross-lesson chains, passing also uses a round. After passing, the chain’s quizzes can be retaken only while rounds are left, and each retake uses one. With 1 round, the quizzes close for retakes as soon as the chain is passed.

Messages. The pass and fail messages on the quiz results screen can be changed for each chain type (“Lesson quiz chain messages”, “Topic quiz chain messages” and “Cross-lesson quiz chain messages”), with the placeholders {quiz}, {next}, {lesson} and {rounds_left}, and so can the notices shown at the top of lesson, topic and quiz pages of the chain (after a fail, when a new round starts, on the student’s current step, and on quizzes completed by passing another one). The message shown when a chain locks (“Locked quiz chain message”) and the message shown when a passed chain has no rounds left (“Retakes closed message”) can be changed in the settings. Leave them empty to use the built-in messages.

For administrators. A student’s profile shows “Quiz chain activity”: the state of each chain and what happened on every attempt. To unlock a chain, choose an option in its “Reset” dropdown and update the profile:

  • “Retake only: (quiz)” opens just that quiz, once. Passing it passes the chain; failing it locks the chain again without moving on.
  • “Reset: start at (quiz)” clears the rounds and the lock: the first quiz starts the chain over, a later quiz lets the student continue from there.

Administrators are never restricted by quiz chains, so test chains with a student account. Only logged-in students are affected. Real LearnDash attempts and scores are never changed or deleted. For chain quizzes, don’t limit retakes in LearnDash, don’t set Quiz Prerequisites, and avoid essay questions. The questions below explain each chain type in more detail.

Requirements

This plugin is an add-on for LearnDash LMS, which must be installed and active. The plugin cannot be activated while LearnDash LMS is inactive.

This is an independent plugin. It is not affiliated with, endorsed by, or sponsored by LearnDash. LearnDash is a separate, commercial product, and LearnDash is a trademark of its respective owner.

Explanations currently support Single Choice questions.

Installation

  1. Install and activate LearnDash LMS (required; activation is refused without it).
  2. Upload the quiz-answers-extender-bulk-import-for-learndash folder to /wp-content/plugins/, or install the plugin from the Plugins > Add New screen.
  3. Activate the plugin through the Plugins screen.
  4. Edit any Single Choice question and fill in the “Answer Explanation” field under each answer, or open LearnDash LMS > Import Questions to import questions from a CSV file.

FAQ

Which question types are supported?

Single Choice questions. Other question types are left untouched.

When do students see the explanations?

You choose in LearnDash LMS > Quiz Answers Extender:

  • At the end of the quiz (on by default): on the results screen, after they click “View Questions”. Logged-in students must have completed the quiz.
  • After each question (off by default): right after they click “Check”. The quiz needs LearnDash’s “Display results after each submitted answer” option, which adds the Check button. Explanations of a question are only sent after LearnDash has graded the student’s answer.

Both can be on at the same time; each explanation is shown once. The “Explanations to show” setting chooses between explanations for every answer option (default) or only for the option the student selected. Guests can see explanations for quizzes that are not part of a course, or that belong to an “open” course.

What is the CSV format?

The first row must contain these column headers:

question_title, question_text, answer_1, answer_2, answer_3, answer_4, correct_answer, explanation_1, explanation_2, explanation_3, explanation_4
  • At least two answers are required; empty answer columns are skipped.
  • correct_answer is the number (1-4) of the correct answer column.
  • question_title or question_text is required (the other is filled in automatically).
  • Comma or semicolon separated, UTF-8 encoded. Files saved by Excel as Windows-1252 are converted automatically.

A sample file can be downloaded from the importer page.

Can different quizzes behave differently?

Yes. The settings page holds the site defaults. On any quiz’s edit screen, the “Answer explanations” box can keep “Use site default” or choose:

  • Feedback: LearnDash default (no explanations), At the end of the quiz, After each question, or After each question and at the end.
  • Explanations to show: Selected option only, or All answer options.

A quiz’s own choice always wins. When feedback is off for a quiz, the plugin adds nothing to it and LearnDash grading, results and progress work exactly as normal.

How do quiz chains work?

There are three chain types: lesson quiz chains (quizzes placed directly in a lesson), topic quiz chains (each topic of a lesson has a quiz) and cross-lesson quiz chains (consecutive lessons that each have a quiz). The “How this chain works” guide under each switch in the settings, and in each lesson’s chain box, shows the course structure each type is made for.

Turn on “Use quiz chains in lessons” in LearnDash LMS > Quiz Answers Extender, then open a lesson and switch on “Treat this lesson’s quizzes as a chain” in its “Quiz chain” box. The chain is every quiz placed directly in the lesson, in course builder order (at least two).

Students move forward one quiz at a time. During a round only their current quiz can be opened: earlier and later quizzes are locked (opening them by link, URL or the browser’s Back button sends the student to their current quiz), and the Restart button is hidden.

  • Student passes their current quiz: every other quiz in the chain is completed for them, the lesson is completed, and the results screen moves on to the next lesson of the course after a 10-second countdown (clicking “View Questions” stops the countdown). LearnDash’s own “Continue” button also goes to the next lesson. After the last lesson, students go where LearnDash sends them next (for example the course completion page).
  • Student fails a quiz that is not the last: they continue to the next quiz. The failed quiz is NOT marked complete. Under Linear progression the student’s current quiz is opened through LearnDash’s documented learndash_course_progression_enabled filter, only for the request in which that student opens or submits that quiz; every other page keeps Linear progression.
  • Student fails the last quiz: they are sent back to the lesson and a new round starts with the first quiz. This repeats until they pass.
  • An attempt on a locked quiz (for example from a tab opened earlier) is recorded by LearnDash as usual but does not move the chain.
  • After the chain is passed, the quizzes can be retaken normally (LearnDash only).

The lesson is completed once every quiz and topic in it is complete. If a lesson-level rule such as a forced lesson timer or video progression would still block it, the plugin marks it complete the way an administrator does in the student’s profile. Lessons with an assignment still wait for it (approval) as usual, and lessons with unfinished topics send the student back to finish them.

Pass or fail always comes from LearnDash, using each quiz’s passing score. Failed quizzes are never recorded as complete. Only when the chain is passed are the other quizzes completed (LearnDash completes a lesson only when all its quizzes are complete), the same way an administrator marks a quiz complete in a user’s profile; real attempts, scores and statistics are never edited or deleted. Don’t limit retakes on chain quizzes, don’t set Quiz Prerequisites on them, and avoid essay questions (results awaiting grading are not acted on). Only logged-in students are affected.

Updating from 1.0.8: lessons that contained a quiz pair get their chain switched on automatically, using the course builder order of all their quizzes.

How do topic quiz chains work?

Turn on “Enable Topic-Based Conditional Quiz Progression” in LearnDash LMS > Quiz Answers Extender, then open a lesson and switch on “Treat this lesson’s topic quizzes as a chain” in its “Topic quiz chain” box. The chain is every topic of the lesson that contains a quiz, in course builder order (at least two). Each topic’s chain quiz is the first quiz placed in that topic. This feature has its own setting and works independently of lesson quiz chains.

  • Student fails the quiz of a topic that is not the last: the results screen shows a button to the next topic. Nothing is marked complete.
  • Student fails the quiz of the last topic: the button leads back to the first topic and a new round starts. This repeats until they pass.
  • Student passes the quiz of their current topic: every topic of the lesson and every quiz inside those topics is completed for them and the lesson is completed. The results screen button and LearnDash’s own “Continue” button lead to the next lesson.

The results screen does not move on by itself; students click the button. When passing, every topic of the lesson (including the topic of the quiz just passed) and the lesson are completed in one LearnDash progress update, as an administrator does in the student’s profile. The student’s next request (the results screen, “Continue” or any page of the lesson) checks that every topic and the lesson are complete and finishes anything missing.

During a round only the current topic’s quiz can be opened; other topic quizzes in the chain redirect to the current topic. Topic pages are not locked. Under Linear progression the current topic and its quiz are opened through LearnDash’s learndash_course_progression_enabled filter, only for the request in which that student opens or submits them.

Pass or fail always comes from LearnDash. The lesson is completed once every quiz and topic in it is complete, so quizzes placed directly in the lesson (outside topics) still have to be completed. Topics or lessons with an assignment wait for it as usual. Only logged-in students are affected. Don’t limit retakes on chain quizzes, don’t set Quiz Prerequisites on them, and avoid essay questions.

How do cross-lesson quiz chains work?

Turn on “Enable Cross-Lesson Conditional Quiz Progression” in LearnDash LMS > Quiz Answers Extender, then switch on “Include this lesson in a cross-lesson quiz chain” in the “Cross-lesson quiz chain” box of each lesson that should take part. Consecutive lessons with the switch on (course builder order) form one chain; at least two. Each lesson’s chain quiz is the first quiz found in its topics or, when its topics have none, the first quiz placed directly in the lesson. The box shows the chain order.

  • Student fails the quiz of a lesson that is not the last of the chain: the results screen (and LearnDash’s “Continue” button) leads to the next lesson of the chain. Nothing is marked complete.
  • Student fails the quiz of the last lesson: back to the first lesson, a new round starts. This repeats until they pass.
  • Student passes the quiz of their current lesson: every quiz (in topics and placed directly in the lessons), every topic and every lesson of the chain is completed, and the button leads to the lesson after the chain. They are never sent back into the chain.

During a round only the current lesson’s chain quiz can be opened; the other chain quizzes redirect to the current lesson. Lesson and topic pages of the chain are not locked, but everything after the chain (later lessons, their topics and quizzes, and quizzes placed directly in the course) redirects to the student’s current chain lesson until they pass, whatever the course’s progression setting. LearnDash administrators are not redirected; the ldae_cross_progression_lock_following filter can turn this lock off. Under Linear progression the current lesson, its topics and quizzes are opened only for the request in which that student opens or submits them.

Priority: a lesson that uses a lesson quiz chain or a topic quiz chain (with that feature turned on) is never part of a cross-lesson chain and ends the run, so each quiz is handled by one chain type only. The lesson box says when this applies. Topics or lessons with an assignment wait for it as usual. Only logged-in students are affected. Don’t limit retakes on chain quizzes, don’t set Quiz Prerequisites on them, and avoid essay questions.

Are administrators restricted by quiz chains?

No. Users with the manage_options capability (administrators, and super admins on multisite) and LearnDash admin users bypass every quiz chain: no chain quiz is locked for them, they are never redirected, and their own attempts don’t move or complete any chain. To see what a student sees, test with a student account. The ldae_progression_bypass_user filter changes who bypasses (return false to test chains as an administrator).

LearnDash’s own Linear course progression is separate from this plugin. To let administrators open steps out of order there too, use LearnDash’s setting for admin users (LearnDash LMS > Settings > General, “Bypass Course limits” or similar, depending on your LearnDash version).

Can I limit how many rounds a student gets in a quiz chain?

Yes, separately for each chain type: “Maximum rounds per lesson quiz chain”, “Maximum rounds per topic quiz chain” and “Maximum rounds per cross-lesson quiz chain” in the Conditional quiz progression settings. 0 (the default) means unlimited. A round ends when the student fails the last quiz of the chain; the results screen tells them how many rounds they have left.

When a student fails the last quiz of their final round, the chain locks: its quizzes redirect to the lesson (for cross-lesson chains, the first lesson of the chain) with a message asking them to contact their instructor, attempts no longer change anything, and nothing after the chain opens through the chain. To unlock it, open the student’s profile, choose an option in the “Reset” dropdown next to the chain in “Quiz chain activity” and update the profile.

“Retake only” (locked chains) opens just the quiz you choose, once. The other quizzes of the chain stay locked. If the student passes it, the chain is passed as usual; if they fail it, the chain locks again straight away and they don’t move on to the next quiz.

The “Reset” choices clear the rounds and the lock instead. Choosing the first quiz starts the chain over. Choosing a later quiz lets the student continue from that quiz: it becomes their current quiz, the other quizzes of the chain redirect to it, and it opens even though the earlier ones were not passed. Either way the rounds and the lock are cleared; LearnDash progress is not changed. Passing within the allowed rounds works as before.

Cross-lesson quiz chains: passing also uses a round. After passing, the chain’s quizzes can be retaken only while rounds are left (each retake uses one); with 1 round they close as soon as the chain is passed. Resetting a passed chain in the student’s profile reopens its quizzes for retakes without a limit. The message shown when retakes are closed can be changed in “Retakes closed message (passed, no rounds left)”; “Locked quiz chain message (all rounds failed)” is used only when a chain locks after failed rounds.

The message students see when a chain locks can be changed in “Locked quiz chain message” in the Conditional quiz progression settings. Use {rounds} for the number of rounds; leave it empty to show the default message.

Per lesson: each chain box on the lesson edit screen (“Quiz chain”, “Topic quiz chain”, “Cross-lesson quiz chain”) has a “Maximum rounds” field. Leave it empty to use the site setting, enter a number to override it for that chain, or 0 for unlimited. A cross-lesson chain uses the value of the first lesson in the chain (course order) that has one. The ldae_chain_max_cycles filter runs last and can change any limit.

Who can use the importer?

Users with the manage_options capability (administrators) by default. Change it with the ldae_import_capability filter.

Can I customise the plugin?

Yes, with these filters:

  • ldae_supported_answer_types – answer types that get explanations (default array( 'single' )).
  • ldae_allowed_explanation_html – allowed inline HTML, as a wp_kses() array.
  • ldae_user_can_view_explanations – final decision on who may load the end-of-quiz explanations.
  • ldae_user_can_view_question_explanations – final decision on who may load one question’s explanations after “Check”.
  • ldae_settings_sections, ldae_settings_fields, ldae_settings_field_types – add sections, settings and setting types to the settings page.
  • ldae_get_setting – override a setting value in code.
  • ldae_quiz_fields – add choices to the per-quiz “Answer explanations” box (settings marked per_quiz get one automatically).
  • ldae_quiz_settings – override the effective settings of a quiz in code.
  • ldae_progression_countdown – seconds before the results screen moves to the next step (default 10; 0 turns the automatic move off).
  • ldae_progression_force_lesson_completion – return false to only complete chain lessons (and topics of topic chains) when LearnDash’s own rules (timer, video) allow it.
  • ldae_chain_message – change a results-screen pass or fail message of a quiz chain; receives the message, the chain type (‘lesson’, ‘topic’ or ‘cross’), the message (‘pass’, ‘pass_partial’, ‘fail_next’ or ‘fail_last’ on the results screen; ‘notice_next’, ‘notice_retry’, ‘notice_order’, ‘notice_blocked’ or ‘notice_skipped’ on pages), the placeholder values and whether the administrator’s own message is used.
  • ldae_chain_max_cycles – maximum rounds of a chain; receives the limit from the settings, the chain type (‘lesson’, ‘topic’ or ‘cross’), the course ID and the lesson ID (the first lesson for cross-lesson chains). 0 = unlimited.
  • ldae_progression_bypass_user – whether a user bypasses every quiz chain (default: administrators and LearnDash admin users).
  • ldae_cross_progression_lock_following – return false to let students open lessons after a cross-lesson chain before passing it (default true).
  • ldae_cross_progression_countdown – seconds before the results screen of a cross-lesson chain quiz moves on by itself (default 0: students click the button).
  • ldae_topic_progression_countdown – seconds before the results screen of a topic chain quiz moves on by itself (default 0: students click the button).
  • ldae_settings_capability – capability required for the settings page (default manage_options).
  • ldae_allow_guest_explanations – whether guests may load explanations for a quiz.
  • ldae_enqueue_frontend – load the frontend assets on custom pages that display a quiz.
  • ldae_builder_root_selectors – CSS selectors of the Quiz Builder container.
  • ldae_import_capability – capability required for the importer.

What happens to my data when I delete the plugin?

Nothing you set up is lost. Deleting the plugin keeps its settings, each quiz’s own choices, lesson, topic and cross-lesson quiz chains, answer explanations and students’ chain progress, so deleting and re-installing (for example to update) changes nothing. Only short-lived temporary data is cleared.

To remove everything for good, switch on “Delete all plugin data when the plugin is deleted” under Plugin data in LearnDash LMS > Quiz Answers Extender before deleting the plugin. LearnDash’s own quizzes, questions, attempts and scores are never touched. (define( 'LDAE_DELETE_EXPLANATIONS_ON_UNINSTALL', true ); in wp-config.php still removes only the answer explanations.)

How do I update without deleting?

Go to Plugins > Add New > Upload Plugin and upload the new zip. WordPress offers “Replace current with uploaded” – choose it. The plugin is replaced in place and nothing runs on removal.

Changelog

1.0.28

  • New: the page notices of every quiz chain type can be edited too, in the same “… quiz chain messages” settings (under “Notices on lesson, topic and quiz pages”): the notice on the next topic or lesson after a fail (topic and cross-lesson chains), on the lesson, first topic or first lesson when a new round starts, on the student’s current quiz, topic or lesson when they try to open another one, on the current lesson when they try to open a lesson after a cross-lesson chain, and on a quiz that was completed by passing another quiz of the chain. New placeholders {topic} and {passed}. Empty boxes keep the built-in notices, so nothing changes until you enter a message. Buttons and links are unchanged.

1.0.27

  • New: editable pass and fail messages for every quiz chain type. In LearnDash LMS > Quiz Answers Extender > Conditional quiz progression, “Lesson quiz chain messages”, “Topic quiz chain messages” and “Cross-lesson quiz chain messages” each have four messages shown on the quiz results screen: passed, passed with other lesson steps still unfinished, failed (moves on to the next quiz, topic or lesson) and failed the last one (a new round starts). Placeholders: {quiz}, {next}, {lesson} and {rounds_left}. Plain text; line breaks are kept. Empty boxes keep the built-in messages, so nothing changes until you enter a message.
  • New: ldae_chain_message filter.

1.0.26

  • Maintenance release after a full code, security and WordPress coding standards review. No changes to features, settings, stored data or behaviour.
  • Security hardening: the textarea setting’s rows attribute is now escaped on output.
  • Translation: added a missing translators comment for a plural string in the lesson chain box.
  • Code quality: a lesson box save call that shared a line with a closing brace is now on its own line.
  • Readme: shorter short description (under the 150-character limit of the WordPress.org readme parser).
  • Readme: new “Conditional quiz progression” section in the description, explaining the three chain types with diagrams, rounds and retakes, messages, and the administrator tools.
  • Fix: expected answers of the explanation requests (quiz not completed yet, answer not graded yet, explanations off for the quiz) are returned with HTTP 200 instead of 403, so browsers no longer log them as console errors. Access rules and retries are unchanged.

1.0.25

  • New: “Retakes closed message (passed, no rounds left)” setting. Replaces the message students see when they already passed a cross-lesson quiz chain, have no rounds left and try to open or retake one of its quizzes. Leave it empty to keep the default message.
  • Changed: the “Locked quiz chain message” setting is now labelled “(all rounds failed)”, to make clear it is used when a chain locks after failed rounds, not after a pass.

1.0.24

  • Fix: cross-lesson quiz chains with a round limit no longer allow unlimited retakes after the chain is passed. Passing now uses a round: after passing, the chain’s quizzes can be retaken only while rounds are left, and each retake uses one. With 1 round the quizzes close as soon as the chain is passed (pages redirect to the lesson with a notice, and LearnDash’s Restart button is hidden on the results screen). Unlimited chains (0) are unchanged.

1.0.23

  • New: “Retake only” in the Reset dropdown of a locked quiz chain (student profile, Quiz chain activity). It opens just the chosen quiz, once: the other quizzes of the chain stay locked, passing it passes the chain as usual, and failing it locks the chain again without moving on to the next quiz. Works for lesson, topic and cross-lesson chains.
  • Changed: the Reset dropdown groups its choices into “Allow one retake” (locked chains only) and “Reset the chain (new rounds)”. The reset choices work as before.

1.0.22

  • Changed: administrators (and LearnDash admin users) now bypass every quiz chain: lesson, topic and cross-lesson chains never lock, redirect or show chain notices to them, and their own quiz attempts don’t move any chain. Students are not affected. New filter ldae_progression_bypass_user.

1.0.21

  • New: “Locked quiz chain message” setting (Conditional quiz progression). Replaces the message students see when a lesson, topic or cross-lesson quiz chain locks after their final round, on the results screen and on the lesson they are sent to. Use {rounds} for the number of rounds; line breaks are kept. Leave it empty to keep the default message.
  • New: “How this chain works” guides under each quiz chain switch on the settings page and in each lesson’s chain box. Each shows the course structure the chain type is made for (lesson with quizzes, topics with quizzes, or consecutive lessons with quizzes) and what failing and passing do.
  • Changed: the Conditional quiz progression section introduction now describes all three chain types and how to choose between them.

1.0.20

  • New: maximum rounds per chain, set separately for lesson, topic and cross-lesson quiz chains (default 0 = unlimited), with a “Maximum rounds” field in each lesson’s chain box to override the site setting for that chain. When a student fails the last quiz of their final round, the chain locks until an administrator resets it in the student’s profile (“Reset” in Quiz chain activity), choosing the quiz the student continues from. New filter ldae_chain_max_cycles.

1.0.19

  • Cross-lesson quiz chains: a lesson whose topics hold no quiz now uses the first quiz placed directly in the lesson as its chain quiz.
  • Cross-lesson quiz chains: until a student passes a chain, the lessons after it (with their topics and quizzes, and quizzes placed directly in the course) redirect to the student’s current chain lesson, whatever the course’s progression setting. New filter ldae_cross_progression_lock_following.
  • Topic and cross-lesson quiz chains: passing completes every topic and lesson in one LearnDash progress update that also re-states steps already complete, so the topic of the quiz just passed stays complete; anything missing is completed on the student’s next request.
  • All quiz chain types: completing lessons and topics now always sends LearnDash the student’s full stored course record with the new steps added (one shared helper), so a chain can no longer make steps completed elsewhere in the course (by LearnDash or another chain) incomplete again. Fixes topics becoming incomplete when lesson, topic and cross-lesson quiz chains are used in the same course.
  • Topic and cross-lesson quiz chains: no countdown on the results screen; students move on with the button, and LearnDash’s own “Continue” button leads to the same place.

1.0.18

  • New: topic-based conditional quiz progression (off by default). In lessons whose topics each contain a quiz, failing a topic quiz leads the student to the next topic, failing the last one leads back to the first topic, and passing any topic quiz completes every topic and topic quiz of the lesson and the lesson itself, and leads to the next lesson. Students move on with a button (no countdown).
  • New: cross-lesson conditional quiz progression (off by default). Consecutive lessons that hold a quiz (in a topic or placed directly in the lesson) form a chain: failing a lesson’s quiz leads to the next lesson of the chain, failing the last one leads back to the first, and passing any of them completes every lesson, topic and quiz of the chain and leads to the lesson after it. Lessons after the chain stay locked until the student passes. Lessons using a lesson or topic quiz chain take priority and are never part of a cross-lesson chain.
  • New: “Topic quiz chain” and “Cross-lesson quiz chain” boxes on the lesson edit screen, and chain information in the quiz “Answer explanations” box.
  • Fix: the quiz “Answer explanations” box no longer shows “Quiz 0 of N” for quizzes inside a topic of a lesson with a quiz chain.

1.0.17

  • Changed: quiz chain notices use clear status colours and icons: red for a failed quiz, green for a pass, amber for a locked attempt, blue for information.

1.0.16

  • Fix: after a student’s progress was reset (for example for a retest), passing the first chain quiz on the first attempt did not complete the other quizzes and the lesson. Resets are now detected from all chain quizzes and the lesson, so a fresh round always starts.

1.0.15

  • Fix: passing (or failing) a later quiz in a chain did nothing because LearnDash’s final “quiz completed” save was still blocked by Linear progression. Linear is now relaxed for every LearnDash quiz request of the student’s current chain quiz, so the attempt is saved and the chain continues (other quizzes completed, lesson completed).
  • New: “Quiz chain activity” on a student’s profile (administrators) shows each chain’s status and what happened on every attempt.

1.0.14

  • Changed: after passing a chain quiz, “Continue” (LearnDash’s button, the plugin’s button and the countdown) goes to the next lesson of the course instead of back to the same lesson.

1.0.13

  • Fix: after failing a chain quiz, LearnDash showed “Please go back and complete the previous quiz” on the next quiz. The student’s current quiz now opens (and is graded) under Linear progression, while earlier and later quizzes stay locked.

1.0.12

  • Fix: deleting the plugin no longer removes your setup. Settings, per-quiz choices, lesson quiz chains, explanations and students’ chain progress are kept, so re-installing changes nothing.
  • New: “Delete all plugin data when the plugin is deleted” switch (off by default) under Plugin data on the settings page.

1.0.11

  • Changed: quiz chains are strictly forward-only. During a round only the student’s current quiz opens; earlier and later quizzes are locked (redirects, no-cache headers, hidden Restart button).
  • Changed: a failed quiz is no longer marked complete to open the next one; the next quiz is opened through LearnDash’s learndash_previous_step_completed filter.
  • New: attempts on a locked quiz are recorded by LearnDash but ignored by the chain.

1.0.10

  • Fix: passing a chain quiz now completes the lesson even when a lesson timer or video progression setting would block LearnDash’s normal completion (lessons with an assignment still wait for it).
  • Changed: after the lesson is completed, students move to LearnDash’s own next step (the next available topic or lesson, or the course completion page) instead of always the next lesson.

1.0.9

  • Changed: conditional progression now uses quiz chains set per lesson (any number of quizzes, course builder order) instead of quiz pairs. Lessons with a 1.0.8 pair are switched to chains automatically.
  • New: passing any chain quiz completes the lesson (when LearnDash allows it) and moves the student to the next lesson after a 10-second countdown that stops on “View Questions”.
  • New: chain order is enforced in each round, so earlier completions cannot be used to skip ahead.

1.0.8

  • New: conditional quiz progression for paired quizzes in a lesson (pass Quiz 1 to complete Quiz 2; fail it to continue to Quiz 2; fail Quiz 2 to return to the lesson and retake Quiz 1).
  • New: “Conditional quiz progression” section on the settings page (off by default) and a pair field in the quiz “Answer explanations” box.

1.0.7

  • New: per-quiz “Answer explanations” box: each quiz can follow the site defaults, use LearnDash’s default behavior, or choose explanations at the end, after each question, or both, and which answers get an explanation.
  • Changed: the settings page now describes its options as site defaults; “Explanations to show” is dimmed while both feedback switches are off.
  • Changed: scripts and styles are versioned by file date, so updates always load fresh files.

1.0.6

  • New: “Explanations to show” setting: explanations for all answer options (default, as before) or only for the option the student selected. Applies to both feedback modes.
  • Fix: browsers and caches now load the updated scripts and styles.

1.0.5

  • New: settings page (LearnDash LMS > Quiz Answers Extender) with switches for each feature.
  • New: show answers and explanations right after the student clicks “Check” (off by default).
  • New: the end-of-quiz explanations can be turned off (on by default, as before).
  • Fix: the correct answer the student did not pick is now labelled “Why this is correct” instead of “Explanation”.

1.0.4

  • Changed: the plugin is renamed to “Quiz Answers Extender & Bulk Import for LearnDash” (slug and text domain quiz-answers-extender-bulk-import-for-learndash). Features, settings, hooks and stored data are unchanged; explanations saved by earlier versions keep working.

1.0.3

  • New: the plugin can only be activated when LearnDash LMS is active, with a clear message otherwise.

1.0.2

  • Fix: when LearnDash’s legacy question editor saves a question under a new question ID, the explanations now follow the question instead of staying on the old ID. LearnDash’s editor URLs are not changed.
  • New: explanations of a question that LearnDash re-created under a new ID are recovered automatically when the question’s quiz, title and answers are unchanged.

1.0.1

  • Fix: explanations entered in LearnDash’s legacy question editor were not saved for questions that have no LearnDash question post. They are now saved, shown again after updating, and displayed on the results review.

1.0.0

  • Initial release.