diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/CHANGELOG.txt ./CHANGELOG.txt --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/CHANGELOG.txt 2007-04-14 02:03:38.000000000 +0530 +++ ./CHANGELOG.txt 2007-06-12 23:14:09.000000000 +0530 @@ -1,4 +1,4 @@ -$Id: CHANGELOG.txt,v 1.2 2007/04/13 20:33:38 webchick Exp $ +$Id: CHANGELOG.txt 107 2007-06-12 17:44:11Z karthik $ 2007-02-02 ---------- Only in /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz: CVS Common subdirectories: /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/images and ./images diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/INSTALL.txt ./INSTALL.txt --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/INSTALL.txt 2007-05-16 23:40:19.000000000 +0530 +++ ./INSTALL.txt 2007-06-12 23:14:10.000000000 +0530 @@ -1,4 +1,4 @@ -$Id: INSTALL.txt,v 1.9 2007/05/16 18:10:19 add1sun Exp $ +$Id: INSTALL.txt 107 2007-06-12 17:44:11Z karthik $ Installation ------------ Only in /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz: matching.module diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/multichoice.info ./multichoice.info --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/multichoice.info 2007-05-16 23:40:19.000000000 +0530 +++ ./multichoice.info 2007-06-12 23:14:11.000000000 +0530 @@ -1,4 +1,4 @@ -; $Id: multichoice.info,v 1.4 2007/05/16 18:10:19 add1sun Exp $ +; $Id: multichoice.info 107 2007-06-12 17:44:11Z karthik $ name = Multichoice package = Quiz description = Multiple choice question type diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/multichoice.module ./multichoice.module --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/multichoice.module 2007-05-18 20:58:37.000000000 +0530 +++ ./multichoice.module 2007-06-14 13:35:24.000000000 +0530 @@ -1,20 +1,38 @@ 'node/add/multichoice', + 'title' => t(MULTICHOICE_NAME), + 'access' => user_access('create multiple choice'), + ); + } + + return $items; +} + +/** * Implementation of hook_perm(). */ function multichoice_perm() { - return array('create multichoice', 'edit own multichoice'); + return array('create multiple choice', 'edit own multiple choice'); } /** @@ -24,11 +42,11 @@ function multichoice_access($op, $node) global $user; if ($op == 'create') { - return user_access('create multichoice'); + return user_access('create multiple choice'); } if ($op == 'update' || $op == 'delete') { - if (user_access('edit own multichoice') && ($user->uid == $node->uid)) { + if (user_access('edit own multiple choice') && ($user->uid == $node->uid)) { return TRUE; } } @@ -42,38 +60,22 @@ function multichoice_node_info() { 'multichoice' => array( 'name' => t(MULTICHOICE_NAME), 'module' => 'multichoice', - 'description' => t('A question type for the quiz module: allows you to create multiple choice questions (ex: A, B, C, D or true/false)'), + 'description' => t('A question type to use in a @quiz: allows you to create multiple choice questions (ex: A, B, C, D or True / False)', array('@quiz' => QUIZ_NAME)), ) ); } /** - * Implementation of hook_menu(). - */ -function multichoice_menu($may_cache) { - $items = array(); - if ($may_cache) { - $items[] = array( - 'path' => 'node/add/multichoice', - 'title' => t(MULTICHOICE_NAME), - 'access' => user_access('create multichoice'), - ); - } - return $items; -} - -/** * Implementation of hook_form(). */ function multichoice_form(&$node) { - - // Display multichoice form + // Display multichoice form. $form['title'] = array( '#type' => 'textfield', '#title' => t('Title'), '#default_value' => $node->title, '#required' => TRUE, - '#description' => t('Add a title that will help distinguish this question from other questions. This will not be seen during the quiz.'), + '#description' => t('A title that will help distinguish this question from other questions. This will not be seen during the quiz.'), ); $form['body'] = array( @@ -82,7 +84,7 @@ function multichoice_form(&$node) { '#default_value' => $node->body, '#required' => TRUE, ); - + $form['body_filter']['format'] = filter_form($node->format); $form['multiple_answers'] = array( @@ -91,57 +93,64 @@ function multichoice_form(&$node) { '#default_value' => $node->multiple_answers, ); - // Determine number of answer rows to display - if (!isset($node->rows)) { - $node->rows = max(2, $node->answers ? count($node->answers) : 5); - } + // Determine number of answer rows to display. The $_POST is used to ensure + // that new rows added during preview are retained if previewed again. + $rows = max(2, $node->answers ? count($node->answers) : 5, count($_POST['answers'])); if ($_POST['more']) { - $node->rows += 5; + $rows += 5; + // Ensure that the 'more' checkbox is unchecked once used. + unset($_POST['more']); } - $answers = $node->answers; + $answers = $node->answers ? $node->answers : array(); - // Display answer rows + // Display answer rows. $form['answers'] = array( '#type' => 'fieldset', '#title' => t('Choices'), '#tree' => TRUE, '#theme' => 'multichoice_form', ); - - for ($i = 0; $i < $node->rows; $i++) { + + reset($answers); + $answer = current($answers); + for ($i = 0; $i < $rows; $i++) { $form['answers'][$i]['correct'] = array( '#type' => 'checkbox', - '#default_value' => $answers[$i]['points'], + '#default_value' => isset($answer['points']) ? $answer['points'] : 0, ); - + $form['answers'][$i]['answer'] = array( '#type' => 'textarea', - '#default_value' => $answers[$i]['answer'], - '#cols' => 30, '#rows' => 2, + '#default_value' => isset($answer['answer']) ? $answer['answer'] : '', + '#cols' => 30, + '#rows' => 2, ); - + $form['answers'][$i]['feedback'] = array( '#type' => 'textarea', - '#default_value' => $answers[$i]['feedback'], - '#cols' => 30, '#rows' => 2, + '#default_value' => isset($answer['feedback']) ? $answer['feedback'] : '', + '#cols' => 30, + '#rows' => 2, ); - - if ($answers[$i]['aid']) { + + if (isset($answer['aid'])) { $form['answers'][$i]['delete'] = array( '#type' => 'checkbox', '#default_value' => 0, ); $form['answers'][$i]['aid'] = array( - '#type' => 'hidden', - '#value' => $answers[$i]['aid'], + '#type' => 'value', + '#value' => $answer['aid'], ); } + $answer = next($answers); } $form['more'] = array( '#type' => 'checkbox', - '#title' => t('I need more answers'), + '#title' => t('I need more answers.'), + '#description' => t('Check and click on the preview button to add more answer fields to the form.') ); return $form; @@ -151,27 +160,27 @@ function multichoice_form(&$node) { * Implementation of hook_validate(). */ function multichoice_validate(&$node) { - - // Hard-code questions to have no teaser and to not be promoted to front page + // Hard-code questions to have no teaser and to not be promoted to front page. $node->teaser = 0; $node->promote = 0; - if (!$node->nid && empty($_POST)) return; + if (!$node->nid && empty($_POST)) { + return; + } - // Validate body + // Validate body. if (!$node->body) { - form_set_error('body', t('Question text is empty')); + form_set_error('body', t('Question text is empty.')); } - // Validate answers + // Validate answers. $answers = array(); $corrects = 0; while (list($key, $answer) = each($node->answers)) { - if ($answer['correct']) { if ($corrects && !$node->multiple_answers) { - form_set_error('multiple_answers', t('Single choice yet multiple correct answers are present')); + form_set_error('multiple_answers', t('Single choice, yet multiple correct answers are present.')); } $corrects++; } @@ -181,13 +190,13 @@ function multichoice_validate(&$node) { } if (!$corrects) { - form_set_error("answers][0]['correct'", t('No correct choice(s)')); + form_set_error("answers][0]['correct'", t('No correct choice(s).')); } if (!count($answers)) { form_set_error("answers][0]['answer'", t('No answers.')); } if (count($answers) < 2) { - form_set_error("answers][0]['answer'", t('Must have at least two answers')); + form_set_error("answers][0]['answer'", t('Must have at least two answers.')); } } @@ -196,11 +205,11 @@ function multichoice_validate(&$node) { */ function multichoice_insert(&$node) { db_query("INSERT INTO {quiz_question} (nid, properties) VALUES(%d, '%s')", $node->nid, serialize(array('multiple_answers' => $node->multiple_answers))); - + while (list($key, $value) = each($node->answers)) { - if (trim($value['answer']) != "") - db_query("INSERT INTO {quiz_question_answer} (aid, question_nid, answer, feedback, points) VALUES(%d, %d, '%s', '%s', %d)", - db_next_id('{quiz_question_answer}_aid'), $node->nid, $value['answer'], $value['feedback'], $value['correct']); + if (trim($value['answer']) != "") { + db_query("INSERT INTO {quiz_question_answer} (aid, question_nid, answer, feedback, points) VALUES(%d, %d, '%s', '%s', %d)", db_next_id('{quiz_question_answer}_aid'), $node->nid, $value['answer'], $value['feedback'], $value['correct']); + } } } @@ -209,22 +218,22 @@ function multichoice_insert(&$node) { */ function multichoice_update($node) { db_query("UPDATE {quiz_question} SET properties = '%s' WHERE nid = %d", serialize(array('multiple_answers' => $node->multiple_answers)), $node->nid); - + while (list($key, $value) = each($node->answers)) { if ($value['aid']) { $value['answer'] = trim($value['answer']); if ($value['delete'] == 1 || empty($value['answer'])) { - //Delete this entry + // Delete this entry. db_query("DELETE FROM {quiz_question_answer} WHERE aid = %d", $value['aid']); - } + } else { - //Update this entry - db_query("UPDATE {quiz_question_answer} SET answer = '%s', feedback = '%s', points = %s WHERE aid = %d", $value['answer'], $value['feedback'], $value['correct'], $value['aid']); + // Update this entry. + db_query("UPDATE {quiz_question_answer} SET answer = '%s', feedback = '%s', points = %d WHERE aid = %d", $value['answer'], $value['feedback'], $value['correct'], $value['aid']); } - } + } else if (trim($value['answer']) != "") { - //If there is an answer, insert a new row - db_query("INSERT INTO {quiz_question_answer} (aid, question_nid, answer, feedback, points) VALUES(%d, %d, '%s', '%s', %d)", + // If there is an answer, insert a new row. + db_query("INSERT INTO {quiz_question_answer} (aid, question_nid, answer, feedback, points) VALUES(%d, %d, '%s', '%s', %d)", db_next_id('{quiz_question_answer}_aid'), $node->nid, $value['answer'], $value['feedback'], $value['correct']); } } @@ -246,12 +255,13 @@ function multichoice_load($node) { $answers = array(); $result = db_query("SELECT * FROM {quiz_question_answer} WHERE question_nid = %d", $node->nid); while ($line = db_fetch_array($result)) { - $answers[] = $line; + $answers[$line['aid']] = $line; } $additions->answers = $answers; $additions->properties = unserialize($additions->properties); $additions->multiple_answers = $additions->properties['multiple_answers']; + return $additions; } @@ -259,36 +269,34 @@ function multichoice_load($node) { * Implementation of hook_view(). */ function multichoice_view(&$node, $teaser = FALSE, $page = FALSE) { - if (user_access('create multichoice')) { + if (user_access('create multiple choice')) { if (!$teaser) { $mynode = node_prepare($node, $teaser); - $mynode->content['body'] = array('#value' => multichoice_render_question($node)); + $mynode->content['body'] = array('#value' => multichoice_render_question($node, 'view')); + return $mynode; - //$node->body = multichoice_render_question($node); } } else if ($teaser) { $mynode = node_prepare($node, $teaser); + return $mynode; - //$node->teaser = t('This is a quiz question, not to be viewed independently.'); - //$node->body = $node->teaser; // we do not need Read more... - } - else { - drupal_access_denied(); } + + drupal_access_denied(); } /** - * Print question to screen + * Print question to screen. * * @param $node - * Question node + * Question node. * * @return - * HTML output + * HTML output. */ -function multichoice_render_question_form($node) { - // Radio buttons for single selection questions, checkboxes for multiselect +function multichoice_render_question_form($node, $quiz_id, $caller) { + // Radio buttons for single selection questions, checkboxes for multiselect. if ($node->multiple_answers == 0) { $type = 'radios'; } @@ -296,7 +304,7 @@ function multichoice_render_question_for $type = 'checkboxes'; } - // Get options + // Get options. $options = array(); while (list($key, $answer) = each($node->answers)) { @@ -304,37 +312,51 @@ function multichoice_render_question_for unset($node->answers[$key]); } else { - $options[$key] = '
'. check_markup($answer['answer'], $node->format, FALSE) .'
'; + // TODO: Add node format support for each answer. + $options[$key] = check_plain($answer['answer']); } } - - $form['start'] = array('#type' => 'markup', '#value' => '
'); - $form['question'] = array('#type' => 'markup', '#value' => check_markup($node->body, $node->format, FALSE)); - - // Create form + + $form['question'] = array('#value' => check_markup($node->body, $node->format, FALSE)); $form['tries'] = array( '#type' => $type, + '#title' => t('Options'), '#options' => $options, - '#default_value' => -1, - ); - - $form['submit'] = array( - '#type' => 'submit', - '#value' => t('Submit'), + '#required' => TRUE ); - + + // Display buttons only if the question is being called as part of a quiz. + if ($caller == 'quiz' ) { + $form['question_id'] = array('#type' => 'value', '#value' => $node->nid); + $form['quiz_id'] = array('#type' => 'value', '#value' => $quiz_id); + $form['submit'] = array( + '#type' => 'submit', + '#value' => t('Submit'), + ); + } + return $form; } -function multichoice_render_question($node) { - return drupal_get_form('multichoice_render_question_form', $node); +function multichoice_render_question_form_submit($form_id, $form_values) { + $tries = is_array($form_values['tries']) ? array_filter($form_values['tries']) : $form_values['tries']; + $question = node_load($form_values['question_id']); + $input = multichoice_structure_input($question, $tries); + // FIXME: Avoid having to pass quiz_id around like below. + quiz_update_result($form_values['quiz_id'], $question, $input); +} + +function multichoice_render_question($question_node, $quiz_id = 0, $caller = 'quiz') { + return drupal_get_form('multichoice_render_question_form', $question_node, $quiz_id, $caller); } /** - * Evaluate whether question is correct + * Structure user input and answers for storage in the questions_results table. * - * @param $nid - * Question Node ID + * @param $question + * Question node. + * @param $tries + * User input. * * @return * Array of results, in the form of: @@ -343,99 +365,94 @@ function multichoice_render_question($no * 'tried' => array of selected answer(s) * ); */ -function multichoice_evaluate_question($nid) { - $question = node_load($nid); +function multichoice_structure_input($question, $tries) { $results = array(); - if (isset($_POST['tries'])) { - if (is_array($_POST['tries'])) { - - // Multi-answer question - while (list($key, $try) = each($_POST['tries'])) { - $results['answers'] = $question->answers; - $results['tried'][] = $question->answers[$try]['aid']; - } - } - else { - - // Single-answer question + if (is_array($tries)) { + // Multi-answer question. + while (list($key, $try) = each($tries)) { $results['answers'] = $question->answers; - $results['tried'][] = $question->answers[$_POST['tries']]['aid']; + $results['tried'][] = $question->answers[$try]['aid']; } } - //Unset $_POST, otherwise it tries to use the previous answers on the next page... - unset($_POST['tries']); - - //Return the result + else { + // Single-answer question. + $results['answers'] = $question->answers; + $results['tried'][] = $question->answers[$tries]['aid']; + } + return $results; } -//Old claculate result function -function multichoice_calculate_result($answers, $tried) { - if (empty($answers)) return; +// Old calculate result function. +function multichoice_calculate_result($input) { + $answers = $input['answers']; + $tried = $input['tried']; + if (empty($answers)) { + return; + } while (list($key, $answer) = each($answers)) { if ($answer['points'] == 1) { if (($key = array_search($answer['aid'], $tried)) !== FALSE) { - //Correct answer was selected, so lets take that out the tried list + // Correct answer was selected, so lets take that out the tried list. unset($tried[$key]); } else { - //Correct answer was not in the "tried" list, so score 0 - return 0; + // Correct answer was not in the "tried" list, so score 0. + return FALSE; } } } - //Finally - have we got any answers left? - //If so - they weren't knocked out as one of the correct ones so logically they must be incorrect! - if (count($tried) > 0) return 0; + // Finally - have we got any answers left? + // If so - they weren't knocked out as one of the correct ones so logically + // they must be incorrect! + if (count($tried) > 0) { + return FALSE; + } - - //Finally, we can consider this correct if its passed the above tests! - return 1; + // Finally, we can consider this correct if it passed the above tests! + return TRUE; } -//New singing and dancing one +// New singing and dancing one. function multichoice_calculate_results($answers, $tried, $showpoints = FALSE, $showfeedback = FALSE) { - //Create results table + // Create results table. $rows = array(); $correctanswers = array(); - + while (list($key, $answer) = each($answers)) { $cols = array(); - + $cols[] = $answer['answer']; - if ($showpoints) $cols[] = (($answer['points'] == 0) ? theme_multichoice_unselected() : theme_multichoice_selected()); - $selected = (array_search($answer['aid'], $tried) !== FALSE); - $cols[] = ($selected ? theme_multichoice_selected() : theme_multichoice_unselected()); - if ($showfeedback) $cols[] = ($selected ? '
'. $answer['feedback'] .'
' : ''); - + if ($showpoints) { + $cols[] = $answer['points'] == 0 ? theme_multichoice_unselected() : theme_multichoice_selected(); + } + $selected = array_search($answer['aid'], $tried) !== FALSE; + $cols[] = $selected ? theme_multichoice_selected() : theme_multichoice_unselected(); + if ($showfeedback) { + $cols[] = $selected ? '
'. $answer['feedback'] .'
' : ''; + } + $rows[] = $cols; - - + if ($answer['points'] > 0) { $correctanswers[] = $answer['aid']; } } - - if ($correctanswers === $tried) { - $score = 1; - } - else { - $score = 0; - } + $score = $correctanswers === $tried ? TRUE : FALSE; - return array('score' => $score, 'resultstable' => $rows); + return array('score' => $score, 'results_table' => $rows); } /** - * List all multiple choice questions + * List all multiple choice questions. * * @return - * Array of questions + * Array of questions. */ function multichoice_list_questions() { - $result = db_query("SELECT nid, body, format FROM {node} WHERE type= '%s'", 'multichoice'); + $result = db_query("SELECT nid, body, format FROM {node} WHERE type = 'multichoice'"); $questions = array(); while ($node = db_fetch_object($result)) { $question = new stdClass(); @@ -443,6 +460,7 @@ function multichoice_list_questions() { $question->nid = $node->nid; $questions[] = $question; } + return $questions; } @@ -451,24 +469,23 @@ function multichoice_list_questions() { ///////////////////////////////////////////////// /** - * Theme function for multichoice form + * Theme function for multichoice form. * - * Lays out answer field elements into a table + * Lays out answer field elements into a table. * * @return string - * HTML output + * HTML output. */ function theme_multichoice_form($form) { - - // Format table header + // Format table header. $header = array( - array('data' => t('Correct')), - array('data' => t('Answer'), 'style' => 'width:250px;'), - array('data' => t('Feedback'), 'style' => 'width:250px;'), - array('data' => t('Delete')), + t('Correct'), + t('Answer'), + t('Feedback'), + t('Delete') ); - // Format table rows + // Format table rows. $rows = array(); foreach (element_children($form) as $key) { $rows[] = array( @@ -479,36 +496,31 @@ function theme_multichoice_form($form) { ); } - // Theme output and display to screen - $output = theme('table', $header, $rows); + // Theme output and display to screen. + $output = theme('table', $header, $rows, array('class' => 'multichoice-choices-table')); return $output; } - /** - * Theme a selection indicator for an answer - * TODO: Default images would be nice + * Theme a selection indicator for an answer. + * TODO: Default images would be nice. */ function theme_multichoice_selected() { return theme_image(drupal_get_path('module', 'quiz') .'/images/selected.gif', t('selected')); } - /** - * Theme an indicator that an answer is not selected / correct - * TODO: Default images would be nice + * Theme an indicator that an answer is not selected / correct. + * TODO: Default images would be nice. */ function theme_multichoice_unselected() { return theme_image(drupal_get_path('module', 'quiz') .'/images/unselected.gif', t('unselected')); } - /** - * Theme function for the multichoice form + * Theme function for the multichoice form. */ function theme_multichoice_render_question_form($form) { - $output = ''; - $output .= drupal_render($form) .'
'; - return $output; + return '
'. drupal_render($form) .'
'; } Only in .: quiz4.patch Only in .: quiz5.patch Only in .: quiz6.patch Only in .: quiz7.patch Only in .: quiz8.patch diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.css ./quiz.css --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.css 2007-05-16 23:40:19.000000000 +0530 +++ ./quiz.css 2007-06-13 11:03:32.000000000 +0530 @@ -1,55 +1,57 @@ -/* $Id: quiz.css,v 1.5 2007/05/16 18:10:19 add1sun Exp $ */ +/* $Id: quiz.css 113 2007-06-13 05:33:31Z karthik $ */ -/* -** Definitions that apply while taking the quiz -*/ -#quiz_progress { +.quiz-options-table { + width: auto; +} + +#quiz-progress { font-style: italic; font-size: 80%; } -div.multichoice_answer_text p { - display: inline; +.quiz-question-bullet { + font-weight: bold; + font-size: 120%; +} + +#quiz-score-possible, #quiz-score-percent { + font-weight: bold; } -.multichoice_answer_text { - margin: -1.9em 0 0 2em; +.quiz-score-correct, .quiz-score-incorrect { + width: 50px; } -/* -** Definitions that apply on the summary pages -*/ -.quiz_question_bullet { - font-weight: bold; - font-size: 120%; +.quiz-score-correct { + background: transparent url(images/correct.gif) no-repeat center; } -#quiz_score_possible, #quiz_score_percent { - font-weight: bold; +.quiz-score-incorrect { + background: transparent url(images/incorrect.gif) no-repeat center; } -.quiz_summary_question { +.quiz-summary-question { margin-bottom: 0.5em; } -tr.quiz_summary_qrow { +tr.quiz-summary-qrow { background: transparent; } -td.quiz_summary_qcell { +td.quiz-summary-qcell { vertical-align: top; padding: 1em 1em 0em 0em; } -td.quiz_summary_qcell table tr { +td.quiz-summary-qcell table tr { background: transparent; } -td.quiz_summary_qcell table td { +td.quiz-summary-qcell table td { vertical-align: top; padding: .5em; } -.quiz_answer_feedback { +.quiz-answer-feedback { font-style: italic; } diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz_datetime.inc ./quiz_datetime.inc --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz_datetime.inc 2007-04-14 02:03:38.000000000 +0530 +++ ./quiz_datetime.inc 2007-06-12 23:14:15.000000000 +0530 @@ -1,5 +1,5 @@ _quiz_date('j', $time), + 'month' => _quiz_date('n', $time), + 'year' => _quiz_date('Y', $time), + ); + } + // return the array + return $time_array; +} diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.info ./quiz.info --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.info 2007-05-16 23:40:19.000000000 +0530 +++ ./quiz.info 2007-06-12 23:14:14.000000000 +0530 @@ -1,5 +1,5 @@ -; $Id: quiz.info,v 1.4 2007/05/16 18:10:19 add1sun Exp $ +; $Id: quiz.info 107 2007-06-12 17:44:11Z karthik $ name = Quiz package = Quiz -description = Create interactive quizzes +description = Create interactive quizzes. version = "$Name: $" \ No newline at end of file diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.install ./quiz.install --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.install 2007-04-14 02:03:38.000000000 +0530 +++ ./quiz.install 2007-06-12 23:09:13.000000000 +0530 @@ -1,15 +1,14 @@ uid == $node->uid)) { - return TRUE; - } - } - - if (user_access('administer quiz')) { - return TRUE; +function quiz_help($section) { + switch ($section) { + case 'admin/help#quiz': + return t(' +

Description

+

The quiz module allows users to administer a quiz, as a sequence of questions, and track the answers given. It allows for the creation of questions (and their answers), and organizes these questions into a quiz. Finally, it provides a mechanism for ensuring question quality through a combination of community revision and moderation. Its target audience includes educational institutions, online training programs, employers, and people who just want to add a fun activity for their visitors to their Drupal site.

+

Creating Your First Quiz

+

Creating an initial quiz requires three steps:

+
    +
  1. Create at least one taxonomy vocabulary and assign it to the quiz and question type modules
    2. +
  2. Create a series of questions
    3. +
  3. Create a quiz based on the series of questions
    4. +
+

Also note that for anyone but the site administrator, creating quizzes requires the create quiz privilege, and creating questions requires the administer question type privilege. These settings can be configured in Administer >> User management >> Access control.

+

Setting up a vocabulary

+
    +
  1. If not already enabled, go to the Administer >> Site building >> Modules section of the control panel and check the enable checkbox to enable the taxonomy module.
    2. +
  2. If you do not already have a taxonomy vocabulary suitable for quizzes, go to Administer >> Content management >> Categories and create a vocabulary for quizzes (for example, Quiz Topics). Ensure that under Types, both quiz and all question types (for example, multichoice) are selected. Depending on your needs, you may wish to create a hierarchical vocabulary, so that topics can be sub-divided into smaller areas, and/or enable multiple select to associate quizzes and questions with more than one category.
    3. +
  3. Add a series of terms to the vocabulary to which questions and quizzes can be assigned. For example: +
+

Creating quiz questions

+
    +
  1. Begin by clicking Create content, and then select a question type node (for example, multichoice)
    2. +
  2. Fill out the question form. The presented interface will vary depending on the question type, but for multiple choice questions: +
    +
    Title
    +
    Question title. This will be displayed as the heading of the question.
    +
    Taxonomy selection
    +
    Any taxonomy vocabularies that are assigned to the question type will be displayed. Select from the terms displayed in order to assign questions to vocabulary terms so that they can be filtered in the quiz creation process.
    +
    Question
    +
    The actual question text (for example, What is 2+2?).
    +
    Multiple Answers
    +
    Whether or not the question has multiple correct answers, such as a "Select all that apply" question.
    +
    Correct
    +
    Indicates that given answer is a correct answer.
    +
    Answer
    +
    An answer choice (for example, 4). If more answers are required, check I need more answers and click the Preview button.
    +
    Feedback
    +
    Feedback, if supplied, will be provided to the user either immediately after answering the question, at the end of the quiz, or not at all (feedback options are configured in quizzes).
    +
    +
    3. +
  3. Repeat for each question you would like included on the quiz.
    4. +
+

Creating the quiz

+
    +
  1. Go to Create content >> Quiz to access the quiz creation form.
    2. +
  2. Fill out the form to set the @quiz options: +
    +
    Title
    +
    Quiz title. This will be displayed as the heading of the quiz.
    +
    Taxonomy selection
    +
    Any taxonomy vocabularies that are assigned to the quiz type will be displayed. Select from the terms displayed in order to assign the quiz to vocabulary terms.
    +
    Number of questions
    +
    Total number of questions on quiz.
    +
    Shuffle questions
    +
    Whether or not to shuffle (randomize) the questions.
    +
    Backwards Navigation
    +
    Whether or not to allow users to return to a previous question.
    +
    Feedback
    +
    Set options on when and whether question feedback should appear.
    +
    Number of takes
    +
    Number of takes to allow user. Varies from 1-9 or Unlimited times.
    +
    +
    3. +
  3. Once the quiz has been created, click the add questions tab to assign questions to the quiz.
    4. +
  4. Begin by selecting one or more terms from the taxonomy list and click Filter question list. This will bring up a selection of questions matching the selected vocabulary terms.
    5. +
  5. Select a radio button next to each question indicating if the question should appear (Randomly, Always, or Never), and click Submit questions.
    6. +
  6. Repeat process until satisfied with question selection.
    7. +
+ ', array('@quiz' => QUIZ_NAME, '@admin-access' => url('admin/user/access'), '@admin-modules' => url('admin/build/modules'), '@admin-taxonomy' => url('admin/content/taxonomy'), '@create-content' => url('node/add'), '@multichoice' => url('node/add/multichoice'), '@create-quiz' => url('node/add/quiz'))); + case 'node/add#quiz': + return t('A collection of questions designed to create interactive tests'); + default: + break; } } /** - * Implementation of hook_node_info(). - */ -function quiz_node_info() { - return array( - 'quiz' => array( - 'name' => t('@quiz', array("@quiz" => QUIZ_NAME)), - 'module' => 'quiz', - 'description' => 'Create interactive quizzes for site visitors')); -} - -/** * Implementation of hook_menu(). */ function quiz_menu($may_cache) { $items = array(); if ($may_cache) { - $access = user_access(QUIZ_PERM_ADMIN_CONFIG); + $access = user_access('administer quiz configuration'); $items[] = array( 'path' => 'admin/settings/quiz', - 'title' => t('@quiz Configuration', array('@quiz' => QUIZ_NAME)), - 'description' => t('Describes what the settings generally do.'), + 'title' => t('Quiz'), + 'description' => t('Configure settings for the quiz module.'), 'callback' => 'drupal_get_form', 'callback arguments' => array('quiz_admin_settings'), - 'access' => user_access(QUIZ_PERM_ADMIN_CONFIG), - 'type' => MENU_NORMAL_ITEM, // optional + 'access' => $access, + 'type' => MENU_NORMAL_ITEM, ); $items[] = array( @@ -96,71 +168,74 @@ function quiz_menu($may_cache) { 'access' => user_access('create quiz'), ); - $items[] = array( - 'path' => 'admin/quiz', - 'title' => t('@quiz Results', array('@quiz' => QUIZ_NAME)), - 'callback' => 'quiz_admin', - 'access' => user_access('administer quiz'), - 'type' => MENU_NORMAL_ITEM, - ); + $items[] = array( + 'path' => 'admin/quiz', + 'title' => t('@quiz results', array('@quiz' => QUIZ_NAME)), + 'callback' => 'quiz_admin', + 'access' => user_access('administer quiz'), + 'type' => MENU_NORMAL_ITEM, + ); } else { - drupal_add_css(drupal_get_path('module', 'quiz') .'/quiz.css', 'module', 'all'); - if (arg(0) == 'node' && is_numeric(arg(1))) { - $node = node_load(arg(1)); - if ($node->type == 'quiz') { - - // Menu item for creating adding questions to quiz - $items[] = array( - 'path' => 'node/'. arg(1) .'/questions', - 'title' => t('Manage questions'), - 'callback' => 'quiz_questions', - 'access' => user_access('create quiz'), - 'type' => MENU_LOCAL_TASK, - ); - - // Menu item for quiz taking interface - $items[] = array( - 'path' => 'node/'. arg(1) .'/quiz/start', - 'title' => t('Take @quiz', array('@quiz' => QUIZ_NAME)), - 'callback' => 'quiz_take_quiz', - 'access' => user_access('access quiz'), - 'type' => MENU_LOCAL_TASK, - ); + $path = drupal_get_path('module', 'quiz'); + include($path .'/quiz_datetime.inc'); + drupal_add_css($path .'/quiz.css'); + + if (arg(0) == 'node' && is_numeric(arg(1))) { + $node = node_load(arg(1)); + if ($node->type == 'quiz') { + // Menu item for creating adding questions to quiz. + $items[] = array( + 'path' => 'node/'. arg(1) .'/questions', + 'title' => t('Manage questions'), + 'callback' => 'quiz_manage_questions', + 'access' => user_access('create quiz'), + 'type' => MENU_LOCAL_TASK, + ); + + // Menu item for quiz taking interface. + $items[] = array( + 'path' => 'node/'. arg(1) .'/engine', + 'title' => t('Take @quiz', array('@quiz' => QUIZ_NAME)), + 'callback' => 'quiz_engine', + 'access' => user_access('access quiz'), + 'type' => MENU_CALLBACK, + ); } } else { $items[] = array( 'path' => 'user/'. arg(1) .'/myresults', - 'title' => t('my results'), + 'title' => t('My results'), 'callback' => 'quiz_get_user_results', - 'access' => user_access('user results'), + 'access' => user_access('access quiz results'), 'type' => MENU_LOCAL_TASK, ); $items[] = array( - 'path' => 'user/quiz/'. arg(2) .'/userresults', - 'title' => t('User Results'), + 'path' => 'user/quiz/'. arg(2), + 'title' => t('User results'), 'callback' => 'quiz_user_results', - 'access' => user_access('user results'), + 'access' => user_access('access quiz results'), 'type' => MENU_CALLBACK, ); - + $items[] = array( - 'path' => 'admin/quiz/'. arg(2) .'/view', + 'path' => 'admin/quiz/'. arg(2), 'title' => t('View @quiz', array('@quiz' => QUIZ_NAME)), 'callback' => 'quiz_admin_results', 'access' => user_access('administer quiz'), 'type' => MENU_CALLBACK, ); - + $items[] = array( 'path' => 'admin/quiz/'. arg(2) .'/delete', 'title' => t('Delete @quiz', array('@quiz' => QUIZ_NAME)), - 'callback' => 'quiz_admin_result_delete', + 'callback' => 'drupal_get_form', + 'callback arguments' => 'quiz_admin_result_delete_form', 'access' => user_access('administer quiz'), - 'type' => MENU_CALLBACK); - + 'type' => MENU_CALLBACK + ); } } @@ -168,14 +243,59 @@ function quiz_menu($may_cache) { } /** + * Implementation of hook_perm(). + */ +function quiz_perm() { + return array('administer quiz configuration', 'administer quiz', 'create quiz', 'access quiz', 'access quiz results'); +} + +/** + * Implementation of hook_access(). + */ +function quiz_access($op, $node) { + global $user; + + if ($op == 'view') { + return user_access('access quiz'); + } + + if ($op == 'create') { + return user_access('create quiz'); + } + + if ($op == 'update' || $op == 'delete') { + if (user_access('create quiz') && ($user->uid == $node->uid)) { + return TRUE; + } + } + + if (user_access('administer quiz')) { + return TRUE; + } +} + +/** + * Implementation of hook_node_info(). + */ +function quiz_node_info() { + return array( + 'quiz' => array( + 'name' => t('@quiz', array("@quiz" => QUIZ_NAME)), + 'module' => 'quiz', + 'description' => t('Create an interactive @quiz for site visitors.', array('@quiz' => QUIZ_NAME)) + ) + ); +} + +/** * Implementation of hook_form(). */ -function quiz_form(&$node) { +function quiz_form(&$node) { $form['title'] = array( '#type' => 'textfield', '#title' => t('Title'), '#default_value' => $node->title, - '#description' => t('The name of the @quiz', array('@quiz' => QUIZ_NAME)), + '#description' => t('The name of the @quiz.', array('@quiz' => QUIZ_NAME)), '#required' => TRUE, ); @@ -183,60 +303,65 @@ function quiz_form(&$node) { '#type' => 'textarea', '#title' => t('Description'), '#default_value' => $node->body, - '#description' => t('A description of what the @quiz entails', array('@quiz' => QUIZ_NAME)), + '#description' => t('A description of what the @quiz entails.', array('@quiz' => QUIZ_NAME)), '#required' => TRUE, ); $form['body_filter']['format'] = filter_form($node->format); $form['number_of_questions'] = array( '#type' => 'textfield', - '#title' => t('Number of questions'), - '#default_value' => ($node->number_of_questions ? $node->number_of_questions : 10), - '#description' => t('The number of questions to include in this @quiz from the question bank', array('@quiz' => QUIZ_NAME)), + '#title' => t('Maximum number of questions'), + '#default_value' => $node->number_of_questions ? $node->number_of_questions : 0, + '#description' => t('The maximum number of questions to include in this @quiz from the question bank. Enter 0 if you would like all questions to be included.', array('@quiz' => QUIZ_NAME)), '#required' => TRUE, ); - + $form['shuffle'] = array( '#type' => 'checkbox', '#title' => t('Shuffle questions'), - '#default_value' => (isset($node->shuffle) ? $node->shuffle : 1), - '#description' => t('Whether to shuffle/randomize the questions on the @quiz', array('@quiz' => QUIZ_NAME)), + '#default_value' => isset($node->shuffle) ? $node->shuffle : 1, + '#description' => t('Whether to shuffle/randomize the questions on the @quiz.', array('@quiz' => QUIZ_NAME)), ); $form['backwards_navigation'] = array( '#type' => 'checkbox', '#title' => t('Backwards navigation'), '#default_value' => $node->backwards_navigation, - '#description' => t('Whether to allow user to go back and revisit their answers'), + '#description' => t('Whether to allow user to go back and revisit their answers.'), ); $form['feedback'] = array( '#type' => 'fieldset', - '#title' => t('When do you want to give feedback?'), + '#title' => t('Feedback'), + '#description' => t('When should feedback be given to the candidate?'), + '#collapsible' => TRUE, + '#collapsed' => TRUE ); $form['feedback']['feedback_time'] = array( '#type' => 'radios', - '#default_value' => $node->feedback_time, + '#default_value' => $node->feedback_time ? $node->feedback_time : FEEDBACK_AFTER_QUIZ, + '#title' => t('Time of feedback'), '#options' => array( - t('At the end of the @quiz', array('@quiz' => QUIZ_NAME)), - t('After each question'), - t('Do not show') + FEEDBACK_AFTER_QUIZ => t('At the end of the @quiz.', array('@quiz' => QUIZ_NAME)), + FEEDBACK_AFTER_QUESTION => t('After each question.'), + FEEDBACK_AFTER_BOTH => t('After each question and at the end of the @quiz.', array('@quiz' => QUIZ_NAME)), + FEEDBACK_NEVER_SHOW => t('Never show.') ), - '#description' => t('Indicates at what point feedback for each question will be given to the user'), + '#required' => TRUE ); - // Set up the availability options + // Set up the availability options. $form['quiz_availability'] = array( '#type' => 'fieldset', '#title' => t('Availability options'), - '#collapsed' => FALSE, + '#collapsed' => TRUE, '#collapsible' => TRUE, ); $form['quiz_availability']['quiz_always'] = array( '#type' => 'checkbox', - '#title' => t('Always Available'), - '#default_value' => $node->quiz_always, + '#title' => t('Always available'), + '#default_value' => isset($node->quiz_always) ? $node->quiz_always : 1, '#description' => t('Click this option to ignore the open and close dates.'), ); $form['quiz_availability']['quiz_open'] = array( @@ -248,54 +373,50 @@ function quiz_form(&$node) { $form['quiz_availability']['quiz_close'] = array( '#type' => 'date', '#title' => t('Close Date'), - '#default_value' => _quiz_form_prepare_date($node->quiz_close, variable_get('quiz_default_close', 30)), + '#default_value' => _quiz_form_prepare_date($node->quiz_close, quiz_variable_get('expire')), '#description' => t('The date this @quiz will cease to be available.', array('@quiz' => QUIZ_NAME)), ); - $options = array('Unlimited'); - for ($i = 1; $i < 10; $i++) { - $options[$i] = $i; - } - $form['takes'] = array( + $form['quiz_availability']['takes'] = array( '#type' => 'select', '#title' => t('Number of takes'), '#default_value' => $node->takes, - '#options' => $options, - '#description' => t('The number of times a user is allowed to take the @quiz', array('@quiz' => QUIZ_NAME)), + '#options' => range(0, 100), + '#description' => t('The number of times a user is allowed to take the @quiz. 0 represents an unlimited number of takes.', array('@quiz' => QUIZ_NAME)), ); - // Quiz summary options - $form['summaryoptions'] = array( + // Quiz summary options. + $form['summary_options'] = array( '#type' => 'fieldset', - '#title' => t('@quiz Summary Options', array('@quiz' => QUIZ_NAME)), + '#title' => t('@quiz summary options', array('@quiz' => QUIZ_NAME)), '#collapsible' => TRUE, - '#collapsed' => FALSE, + '#collapsed' => TRUE, ); - if (variable_get('quiz_use_passfail', 1)) { - // New nodes get the default. Otherwise they get 0. (ignore pass / fail feedback) + if (quiz_variable_get('access_pass_settings')) { + // New nodes get the default. Otherwise they get 0. + // (Ignore pass / fail feedback). if (!$node->nid) { - $node->pass_rate = variable_get('quiz_default_pass_rate', 75); + $node->pass_rate = quiz_variable_get('pass_mark'); } - $form['summaryoptions']['pass_rate'] = array( - '#type' => 'textfield', - '#title' => t('Pass rate for @quiz (%)', array('@quiz' => QUIZ_NAME)), - '#default_value' => ($node->pass_rate ? $node->pass_rate : 0), - '#description' => t('Pass rate for the @quiz as a percentage score', array('@quiz' => QUIZ_NAME)), - '#required' => FALSE, + $form['summary_options']['pass_rate'] = array( + '#type' => 'select', + '#title' => t('Pass percentage for the @quiz.', array('@quiz' => QUIZ_NAME)), + '#options' => range(0, 100), + '#default_value' => $node->pass_rate ? $node->pass_rate : 0, + '#description' => t('Pass percentage for the @quiz.', array('@quiz' => QUIZ_NAME)), + '#required' => FALSE ); - $form['summaryoptions']['summary_pass'] = array( + $form['summary_options']['summary_pass'] = array( '#type' => 'textarea', '#title' => t('Summary text if passed.'), '#default_value' => $node->summary_pass, - '#cols' => 60, '#description' => t('Summary for when the user gets enough correct answers to pass the @quiz. Leave blank if you don\'t want to give different summary text if they passed or if you are not using the "percent to pass" option above. If you don\'t use the "Percentage needed to pass" field above, this text will not be used.', array('@quiz' => QUIZ_NAME)), ); } - $form['summaryoptions']['summary_default'] = array( + $form['summary_options']['summary_default'] = array( '#type' => 'textarea', '#title' => t('Default summary text.'), '#default_value' => $node->summary_default, - '#cols' => 60, '#description' => t("Default summary. Leave blank if you don't want to give a summary."), ); @@ -303,121 +424,18 @@ function quiz_form(&$node) { } /** - * Takes a time element and prepares to send it to form_date() - * - * @param $time - * The time to be turned into an array. This can be: - * - a timestamp when from the database - * - an array (day, month, year) when previewing - * - null for new nodes - * @return - * an array for form_date (day, month, year) - */ -function _quiz_form_prepare_date($time = '', $offset = 0) { - // if this is empty, get the current time - if ($time == '') { - $time = time(); - $time = strtotime("+$offset days", $time); - } - // If we are previewing, $time will be an array so just pass it through - $time_array = array(); - if (is_array($time)) { - $time_array = $time; - } - // otherwise build the array from the timestamp - elseif (is_numeric($time)) { - $time_array = array( - 'day' => _quiz_date('j', $time), - 'month' => _quiz_date('n', $time), - 'year' => _quiz_date('Y', $time), - ); - } - // return the array - return $time_array; -} - -/** - * @param $nid - * Quiz ID - * Finds out the number of questions for the quiz. - * Good example of usage could be to calculate the % of score - * @return integer - * Returns the number of quiz questions. - */ -function quiz_get_number_of_questions($nid) { - $result = db_fetch_object(db_query('SELECT number_of_questions FROM {quiz} WHERE nid = %d', $nid)); - $number_of_questions = $result->number_of_questions; - return $number_of_questions; -} - -/** - * @param $nid - * Quiz ID - * Finds out the pass rate for the quiz. - * @return integer - * Returns the pass rate of quiz. - */ -function quiz_get_pass_rate($nid) { - $passrate = db_fetch_object(db_query('SELECT pass_rate FROM {quiz} WHERE nid = %d', $nid)); - return $passrate->pass_rate; -} - -/** * Implementation of hook_validate(). */ function quiz_validate($node) { - if (!$node->nid && empty($_POST)) return; - - if (empty($node->body)) { - form_set_error('body', t('Description is required.')); - } - - // validate the number of questions against the actual questions assigned to this quiz - if ($node->number_of_questions < 1) { - form_set_error('number_of_questions', t('Number of questions is required and must be a positive number.')); - } - else if ($node->nid) { - // get the number of each kind of question - $anum_random = quiz_get_num_questions($node->nid, QUESTION_RANDOM); - $anum_always = quiz_get_num_questions($node->nid, QUESTION_ALWAYS); - $anum_total = $anum_always + $anum_random; - // If we have random number, add one to the low range. - if ($anum_random > 0) { - $anum_always++; - } - // If we have more than one random number, lower the high range by one. - if ($anum_random > 1) { - $anum_total--; - } - // format the valid range - if ($anum_always != $anum_total) { - $range = t('between %low and %high', array('%low' => $anum_always, '%high' => $anum_total)); - } - else { - $range = $anum_total; - } - // If there are not enough questions to support this number. - if ($anum_total < $node->number_of_questions) { - form_set_error('number_of_questions', t("You don't currently have enough questions assigned to this @quiz to support that many questions. Either change the number of questions to %range or !action to this @quiz.", array('@quiz' => QUIZ_NAME, '%range' => $range, '!action' => l(t('add more questions'), 'node/'. $node->nid .'/questions')))); - } - // If there are too many questions for this number. - else if ($anum_always > $node->number_of_questions) { - form_set_error('number_of_questions', t('There are too many questions assigned to this @quiz to support that low of a number. Either change the number of questions to %range or !action from this @quiz.', array('@quiz' => QUIZ_NAME, '%range' => $range, '!action' => l(t('remove some questions'), 'node/'. $node->nid .'/questions')))); - } + // Validate the number of questions against the actual questions assigned to + // this quiz. + if (!is_numeric($node->number_of_questions) || $node->number_of_questions < 0) { + form_set_error('number_of_questions', t('The maximum umber of questions must be a positive number.')); } if (mktime(0, 0, 0, $node->quiz_open['month'], $node->quiz_open['day'], $node->quiz_open['year']) > mktime(0, 0, 0, $node->quiz_close['month'], $node->quiz_close['day'], $node->quiz_close['year'])) { form_set_error('quiz_close', t('Please make sure the close date is after the open date.')); } - if (!is_numeric($node->pass_rate)) { - form_set_error('pass_rate', t('The pass rate value must be a number between 0% and 100%.')); - } - if ($node->pass_rate > 100) { - form_set_error('pass_rate', t('The pass rate value must not be more than 100%.')); - } - if ($node->pass_rate < 0) { - form_set_error('pass_rate', t('The pass rate value must not be less than 0%.')); - } } /** @@ -426,8 +444,8 @@ function quiz_validate($node) { function quiz_insert($node) { quiz_translate_form_date($node, 'quiz_open'); quiz_translate_form_date($node, 'quiz_close'); - $sql = "INSERT INTO {quiz} (nid, number_of_questions, shuffle, backwards_navigation, feedback_time, quiz_open, quiz_close, takes, pass_rate, summary_pass, summary_default, quiz_always)"; - $sql .= " VALUES(%d, %d, %d, %d, %d, %d, %d, %d, %d, '%s', '%s', %d)"; + $sql = "INSERT INTO {quiz} (nid, number_of_questions, shuffle, backwards_navigation, feedback_time, quiz_open, quiz_close, takes, pass_rate, summary_pass, summary_default, quiz_always) + VALUES(%d, %d, %d, %d, %d, %d, %d, %d, %d, '%s', '%s', %d)"; db_query($sql, $node->nid, $node->number_of_questions, $node->shuffle, $node->backwards_navigation, $node->feedback_time, $node->quiz_open, $node->quiz_close, $node->takes, $node->pass_rate, $node->summary_pass, $node->summary_default, $node->quiz_always); } @@ -454,296 +472,605 @@ function quiz_delete($node) { function quiz_load($node) { $additions = db_fetch_object(db_query('SELECT * FROM {quiz} WHERE nid = %d', $node->nid)); $results = db_query('SELECT * FROM {quiz_questions} WHERE quiz_nid = %d', $node->nid); + while ($question = db_fetch_object($results)) { - $additions->question_status[$question->question_nid] = $question->question_status; + $additions->question_priority[$question->question_nid] = $question->question_priority; } + $additions->max_questions = $additions->number_of_questions == 0 ? count($additions->question_priority) : $additions->number_of_questions; + return $additions; } /** * Implementation of hook_view(). */ - function quiz_view($node, $teaser = FALSE, $page = FALSE) { - if (!$teaser && user_access('create quiz')) { + $quiz_available = quiz_get_availability($node); + if ($quiz_available === TRUE) { $node = node_prepare($node, $teaser); - $node->content['body']['#value'] = theme('quiz_view', $node, $teaser, $page); + $node->content['admin'] = array( + '#value' => theme('quiz_view', $node, $teaser, $page), + '#weight' => 4 + ); } - elseif (!$teaser && !user_access('create quiz')) { - $node = node_prepare($node, $teaser); - $node->content['body']['#value'] .= theme('quiz_view', $node, $teaser, $page); + else { + $node->content['body']['#value'] = $quiz_available; } + return $node; } /** - * Themes a message about the quiz's availability for quiz takers - * - * + * Implementation of hook_link(). */ -function theme_quiz_availability($node) { - $output = '

'; - if (!$node->quiz_always) { - if ($node->quiz_open > time()) { - $output .= t('This quiz will not be available until %time.', array('%time' => format_date($node->quiz_open))); - } - elseif ($node->quiz_close < time()) { - $output .= t('This quiz closes %time.', array('%time' => format_date($node->quiz_close))); - } - else { - $output .= t('This quiz is no longer available.'); - } +function quiz_link($type, $node = NULL, $teaser = FALSE) { + $links = array(); + + if ($type == 'node' && $node->type == 'quiz') { + $links['quiz_start'] = array( + 'title' => t('Begin @quiz', array('@quiz' => QUIZ_NAME)), + 'href' => "node/$node->nid/engine", + 'attributes' => array('title' => t('Begin lesson.')) + ); } - $output .= '

'."\n"; - return $output; + + return $links; } /** - * Theme the node view for quizzes + * Menu Callback: Quiz configuration form. */ -function theme_quiz_view($node, $teaser = FALSE, $page = FALSE) { - $output = ''; - // Ouput quiz options - $output .= '

'. t('@quiz Options', array('@quiz' => QUIZ_NAME)) .'

'; - $header = array( - t('# of Questions'), - t('Shuffle?'), - t('Allow Backwards?'), - t('Feedback'), - t('Number of takes') - ); - $shuffle = $node->shuffle == 1 ? t('Yes') : t('No'); - $backwards = $node->backwards_navigation == 1 ? t('Yes') : t('No'); - $feedback_options = array( - t('At the end of each @quiz', array('@quiz' => QUIZ_NAME)), - t('After each question'), - t('Do not show') +function quiz_admin_settings() { + $form = array('quiz' => array('#tree' => TRUE)); + $form['quiz']['general'] = array( + '#type' => 'fieldset', + '#title' => t('General settings'), + '#collapsible' => TRUE, + '#parents' => array('quiz') + ); + $form['quiz']['general']['name'] = array( + '#type' => 'textfield', + '#title' => t('Name'), + '#default_value' => QUIZ_NAME, + '#description' => t('The term used to refer to quizzes across the site (for example: quiz, test, assessment). This will affect display text but will not affect menu paths.'), + '#required' => TRUE + ); + $form['quiz']['general']['pager'] = array( + '#type' => 'textfield', + '#title' => t('Pager'), + '#default_value' => quiz_variable_get('pager'), + '#description' => t('Number of entries to display per page on various pages belonging to the quiz module.', array('@quiz' => QUIZ_NAME)), + '#required' => TRUE ); - $feedback = $feedback_options[$node->feedback_time]; - $takes = $node->takes == 0 ? t('Unlimited') : check_plain($node->takes); - $rows = array(); - $rows[] = array( - check_plain($node->number_of_questions), - $shuffle, - $backwards, - $feedback, - $takes - ); - $output .= theme('table', $header, $rows); - // Format Quiz Dates - $output .= '

'. t('@quiz start/end', array('@quiz' => QUIZ_NAME)) .'

'; - if (!$node->quiz_always) { - // if we are previewing, make sure the dates are timestamps and not form arrays - if (is_array($node->quiz_open)) { - quiz_translate_form_date($node, 'quiz_open'); - } - if (is_array($node->quiz_close)) { - quiz_translate_form_date($node, 'quiz_close'); - } - // format the availability info - $output .= '

'. format_date($node->quiz_open) .' — '. format_date($node->quiz_close) .'

'; - $output .= '

'. t('Days @quiz live for:', array('@quiz' => QUIZ_NAME)) .' '. floor((strtotime($node->close) - strtotime($node->open)) / 60 / 60 / 24) .'

'; - $remaining = floor(($node->quiz_close - time()) / 60 / 60 / 24); - $remaining = ($remaining < 0)?'Expired':$remaining; - $output .= '

Days remaining: '. $remaining .'

'; - $elapsed = floor((time() - $node->quiz_open) / 60 / 60 / 24); - $elapsed = ($elapsed < 0)?(-$elapsed) .' days to go':$elapsed; - $output .= '

Days since start: '. $elapsed .'

'; - } - else { - $output .= '

'. t('This Quiz is always available.') .'

'."\n"; - } + $form['quiz']['quiz_defaults'] = array( + '#type' => 'fieldset', + '#title' => t('@quiz defaults', array('@quiz' => QUIZ_NAME)), + '#collapsible' => TRUE, + '#parents' => array('quiz') + ); - // Format taxonomy selection (if applicable) - if (function_exists(taxonomy_node_get_terms)) { - $output .= '

'. t('Taxonomy selection') .'

'; - $terms = array(); - foreach (taxonomy_node_get_terms($node->nid) as $term) { - $terms[] = check_plain($term->name); - } - if (!empty($terms)) { - $terms = implode(', ', $terms); - $output .= "

$terms

"; - } - else { - $output .= '

'. t('No selected terms found') .'

'; - } - } - - // Format pass / fail and summary options - if ($node->pass_rate || $node->summary_default || $node->summary_pass) { - if ($node->pass_rate) { - $output .= '

'. t('Pass / fail and summary options') .'

'."\n"; - $output .= '

'. t('Percentage needed to pass:') .' '. check_plain($node->pass_rate) .'

'."\n"; - $output .= '
'. t('Summary text if the user passed:') .' '; - $output .= ($node->summary_pass) ? check_markup($node->summary_pass) : t('No text defined.'); - $output .= '
'."\n"; - } - $output .= '
'. t('Default summary text:') .' '; - $output .= ($node->summary_default) ? check_markup($node->summary_default) : t('No text defined.'); - $output .= '
'."\n"; - } + // Option to globally turn off pass / fail form elements. + $form['quiz']['quiz_defaults']['expire'] = array( + '#type' => 'textfield', + '#title' => t('Default number of days before a @quiz is closed', array('@quiz' => QUIZ_NAME)), + '#default_value' => quiz_variable_get('expire'), + '#description' => t('Supply a number of days to calculate the default close date for new quizzes.'), + '#required' => TRUE + ); + $form['quiz']['quiz_defaults']['pass_mark'] = array( + '#type' => 'select', + '#title' => t('Default percentage needed to pass a @quiz', array('@quiz' => QUIZ_NAME)), + '#options' => range(0, 100), + '#default_value' => quiz_variable_get('pass_mark'), + '#description' => t('Supply a number between 1 and 100 to set as the default percentage correct needed to pass a quiz. Set to 0 if you want to ignore pass / fail summary information by default.'), + '#required' => TRUE + ); + $form['quiz']['quiz_defaults']['access_pass_settings'] = array( + '#type' => 'checkbox', + '#title' => t('Display pass / fail options in the @quiz form', array('@quiz' => QUIZ_NAME)), + '#default_value' => quiz_variable_get('access_pass_settings'), + '#description' => t('Check this to display the pass / fail options in the quiz form. You can still choose to ignore pass / fail options on a quiz by quiz basis if this is checked, but if you want to prohibit other quiz module creators from using these options, unchecked this option.') + ); - // Format quiz questions - if (is_numeric(arg(1))) { - $output .= '

'. t('@quiz Questions', array('@quiz' => QUIZ_NAME)) .'

'; - $questions = _quiz_get_questions(); - $output .= theme('quiz_question_table', $questions); - } - return $output; + return system_settings_form($form); } - /** - * Displays all the quizs the user has taken part in - * - * @return - * HTML output for page - */ -function quiz_get_user_results() { - global $user; - $results = array(); - $dbresult = db_query("SELECT - n.nid nid, - n.title title, - u.name name, - qr.rid rid, - qr.time_start, - qr.time_end - FROM {node} n, {quiz} q, {quiz_result} qr, {users} u - WHERE - n.type = 'quiz' - AND - n.nid = q.nid - AND - qr.quiz_nid = q.nid - AND - u.uid = qr.uid - AND - u.uid = ". $user->uid ." - ORDER BY qr.rid ASC"); - //Create results array - while ($line = db_fetch_array($dbresult)) { - $results[$line['rid']] = $line; + * Validation quiz configuration settings form. + */ +function quiz_settings_form_validate($form_id, $form_values) { + $configuration = $form_values['quiz']; + if (!is_numeric($form_values['quiz']['expire']) || $form_values['quiz']['expire'] <= 0) { + form_set_error('expire', t('The default number of days before a quiz is closed must be a number greater than 0.')); } - return theme('quiz_get_user_results', $results); - } /** - * Handles quiz taking + * Menu callback: Handle quiz taking. + * + * @TODO: This should probably be pluggable. + * @TODO: Avoid storing the entire question list in the session. How does one + * handle a quiz with a large or unlimited number of questions? * * @return - * HTML output for page + * HTML output for page. */ -function quiz_take_quiz() { +function quiz_engine() { global $user; + if (arg(0) == 'node' && is_numeric(arg(1)) && user_access('access quiz')) { - if ($quiz = node_load(arg(1))) { - if (!isset($_SESSION['quiz_'. $quiz->nid]['quiz_questions'])) { - - // First time running through quiz - if ($rid = quiz_start_actions($user->uid, $quiz->nid)) { - // Create question list + if ($quiz = node_load(arg(1))) { + $session_id = 'quiz_'. $quiz->nid; + + if (!isset($_SESSION[$session_id]['quiz_questions'])) { + // First time running through quiz. + if ($rid = quiz_start_actions($quiz)) { + // Create question list. $questions = quiz_build_question_list($quiz->nid); if (count($questions) == 0) { - drupal_set_message(t('No questions were found. Please assign questions before trying to take this @quiz.', array('@quiz' => QUIZ_NAME)), 'error'); - return ''; + drupal_set_message(t('No questions have been assigned to this @quiz.', array('@quiz' => QUIZ_NAME)), 'error'); + drupal_goto('node/'. $quiz->nid); + } + else { + // Initialize session variables. + $_SESSION[$session_id]['quiz_questions'] = $questions; + $_SESSION[$session_id]['rid'] = $rid; + $_SESSION[$session_id]['question_number'] = 0; } - // Initialize session variables - $_SESSION['quiz_'. $quiz->nid]['quiz_questions'] = $questions; - $_SESSION['quiz_'. $quiz->nid]['rid'] = $rid; - $_SESSION['quiz_'. $quiz->nid]['question_number'] = 0; - - } - else { - return ''; - } - } - - // Check for answer submission - if ($_POST['op'] == t('Submit')) { - if (!isset($_POST['tries'])) { - drupal_set_message('You must select an answer before you can progress to the next question!', 'error'); } else { - $former_question = node_load(array('nid' => array_shift($_SESSION['quiz_'. $quiz->nid]['quiz_questions']))); - $result = module_invoke($former_question->type, 'evaluate_question', $former_question->nid); - db_query("REPLACE {quiz_question_results} VALUES(%d, %d, '%s')", $_SESSION['quiz_'. $quiz->nid]['rid'], $former_question->nid, serialize($result)); + drupal_goto('node/'. $quiz->nid); } } - // If this quiz is in progress, load the next questions - // and return it via the theme - if (!empty($_SESSION['quiz_'. $quiz->nid]['quiz_questions'])) { - - $question_node = node_load(array('nid' => $_SESSION['quiz_'. $quiz->nid]['quiz_questions'][0])); + // If this quiz is in progress, load the next question and return it via + // the theme. + if (!empty($_SESSION[$session_id]['quiz_questions'])) { + $question_node = node_load($_SESSION[$session_id]['quiz_questions'][0]); return theme('quiz_take_question', $quiz, $question_node); } - - // At the end of quiz else { - //First - update the result to show we have finished. - $now = time(); - db_query("UPDATE {quiz_result} SET time_end = %d WHERE rid = %d", $now, $_SESSION['quiz_'. $quiz->nid]['rid']); - - //Get the results and summary text for this quiz - $questions = _quiz_get_answers($_SESSION['quiz_'. $quiz->nid]['rid']); - $score = quiz_calculate_score($_SESSION['quiz_'. $quiz->nid]['rid']); + // At the end of quiz. + // Get the results and summary text for this quiz. + $questions = _quiz_get_answers($_SESSION[$session_id]['rid']); + $score = quiz_calculate_score($_SESSION[$session_id]['rid']); $summary = _quiz_get_summary_text($quiz, $score); - // get the themed summary page + // First - update the result to show we have finished. + db_query("UPDATE {quiz_results} SET time_end = %d, score = %d WHERE rid = %d", time(), $score['percentage_score'], $_SESSION[$session_id]['rid']); + + // Get the themed summary page. $output = theme('quiz_take_summary', $quiz, $questions, $score, $summary); - //remove session variables - unset($_SESSION['quiz_'. $quiz->nid]); + // Remove session variables. + unset($_SESSION[$session_id]); - // return return $output; - } } } + // If we got down here then the quiz does not exist. drupal_not_found(); } +/** + * Menu callback: Quiz admin. + */ +function quiz_admin() { + $results = _quiz_get_results(); + return theme('quiz_admin', $results); +} -/*** - * Get the summary message for a completed quiz - * - * Summary is determined by whether we are using the - * pass / fail options, how the user did, and - * whether this is being called from admin/quiz/[quizid]/view. +/** + * Menu callback: Quiz results user. + */ +function quiz_user_results() { + $result = db_fetch_object(db_query('SELECT q.nid + FROM {quiz} q INNER JOIN {quiz_results} qr ON (qr.quiz_nid = q.nid) + WHERE qr.rid = %d', arg(2)) + ); + if ($result->nid) { + $quiz = node_load($result->nid); + $questions = _quiz_get_answers(arg(2)); + $score = quiz_calculate_score(arg(2)); + $summary = _quiz_get_summary_text($quiz, $score); + return theme('quiz_user_summary', $quiz, $questions, $score, $summary); + } + else { + drupal_not_found(); + } +} + +/** + * Menu callback: Quiz results admin. + */ +function quiz_admin_results() { + $result = db_fetch_object(db_query('SELECT q.nid + FROM {quiz} q INNER JOIN {quiz_results} qr ON (qr.quiz_nid = q.nid) + WHERE qr.rid = %d', arg(2)) + ); + if ($result->nid) { + $quiz = node_load($result->nid); + $questions = _quiz_get_answers(arg(2)); + $score = quiz_calculate_score(arg(2)); + $summary = _quiz_get_summary_text($quiz, $score); + return theme('quiz_admin_summary', $quiz, $questions, $score, $summary); + } + else { + drupal_not_found(); + } +} + +/** + * Menu callback: Delete result. + */ +function quiz_admin_result_delete_form() { + $form['del_rid'] = array('#type' => 'value', '#value' => arg(2)); + return confirm_form( + $form, + t('Are you sure you want to delete this @quiz result?', array('@quiz' => QUIZ_NAME)), + 'admin/quiz', + t('This action cannot be undone.'), + t('Delete'), + t('Cancel') + ); +} + +function quiz_admin_result_delete_form_submit($form_id, $form_values) { + db_query("DELETE FROM {quiz_results} WHERE rid = %d", $form_values['del_rid']); + db_query("DELETE FROM {quiz_question_results} WHERE result_rid = %d", $form_values['del_rid']); + drupal_set_message(t('Deleted result.')); + + return 'admin/quiz'; +} + +/** + * Menu callback: Display the manage questions tab. + */ +function quiz_manage_questions() { + $status = arg(3); + $assigned = $unassigned = TRUE; + if ($status == 'assigned') { + $unassigned = FALSE; + } + else if ($status == 'unassigned') { + $assigned = FALSE; + } + + $terms = arg(4); + $terms = !empty($terms) ? explode(' ', $terms) : array(); + // This should technically be unnecessary as appropriate filtering takes place + // later as well. + $terms = array_map(create_function('$i', 'return intval($i);'), $terms); + + return drupal_get_form('quiz_manage_questions_filter_form', $assigned, $unassigned, $terms) . drupal_get_form('quiz_manage_questions_form', $assigned, $unassigned, $terms); +} + +/** + * Filter questions form for the manage questions page. * - * TODO: Need better feedback for when a user is viewing - * their quiz results from the results list (and possibily - * when revisiting a quiz they can't take again) + * @param $assigned + * Boolean - controls status of the 'assigned' checkbox. + * @param $unassigned + * Boolean - controls status of the 'unassigned' checkbox. + * @param $terms + * Array - Sets the default terms for the vocabulary forms. + * + * @return $form + */ +function quiz_manage_questions_filter_form($assigned, $unassigned, $terms) { + $taxonomy = _quiz_taxonomy_select($terms); + + $form = array(); + // Display filtering options. + if (!empty($taxonomy)) { + $form['taxonomy_filter'] = array( + '#type' => 'fieldset', + '#title' => t('Filter questions'), + '#description' => t('Select term(s) to filter the question list.') + ); + + $form['taxonomy_filter']['taxonomy'] = $taxonomy; + $form['taxonomy_filter']['taxonomy']['#tree'] = TRUE; + $form['taxonomy_filter']['taxonomy']['#prefix'] = '
'; + $form['taxonomy_filter']['taxonomy']['#suffix'] = '
'; + $form['taxonomy_filter']['assigned'] = array( + '#type' => 'checkbox', + '#title' => t('Display assigned questions.'), + '#default_value' => $assigned, + '#prefix' => '
' + ); + $form['taxonomy_filter']['unassigned'] = array( + '#type' => 'checkbox', + '#title' => t('Display unassigned questions.'), + '#default_value' => $unassigned, + '#suffix' => '
' + ); + $form['taxonomy_filter']['nid'] = array('#type' => 'value', '#value' => arg(1)); + $form['taxonomy_filter']['submit'] = array('#type' => 'submit', '#value' => t('Filter question list')); + } + + return $form; +} + +/** + * Process filter_form submissions and redirect appropriately. + */ +function quiz_manage_questions_filter_form_submit($form_id, $form) { + $taxonomy = isset($form['taxonomy']) ? array_filter($form['taxonomy']) : array(); + $taxonomy = implode(' ', $taxonomy); + + $status = 'assigned'; + if ($form['assigned'] && $form['unassigned']) { + $status = 'all'; + } + elseif ($form['unassigned']) { + $status = 'unassigned'; + } + + return 'node/'. $form['nid'] .'/questions/'. $status .'/'. $taxonomy; +} + +/** + * Display the questions table form. * + * @param $assigned + * Boolean - Should questions assigned to this quiz be displayed? + * @param $unassigned + * Boolean - Should questions not assigned to this quiz be displayed? + * @param $terms + * Array - An array of terms that questions should be filtered on. + * + * @return $form + */ +function quiz_manage_questions_form($assigned, $unassigned, $terms) { + $quiz = node_load(arg(1)); + + // Set page title. + drupal_set_title(check_plain($quiz->title)); + + // Display filtered question list. + $form['filtered_question_list'] = array( + '#type' => 'fieldset', + '#title' => t('Question bank'), + '#description' => t('The following questions are available in the question bank. %x @question have already been selected for this @quiz.', array('@quiz' => QUIZ_NAME, '%x' => check_plain($quiz->number_of_questions), '@question' => format_plural($quiz->number_of_questions, t('question'), t('questions')))), + '#collapsible' => TRUE, + '#collapsed' => FALSE + ); + + $priority_descriptions = array( + QUESTION_RANDOM => t('Random'), + QUESTION_ALWAYS => t('Always'), + QUESTION_NEVER => t('Never') + ); + + // Grab current question priorities, if any. + $questions = quiz_filter_question_list($terms, $assigned, $unassigned, $quiz->nid); + $nodes = $assigned_questions = array(); + while (list($key, $question) = each($questions)) { + $nodes[$question->nid] = ''; + if ($question->question_priority != QUESTION_NEVER) { + $assigned_questions[$question->nid] = TRUE; + } + $form['filtered_question_list']['question'][$question->nid] = array('#value' => l($question->title, 'node/'. $question->nid)); + $form['filtered_question_list']['type'][$question->nid] = array('#value' => $question->type); + $form['filtered_question_list']['question_priority'][$question->nid] = array('#value' => $priority_descriptions[$question->question_priority]); + } + $form['filtered_question_list']['nodes'] = array('#type' => 'checkboxes', '#options' => $nodes); + + // Store assigned questions to avoid additional DB calls during form_submit. + $form['assigned_questions'] = array('#type' => 'value', '#value' => $assigned_questions); + + $form['controls'] = array('#type' => 'fieldset'); + $form['controls']['operation'] = array( + '#type' => 'select', + '#title' => t('With selected'), + '#options' => array( + 'assign-'. QUESTION_RANDOM => t('Assign as random questions'), + 'assign-'. QUESTION_ALWAYS => t('Assign as always-asked questions'), + 'assign-'. QUESTION_NEVER => t('Unassign') + ), + '#prefix' => '
', + ); + + $form['controls']['submit'] = array( + '#type' => 'submit', + '#value' => t('Update'), + '#suffix' => '
' + ); + + return $form; +} + +/** + * Validate the manage questions form. + */ +function quiz_manage_questions_form_validate($form_id, $form_values) { + $questions = array_filter($form_values['nodes']); + if (empty($questions)) { + form_set_error('', t('No questions were selected. Please select a question and try again.')); + } +} + +/** + * Process manage questions form submission. + * @TODO: Replace 'always' and 'random' with priority levels. + */ +function quiz_manage_questions_form_submit($form_id, $form_values) { + $questions = array_filter($form_values['nodes']); + $operation = explode('-', $form_values['operation']); + // Load the node. + $quiz = node_load(arg(1)); + // Update quiz with selected question options. + quiz_update_questions($quiz, $questions, $operation[1], $form_values['assigned_questions']); + + // Determine how many more questions are required. + $qnum = $quiz->number_of_questions; + $anum_random = quiz_get_num_questions($quiz->nid, QUESTION_RANDOM); + $anum_always = quiz_get_num_questions($quiz->nid, QUESTION_ALWAYS); + $anum_total = $anum_always + $anum_random; + + // If we have some random questions, increase this number by one. + if ($anum_random > 0) { + $anum_always++; + } + + // If there are not enough questions, lower the number of questions and let + // the user know. + if ($anum_total < $qnum) { + drupal_set_message(t('The number of questions for this @quiz have been lowered to %anum to match the number of questions you assigned.', array('@quiz' => QUIZ_NAME, '%anum' => $anum_total))); + db_query("UPDATE {quiz} SET number_of_questions = %d WHERE nid = %d", $anum_total, $quiz->nid); + } + + // If there are too many questions set to "always", increase the number of + // questions and let the user know. + else if ($anum_always > $qnum) { + drupal_set_message(t('The number of questions for this @quiz have been increased to %anum to match the number of questions you assigned.', array('@quiz' => QUIZ_NAME, '%anum' => $anum_always))); + db_query("UPDATE {quiz} SET number_of_questions = %d WHERE nid = %d", $anum_always, $quiz->nid); + } + + // Otherwise, just give general feedback. + else { + drupal_set_message(t('Questions updated successfully.')); + } +} + +/** + * Called by question modules. Store question result in the database and move + * to the next question. + */ +function quiz_update_result($quiz_id, $question, $input) { + $session_id = 'quiz_'. $quiz_id; + // FIXME: MySQL only query. + db_query("REPLACE {quiz_question_results} VALUES(%d, %d, '%s')", $_SESSION[$session_id]['rid'], $question->nid, serialize($input)); + + $quiz = node_load($quiz_id); + if ($quiz->feedback_time == FEEDBACK_AFTER_QUESTION) { + $result = multichoice_calculate_result($input); + // TODO: Add feedback. + if ($result) { + drupal_set_message('Correct!'); + } + else { + drupal_set_message('Incorrect!'); + } + } + + // Move to the next question. + // FIXME: This is very dodgy. + array_shift($_SESSION[$session_id]['quiz_questions']); +} + +/** + * Return a quiz module variable. + * + * @param $name + * The name of the variable to retrieve. + * @return + * The value of the variable requested. + */ +function quiz_variable_get($name) { + static $variables = array(); + + if (empty($variables)) { + $defaults = array( + 'name' => 'Quiz', + 'expire' => 30, + 'pass_mark' => 80, + 'access_pass_settings' => 1, + 'pager' => 5 + ); + $variables = variable_get('quiz', array()); + $variables = array_merge($defaults, $variables); + } + + return $variables[$name]; +} + +/** + * Finds out the number of questions for the quiz. Good example of usage could + * be to calculate the % of score. + * + * @param $nid + * Quiz ID. + * @return integer + * Returns the number of quiz questions. + */ +function quiz_get_number_of_questions($nid) { + return db_result(db_query('SELECT number_of_questions FROM {quiz} WHERE nid = %d', $nid)); +} + +/** + * @param $nid + * Quiz ID + * Finds out the pass rate for the quiz. + * @return integer + * Returns the pass rate of quiz. + */ +function quiz_get_pass_rate($nid) { + return db_result(db_query('SELECT pass_rate FROM {quiz} WHERE nid = %d', $nid)); +} + +/** + * Displays all the quizzes the user has taken part in. + * + * @return + * HTML output for page. + */ +function quiz_get_user_results() { + global $user; + + $results = array(); + $sql = "SELECT n.nid, n.title, qr.rid, qr.score, qr.time_start, qr.time_end + FROM {node} n INNER JOIN {quiz} q ON (n.nid = q.nid) INNER JOIN {quiz_results} qr ON (qr.quiz_nid = q.nid) + WHERE n.type = 'quiz' AND qr.uid = %d + ORDER BY qr.rid DESC + "; + + $result = pager_query($sql, quiz_variable_get('pager'), 0, NULL, $user->uid); + + // Create results array. + while ($line = db_fetch_object($result)) { + $results[$line->rid] = $line; + } + + return theme('quiz_get_user_results', $results); +} + +/** + * Get the summary message for a completed quiz. + * + * Summary is determined by whether we are using the pass / fail options, how + * the user did, and whether this is being called from admin/quiz/[quizid]/view. + * + * TODO: Need better feedback for when a user is viewing their quiz results from + * the results list (and possibily when revisiting a quiz they can't take + * again). + * * @param $quiz - * The quiz node object + * The quiz node object. * @param $score - * The score information as returned by quiz_calculate_score() + * The score information as returned by quiz_calculate_score(). * @return - * Filtered summary text or null if we are not displaying any summary + * Filtered summary text or null if we are not displaying any summary. */ function _quiz_get_summary_text($quiz, $score) { - $summary = ''; - // if we are using pass / fail and they passed + // If we are using pass / fail and they passed. if (trim($quiz->summary_pass) != '' && $quiz->pass_rate > 0 && $score['percentage_score'] >= $quiz->pass_rate) { - // If we are coming from the admin view page + // If we are coming from the admin view page. if (arg(3) == 'view') { - $summary = t('The user passed this quiz.'); + $summary = t('The user passed this quiz.'); } else { - $summary = check_markup($quiz->summary_pass, $quiz->format); + $summary = check_markup($quiz->summary_pass, $quiz->format); } - } - // If the user did not pass or we are not using pass / fail + } + // If the user did not pass or we are not using pass / fail. else { - // If we are coming from the admin view page - // only show a summary if we are using pass / fail. + // If we are coming from the admin view page, only show a summary if we are + // using pass / fail. if (arg(3) == 'view') { if ($node->pass_rate > 0) { $summary = t('The user failed this quiz.'); @@ -753,154 +1080,108 @@ function _quiz_get_summary_text($quiz, $ $summary = check_markup($quiz->summary_default, $quiz->format); } } + return $summary; } /** - * Actions to take place at the start of a quiz + * Actions to take place at the start of a quiz. * - * @param $uid - * User ID - * @param $nid - * Quiz node ID + * @param $quiz + * Quiz node. * @return integer * Returns quiz_result rid, or false if there is an error. */ -function quiz_start_actions($uid, $nid) { - // get the quiz node - $quiz = node_load($nid); - - // make sure this is available - if (!$quiz->quiz_always == 1) { - // compare current gm time to open and close dates (which should still be in gm time) - if (gmmktime() >= $quiz->quiz_close || gmmktime() < $quiz->quiz_open) { - drupal_set_message(t('This @quiz is not currently available.', array('@quiz' => QUIZ_NAME)), 'status'); - if (!user_access('create quiz')) { - return FALSE; - } - } - } - - // get the results +function quiz_start_actions($quiz) { global $user; - $results = _quiz_get_results($quiz->nid, $user->uid); - // Check to see if the user alredy passed this quiz - // but only perform this check if it is a registered user - if ($user->uid) { - $passed = FALSE; - while ($next = next($results)) { - $score = quiz_calculate_score($next['rid']); - if ($score['percentage_score'] >= $quiz->pass_rate) { - $passed = TRUE; - break; - } - } - if ($passed == TRUE) { - drupal_set_message(t('You have already passed this @quiz.', array('@quiz' => QUIZ_NAME)), 'status'); - // Allow quiz creators to test their quizzes - if (!user_access('create quiz')) { - return FALSE; - } - } - } - // Validate number of takes - if ($quiz->takes != 0) { - //$result = db_result(db_query('SELECT COUNT(rid) AS count FROM {quiz_result} WHERE uid = %d AND quiz_nid = %d', $uid, $nid)); - $times = count($results); - if ($times >= $quiz->takes) { - drupal_set_message(t('You have already taken this @quiz %d times.', array('@quiz' => QUIZ_NAME, '%d' => $times)), 'status'); - // Allow quiz creators to test their quizzes - if (!user_access('create quiz')) { - return FALSE; - } - } + $quiz_available = quiz_get_availability($quiz); + if ($quiz_available !== TRUE) { + drupal_set_message(t('This @quiz is not currently available.', array('@quiz' => QUIZ_NAME))); + return FALSE; } - // Insert quiz_results record - $rid = db_next_id('{quiz_results}_rid'); - $now = time(); - $result = db_query("INSERT INTO {quiz_result} (rid, quiz_nid, uid, time_start) VALUES (%d, %d, %d, %d)", $rid, $nid, $uid, $now); - if ($result) { - return $rid; - } - else { - drupal_set_message(t('There was a problem starting the @quiz. Please try again later.', array('@quiz' => QUIZ_NAME), 'error')); + $quiz_takes_available = quiz_validate_takes($quiz, $user->uid); + if ($quiz_takes_available !== TRUE) { + drupal_set_message($quiz_takes_available); return FALSE; } + + // Initialise quiz_results record. + $rid = db_next_id('{quiz_results}_rid'); + $result = db_query("INSERT INTO {quiz_results} (rid, quiz_nid, uid, time_start) VALUES (%d, %d, %d, %d)", $rid, $quiz->nid, $user->uid, time()); + + return $rid; } /** - * Calculates the score user received on quiz + * Calculates the score user received on quiz. * * @param $rid - * Quiz result ID + * Quiz result ID. * @return array - * Contains three elements: question_count, num_correct and percentage_score + * Contains three elements: question_count, num_correct and percentage_score. */ function quiz_calculate_score($rid) { - // initialize our variables - $question_count = 0; - $num_correct = 0; - $percentage_score = 0; - - // Get the all answers from the database - $result = db_query("SELECT - qqr.answer answer, - qqr.question_nid qnid, - n.type type - FROM {quiz_question_results} qqr, {node} n - WHERE qqr.result_rid = %d AND n.nid = qqr.question_nid", $rid); + // Initialize our variables. + $question_count = $num_correct = $percentage_score = 0; + + // Get the all answers from the database. + $result = db_query("SELECT qqr.answer answer, qqr.question_nid qnid, n.type type + FROM {quiz_question_results} qqr INNER JOIN {node} n ON (n.nid = qqr.question_nid) + WHERE qqr.result_rid = %d", $rid + ); while ($r = db_fetch_array($result)) { $question_count++; $r['answer'] = unserialize($r['answer']); - $s = module_invoke($r['type'], 'calculate_result', $r['answer']['answers'], $r['answer']['tried']); - $num_correct += $s; - $r['score'] = $s; // I think this is legacy + $s = module_invoke($r['type'], 'calculate_result', $r['answer']); + if ($s) { + $num_correct++; + } } - - // calculate the percentage score + + // Calculate the percentage score. if ($question_count > 0) { $percentage_score = round(($num_correct * 100) / $question_count); } - // build the score array + // Build the score array. $score = array( 'question_count' => $question_count, - 'num_correct' => $num_correct, + 'num_correct' => $num_correct, 'percentage_score' => $percentage_score, ); - // return the array + // Return the array. return $score; } /** - * Retrieves a question list for a given quiz + * Retrieves a question list for a given quiz. * * @param $nid - * Quiz node ID + * Quiz node ID. * @return - * Array of question node IDs + * Array of question node IDs. */ function quiz_build_question_list($nid) { $questions = array(); $quiz = node_load($nid); - // Get required questions first - $result = db_query("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_status = %d", $nid, QUESTION_ALWAYS); + // Get required questions first. + $result = db_query("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_priority = %d", $nid, QUESTION_ALWAYS); while ($question_node = db_fetch_object($result)) { $questions[] = $question_node->question_nid; } - // Get random questions for the remainder - $quiz->number_of_questions -= count($questions); - $result = db_query_range("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_status = %d ORDER BY RAND()", $nid, QUESTION_RANDOM, 0, $quiz->number_of_questions); + // Get random questions for the remainder. + $quiz->max_questions -= count($questions); + $result = db_query_range("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_priority = %d ORDER BY RAND()", $nid, QUESTION_RANDOM, 0, $quiz->max_questions); while ($question_node = db_fetch_object($result)) { $questions[] = $question_node->question_nid; } - // Shuffle questions if required + // Shuffle questions if required. if ($quiz->shuffle == 1) { shuffle($questions); } @@ -909,125 +1190,22 @@ function quiz_build_question_list($nid) } /** - * Implementation of hook_help(). - */ -function quiz_help($section) { - switch ($section) { - case 'admin/help#quiz': - return t(' -

Description

-

The quiz module allows users to administer a quiz, as a sequence of questions, and track the answers given. It allows for the creation of questions (and their answers), and organizes these questions into a quiz. Finally, it provides a mechanism for ensuring question quality through a combination of community revision and moderation. Its target audience includes educational institutions, online training programs, employers, and people who just want to add a fun activity for their visitors to their Drupal site.

-

Creating Your First Quiz

-

Creating an initial quiz requires three steps:

-
    -
  1. Create at least one taxonomy vocabulary and assign it to the quiz and question type modules
    2. -
  2. Create a series of questions
    3. -
  3. Create a quiz based on the series of questions
    4. -
-

Also note that for anyone but the site administrator, creating quizzes requires the create quiz privilege, and creating questions requires the administer question type privilege. These settings can be configured in Administer >> User management >> Access control.

-

Setting up a vocabulary

-
    -
  1. If not already enabled, go to the Administer >> Site building >> Modules section of the control panel and check the enable checkbox to enable the taxonomy module.
    2. -
  2. If you do not already have a taxonomy vocabulary suitable for quizzes, go to Administer >> Content management >> Categories and create a vocabulary for quizzes (for example, Quiz Topics). Ensure that under Types, both quiz and all question types (for example, multichoice) are selected. Depending on your needs, you may wish to create a hierarchical vocabulary, so that topics can be sub-divided into smaller areas, and/or enable multiple select to associate quizzes and questions with more than one category.
    3. -
  3. Add a series of terms to the vocabulary to which questions and quizzes can be assigned. For example: -
-

Creating quiz questions

-
    -
  1. Begin by clicking Create content, and then select a question type node (for example, multichoice)
    2. -
  2. Fill out the question form. The presented interface will vary depending on the question type, but for multiple choice questions: -
    -
    Title
    -
    Question title. This will be displayed as the heading of the question.
    -
    Taxonomy selection
    -
    Any taxonomy vocabularies that are assigned to the question type will be displayed. Select from the terms displayed in order to assign questions to vocabulary terms so that they can be filtered in the quiz creation process.
    -
    Question
    -
    The actual question text (for example, What is 2+2?).
    -
    Multiple Answers
    -
    Whether or not the question has multiple correct answers, such as a "Select all that apply" question.
    -
    Correct
    -
    Indicates that given answer is a correct answer.
    -
    Answer
    -
    An answer choice (for example, 4). If more answers are required, check I need more answers and click the Preview button.
    -
    Feedback
    -
    Feedback, if supplied, will be provided to the user either immediately after answering the question, at the end of the quiz, or not at all (feedback options are configured in quizzes).
    -
    -
    3. -
  3. Repeat for each question you would like included on the quiz.
    4. -
-

Creating the quiz

-
    -
  1. Go to Create content >> Quiz to access the quiz creation form.
    2. -
  2. Fill out the form to set the @quiz options: -
    -
    Title
    -
    Quiz title. This will be displayed as the heading of the quiz.
    -
    Taxonomy selection
    -
    Any taxonomy vocabularies that are assigned to the quiz type will be displayed. Select from the terms displayed in order to assign the quiz to vocabulary terms.
    -
    Number of questions
    -
    Total number of questions on quiz.
    -
    Shuffle questions
    -
    Whether or not to shuffle (randomize) the questions.
    -
    Backwards Navigation
    -
    Whether or not to allow users to return to a previous question.
    -
    Feedback
    -
    Set options on when and whether question feedback should appear.
    -
    Number of takes
    -
    Number of takes to allow user. Varies from 1-9 or Unlimited times.
    -
    -
    3. -
  3. Once the quiz has been created, click the add questions tab to assign questions to the quiz.
    4. -
  4. Begin by selecting one or more terms from the taxonomy list and click Filter question list. This will bring up a selection of questions matching the selected vocabulary terms.
    5. -
  5. Select a radio button next to each question indicating if the question should appear (Randomly, Always, or Never), and click Submit questions.
    6. -
  6. Repeat process until satisfied with question selection.
    7. -
- ', array('@quiz' => QUIZ_NAME, '@admin-access' => url('admin/user/access'), '@admin-modules' => url('admin/build/modules'), '@admin-taxonomy' => url('admin/content/taxonomy'), '@create-content' => url('node/add'), '@multichoice' => url('node/add/multichoice'), '@create-quiz' => url('node/add/quiz'))); - case 'node/add#quiz': - return t('A collection of questions designed to create interactive tests'); - default: - break; - } -} - -/** - * Retrieve list of question types + * Retrieve list of question types. * - * Determined by which modules implement the list_questions() hook + * Determined by which modules implement the list_questions() hook. * * @return - * Array of question types + * Array of question types. */ function _quiz_get_question_types() { return module_implements('list_questions'); } /** - * Retrieve list of vocabularies for all quiz question types + * Retrieve list of vocabularies for all quiz question types. * * @return - * An array containing vocabulary list + * An array containing vocabulary list. */ function _quiz_get_vocabularies() { $vocabularies = array(); @@ -1036,268 +1214,124 @@ function _quiz_get_vocabularies() { $vocabularies[$vid] = $vocabulary; } } + return $vocabularies; } /** - * Prints a taxonomy selection form for each vocabulary + * Prints a taxonomy selection form for each vocabulary. * - * @param $value - * Default selected value(s) + * @param $terms + * Taxonomy terms in a space separated string. * @return - * HTML output to print to screen + * Form array. */ -function _quiz_taxonomy_select($value = 0) { +function _quiz_taxonomy_select($terms = array()) { $form = array(); + foreach (_quiz_get_vocabularies() as $vid => $vocabulary) { - $form['taxonomy'][$vid] = taxonomy_form($vid, $value); + // Render vocabulary form. Unlike taxonomy_form_all, free tag vocabularies + // are rendered incorrectly, which might be intentional. + // The third parameter (' ') is to ensure that the vocabulary help text + // is not to be displayed. It requires a string with a single space - a + // taxonomy module bug. + $form[$vid] = taxonomy_form($vid, $terms, ' '); } - return $form; -} - -/** - * Retrieve list of questions assigned to quiz - * - * @return - * Array of questions - */ -function _quiz_get_questions() { - $quiz = node_load(arg(1)); - $questions = array(); - if (!empty($quiz->nid)) { - // Retrieve list of questions - $result = db_query(" - SELECT n.nid, n.type, nr.body, nr.format, q.question_status - FROM {node} n, {node_revisions} nr, {quiz_questions} q - WHERE n.nid = q.question_nid - AND n.nid = nr.nid - AND q.quiz_nid = %d", $quiz->nid - ); - // Create questions array - while ($node = db_fetch_object($result)) { - $questions[] = quiz_node_map($node); - } - } - - return $questions; + return $form; } - /** - * Handles "add question" tab - * - * Displays form which allows questions to be filtered by taxonomy vocabulary, - * and assigned to the given quiz + * Retrieve list of questions assigned to quiz. * * @return - * HTML output to create page - */ -function quiz_questions_form() { - if ($_POST) { - if ($_POST['op'] == 'Filter question list') { - //BE CAREFUL OF THE $_POST['edit'] ARRAY AS THIS VALUE IS LIABLE TO CHANGE WHEN VOCABS ARE ADDED AND DELETED...IF YOU HAVE MORE THAN ONE VOCAB, MAY GOD HELP YOU!! - $_SESSION['quiz_filter'] = $_POST['edit'][4]; - } - } - - if (isset($_SESSION['quiz_filter'])) { - $terms = $_SESSION['quiz_filter']; - } - else { - $terms = array(); - } - - $quiz = node_load(arg(1)); - - // Set page title - drupal_set_title(check_plain($quiz->title)); - - // show the number of questions that this quiz currently has - $form['numberofquestions'] = array( - '#prefix' => '
', - '#value' => t('This @quiz consists of %x @question.', array('@quiz' => QUIZ_NAME, '%x' => check_plain($quiz->number_of_questions), '@question' => format_plural($quiz->number_of_questions, t('question'), t('questions')))), - '#suffix' => '

'."\n" - ); - - - // Display filtering options - if (_quiz_taxonomy_select() != array()) { - $form['taxonomy_filter'] = array( - '#type' => 'fieldset', - '#title' => t('Select one or more terms to filter the question list'), - ); - $form['taxonomy_filter']['taxonomy']['#tree'] = TRUE; - - $form['taxonomy_filter']['taxonomy'] = _quiz_taxonomy_select($terms); - $form['taxonomy_filter']['submit'] = array( - '#type' => 'submit', - '#value' => t('Filter question list'), - ); - } - - // Grab current question status, if any - $questions = quiz_filter_question_list($terms); - - $result = db_query('SELECT question_nid, question_status FROM {quiz_questions} WHERE quiz_nid = %d', $quiz->nid); - while ($assigned_question = db_fetch_object($result)) { - if (array_key_exists($assigned_question->question_nid, $questions)) { - $the_question =& $questions[$assigned_question->question_nid]; - $the_question->status = $assigned_question->question_status; - } - } - - - // Display filtered question list - $form['filtered_question_list'] = array( - '#type' => 'fieldset', - '#title' => t('The following questions were found'), - '#theme' => 'quiz_filtered_questions', - ); - - $form['filtered_question_list']['question_status']['#tree'] = TRUE; - - while (list($key, $question) = each($questions)) { - $form['filtered_question_list']['question_status'][$question->nid] = array( - '#type' => 'radios', - '#options' => array(QUESTION_RANDOM => '', QUESTION_ALWAYS => '', QUESTION_NEVER => ''), - '#default_value' => $question->status, - ); - $form['filtered_question_list']['question'][$question->nid] = array( - '#type' => 'markup', - '#value' => $question->question, - ); - $form['filtered_question_list']['type'][$question->nid] = array( - '#type' => 'markup', - '#value' => $question->type, - ); - } - - // Get questions assigned to this quiz - $questions = _quiz_get_questions(); - - // Display questions - $form['assigned_questions'] = array( - '#type' => 'fieldset', - '#title' => t('Questions assigned to this @quiz', array('@quiz' => QUIZ_NAME)), - ); - $form['assigned_questions']['questions'] = array( - '#type' => 'markup', - '#value' => theme('quiz_question_table', $questions), - ); - - // Display links to create other questions - $form['additional_questions'] = array( - '#type' => 'fieldset', - '#title' => t('Create additional questions'), - '#theme' => 'additional_questions', - ); - foreach (_quiz_get_question_types() as $type) { - $form['additional_questions'][$type] = array( - '#type' => 'markup', - '#value' => l($type, 'node/add/$type', array('title' => t("Go to $type administration"))) .' ', - ); - } - $form['submit'] = array( - '#type' => 'submit', - '#value' => t('Submit questions'), - ); - return $form; -} - -function quiz_questions() { - return drupal_get_form('quiz_questions_form'); -} - - -/** - * Submit function for quiz_questions - * - * Updates from the "add questions" tab - * - * @param $form_id - * A string containing the form id - * @param $values - * Array containing the form values - */ -function quiz_questions_form_submit($form_id, $values) { - // load the node - $quiz = node_load(arg(1)); - // Update quiz with selected question options - if (!quiz_update_questions($values['question_status'])) { - form_set_error('', t('Either no questions were selected, or there was a problem updating your @quiz. Please try again.', array('@quiz' => QUIZ_NAME))); - return; - } - - // Determine how many more questions are required - $qnum = $quiz->number_of_questions; - $anum_random = quiz_get_num_questions($quiz->nid, QUESTION_RANDOM); - $anum_always = quiz_get_num_questions($quiz->nid, QUESTION_ALWAYS); - $anum_total = $anum_always + $anum_random; - - // If we have some random questions, increase this number by one. - if ($anum_random > 0) { - $anum_always++; - } - - // If there are not enough questions, lower the number of questions and let the user know. - if ($anum_total < $qnum) { - drupal_set_message(t('The number of questions for this @quiz have been lowered to %anum to match the number of questions you assigned.', array('@quiz' => QUIZ_NAME, '%anum' => $anum_total)), 'status'); - db_query("UPDATE {quiz} SET number_of_questions = %d WHERE nid = %d", $anum_total, $quiz->nid); - } + * Array of questions. + */ +function _quiz_get_questions() { + $quiz = node_load(arg(1)); + $questions = array(); + if (!empty($quiz->nid)) { + // Retrieve list of questions. + $result = db_query("SELECT n.nid, n.title, n.type, nr.body, nr.format, q.question_priority + FROM {node} n INNER JOIN {node_revisions} nr ON (n.nid = nr.nid) INNER JOIN {quiz_questions} q ON (n.nid = q.question_nid) + WHERE q.quiz_nid = %d", $quiz->nid + ); - // If there are too many questions set to "always", increase the number of questions and let the user know. - else if ($anum_always > $qnum) { - drupal_set_message(t('The number of questions for this @quiz have been increased to %anum to match the number of questions you assigned.', array('@quiz' => QUIZ_NAME, '%anum' => $anum_always)), 'status'); - db_query("UPDATE {quiz} SET number_of_questions = %d WHERE nid = %d", $anum_always, $quiz->nid); + // Create questions array. + while ($node = db_fetch_object($result)) { + $questions[] = quiz_node_map($node); + } } - // Otherwise just give general feedback. - else { - drupal_set_message(t('Questions updated successfully.')); - } + return $questions; } /** - * Gets the number questions of a given type for a quiz - * + * Gets the number questions of a given type for a quiz. + * * @param $nid - * node id of the quiz + * Node ID of the quiz. * @param $type - * status constant + * Priority constant. * @return - * Number of questions that meet the criteria + * Number of questions that meet the criteria. */ -function quiz_get_num_questions($nid, $type) { - return db_num_rows(db_query("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_status = %d", $nid, $type)); +function quiz_get_num_questions($nid, $priority) { + return db_num_rows(db_query("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_priority = %d", $nid, $priority)); } - /** * Filters question list by given terms. * * @param $terms - * An array of vocabulary term IDs + * An array of vocabulary term IDs. + * @param $assigned + * Should assigned questions be retrieved? + * @param $terms + * Should unassigned questions be retrieved? + * @param $quiz_nid + * The node ID of the quiz node being managed. + * * @return - * Array of questions which match terms + * Array of questions which match terms. */ -function quiz_filter_question_list($terms = NULL) { +function quiz_filter_question_list($terms, $assigned, $unassigned, $quiz_nid) { + // Retrieve question list from database, filtered on vocabulary terms. + $sql = "SELECT DISTINCT n.nid, n.title, n.type, nr.body, nr.format, qq.question_priority FROM {node} n"; + $joins[] = "INNER JOIN {node_revisions} nr ON (n.nid = nr.nid)"; + // Select published question nodes only. + $wheres[] = "n.status = 1"; + $wheres[] = "n.type IN ('". implode("','", _quiz_get_question_types()) ."')"; + + $args = array(); - // Retrieve question list from database, filtered on vocabulary terms - $sql = " - SELECT DISTINCT n.nid, n.type, r.body, r.format - FROM {node} n, {node_revisions} r "; if (count($terms) > 0) { - $sql .= ", {term_node} t "; + $joins[] = "INNER JOIN {term_node} t ON (t.nid = nr.nid)"; + $wheres[] .= "t.tid IN (". implode(', ', $terms) .")"; } - $sql .= "WHERE n.nid = r.nid AND n.type IN ('". implode("','", _quiz_get_question_types()) ."') "; - if (count($terms) > 0) { - $sql .= "AND t.tid IN (". $terms .") AND t.nid = n.nid"; + if ($assigned && !$unassigned) { + $joins[] = "INNER JOIN {quiz_questions} qq ON (n.nid = qq.question_nid)"; + $wheres[] = "qq.quiz_nid = %d"; + $args[] = $quiz_nid; + } + else if ($unassigned && !$assigned) { + // Unassigned questions will not necessarily be present in the + // quiz_questions table. Therefore, use a LEFT JOIN. + $joins[] = "LEFT JOIN {quiz_questions} qq ON (n.nid = qq.question_nid)"; + $wheres[] = "qq.question_nid IS NULL"; + } + else { + $joins[] = "LEFT JOIN {quiz_questions} qq ON (n.nid = qq.question_nid)"; + $wheres[] = "(qq.quiz_nid = %d OR qq.question_nid IS NULL)"; + $args[] = $quiz_nid; } - $result = db_query($sql); - - // Create questions array + $joins = implode(' ', $joins); + $wheres = implode(' AND ', $wheres); + + $result = pager_query("$sql $joins WHERE $wheres ORDER BY n.title ASC", quiz_variable_get('pager'), 0, NULL, $args); + + // Create questions array. $questions = array(); while ($node = db_fetch_object($result)) { $questions[$node->nid] = quiz_node_map($node); @@ -1307,159 +1341,56 @@ function quiz_filter_question_list($term } /** - * Map node properties to a question object + * Map node properties to a question object. * * @param $node - * Node + * Node. * @return - * Question object + * Question object. */ function quiz_node_map($node) { $new_question = new stdClass(); + $new_question->title = $node->title; $new_question->question = check_markup($node->body, $node->format); $new_question->nid = $node->nid; $new_question->type = $node->type; - $new_question->status = isset($node->question_status) ? $node->question_status : 2; + $new_question->question_priority = isset($node->question_priority) ? $node->question_priority : QUESTION_NEVER; + return $new_question; } /** - * Updates questions assigned to the quiz + * Updates questions assigned to the quiz. * * @param $questions - * Array of questions and their status - * @return - * True if update was a success, false if three was a problem + * Array of questions and their priorities. */ -function quiz_update_questions($questions) { - $quiz = node_load(arg(1)); - $return = true; - - if (!empty($questions)) { - // Get currently assigned questions - $result = db_query("SELECT quiz_nid, question_nid, question_status FROM {quiz_questions} WHERE quiz_nid = %d", $quiz->nid); - $assigned_questions = array(); - while ($assigned_question = db_fetch_object($result)) { - $assigned_questions[$assigned_question->question_nid] = $assigned_question->question_status; - } - - // Perform update if question is already assigned, or insert if it's a new question - while (list($key, $value) = each($questions)) { - if ($value == QUESTION_NEVER) { - $result = db_query("DELETE FROM {quiz_questions} WHERE quiz_nid = %d AND question_nid = %d", $quiz->nid, $key); - if (!$result) { - $return = false; - } +function quiz_update_questions($quiz, $questions, $priority, $assigned_questions) { + foreach ($questions as $question_nid) { + if ($priority == QUESTION_NEVER) { + db_query("DELETE FROM {quiz_questions} WHERE quiz_nid = %d AND question_nid = %d", $quiz->nid, $question_nid); + } + else { + if (isset($assigned_questions[$question_nid])) { + db_query("UPDATE {quiz_questions} SET question_priority = %d WHERE quiz_nid = %d AND question_nid = %d", $priority, $quiz->nid, $question_nid); } else { - if (array_key_exists($key, $assigned_questions)) { - $result = db_query("UPDATE {quiz_questions} SET question_status = %d WHERE quiz_nid = %d AND question_nid = %d", $value, $quiz->nid, $key); - if (!$result) { - $return = false; - } - } - else { - $result = db_query("INSERT INTO {quiz_questions} (quiz_nid, question_nid, question_status) VALUES (%d, %d, %d)", $quiz->nid, $key, $value); - if (!$result) { - $return = false; - } - } + db_query("INSERT INTO {quiz_questions} (quiz_nid, question_nid, question_priority) VALUES (%d, %d, %d)", $quiz->nid, $question_nid, $priority); } } - - } - else { - $return = false; - } - - return $return; - -} - - -/** - * Implementation of hook_settings() - */ -function quiz_admin_settings() { - $form = array(); - // option to globally turn off pass / fail form elements - $form['quiz_default_close'] = array( - '#type' => 'textfield', - '#title' => t('Default number of days before a @quiz is closed', array('@quiz' => QUIZ_NAME)), - '#default_value' => variable_get('quiz_default_close', 30), - '#description' => t('Supply a number of days to calculate the default close date for new quizzes.'), - ); - $form['quiz_use_passfail'] = array( - '#type' => 'checkbox', - '#title' => t('Display pass / fail options in the @quiz form', array('@quiz' => QUIZ_NAME)), - '#default_value' => variable_get('quiz_use_passfail', 1), - '#description' => t('Check this to display the pass / fail options in the quiz form. You can still choose to ignore pass / fail options on a quiz by quiz basis if this is checked, but if you want to prohibit other quiz module creators from using these options, unchecked this option.'), - ); - $form['quiz_default_pass_rate'] = array( - '#type' => 'textfield', - '#title' => t('Default percentage needed to pass a @quiz', array('@quiz' => QUIZ_NAME)), - '#default_value' => variable_get('quiz_default_pass_rate', 75), - '#description' => t('Supply a number between 1 and 100 to set as the default percentage correct needed to pass a quiz. Set to 0 if you want to ignore pass / fail summary information by default.'), - ); - $form['quiz_name'] = array( - '#type' => 'textfield', - '#title' => t('Assessment name'), - '#default_value' => QUIZ_NAME, - '#description' => t('How do you want to refer to quizzes across the site (for example: quiz, test, assessment). This will affect display text but will not affect menu paths.'), - '#required' => TRUE, - ); - return system_settings_form($form); -} - -/** - * Validation form settings form - */ -function quiz_settings_form_validate($form_id, $form_values) { - if (!is_numeric($form_values['quiz_default_close']) || $form_values['quiz_default_close'] <= 0) { - form_set_error('quiz_default_close', t('The default number of days before a quiz is closed must be a number greater than 0.')); - } - if (!is_numeric($form_values['quiz_default_pass_rate'])) { - form_set_error('quiz_default_pass_rate', t('The pass rate value must be a number between 0% and 100%.')); - } - if ($form_values['quiz_default_pass_rate'] > 100) { - form_set_error('quiz_default_pass_rate', t('The pass rate value must not be more than 100%.')); - } - if ($form_values['quiz_default_pass_rate'] < 0) { - form_set_error('quiz_default_pass_rate', t('The pass rate value must not be less than 0%.')); } } /** - * Quiz Admin - * - */ -function quiz_admin() { - $results = _quiz_get_results(); - return theme('quiz_admin', $results); -} - - -/* - * Get a full results list + * Get a full results list. */ -function _quiz_get_results($nid = '', $uid = 0) { +function _quiz_get_results($nid = NULL, $uid = 0, $pager = TRUE) { $results = array(); $args = array(); - $sql = "SELECT n.nid nid, - n.title title, - u.name name, - qr.rid rid, - qr.time_start, - qr.time_end - FROM {node} n, {quiz} q, {quiz_result} qr, {users} u - WHERE - n.type = 'quiz' - AND - n.nid = q.nid - AND - qr.quiz_nid = q.nid - AND - u.uid = qr.uid"; + $sql = "SELECT n.nid, n.title, u.uid, u.name, qr.rid, qr.time_start, qr.time_end, qr.score + FROM {node} n INNER JOIN {quiz} q ON (q.nid = n.nid) INNER JOIN {quiz_results} qr ON (qr.quiz_nid = q.nid) INNER JOIN {users} u ON (u.uid = qr.uid) + WHERE n.type = 'quiz' + "; if ($nid) { $sql .= " AND qr.quiz_nid = %d"; $args[] = $nid; @@ -1468,484 +1399,483 @@ function _quiz_get_results($nid = '', $u $sql .= " AND qr.uid = %d"; $args[] = $uid; } - $sql .= " ORDER BY qr.rid ASC"; - $dbresult = db_query($sql, $args); - //Create results array - while ($line = db_fetch_array($dbresult)) { - $results[$line['rid']] = $line; - } - return $results; -} - -/* - * Quiz Results User - */ -function quiz_user_results() { - $result = db_fetch_object(db_query('SELECT q.nid FROM {quiz} q, {quiz_result} qr WHERE qr.quiz_nid = q.nid AND qr.rid = %d', arg(2))); - if ($result->nid) { - $quiz = node_load($result->nid); - $questions = _quiz_get_answers(arg(2)); - $score = quiz_calculate_score(arg(2)); - $summary = _quiz_get_summary_text($quiz, $score); - return theme('quiz_user_summary', $quiz, $questions, $score, $summary); + $sql .= " ORDER BY qr.rid DESC"; + if ($pager) { + $result = pager_query($sql, quiz_variable_get('pager'), 0, NULL, $args); } else { - drupal_not_found(); + $result = db_query($sql, $args); } -} -/* - * Quiz Results Admin - */ -function quiz_admin_results() { - $result = db_fetch_object(db_query('SELECT quiz.nid FROM {quiz} quiz, {quiz_result} quiz_result WHERE quiz_result.quiz_nid = quiz.nid AND quiz_result.rid = %d', arg(2))); - if ($result->nid) { - $quiz = node_load($result->nid); - $questions = _quiz_get_answers(arg(2)); - $score = quiz_calculate_score(arg(2)); - $summary = _quiz_get_summary_text($quiz, $score); - return theme('quiz_admin_summary', $quiz, $questions, $score, $summary); - } - else { - drupal_not_found(); + // Create results array. + while ($score = db_fetch_object($result)) { + $results[$score->rid] = $score; } -} - - -/* - * Delete Result - */ -function quiz_admin_result_delete() { - return drupal_get_form('quiz_admin_result_delete_form'); -} - -function quiz_admin_result_delete_form() { - $form['del_rid'] = array('#type' => 'hidden', '#value' => arg(2)); - return confirm_form($form, - t('Are you sure you want to delete this @quiz result?', array('@quiz' => QUIZ_NAME)), - 'admin/quiz', - t('This action cannot be undone.'), - t('Delete'), - t('Cancel')); -} -function quiz_admin_result_delete_form_submit($form_id, $form_values) { - - db_query("DELETE FROM {quiz_result} WHERE rid = %d", $form_values['del_rid']); - db_query("DELETE FROM {quiz_question_results} WHERE result_rid = %d", $form_values['del_rid']); - drupal_set_message(t('Deleted result.')); - return "admin/quiz"; + return $results; } - function _quiz_get_answers($rid) { $results = array(); - $dbresult = db_query("SELECT - qqr.question_nid qnid, - qqr.answer qanswer, - nr.body question, - n.type type - FROM {quiz_question_results} qqr, {quiz_question} qq, {node} n, {node_revisions} nr - WHERE - qqr.result_rid = %d - AND - qqr.question_nid = qq.nid - AND - n.nid = qq.nid - AND - nr.nid = n.nid", $rid); - //Create results array + $dbresult = db_query("SELECT qqr.question_nid qnid, qqr.answer qanswer, nr.body question, n.type type + FROM {quiz_question_results} qqr INNER JOIN {quiz_question} qq ON (qqr.question_nid = qq.nid) INNER JOIN {node} n ON (n.nid = qq.nid) INNER JOIN {node_revisions} nr ON (nr.nid = n.nid) + WHERE qqr.result_rid = %d", $rid + ); + // Create results array. while ($line = db_fetch_array($dbresult)) { $results[$line['qnid']] = $line; } + return $results; } /** - * Get the quiz name variable for use as a constant - * so we don't have to keep calling for it in every function + * Check if a quiz is available. * - * @return - * quiz name variable - **/ -function _quiz_get_quiz_name() { - return variable_get('quiz_name', 'Quiz'); + * @param $node + * The quiz node object. + * @return $return + * TRUE if the quiz is available or an appropriate error message if not. + */ +function quiz_get_availability($node) { + $return = TRUE; + + if (!$node->quiz_always) { + if ($node->quiz_close <= time()) { + $return = t('This @quiz is no longer available', array('@quiz' => QUIZ_NAME)); + } + else if ($node->quiz_open > time()) { + if (is_array($node->quiz_close)) { + quiz_translate_form_date($node, 'quiz_close'); + } + + $return = t('This @quiz will be available from %date.', array('@quiz' => QUIZ_NAME, '%date' => format_date($node->quiz_close))); + } + } + + return $return; } +/** + * Check if a user has reached the maximum number of takes available. + * + * @param $quiz + * The quiz node object. + * @param $uid + * User ID. + * @return $return + * TRUE if takes are available or an appropriate error message if not. + */ +function quiz_validate_takes($quiz, $uid) { + if ($uid > 0) { + $takes = db_result(db_query('SELECT COUNT(rid) AS count FROM {quiz_results} WHERE uid = %d AND quiz_nid = %d', $uid, $quiz->nid)); + // FIXME: Allow quiz owner and quiz admins to retake the quiz as many times as + // they like. + if ($quiz->takes != 0 && $takes >= $quiz->takes) { + return t('You have already taken this @quiz the maximum %d times.', array('@quiz' => QUIZ_NAME, '%d' => $quiz->takes)); + } + } + + return TRUE; +} ///////////////////////////////////////////////// /// Theme functions ///////////////////////////////////////////////// /** - * Theme the admin results table - * + * Theme the admin results table. + * @TODO Perhaps club this with the user results theme function. + * * @param $results - * As returned by _quiz_get_results() + * As returned by _quiz_get_results(). */ function theme_quiz_admin($results) { - $output = ''; $rows = array(); while (list($key, $result) = each($results)) { + if ($result->time_end > 0) { + $finished = format_date($result->time_end, 'small'); + $view = l('View', 'admin/quiz/'. $result->rid); + } + else { + $finished = t('In progress'); + $view = t('View'); + } $rows[] = array( - l('view', 'admin/quiz/'. $result['rid'] .'/view') .' | '. l('delete', 'admin/quiz/'. $result['rid'] .'/delete'), - check_plain($result['title']), - check_plain($result['name']), - $result['rid'], - format_date($result['time_start'], 'small'), - ($result['time_end'] > 0) ? format_date($result['time_end'], 'small') : t('In Progress'), + l($result->title, 'node/'. $result->nid), + theme('username', $result), + t('@score%', array('@score' => $result->score)), + format_date($result->time_start, 'small'), + $finished, + $view, + l('Delete', 'admin/quiz/'. $result->rid .'/delete'), ); } - + $header = array( - t('Action'), - t('@quiz Title', array('@quiz' => QUIZ_NAME)), + t('@quiz title', array('@quiz' => QUIZ_NAME)), t('Username'), - t('Result
ID'), - t('Time Started'), - t('Finished?')); - + t('Score'), + t('Time started'), + t('Finished'), + array('data' => t('Operations'), 'colspan' => 2), + ); + if (!empty($rows)) { - $output .= theme('table', $header, $rows); + $output = theme('table', $header, $rows); + $output .= theme('pager', NULL, quiz_variable_get('pager'), 0); } else { - $output .= t('No @quiz results found.', array('@quiz' => QUIZ_NAME)); + $output = t('No @quiz results found.', array('@quiz' => QUIZ_NAME)); } + return $output; } /** - * Theme the user results page - * + * Theme the user results page. + * * @param $results - * An array of quiz information + * An array of quiz information. * @return - * Themed html + * Themed HTML. */ function theme_quiz_get_user_results($results) { - $output = ''; $rows = array(); + while (list($key, $result) = each($results)) { + if ($result->time_end > 0) { + $finished = format_date($result->time_end, 'small'); + $view = l('View', 'user/quiz/'. $result->rid); + } + else { + $finished = t('In progress'); + $view = t('View'); + } $rows[] = array( - l('view', 'user/quiz/'. $result['rid'] .'/userresults'), - check_plain($result['title']), - check_plain($result['name']), - $result['rid'], - format_date($result['time_start'], 'small'), - ($result['time_end'] > 0) ? format_date($result['time_end'], 'small') : t('In Progress'), + l($result->title, 'node/'. $result->nid), + t('@score%', array('@score' => $result->score)), + format_date($result->time_start, 'small'), + $finished, + $view ); } - + $header = array( - t('Action'), t('@quiz Title', array('@quiz' => QUIZ_NAME)), - t('Username'), - t('Result
ID'), - t('Time Started'), - t('Finished?')); - + t('Score'), + t('Time started'), + t('Finished'), + t('Operations') + ); + if (!empty($rows)) { - $output .= theme('table', $header, $rows); + $output = theme('table', $header, $rows); + $output .= theme('pager', NULL, quiz_variable_get('pager'), 0); } else { - $output .= t('No @quiz results found.', array('@quiz' => QUIZ_NAME)); + $output = t('No @quiz results found.', array('@quiz' => QUIZ_NAME)); } - return $output; + + return $output; } /** - * Theme the filtered question list + * Theme the filtered question list. */ -function theme_quiz_filtered_questions($form) { - $header = array(t('Random'), t('Always'), t('Never'), t('Question'), t('Type')); +function theme_quiz_manage_questions_form($form) { + $header = array(theme('table_select_header_cell'), t('Question'), t('Type'), t('Frequency'), t('Operations')); $rows = array(); - while (list($nid, $values) = each($form['question_status'])) { + while (list($nid, $values) = each($form['filtered_question_list']['question_priority'])) { if (is_numeric($nid)) { $rows[] = array( - drupal_render($form['question_status'][$nid][0]), - drupal_render($form['question_status'][$nid][1]), - drupal_render($form['question_status'][$nid][2]), - drupal_render($form['question'][$nid]), - drupal_render($form['type'][$nid]) + drupal_render($form['filtered_question_list']['nodes'][$nid]), + drupal_render($form['filtered_question_list']['question'][$nid]), + drupal_render($form['filtered_question_list']['type'][$nid]), + drupal_render($form['filtered_question_list']['question_priority'][$nid]), + l('Edit', 'node/'. $nid .'/edit') ); } } if (!empty($rows)) { - $output .= theme('table', $header, $rows); + $output = theme('table', $header, $rows); + $output .= theme('pager', NULL, quiz_variable_get('pager'), 0); + // Stick table inside the fieldset. + $form['filtered_question_list']['#children'] = $output; + $output = drupal_render($form); } else { - $output .= t('No questions found.'); - } - return $output; -} - - -/** - * Theme a table containing array of questions and options - * - * @param $questions - * Array of question nodes - * @return - * HTML to output table - */ -function theme_quiz_question_table($questions) { - $output = ''; - $rows = array(); - $status_descriptions = array(t('Random'), t('Always'), t('Never')); - while (list($key, $question) = each($questions)) { - $rows[] = array( - $status_descriptions[$question->status], - check_markup($question->question), - $question->type, - l('Edit', 'node/'. $question->nid .'/edit')); + $output = t('No questions found.'); } - $header = array(t('Status'), t('Question'), t('Type'), t('Edit')); - if (!empty($rows)) { - $output .= theme('table', $header, $rows); - } - else { - $output .= 'No questions found.'; - } return $output; } - -/** - * Pass the correct mark to the theme so that theme authors can use an image - * - * TODO: A default image might be better here. - */ -function theme_quiz_score_correct() { - return theme('image', drupal_get_path('module', 'quiz') .'/images/correct.gif', t('correct')); -} - - /** - * Pass the incorrect mark to the theme so that theme authors can use an image + * Theme a progress indicator for use during a quiz. * - * TODO: A default image might be better here. - */ -function theme_quiz_score_incorrect() { - return theme('image', drupal_get_path('module', 'quiz') .'/images/incorrect.gif', t('incorrect')); -} - - -/** - * Theme a progress indicator for use during a quiz - * * @param $question_number - * The position of the current question in the sessions' array - * @param $num_of_question - * The number of questions for this quiz as returned by quiz_get_number_of_questions() + * The position of the current question in the sessions' array. + * @param $num_of_questions + * The number of questions for this quiz as returned by + * quiz_get_number_of_questions(). * @return - * Themed html + * Themed HTML. */ -function theme_quiz_progress($question_number, $num_of_question) { - +function theme_quiz_progress($question_number, $num_of_questions) { // Determine the percentage finished (not used but left for other implementations) - //$progress = ($question_number*100)/$num_of_question; - - // Get the current question # by adding one + // $progress = ($question_number*100)/$num_of_question; + + // Get the current question # by adding one. $current_question = $question_number + 1; - - // return html - $output = ''; - $output .= '
'; - $output .= t('Question %x of %y', array('%x' => $current_question, '%y' => $num_of_question)); - $output .= '

'."\n"; - return $output; -} + // Return HTML. + $output = '
'; + $output .= t('Question %x of %y', array('%x' => $current_question, '%y' => $num_of_questions)); + $output .= '
'; + return $output; +} /** - * Theme a question page - * + * Theme a question page. + * * @param $quiz - * The quiz node object + * The quiz node object. * @param $question_node - * The question node + * The question node. * @return - * Themed html + * Themed HTML. */ function theme_quiz_take_question($quiz, $question_node) { + // Calculation for quiz progress bar. + $max_questions = $quiz->max_questions; + $question_number = $max_questions - count($_SESSION['quiz_'. $quiz->nid]['quiz_questions']); + + // Set the title here in case themers want to do something different. + drupal_set_title(check_plain($quiz->title)); + + // Return the elements of the page. + $output = theme('quiz_progress', $question_number, $max_questions); + // Render question form. Pass the Quiz nid to pass as #type => value. + $output .= module_invoke($question_node->type, 'render_question', $question_node, $quiz->nid); - //Calculation for quiz progress bar - $number_of_questions = quiz_get_number_of_questions($quiz->nid); - $question_number = $number_of_questions - count($_SESSION['quiz_'. $quiz->nid]['quiz_questions']); - - // Set the title here in case themers want to do something different - drupal_set_title(check_plain($quiz->title)); - - // Return the elements of the page - $output = ''; - $output .= theme('quiz_progress', $question_number, $number_of_questions); - $output .= module_invoke($question_node->type, 'render_question', $question_node); return $output; } - /** - * Theme the summary page after the quiz has been completed - * + * Theme the summary page after the quiz has been completed. + * * @param $quiz - * The quiz node object + * The quiz node object. * @param $questions - * The questions array as defined by _quiz_get_answers + * The questions array as defined by _quiz_get_answers. * @param $score - * Array of score information as returned by quiz_calculate_score() + * Array of score information as returned by quiz_calculate_score(). * @param $summary - * Filtered text of the summary + * Filtered text of the summary. * @return - * Themed html + * Themed HTML. */ function theme_quiz_take_summary($quiz, $questions, $score, $summary) { - - // Set the title here so themers can adjust + // Set the title here so themers can adjust. drupal_set_title(check_plain($quiz->title)); - // Display overall result - $output = ''; - $output .= '
'. t('You got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'."\n"; - $output .= '
'. t('Your score: @score%', array('@score' => $score['percentage_score'])) .'

'."\n"; - $output .= '
'. $summary .'

'."\n"; - - // Get the feedback for all questions - $output .= theme('quiz_feedback', $questions, FALSE, TRUE); + // Display overall result. + $output = '
'. t('You got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'; + $output .= '
'. t('Your score: @score%', array('@score' => $score['percentage_score'])) .'
'; + $output .= '
'. $summary .'
'; + + // Display feedback for all questions. + if ($quiz->feedback_time == FEEDBACK_AFTER_QUIZ || $quiz->feedback_time == FEEDBACK_AFTER_BOTH) { + // FIXME: This should probably be paginated. + $output .= theme('quiz_feedback', $questions, FALSE, TRUE); + } return $output; - } - /** - * Theme the summary page for admins - * + * Theme the summary page for admins. + * * @param $quiz - * The quiz node object + * The quiz node object. * @param $questions - * The questions array as defined by _quiz_get_answers + * The questions array as defined by _quiz_get_answers. * @param $score - * Array of score information as returned by quiz_calculate_score() + * Array of score information as returned by quiz_calculate_score(). * @param $summary - * Filtered text of the summary + * Filtered text of the summary. * @return - * Themed html + * Themed HTML. */ function theme_quiz_admin_summary($quiz, $questions, $score, $summary) { - - // Set the title here so themers can adjust + // Set the title here so themers can adjust. drupal_set_title(check_plain($quiz->title)); - // Display overall result - $output = ''; - $output .= '
'. t('This person got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'."\n"; - $output .= '
'. t('Total score: @score%', array('@score' => $score['percentage_score'])) .'

'."\n"; - $output .= '
'. $summary .'

'."\n"; - - // Get the feedback for all questions + // Display overall result. + $output = '
'. t('User got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'; + $output .= '
'. t('Total score: @score%', array('@score' => $score['percentage_score'])) .'
'; + $output .= '
'. $summary .'
'; + + // Get the feedback for all questions. $output .= theme('quiz_feedback', $questions, TRUE, TRUE); return $output; } - /** - * Theme the summary page for user results - * + * Theme the summary page for user results. + * * @param $quiz - * The quiz node object + * The quiz node object. * @param $questions - * The questions array as defined by _quiz_get_answers + * The questions array as defined by _quiz_get_answers. * @param $score - * Array of score information as returned by quiz_calculate_score() + * Array of score information as returned by quiz_calculate_score(). * @param $summary - * Filtered text of the summary + * Filtered text of the summary. * @return - * Themed html + * Themed HTML. */ function theme_quiz_user_summary($quiz, $questions, $score, $summary) { - - // Set the title here so themers can adjust + // Set the title here so themers can adjust. drupal_set_title(check_plain($quiz->title)); - // Display overall result - $output = ''; - $output .= '
'. t('You got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'."\n"; - $output .= '
'. t('Your score was: @score%', array('@score' => $score['percentage_score'])) .'

'."\n"; - $output .= '
'. $summary .'

'."\n"; - - // Get the feedback for all questions + // Display overall result. + $output = '
'. t('You got %num_correct of %question_count correct.', array('%num_correct' => $score['num_correct'], '%question_count' => $score['question_count'])) .'
'; + $output .= '
'. t('Your score was: @score%', array('@score' => $score['percentage_score'])) .'
'; + $output .= '
'. $summary .'
'; + + // Get the feedback for all questions. $output .= theme('quiz_feedback', $questions, FALSE, TRUE); return $output; - } - /** - * Theme the question feedback - * + * Theme the question feedback. + * * @param $questions - * Array of quiz objects as returned by _quiz_get_answers - * @param showpoints - * Binary flag for whether to show the actual answers - * @param $showfeedback - * binary flag for whether to show question feedback + * Array of quiz objects as returned by _quiz_get_answers. + * @param $show_answers + * Binary flag for whether to show the actual answers. + * @param $show_feedback + * Binary flag for whether to show question feedback. * @return - * Themed html + * Themed HTML. */ -function theme_quiz_feedback($questions, $showpoints = TRUE, $showfeedback = FALSE) { +function theme_quiz_feedback($questions, $show_answers = TRUE, $show_feedback = FALSE) { $rows = array(); - $header = array(t('Question Result(s)'), ''); - // go through each of the questions + $header = array(t('Question result(s)')); + // Go through each of the questions. while (list($key, $question) = each($questions)) { - - // reset the cols array + // Reset the cols array. $cols = array(); - - // Get the answer table for this question - $question['qanswer'] = unserialize($question['qanswer']); - $result = module_invoke($question['type'], 'calculate_results', $question['qanswer']['answers'], $question['qanswer']['tried'], $showpoints, $showfeedback); - - // Build the question answers header (add blank space for IE) - $innerheader = array(t('Answers')); - if ($showpoints) { - $innerheader[] = t('Correct Answer'); - } - $innerheader[] = t('User Answer'); - if ($showfeedback) { - $innerheader[] = ' '; - } - - // Add the cell with the question and the answers - $q_output = '
Q: '. check_markup($question['question']) .'
'; - $q_output .= theme('table', $innerheader, $result['resultstable']) .'
'; - $cols[] = array('data' => $q_output, 'class' => 'quiz_summary_qcell'); - - // Get the score result for each question. - if ($result['score'] == 1) { - $cols[] = array('data' => theme('quiz_score_correct'), 'class' => 'quiz_summary_qcell'); - } - else { - $cols[] = array('data' => theme('quiz_score_incorrect'), 'class' => 'quiz_summary_qcell'); - } - // pack all of this into this row - $rows[] = array('data' => $cols, 'class' => 'quiz_summary_qrow'); + // Get the answer table for this question. + $output = theme('question_feedback', $question, $show_answers, $show_feedback); + $cols[] = array('data' => $output, 'class' => 'quiz-summary-qcell'); + + // Pack all of this into this row. + $rows[] = array('data' => $cols, 'class' => 'quiz-summary-qrow'); } + return theme('table', $header, $rows); } +/** + * Theme the question feedback. + * + * @param $questions + * Array of quiz objects as returned by _quiz_get_answers. + * @param $show_answer + * Binary flag for whether to show the actual answers. + * @param $show_feedback + * Binary flag for whether to show question feedback. + * @return + * Themed HTML. + */ +function theme_question_feedback($question, $show_answer = TRUE, $show_feedback = FALSE) { + $question['qanswer'] = unserialize($question['qanswer']); + $result = module_invoke($question['type'], 'calculate_results', $question['qanswer']['answers'], $question['qanswer']['tried'], $show_answer, $show_feedback); + + // Build the question answers header (add blank space for IE). + $header = array('', t('Answers')); + if ($show_answer) { + $header[] = t('Correct answer'); + } + $header[] = t('User answer'); + if ($show_feedback) { + $header[] = t('Feedback'); + } + + // Add the cell with the question and the answers. + $output = '
'. check_markup($question['question']) .'
'; + + $row_span = count($result['results_table'][0]); + // Get the score result for each question. + if ($result['score'] == 1) { + $score = array('rowspan' => $row_span, 'class' => 'quiz-score-correct', 'title' => t('Correct')); + } + else { + $score = array('rowspan' => $row_span, 'class' => 'quiz-score-incorrect', 'title' => t('Incorrect')); + } + + array_unshift($result['results_table'][0], $score); + $output .= theme('table', $header, $result['results_table']); + + return $output; +} /** - * Allow the option to theme the questions form + * Theme the node view for quizzes. */ -function theme_quiz_questions($form) { - $output = ''; - $output .= drupal_render($form); - return $output; +function theme_quiz_view($node, $teaser = FALSE, $page = FALSE) { + $row_header = array( + t('Max questions'), + t('Pass percentage'), + t('Maximum takes') + ); + $rows[] = array($node->number_of_questions ? check_plain($node->number_of_questions) : t('All')); + $rows[] = array($node->pass_rate ? check_plain($node->pass_rate) : t('N/A')); + $rows[] = array($node->takes ? check_plain($node->takes) : t('Unlimited')); + + if (!$node->always) { + if (is_array($node->quiz_close)) { + quiz_translate_form_date($node, 'quiz_close'); + } + + $row_header[] = t('Close date'); + $rows[] = array(format_date($node->quiz_close)); + } + + return theme('quiz_row_table', array(), $row_header, $rows, array('class' => 'quiz-options-table'), t('@quiz options', array('@quiz' => QUIZ_NAME))); +} + +/** + * Return a themed table with row headers. + * + * @param $column_header + * An array containing the table column headers. + * @param $row_header + * An array containing the table row headers. + * @param $rows + * An array of table rows. + * @param $attributes + * An array of HTML attributes to apply to the table tag. + * @param $caption + * A localized string to use for the tag. + * @return + * An HTML string representing the table. + */ +function theme_quiz_row_table($column_header, $row_header, $rows, $attributes = array(), $caption = NULL) { + foreach ($rows as $number => $row) { + array_unshift($row, array('data' => $row_header[$number], 'header' => TRUE)); + $rows[$number] = $row; + } + + return theme('table', $column_header, $rows, $attributes, $caption); } diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/README.txt ./README.txt --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/README.txt 2007-04-14 02:03:38.000000000 +0530 +++ ./README.txt 2007-06-12 23:14:10.000000000 +0530 @@ -1,4 +1,4 @@ -; $Id: README.txt,v 1.5 2007/04/13 20:33:38 webchick Exp $ +; $Id: README.txt 107 2007-06-12 17:44:11Z karthik $ Overview -------- Only in .: .svn diff -up /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/TODO.txt ./TODO.txt --- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/TODO.txt 2007-04-14 02:03:38.000000000 +0530 +++ ./TODO.txt 2007-06-12 23:14:11.000000000 +0530 @@ -1,4 +1,4 @@ -$Id: TODO.txt,v 1.3 2007/04/13 20:33:38 webchick Exp $ +$Id: TODO.txt 107 2007-06-12 17:44:11Z karthik $ Critical --------