--- /media/hda7/www/cvs/drupal/contrib/cli/d5/contributions/modules/quiz/quiz.module 2007-05-18 20:58:37.000000000 +0530
+++ quiz.module 2007-06-06 10:15:13.000000000 +0530
@@ -1,78 +1,136 @@
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:
+
+ - Create at least one taxonomy vocabulary and assign it to the quiz and question type modules
+ - Create a series of questions
+ - Create a quiz based on the series of questions
+
+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
+
+ - 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.
+ - 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.
+ - Add a series of terms to the vocabulary to which questions and quizzes can be assigned. For example:
+
+ - Literature
+
+ - Children\'s books
+ - Poetry
+ - Shakespeare
+
+
+ - Mathematics
+
+ - Algebra
+ - Trigonometry
+ - Calculus
+
+
+ - Information Technology
+
+ - Hardware
+ - Programming
+ - Databases
+
+
+
+
+Creating quiz questions
+
+ - Begin by clicking Create content, and then select a question type node (for example, multichoice)
+ - 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).
+
+
+ - Repeat for each question you would like included on the quiz.
+
+Creating the quiz
+
+ - Go to Create content >> Quiz to access the quiz creation form.
+ - 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.
+
+
+ - Once the quiz has been created, click the add questions tab to assign questions to the quiz.
+ - 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.
+ - Select a radio button next to each question indicating if the question should appear (Randomly, Always, or Never), and click Submit questions.
+ - Repeat process until satisfied with question selection.
+
+ ', 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) {
@@ -82,12 +140,12 @@ function quiz_menu($may_cache) {
$access = user_access(QUIZ_PERM_ADMIN_CONFIG);
$items[] = array(
'path' => 'admin/settings/quiz',
- 'title' => t('@quiz Configuration', array('@quiz' => QUIZ_NAME)),
+ 'title' => t('Quiz'),
'description' => t('Describes what the settings generally do.'),
'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,43 +154,45 @@ 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) .'/quiz/start',
+ 'title' => t('Take @quiz', array('@quiz' => QUIZ_NAME)),
+ 'callback' => 'quiz_take_quiz',
+ 'access' => user_access('access quiz'),
+ 'type' => MENU_LOCAL_TASK,
+ );
}
}
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'),
'type' => MENU_LOCAL_TASK,
@@ -145,7 +205,7 @@ function quiz_menu($may_cache) {
'access' => user_access('user results'),
'type' => MENU_CALLBACK,
);
-
+
$items[] = array(
'path' => 'admin/quiz/'. arg(2) .'/view',
'title' => t('View @quiz', array('@quiz' => QUIZ_NAME)),
@@ -153,14 +213,15 @@ function quiz_menu($may_cache) {
'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 +229,59 @@ function quiz_menu($may_cache) {
}
/**
+ * Implementation of hook_perm().
+ */
+function quiz_perm() {
+ return array(QUIZ_PERM_ADMIN_CONFIG, 'administer quiz', 'create quiz', 'access quiz', 'user 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' => 'Create interactive quizzes for site visitors'
+ )
+ );
+}
+
+/**
* 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,7 +289,7 @@ 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);
@@ -192,27 +298,30 @@ function quiz_form(&$node) {
'#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)),
+ '#description' => t('The number of questions to include in this @quiz from the question bank.', 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)),
+ '#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(
@@ -223,20 +332,20 @@ function quiz_form(&$node) {
t('After each question'),
t('Do not show')
),
- '#description' => t('Indicates at what point feedback for each question will be given to the user'),
+ '#description' => t('Indicates at what point feedback for each question will be given to the user.'),
);
- // 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 +357,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, 20),
+ '#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)),
'#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)),
+ $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 rate for the @quiz as a percentage score', array('@quiz' => QUIZ_NAME)),
+ '#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,81 +408,16 @@ 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
+ // 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
+ // 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;
@@ -389,10 +429,10 @@ function quiz_validate($node) {
if ($anum_random > 1) {
$anum_total--;
}
- // format the valid range
+ // 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;
}
@@ -411,7 +451,7 @@ function quiz_validate($node) {
}
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%.'));
}
@@ -463,7 +503,6 @@ function quiz_load($node) {
/**
* Implementation of hook_view().
*/
-
function quiz_view($node, $teaser = FALSE, $page = FALSE) {
if (!$teaser && user_access('create quiz')) {
$node = node_prepare($node, $teaser);
@@ -477,192 +516,105 @@ function quiz_view($node, $teaser = FALS
}
/**
- * Themes a message about the quiz's availability for quiz takers
- *
- *
+ * Menu Callback: Quiz configuration form.
*/
-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.');
- }
- }
- $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')
- );
- $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";
- }
-
- // 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";
- }
-
- // 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;
-}
-
-
-/**
- * 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;
+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.
*
* @return
- * HTML output for page
+ * HTML output for page.
*/
function quiz_take_quiz() {
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 ($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
+ // 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 '';
}
- // Initialize session variables
+ // 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
+ // 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');
@@ -674,470 +626,191 @@ function quiz_take_quiz() {
}
}
- // If this quiz is in progress, load the next questions
- // and return it via the theme
+ // 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]));
return theme('quiz_take_question', $quiz, $question_node);
}
- // At the end of quiz
+ // At the end of quiz.
else {
- //First - update the result to show we have finished.
+ // 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
+ // 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']);
$summary = _quiz_get_summary_text($quiz, $score);
- // get the themed summary page
+ // Get the themed summary page.
$output = theme('quiz_take_summary', $quiz, $questions, $score, $summary);
- //remove session variables
+ // Remove session variables.
unset($_SESSION['quiz_'. $quiz->nid]);
- // return
return $output;
-
}
}
}
+
// If we got down here then the quiz does not exist.
drupal_not_found();
}
-
-/***
- * 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
- * @param $score
- * The score information as returned by quiz_calculate_score()
- * @return
- * Filtered summary text or null if we are not displaying any summary
+/**
+ * Menu callback: Quiz admin.
*/
-function _quiz_get_summary_text($quiz, $score) {
- $summary = '';
- // 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 (arg(3) == 'view') {
- $summary = t('The user passed this quiz.');
- }
- else {
- $summary = check_markup($quiz->summary_pass, $quiz->format);
- }
- }
- // 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 (arg(3) == 'view') {
- if ($node->pass_rate > 0) {
- $summary = t('The user failed this quiz.');
- }
- }
- else {
- $summary = check_markup($quiz->summary_default, $quiz->format);
- }
- }
- return $summary;
+function quiz_admin() {
+ $results = _quiz_get_results();
+ return theme('quiz_admin', $results);
}
/**
- * Actions to take place at the start of a quiz
- *
- * @param $uid
- * User ID
- * @param $nid
- * Quiz node ID
- * @return integer
- * Returns quiz_result rid, or false if there is an error.
+ * Menu callback: Quiz results user.
*/
-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
- 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;
- }
- }
+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);
}
-
- // 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;
- }
- }
+ else {
+ drupal_not_found();
}
+}
- // 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;
+/**
+ * Menu callback: 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_set_message(t('There was a problem starting the @quiz. Please try again later.', array('@quiz' => QUIZ_NAME), 'error'));
- return FALSE;
+ drupal_not_found();
}
}
/**
- * Calculates the score user received on quiz
- *
- * @param $rid
- * Quiz result ID
- * @return array
- * Contains three elements: question_count, num_correct and percentage_score
+ * Menu callback: Delete result.
*/
-function quiz_calculate_score($rid) {
- // initialize our variables
- $question_count = 0;
- $num_correct = 0;
- $percentage_score = 0;
+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')
+ );
+}
- // 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);
- 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
+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';
+}
+
+/**
+ * Menu callback: Display the manage questions tab.
+ */
+function quiz_manage_questions() {
+ $status = arg(3);
+ $assigned = $unassigned = TRUE;
+ if ($status == 'assigned') {
+ $unassigned = FALSE;
}
-
- // calculate the percentage score
- if ($question_count > 0) {
- $percentage_score = round(($num_correct * 100) / $question_count);
+ else if ($status == 'unassigned') {
+ $assigned = FALSE;
}
- // build the score array
- $score = array(
- 'question_count' => $question_count,
- 'num_correct' => $num_correct,
- 'percentage_score' => $percentage_score,
- );
+ $terms = arg(4);
+ $terms = !empty($terms) ? explode(' ', $terms) : array();
+ $terms = array_map(create_function('$i', 'return intval($i);'), $terms);
- // return the array
- return $score;
+ return drupal_get_form('quiz_manage_questions_filter_form', $assigned, $unassigned, $terms) . drupal_get_form('quiz_manage_questions_form', $assigned, $unassigned, $terms);
}
-/**
- * Retrieves a question list for a given quiz
- *
- * @param $nid
- * Quiz node ID
- * @return
- * Array of question node IDs
- */
-function quiz_build_question_list($nid) {
- $questions = array();
- $quiz = node_load($nid);
+function quiz_manage_questions_filter_form($assigned, $unassigned, $terms) {
+ $taxonomy = _quiz_taxonomy_select($terms);
- // Get required questions first
- $result = db_query("SELECT question_nid FROM {quiz_questions} WHERE quiz_nid = %d AND question_status = %d", $nid, QUESTION_ALWAYS);
- while ($question_node = db_fetch_object($result)) {
- $questions[] = $question_node->question_nid;
- }
+ $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.')
+ );
- // 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);
- while ($question_node = db_fetch_object($result)) {
- $questions[] = $question_node->question_nid;
+ $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'));
}
- // Shuffle questions if required
- if ($quiz->shuffle == 1) {
- shuffle($questions);
+ return $form;
+}
+
+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 $questions;
+ return 'node/'. $form['nid'] .'/questions/'. $status .'/'. $taxonomy;
}
/**
- * 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:
-
- - Create at least one taxonomy vocabulary and assign it to the quiz and question type modules
- - Create a series of questions
- - Create a quiz based on the series of questions
-
-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
-
- - 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.
- - 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.
- - Add a series of terms to the vocabulary to which questions and quizzes can be assigned. For example:
-
- - Literature
-
- - Children\'s books
- - Poetry
- - Shakespeare
-
-
- - Mathematics
-
- - Algebra
- - Trigonometry
- - Calculus
-
-
- - Information Technology
-
- - Hardware
- - Programming
- - Databases
-
-
-
-
-Creating quiz questions
-
- - Begin by clicking Create content, and then select a question type node (for example, multichoice)
- - 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).
-
-
- - Repeat for each question you would like included on the quiz.
-
-Creating the quiz
-
- - Go to Create content >> Quiz to access the quiz creation form.
- - 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.
-
-
- - Once the quiz has been created, click the add questions tab to assign questions to the quiz.
- - 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.
- - Select a radio button next to each question indicating if the question should appear (Randomly, Always, or Never), and click Submit questions.
- - Repeat process until satisfied with question selection.
-
- ', 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
- *
- * Determined by which modules implement the list_questions() hook
- *
- * @return
- * Array of question types
- */
-function _quiz_get_question_types() {
- return module_implements('list_questions');
-}
-
-/**
- * Retrieve list of vocabularies for all quiz question types
- *
- * @return
- * An array containing vocabulary list
- */
-function _quiz_get_vocabularies() {
- $vocabularies = array();
- foreach (_quiz_get_question_types() as $type) {
- foreach (taxonomy_get_vocabularies($type) as $vid => $vocabulary) {
- $vocabularies[$vid] = $vocabulary;
- }
- }
- return $vocabularies;
-}
-
-/**
- * Prints a taxonomy selection form for each vocabulary
- *
- * @param $value
- * Default selected value(s)
- * @return
- * HTML output to print to screen
- */
-function _quiz_taxonomy_select($value = 0) {
- $form = array();
- foreach (_quiz_get_vocabularies() as $vid => $vocabulary) {
- $form['taxonomy'][$vid] = taxonomy_form($vid, $value);
- }
- 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;
-}
-
-
-/**
- * Handles "add question" tab
+ * Handles "add question" tab.
*
* Displays form which allows questions to be filtered by taxonomy vocabulary,
- * and assigned to the given quiz
+ * and assigned to the given quiz.
*
- * @return
- * HTML output to create page
+ * @return $form
*/
-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();
- }
-
+function quiz_manage_questions_form($assigned, $unassigned, $terms) {
$quiz = node_load(arg(1));
- // Set page title
+ // 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);
+ // Grab current question status, if any.
+ $questions = quiz_filter_question_list($terms, $assigned, $unassigned, $quiz->nid);
$result = db_query('SELECT question_nid, question_status FROM {quiz_questions} WHERE quiz_nid = %d', $quiz->nid);
while ($assigned_question = db_fetch_object($result)) {
@@ -1146,90 +819,82 @@ function quiz_questions_form() {
$the_question->status = $assigned_question->question_status;
}
}
-
- // Display filtered question list
+ // Display filtered question list.
$form['filtered_question_list'] = array(
'#type' => 'fieldset',
- '#title' => t('The following questions were found'),
- '#theme' => 'quiz_filtered_questions',
+ '#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
);
$form['filtered_question_list']['question_status']['#tree'] = TRUE;
+ $status_descriptions = array(t('Random'), t('Always'), t('Never'));
+
+ $nodes = $assigned_questions = array();
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,
- );
+ $nodes[$question->nid] = '';
+ if ($question->status != 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_status'][$question->nid] = array('#value' => $status_descriptions[$question->status]);
}
+ $form['filtered_question_list']['nodes'] = array('#type' => 'checkboxes', '#options' => $nodes);
- // Get questions assigned to this quiz
- $questions = _quiz_get_questions();
+ // Store assigned status to avoid additional DB calls during form_submit.
+ $form['assigned_questions'] = array('#type' => 'value', '#value' => $assigned_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),
+ $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' => '',
);
- // 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(
+ $form['controls']['submit'] = array(
'#type' => 'submit',
- '#value' => t('Submit questions'),
+ '#value' => t('Update'),
+ '#suffix' => '
'
);
+
return $form;
}
-function quiz_questions() {
- return drupal_get_form('quiz_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.'));
+ }
}
-
/**
- * Submit function for quiz_questions
- *
- * Updates from the "add questions" tab
- *
+ * Submit function for quiz_questions.
+ *
+ * Updates from the "add questions" tab.
+ *
* @param $form_id
- * A string containing the form id
+ * A string containing the form id.
* @param $values
- * Array containing the form values
+ * Array containing the form values.
*/
-function quiz_questions_form_submit($form_id, $values) {
- // load the node
+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
- 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;
- }
+ // Update quiz with selected question options.
+ quiz_update_questions($quiz, $questions, $operation[1], $form_values['assigned_questions']);
- // Determine how many more questions are required
+ // 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);
@@ -1240,226 +905,489 @@ function quiz_questions_form_submit($for
$anum_always++;
}
- // If there are not enough questions, lower the number of questions and let the user know.
+ // 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);
}
- // If there are too many questions set to "always", increase the number of questions and let the user know.
+ // 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);
}
- // Otherwise just give general feedback.
+ // Otherwise, just give general feedback.
else {
drupal_set_message(t('Questions updated successfully.'));
}
}
/**
- * Gets the number questions of a given type for a quiz
- *
- * @param $nid
- * node id of the quiz
- * @param $type
- * status constant
+ * Return a quiz module variable.
+ *
+ * @param $name
+ * The name of the variable to retrieve.
* @return
- * Number of questions that meet the criteria
+ * The value of the variable requested.
*/
-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_variable_get($name) {
+ static $variables = array();
+ if (empty($variables)) {
+ $defaults = array(
+ 'name' => 'Quiz',
+ 'expire' => 30,
+ 'pass_mark' => 80,
+ 'access_pass_settings' => 1,
+ 'manage_pager' => 5
+ );
+ $variables = variable_get('quiz', array());
+ $variables = array_merge($defaults, $variables);
+ }
+
+ return $variables[$name];
+}
/**
- * Filters question list by given terms.
+ * Finds out the number of questions for the quiz. Good example of usage could
+ * be to calculate the % of score.
*
- * @param $terms
- * An array of vocabulary term IDs
- * @return
- * Array of questions which match terms
+ * @param $nid
+ * Quiz ID.
+ * @return integer
+ * Returns the number of quiz questions.
*/
-function quiz_filter_question_list($terms = NULL) {
+function quiz_get_number_of_questions($nid) {
+ return db_result(db_query('SELECT number_of_questions FROM {quiz} WHERE nid = %d', $nid));
+}
- // 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 ";
- }
- $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";
- }
+/**
+ * @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));
+}
- $result = db_query($sql);
-
- // Create questions array
- $questions = array();
- while ($node = db_fetch_object($result)) {
- $questions[$node->nid] = quiz_node_map($node);
+/**
+ * Displays all the quizzes 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 = %d
+ ORDER BY qr.rid ASC", $user->uid
+ );
+ // Create results array.
+ while ($line = db_fetch_array($dbresult)) {
+ $results[$line['rid']] = $line;
}
- return $questions;
+ return theme('quiz_get_user_results', $results);
}
/**
- * Map node properties to a question object
+ * Get the summary message for a completed quiz.
*
- * @param $node
- * Node
+ * 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.
+ * @param $score
+ * The score information as returned by quiz_calculate_score().
* @return
- * Question object
+ * Filtered summary text or null if we are not displaying any summary.
*/
-function quiz_node_map($node) {
- $new_question = new stdClass();
- $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;
- return $new_question;
+function _quiz_get_summary_text($quiz, $score) {
+ // 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 (arg(3) == 'view') {
+ $summary = t('The user passed this quiz.');
+ }
+ else {
+ $summary = check_markup($quiz->summary_pass, $quiz->format);
+ }
+ }
+ // 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 (arg(3) == 'view') {
+ if ($node->pass_rate > 0) {
+ $summary = t('The user failed this quiz.');
+ }
+ }
+ else {
+ $summary = check_markup($quiz->summary_default, $quiz->format);
+ }
+ }
+
+ return $summary;
}
/**
- * Updates questions assigned to the quiz
+ * Actions to take place at the start of a quiz.
*
- * @param $questions
- * Array of questions and their status
- * @return
- * True if update was a success, false if three was a problem
+ * @param $uid
+ * User ID.
+ * @param $nid
+ * Quiz node ID.
+ * @return integer
+ * Returns quiz_result rid, or false if there is an error.
*/
-function quiz_update_questions($questions) {
- $quiz = node_load(arg(1));
- $return = true;
+function quiz_start_actions($uid, $nid) {
+ // Get the quiz node.
+ $quiz = node_load($nid);
- 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;
- }
+ // 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;
}
- 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;
- }
- }
+ }
+ }
+
+ // Get the results.
+ 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;
+ }
+ }
+ }
+
+ // 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 {
- $return = false;
+ drupal_set_message(t('There was a problem starting the @quiz. Please try again later.', array('@quiz' => QUIZ_NAME), 'error'));
+ return FALSE;
+ }
+}
+
+/**
+ * Calculates the score user received on quiz.
+ *
+ * @param $rid
+ * Quiz result ID.
+ * @return array
+ * 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
+ );
+ 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.
+ }
+
+ // Calculate the percentage score.
+ if ($question_count > 0) {
+ $percentage_score = round(($num_correct * 100) / $question_count);
+ }
+
+ // Build the score array.
+ $score = array(
+ 'question_count' => $question_count,
+ 'num_correct' => $num_correct,
+ 'percentage_score' => $percentage_score,
+ );
+
+ // Return the array.
+ return $score;
+}
+
+/**
+ * Retrieves a question list for a given quiz.
+ *
+ * @param $nid
+ * Quiz node ID.
+ * @return
+ * 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);
+ 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);
+ while ($question_node = db_fetch_object($result)) {
+ $questions[] = $question_node->question_nid;
}
- return $return;
+ // Shuffle questions if required.
+ if ($quiz->shuffle == 1) {
+ shuffle($questions);
+ }
+ return $questions;
}
+/**
+ * Retrieve list of question types.
+ *
+ * Determined by which modules implement the list_questions() hook.
+ *
+ * @return
+ * Array of question types.
+ */
+function _quiz_get_question_types() {
+ return module_implements('list_questions');
+}
/**
- * Implementation of hook_settings()
+ * Retrieve list of vocabularies for all quiz question types.
+ *
+ * @return
+ * An array containing vocabulary list.
*/
-function quiz_admin_settings() {
+function _quiz_get_vocabularies() {
+ $vocabularies = array();
+ foreach (_quiz_get_question_types() as $type) {
+ foreach (taxonomy_get_vocabularies($type) as $vid => $vocabulary) {
+ $vocabularies[$vid] = $vocabulary;
+ }
+ }
+ return $vocabularies;
+}
+
+/**
+ * Prints a taxonomy selection form for each vocabulary.
+ *
+ * @param $terms
+ * Taxonomy terms in a space separated string.
+ * @return
+ * Form array.
+ */
+function _quiz_taxonomy_select($terms = array()) {
$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);
+
+ foreach (_quiz_get_vocabularies() as $vid => $vocabulary) {
+ $form[$vid] = taxonomy_form($vid, $terms);
+ }
+
+ return $form;
}
/**
- * Validation form settings 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.title, 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;
+}
+
+/**
+ * Gets the number questions of a given type for a quiz.
+ *
+ * @param $nid
+ * Node id of the quiz.
+ * @param $type
+ * Status constant.
+ * @return
+ * 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));
+}
+
+/**
+ * Filters question list by given terms.
+ *
+ * @param $terms
+ * 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.
*/
-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%.'));
+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 FROM {node} n";
+ $joins[] = "INNER JOIN {node_revisions} nr USING (nid)";
+ // Select published question nodes only.
+ $wheres[] = "n.status = 1";
+ $wheres[] = "n.type IN ('". implode("','", _quiz_get_question_types()) ."')";
+
+ $args = array();
+
+ if (count($terms) > 0) {
+ $joins[] = "INNER JOIN {term_node} t USING (nid)";
+ $wheres[] .= "t.tid IN (". implode(', ', $terms) .")";
+ }
+ if ($assigned && !$unassigned) {
+ $joins[] = "INNER JOIN {quiz_questions} qq ON (n.nid = qq.question_nid)";
+ $wheres[] = "qq.quiz_nid = %d";
+ $args[] = $quiz_nid;
}
- 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%.'));
+ 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[] = "(n.nid != qq.question_nid OR qq.question_nid IS NULL)";
+ $args[] = $quiz_nid;
+ }
+
+ $joins = implode(' ', $joins);
+ $wheres = implode(' AND ', $wheres);
+
+ $result = pager_query("$sql $joins WHERE $wheres ORDER BY n.title ASC", quiz_variable_get('manage_pager'), 0, NULL, $args);
+
+ // Create questions array.
+ $questions = array();
+ while ($node = db_fetch_object($result)) {
+ $questions[$node->nid] = quiz_node_map($node);
}
+
+ return $questions;
}
/**
- * Quiz Admin
- *
+ * Map node properties to a question object.
+ *
+ * @param $node
+ * Node.
+ * @return
+ * Question object.
*/
-function quiz_admin() {
- $results = _quiz_get_results();
- return theme('quiz_admin', $results);
+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;
+
+ return $new_question;
}
+/**
+ * Updates questions assigned to the quiz.
+ *
+ * @param $questions
+ * Array of questions and their status.
+ */
+function quiz_update_questions($quiz, $questions, $status, $assigned_questions) {
+ foreach ($questions as $question_nid) {
+ dpr($status);
+ if ($status == QUESTION_NEVER) {
+ $result = db_queryd("DELETE FROM {quiz_questions} WHERE quiz_nid = %d AND question_nid = %d", $quiz->nid, $question_nid);
+ }
+ else {
+ if (isset($assigned_questions[$question_nid])) {
+ $result = db_queryd("UPDATE {quiz_questions} SET question_status = %d WHERE quiz_nid = %d AND question_nid = %d", $status, $quiz->nid, $question_nid);
+ }
+ else {
+ $result = db_queryd("INSERT INTO {quiz_questions} (quiz_nid, question_nid, question_status) VALUES (%d, %d, %d)", $quiz->nid, $question_nid, $status);
+ }
+ }
+ }
+}
-/*
- * Get a full results list
+/**
+ * Get a full results list.
*/
function _quiz_get_results($nid = '', $uid = 0) {
$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 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
+ ";
if ($nid) {
$sql .= " AND qr.quiz_nid = %d";
$args[] = $nid;
@@ -1470,121 +1398,37 @@ function _quiz_get_results($nid = '', $u
}
$sql .= " ORDER BY qr.rid ASC";
$dbresult = db_query($sql, $args);
- //Create results array
+ // 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);
- }
- else {
- drupal_not_found();
- }
-}
-
-/*
- * 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();
- }
-}
-
-
-/*
- * 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";
-}
-
-
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, {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.
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
- *
- * @return
- * quiz name variable
- **/
-function _quiz_get_quiz_name() {
- return variable_get('quiz_name', 'Quiz');
-}
-
-
/////////////////////////////////////////////////
/// Theme functions
/////////////////////////////////////////////////
/**
- * Theme the admin results table
- *
+ * Theme the admin results table.
+ *
* @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)) {
@@ -1597,7 +1441,7 @@ function theme_quiz_admin($results) {
($result['time_end'] > 0) ? format_date($result['time_end'], 'small') : t('In Progress'),
);
}
-
+
$header = array(
t('Action'),
t('@quiz Title', array('@quiz' => QUIZ_NAME)),
@@ -1605,27 +1449,28 @@ function theme_quiz_admin($results) {
t('Result
ID'),
t('Time Started'),
t('Finished?'));
-
+
if (!empty($rows)) {
- $output .= theme('table', $header, $rows);
+ $output = theme('table', $header, $rows);
}
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)) {
$rows[] = array(
l('view', 'user/quiz/'. $result['rid'] .'/userresults'),
@@ -1636,7 +1481,7 @@ function theme_quiz_get_user_results($re
($result['time_end'] > 0) ? format_date($result['time_end'], 'small') : t('In Progress'),
);
}
-
+
$header = array(
t('Action'),
t('@quiz Title', array('@quiz' => QUIZ_NAME)),
@@ -1644,87 +1489,58 @@ function theme_quiz_get_user_results($re
t('Result
ID'),
t('Time Started'),
t('Finished?'));
-
+
if (!empty($rows)) {
- $output .= theme('table', $header, $rows);
+ $output = theme('table', $header, $rows);
}
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'])) {
+ $table_form = $form['filtered_question_list'];
+ while (list($nid, $values) = each($table_form['question_status'])) {
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($table_form['nodes'][$nid]),
+ drupal_render($table_form['question'][$nid]),
+ drupal_render($table_form['type'][$nid]),
+ drupal_render($table_form['question_status'][$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('manage_pager'), 0);
}
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
- *
+ * 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
+ * Pass the incorrect mark to the theme so that theme authors can use an image.
*
* TODO: A default image might be better here.
*/
@@ -1732,186 +1548,169 @@ 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
- *
+ * Theme a progress indicator for use during a quiz.
+ *
* @param $question_number
- * The position of the current question in the sessions' array
+ * 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 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) {
-
// 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 .= '';
+
+ // Return HTML.
+ $output = '
';
$output .= t('Question %x of %y', array('%x' => $current_question, '%y' => $num_of_question));
- $output .= '
'."\n";
- return $output;
+ $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
+ //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));
+ // 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);
+ // Return the elements of the page.
+ $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";
+ // Display overall result.
+ $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 .= ''. $summary .'
';
+
+ // Get the feedback for all questions.
$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";
+ // Display overall result.
+ $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
+
+ // 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";
+ // Display overall result.
+ $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
+
+ // 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
+ * Array of quiz objects as returned by _quiz_get_answers.
* @param showpoints
- * Binary flag for whether to show the actual answers
+ * Binary flag for whether to show the actual answers.
* @param $showfeedback
- * binary flag for whether to show question feedback
+ * Binary flag for whether to show question feedback.
* @return
- * Themed html
+ * Themed HTML.
*/
function theme_quiz_feedback($questions, $showpoints = TRUE, $showfeedback = FALSE) {
$rows = array();
$header = array(t('Question Result(s)'), '');
- // go through each of the questions
+ // 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
+
+ // 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)
+
+ // Build the question answers header (add blank space for IE).
$innerheader = array(t('Answers'));
if ($showpoints) {
$innerheader[] = t('Correct Answer');
@@ -1921,7 +1720,7 @@ function theme_quiz_feedback($questions,
$innerheader[] = ' ';
}
- // Add the cell with the question and the answers
+ // 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');
@@ -1931,21 +1730,136 @@ function theme_quiz_feedback($questions,
$cols[] = array('data' => theme('quiz_score_correct'), 'class' => 'quiz_summary_qcell');
}
else {
- $cols[] = array('data' => theme('quiz_score_incorrect'), 'class' => 'quiz_summary_qcell');
+ $cols[] = array('data' => theme('quiz_score_incorrect'), 'class' => 'quiz_summary_qcell');
}
- // pack all of this into this row
+ // Pack all of this into this row.
$rows[] = array('data' => $cols, 'class' => 'quiz_summary_qrow');
}
+
return theme('table', $header, $rows);
}
-
/**
- * Allow the option to theme the questions form
+ * Allow the option to theme the questions form.
*/
function theme_quiz_questions($form) {
- $output = '';
- $output .= drupal_render($form);
+ return drupal_render($form);
+}
+
+/**
+ * Themes a message about the quiz's availability for quiz takers.
+ */
+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.');
+ }
+ }
+ $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')
+ );
+ $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";
+ }
+
+ // 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 .= '
';
+ }
+ $output .= ''. t('Default summary text:') .' ';
+ $output .= ($node->summary_default) ? check_markup($node->summary_default) : t('No text defined.');
+ $output .= '
';
+ }
+
+ // 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;
}