I've got a project that might be able to use the quiz module and I think we can throw some patches at it once the new cvs code gets submitted. I've got nicholasThompson's patches installed (http://drupal.org/node/77792), and besides some of the minor errors that I think people are waiting for, everything is working for me.

One major feature is the option to give feedback telling a student how he or she did, along with instructions for what to do next. As it stands, finishing a quiz is something of a dead-end.

As far as the interface goes, I could see adding the following form elements:

  • A text field with a value of the percentage of correct answers needed to pass the quiz.
  • A textarea for feedback at the end of the quiz for when the student has passed.
  • A textarea for feedback at the end of the quiz for when the student has failed.

As I said, I'd be willing to roll up a patch that does this if we can get a good, updated version in cvs. Feedback on these ideas would be great so we know whether we should consider the quiz module for this or not.

CommentFileSizeAuthor
#1 quiz_summary.patch13.87 KBseanbfuller

Comments

seanbfuller’s picture

StatusFileSize
new13.87 KB

Here is a patch that adds this basic functionality. This ended up being a bigger patch than I originally planned. My apologies in advance for that. I was hoping to make it smaller, but there were a number of issues that I had to fix while in there to bring it all together.

This patch relies on the following patches in this order:
http://drupal.org/node/77792 (working module)
http://drupal.org/node/84419 (completion of workflow for taking the quiz)
http://drupal.org/node/84408 (turning off the default value for quizes and handling the error)

Here is the punch list:

  1. The percentage to pass, the summary_pass and the summary_fail fields are all optional.
  2. Added a quiz_settings to incorporate a setting to completely turn off the pass / fail functions across all quizzes.
  3. Passed quiz_view through theme_quiz_view and moved most of the page's code there.
  4. Fixed some minor security issues in theme_quiz_view where some node data was not being passed through check_plain or check_markup.
  5. Added the display of summary options to theme_quiz_view
  6. Added the summary option display to theme_quiz_result
  7. Added three new fields to the .install file's hook_install for the quiz table.

Currently, this patch does not affect the admin quiz result page. Beyond some isolated bug fixes, that seems to be the biggest section that needs some love in order for it to be come a deliverable module. At this point the patch queue is pretty big, however, and I'd like to get feedback on the new version of the module before I proceed.

A note concerning pass / fail and the gradebook.

I went ahead and took a quick browse through the gradebook while working on this patch. I wanted to make sure I didn't do anything that would prohibit these two modules working together in the future. As far as I can tell, we should be Ok as long as we consider the percentage_score value an internal number. Quiz module should still be able to invoke the gradebook's hook_invoke_gradebookapi() to report back in a different manner if needed.

seanbfuller’s picture

Status: Active » Needs review

I forgot to update the status.

nicholasthompson’s picture

Interesting... Nikos and myself will have to have a look through this tomorrow. We need a working version of Quiz finished for the end of September (ie, Friday) for our Child Protection Courses that are to come out soon at www.optimusprolearning.com.

nicholasthompson’s picture

Oh I meant to say - on the Eurostar (on the way home) we did a couple of hours work on the module. We have a couple of new features for it... The biggest is feedback.

Each question has its own feedback. We wrote a function which summarises your quiz at the end. It tells you if you got the question correct or not plus a summary of what you answered.

The problem is, if the user selects all answer from a multi-select question, then all the feedback is given which basically gives the answer away. The alternatives are:
1) Dont give any feedback if the answer is not correct... But then how are they supposed to get it rights and, if they got it right, why do they need feedback?
2) Only give feedback to incorrect answers - but then its obvious which are right and wrong

Hmmm....

webchick’s picture

AFAIK "when to show feedback" was an option at one point. If it's not there anymore (or was never originally implemented) for some reason, it should be. So feedback could either be shown after each question, or collated for display at the end of the quiz.

nicholasthompson’s picture

Just a thought... Maybe the "when to show feedback" should be tied to the option for backtracking.

Whats the point in showing feedback just after a question if you cant backtrack to do anything about it?

webchick’s picture

Haha true. :) That doesn't make much sense. ;)

not sure they should be tied together; for example I might want people to be able to second-guess themselves and only show them if they're right or not at the very end. However, I agree that if "show feedback at the end of each question" is selected, then "Backwards navigation" should not be.

seanbfuller’s picture

By "pass or fail feedback" I was actually talking about additional (and optional) feedback at the quiz level. I realized this was a bit misleading in the interface so I changed the name to "summary" in an attempt to make it clearer. Sorry for the confusion.

This patch would allow for quiz creators to display a message at the end of the quiz, optionally based on how the student did and in addition to feedback on a question-by-question basis. For example, if they passed, the quiz might reply with "You passed! Go on to the next section by clicking on this link." If they did not get enough correct to pass, the quiz might reply with "You failed. Please go back to the materials and try again."

This patch implements these summaries as completely optional. Additionally, the fail message is actually labeled as the default message, meaning that you can give the same summary no matter how the student did.

What do you all think?

seanbfuller’s picture

Most of this was covered in http://drupal.org/node/85983. Anything else will be a new issue.

seanbfuller’s picture

Status: Needs review » Closed (duplicate)