quiz_question.pages.inc in Quiz 7.6

User page callbacks for the quiz_question module.

File

question_types/quiz_question/quiz_question.pages.inc

<?php

/**
 * @file
 * User page callbacks for the quiz_question module.
 */

/**
 * Create the form for the revision actions page
 *
 * Form for deciding what to do with the quizzes a question is member of when the question is
 * revised
 *
 * @param $form_state
 * @param $nid
 *  Question node id
 * @param $vid
 *  Question node version id
 * @return
 *  FAPI form array
 */
function quiz_question_revision_actions_form($form, $form_state, $nid) {
  $efq = new EntityFieldQuery();
  $result = $efq
    ->entityCondition('entity_type', 'quiz_question_relationship')
    ->propertyCondition('child_nid', $nid)
    ->execute();
  $relationships = entity_load('quiz_question_relationship', array_keys($result['quiz_question_relationship']));
  $text = t('You have created a new revision of a question that belongs to %num quizzes. Choose what you want to do with the different quizzes.', array(
    '%num' => count($relationships),
  ));
  $form['intro'] = array(
    '#markup' => $text,
  );
  $form['quizzes'] = array();

  // Create a form element for each quiz
  foreach ($relationships as $relationship) {
    $quiz = node_load($relationship->parent_nid);
    $answered = quiz_has_been_answered($quiz);
    $form['quizzes']['#tree'] = TRUE;
    $form['quizzes'][$quiz->nid]['revise'] = array(
      '#type' => 'radios',
      '#title' => check_plain($quiz->title) . ' - ' . ($answered ? t('answered') : t('unanswered')) . ', ' . ($quiz->status ? t('published') : t('unpublished')),
      '#options' => array(
        'update' => t('Update'),
        'revise' => t('Create new revision'),
        'nothing' => t('Do nothing'),
      ),
      '#default_value' => $answered ? 'revise' : 'update',
    );
    $form['quizzes'][$quiz->nid]['status'] = array(
      '#type' => 'checkbox',
      '#title' => $quiz->status ? t('Leave published') : t('Publish'),
      '#default_value' => $quiz->status,
    );
  }
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Submit'),
  );

  // Help texts
  $form['update_expl'] = array(
    '#type' => 'item',
    '#title' => t('Update'),
    '#description' => t('Replace the old revision of the question with the new revision. This may affect reporting. It is the default when the most recent Quiz revision has not been answered.'),
  );
  $form['revise_expl'] = array(
    '#type' => 'item',
    '#title' => t('Create new revision'),
    '#description' => t('If the current revision of a Quiz has been answered, you should make a new revision to ensure that existing answer statistics and reports remain correct.') . '<br/>' . t('If the new revision of the question only corrects spelling errors, you do not need to create a new revision of the Quiz.'),
  );
  $form['nothing_expl'] = array(
    '#type' => 'item',
    '#title' => t('Do nothing'),
    '#description' => t('The quiz will not be revised, and will still use the old revision of the question.'),
  );
  return $form;
}

/**
 * Submit callback for the revision actions page
 */
function quiz_question_revision_actions_form_submit($form, &$form_state) {
  foreach ($form_state['values']['quizzes'] as $nid => $actions) {

    // Get the current version of the questions.
    $quiz_node = node_load($nid);
    $question_node = node_load(arg(1));
    $efq = new EntityFieldQuery();
    $results = $efq
      ->entityCondition('entity_type', 'quiz_question_relationship')
      ->propertyCondition('parent_nid', $quiz_node->nid)
      ->propertyCondition('parent_vid', $quiz_node->vid)
      ->execute();
    $questions = entity_load('quiz_question_relationship', array_keys($results['quiz_question_relationship']));
    foreach ($questions as $question) {
      if ($question->child_nid == $question_node->nid) {

        // We found the existing question.
        $question->child_vid = $question_node->vid;
      }
    }
    if ($actions['revise'] == 'revise') {
      quiz_set_questions($quiz_node, $questions, TRUE);
    }
    if ($actions['revise'] == 'update') {
      quiz_set_questions($quiz_node, $questions, FALSE);
    }
  }
}

Functions

Name	Description
quiz_question_revision_actions_form	Create the form for the revision actions page
quiz_question_revision_actions_form_submit	Submit callback for the revision actions page