Linux 软件免费装

Quiz Answers Extender & Bulk Import for LearnDash

开发者 saqibabbasi
更新时间 2026年11月18日 01:40
PHP版本: 7.4 及以上
WordPress版本: 7.1
版权: GPLv2 or later
版权网址: 版权信息

标签

quiz lms learndash csv import explanation

下载

1.0.4 1.0.26 1.0.28

详情介绍:

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

安装:

  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.

升级注意事项:

1.0.28 Adds editable page notices (after a fail, new round, current step, completed quiz) for lesson, topic and cross-lesson quiz chains. Nothing changes for students until you enter a message. 1.0.27 Adds editable pass and fail messages for lesson, topic and cross-lesson quiz chains. Nothing changes for students until you enter a message. 1.0.26 Maintenance release after a full code and security review. No functional changes. 1.0.25 Adds a customisable message for passed cross-lesson chains whose retakes are closed. 1.0.24 Cross-lesson chains with a round limit now close their quizzes for retakes once the student has passed and has no rounds left. 1.0.23 Locked quiz chains can now be opened for a single retake of one quiz; failing it locks the chain again. 1.0.22 Administrators can now open every lesson, topic and quiz without quiz chain restrictions. Test chains with a student account. 1.0.21 Adds a customisable message for locked quiz chains and visual guides that explain each chain type. Nothing changes for students until you enter a custom message. 1.0.20 Adds an optional maximum number of rounds per quiz chain (lesson, topic and cross-lesson). Unlimited by default, so nothing changes until you set a limit. 1.0.19 Cross-lesson chains now accept quizzes placed directly in lessons and lock the lessons after a chain until it is passed. Fixes topics becoming incomplete when passing a chain, including when all three chain types are used in one course. 1.0.18 Adds optional topic-based and cross-lesson conditional quiz progression. Both are off until you turn them on; existing quizzes and lesson quiz chains are unchanged. 1.0.17 Failed-quiz notices are now shown in red instead of green. 1.0.16 Fixes passing on the first attempt after a progress reset having no effect. 1.0.15 Fixes passing a later chain quiz having no effect. Adds a chain activity panel to student profiles. 1.0.14 "Continue" after passing a chain quiz now goes to the next lesson. 1.0.13 Fixes the next chain quiz staying locked after a failed quiz. 1.0.12 Deleting and re-installing the plugin now keeps all your settings, quiz choices and lesson chains. 1.0.11 Strict forward-only quiz chains; failed quizzes are no longer marked complete. Test a chain lesson as a student after updating. 1.0.10 Chain lessons now complete reliably when a quiz is passed, and students move to the next available topic or lesson. 1.0.9 Quiz pairs become lesson quiz chains (switched on automatically for lessons with a pair). Check the chain order in each lesson's "Quiz chain" box. 1.0.8 Adds optional conditional progression for paired quizzes. Off until you turn it on; nothing changes for existing quizzes. 1.0.7 Adds per-quiz feedback settings. Existing quizzes keep using your current settings. 1.0.6 Adds the "Explanations to show" setting. Existing behavior is unchanged until you change it. 1.0.5 Adds a settings page and optional explanations after each question. Existing behavior is unchanged until you change the settings. 1.0.4 New plugin name and slug. No functional changes; existing explanations are kept. 1.0.3 Adds a LearnDash LMS requirement check on activation. 1.0.2 Explanations now stay with a question when LearnDash's legacy editor saves it under a new ID. 1.0.1 Fixes explanations not saving in the legacy LearnDash question editor. 1.0.0 Initial release.

常见问题:

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.

更新日志:

1.0.28 1.0.27 1.0.26 1.0.25 1.0.24 1.0.23 1.0.22 1.0.21 1.0.20 1.0.19 1.0.18 1.0.17 1.0.16 1.0.15 1.0.14 1.0.13 1.0.12 1.0.11 1.0.10 1.0.9 1.0.8 1.0.7 1.0.6 1.0.5 1.0.4 1.0.3 1.0.2 1.0.1 1.0.0