assessment_question.admin.inc

<?php

/**
 * Administration pages for the assessment question questions module.
 * @file
 */

/**
 * Generate a view of all unscored answer questions.
 *
 * @see theme_assessment_question_view_unscored()
 */
function assessment_question_view_unscored() {
  $unscored = AssessmentResponse::fetchAllUnscoredAnswers();
  return theme('assessment_question_view_unscored', array('unscored' => $unscored));
}

/**
 * Page handler for displaying a scoring form.
 * This function is called directly from the menu router. It generates a form for
 * scoring a quiz.
 *
 * @param $vid
 *  The VID of the question and answer to load.
 * @param $rid
 *  The result ID of the answer to load.
 * @return
 *  Text to display.
 */
function assessment_question_edit_score($vid, $rid) {

  // We have to do the vid -> nid lookup ourselves because node_load uses only node.vid,
  // and we need to be able to access old nodes in node_revision.vid.
  $nid = db_query('SELECT nid FROM {node_revision} WHERE vid = :vid', array(':vid' => $vid))->fetchField();
  if (!$nid) {
    drupal_not_found();
    return;
  }

  $node = node_load($nid, $vid);
  if (!$node || $node->type != 'assessment_question') {
    drupal_not_found();
    return;
  }

  $answer = (object) assessment_question_get_answer($node->nid, $node->vid, $rid);
  if (!$answer) {
    drupal_not_found();
    return;
  }
  if ($node->max_score > 0) {
    $answer->rel_score = round($answer->score * $answer->rel_max_score / $node->max_score);
  }
  else {
    $answer->rel_score = 0;
  }
  drupal_set_title(t('Score answer to "@title"', array('@title' => $node->title)), PASS_THROUGH);
  return drupal_get_form('assessment_question_score_form', $node, $answer);
}

/**
 * Build a form for scoring assessment question questions.
 *
 * @param $node
 *  The question node.
 * @param $answer
 *  An object containing an answer to the question. This form is for scoring that answer.
 * @return
 *  The form (as a FAPI array).
 */
function assessment_question_score_form($form, $form_state, $node, $answer) {
  if (!$node || $node->type != 'assessment_question' || !$answer) {
    drupal_not_found();
    return;
  }
  // Set up the form
  $form['question'] = array(
    '#type' => 'item',
    '#title' => t('Question'),
    '#markup' => check_markup($node->body['und'][0]['value'], $node->body['und'][0]['format']),
  );
  $form['rubric'] = array(
    '#type' => 'item',
    '#title' => t('Rubric'),
    '#markup' => check_markup($node->rubric),
  );
  $form['show_max_score'] = array(
    '#type' => 'item',
    '#title' => t('Maximum Score'),
    '#markup' => (int) $answer->rel_max_score,
  );
  $form['score_answer'] = array(
    '#type' => 'fieldset',
    '#title' => t('Score answer'),
  );
  $form['score_answer']['answer'] = array(
    '#type' => 'item',
    '#title' => t('Answer'),
    '#markup' => check_markup($answer->answer),
  );
  $form['score_answer']['score'] = array(
    '#type' => 'textfield',
    '#title' => t('Score'),
    '#description' => t('The score for this essay, between 0 and @max', array('@max' => $answer->rel_max_score)),
    '#size' => 3,
    '#maxlength' => 3,
    '#default_value' => (int) $answer->rel_score,
    '#required' => TRUE,
  );
  $form['score_answer']['answer_feedback'] = array(
    '#title' => t('Feedback'),
    '#type' => 'text_format',
    '#description' => t('The text entered here would be shown to attendees'),
    '#default_value' => $answer->answer_feedback,
    '#format' => isset($answer->answer_feedback_format) ? $answer->answer_feedback_format : NULL
  );

  $form['score_answer']['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save this score'),
  );

  // Save some work by keeping these.
  $form['max_score'] = array(
    '#type' => 'value',
    '#value' => $node->max_score,
  );
  $form['rel_max_score'] = array(
    '#type' => 'value',
    '#value' => $answer->rel_max_score,
  );
  $form['question_nid'] = array(
    '#type' => 'value',
    '#value' => $answer->question_nid,
  );
  $form['question_vid'] = array(
    '#type' => 'value',
    '#value' => $answer->question_vid,
  );
  $form['result_id'] = array(
    '#type' => 'value',
    '#value' => $answer->result_id,
  );

  return $form;
}

/**
 * Validates the assessment question score form
 */
function assessment_question_score_form_validate($form, $form_state) {
  // Check to make sure that entered score is not higher than max allowed score.
  $max = (int) $form_state['values']['rel_max_score'];
  $given = $form_state['values']['score'];
  if (!_quiz_is_int($given, 0, $max)) {
    $args = array('@score' => $given, '@max' => $max);
    form_set_error('score', t('The given score (@score) must be an integer between 0 and @max', $args));
  }
}

/**
 * Submit handler for the assessment question score form
 */
function assessment_question_score_form_submit($form, &$form_state) {
  $result = db_query('SELECT nid, vid FROM {quiz_node_results} WHERE result_id = :result_id', array(':result_id' => $form_state['values']['result_id']))->fetch();

  $result = assessment_question_score_an_answer(array(
    'quiz' => node_load($result->nid, $result->vid),
    'nid' => $form_state['values']['question_nid'],
    'vid' => $form_state['values']['question_vid'],
    'rid' => $form_state['values']['result_id'],
    'score' => $form_state['values']['score'],
    'max_score' => $form_state['values']['rel_max_score'],
    'answer_feedback' => $form_state['values']['answer_feedback']
  ));

  if ($result == 1) {
    drupal_set_message(t('The score has been saved.'));
    $form_state['redirect'] = 'admin/quiz/reports/score-assessment question';
  }
  else {
    drupal_set_message(t('Error saving the score. The selected answer was not scored.'), 'error');
  }
}