You are here

Home » API reference » Course 7 » course_quiz.classes.inc

class CourseObjectQuiz in Course 7

Same name and namespace in other branches
  1. 6 modules/course_quiz/course_quiz.classes.inc \CourseObjectQuiz
  2. 7.2 modules/course_quiz/course_quiz.classes.inc \CourseObjectQuiz

Hierarchy

Expanded class hierarchy of CourseObjectQuiz

1 string reference to 'CourseObjectQuiz'
course_quiz_course_handlers in modules/course_quiz/course_quiz.module
Implements hook_course_handlers().

File

modules/course_quiz/course_quiz.classes.inc, line 3

View source 
class CourseObjectQuiz extends CourseObjectNode {

  /**
   * Create the quiz node and set it as this object's instance.
   */
  function create($node = NULL) {
    if (!$node) {
      $node = new stdClass();
    }
    $node->auto_created = TRUE;
    parent::create($node);
  }

  /**
   * The take URL of the quiz is /take.
   */
  function getTakeUrl() {
    if ($this
      ->getOption('quiz_goto') == "view") {
      return url("node/{$this->node->nid}");
    }
    else {
      return url("node/{$this->node->nid}/take");
    }
  }

  /**
   * Marks a user's fulfillment record for this object complete if the user
   * passed the quiz.
   */
  function grade($user, $rid) {
    $nid = (int) $this
      ->getInstanceId();
    $fulfillment = $this
      ->getFulfillment();
    $result_ids = (array) $fulfillment
      ->getOption('quiz_result_ids');
    $result_ids[] = $rid;
    $fulfillment
      ->setOption('instance', $rid);
    $fulfillment
      ->setOption('quiz_result_ids', $result_ids);
    $result = quiz_result_load($rid);
    if ($result && $result->score >= $this
      ->getOption('passing_grade')) {
      $fulfillment
        ->setGrade($result->score)
        ->setComplete()
        ->save();
    }
    else {
      $fulfillment
        ->setGrade($result->score)
        ->save();
    }
  }

  /**
   * Course quiz options.
   */
  public function optionsDefinition() {
    $options = parent::optionsDefinition();
    $options['quiz_goto'] = 'view';
    $options['passing_grade'] = 75;
    return $options;
  }

  /**
   * Add an option only pertinent to quiz?
   */
  public function optionsForm(&$form, &$form_state) {
    parent::optionsForm($form, $form_state);
    $defaults = $this
      ->getOptions();
    $form['quiz_goto'] = array(
      '#type' => 'select',
      '#title' => t('Quiz entry point'),
      '#options' => array(
        'view' => t('View Quiz'),
        'take' => t('Take Quiz'),
      ),
      '#default_value' => $defaults['quiz_goto'],
      '#description' => t('Selecting "Take Quiz" will launch the user directly into taking the quiz, without viewing the quiz body.'),
    );
    $form['grading']['passing_grade'] = array(
      '#title' => t('Passing grade'),
      '#type' => 'textfield',
      '#size' => 4,
      '#default_value' => $defaults['passing_grade'],
      '#description' => t('The user will not be able to proceed past this object unless this grade is met.'),
    );
  }

  /**
   * Let the user know if they have a Quiz without questions.
   */
  public function getWarnings() {
    $warnings = parent::getWarnings();
    if ($this
      ->getInstanceId()) {
      if (!quiz_get_number_of_questions($this->node->vid, $this->node->nid)) {
        if (course_quiz_quiz_version() >= 5) {
          $link = l('add questions', "node/{$this->getInstanceId()}/quiz/questions");
        }
        else {
          $link = l('add questions', "node/{$this->getInstanceId()}/questions");
        }
        $warnings[] = t('This Quiz does not have any questions. Please !link.', array(
          '!link' => $link,
        ));
      }
    }
    return $warnings;
  }
  public function getReports() {
    $reports = parent::getReports();
    $reports['results'] = array(
      'title' => t('Results'),
    );
    if (module_exists('quiz_stats')) {
      $reports['statistics'] = array(
        'title' => t('Statistics'),
      );
    }
    return $reports;
  }
  public function getReport($key) {
    module_load_include('inc', 'quiz', 'quiz.admin');
    switch ($key) {
      case 'results':
        if (course_quiz_quiz_version() >= 5) {
          $out = views_embed_view('quiz_results', 'default', $this->node->nid);
        }
        else {
          $out = drupal_get_form('quiz_results_manage_results_form', $this->node);
        }
        return array(
          'title' => t('Quiz results'),
          'content' => $out,
        );
      case 'statistics':
        module_load_include('inc', 'quiz_stats', 'quiz_stats.admin');
        return array(
          'title' => t('Quiz statistics'),
          'content' => quiz_stats_get_adv_stats($this->node->vid),
        );
    }
    return parent::getReport($key);
  }

  /**
   * Remove all quiz attempts associated with this fulfillment.
   */
  public function unenroll() {
    parent::unenroll();
    $fulfillment = $this
      ->getFulfillment();
    $result_ids = (array) $fulfillment
      ->getOption('quiz_result_ids');
    if (course_quiz_quiz_version() >= 5) {
      entity_delete_multiple('quiz_result', $result_ids);
    }
    else {
      quiz_delete_results($result_ids);
    }
  }
  function getNodeTypes() {
    return array(
      'quiz',
    );
  }
  function isGraded() {
    return TRUE;
  }
  function getCloneAbility() {
    return t('%object can only be partially cloned. It will be created with the same settings, but without the questions.', array(
      '%object' => $this
        ->getTitle(),
    ));
  }

  /**
   * Exception for quiz: we need to set auto_created.
   */
  function thaw($ice) {
    $this->node = $ice->node;
    unset($this->node->nid);
    unset($this->node->vid);
    $this->node->auto_created = TRUE;
    node_save($this->node);
    return $this->node->nid;
  }
  function getOptionsSummary() {
    $summary = parent::getOptionsSummary();
    if ($this
      ->getInstanceId()) {
      if (course_quiz_quiz_version() >= 5) {
        $summary['questions'] = l(t('Edit questions'), "node/{$this->getInstanceId()}/quiz/questions");
      }
      else {
        $summary['questions'] = l(t('Edit questions'), "node/{$this->getInstanceId()}/questions");
      }
    }
    return $summary;
  }

  /**
   * Get the status of this quiz for the requirements list.
   */
  function getStatus() {
    $grade = $this
      ->isGraded() ? t('Your grade: %grade_result%<br/>Pass grade: %passing_grade%', array(
      '%grade_result' => $this
        ->getFulfillment()
        ->getOption('grade_result'),
      '%passing_grade' => $this
        ->getOption('passing_grade'),
    )) : '';
    return $grade;
  }

  /**
   * Course node context handler callback.
   *
   * If this question is part of a quiz in a course, what quizzes do we belong
   * to?
   */
  public static function getNodeInstances($node) {
    $quizzes = array();

    // Finding quizzes this question already belongs to.
    $sql = 'SELECT n.nid, r.parent_vid AS vid, n.title FROM {quiz_node_relationship} r
            JOIN {node} n ON n.nid = r.parent_nid
            WHERE r.child_vid = :child_vid
            ORDER BY r.parent_vid DESC';
    $res = db_query($sql, array(
      ':child_vid' => $node->vid,
    ));
    while ($row = $res
      ->fetch()) {
      $quizzes[] = $row->nid;
    }
    return $quizzes;
  }

}

Members

Namesort descending Modifiers Type Description Overrides
CourseHandler::addOptions final public function Merge an array of options onto the existing options.
CourseHandler::getAccessMessages public function Get an array of access messages.
CourseHandler::getDatabaseFields protected function Return an array of database fields. This determines what fields should be serialized instead of stored.
CourseHandler::getId function
CourseHandler::getOption public function Get an handler option's value.
CourseHandler::optionsMerge private function Merge arrays with replace, not append.
CourseHandler::setAccessMessage public function Set an access message to be displayed along with the course object when it is in the outline. For example, "This activity will open on XYZ" or "Please complete Step 1 to take this activity."
CourseHandler::setOption public function Set an option for this handler.
CourseHandler::setOptions final public function Set this entire handler's options.
CourseObject::$accessMessages protected property
CourseObject::buildContent function Builds a structured array representing the entity's content. Overrides Entity::buildContent
CourseObject::getComponent function Get the object component for this course object.
CourseObject::getComponentName function Get the object component title for this course object.
CourseObject::getCourse function Get the Course that contains this CourseObject.
CourseObject::getCourseNid function Get the course node ID this CourseObject belongs to.
CourseObject::getFulfillment public function Get the user's fulfillment for this course object.
CourseObject::getInstanceId function Get the instance ID. This could be the external component ID, a Node ID...
CourseObject::getMaxOccurences public static function Return the number of occurances that can be in a course at the same time. For example, the design of the Certificate module can only have 1 set of mappings per node. The same goes for Course Credit. We may also want a course object that can only be… 2
CourseObject::getModule function Get the module that provides this course object.
CourseObject::getOptions public function Get options, with session options, except weight, having precedence. Overrides CourseHandler::getOptions
CourseObject::getUrl public function Return the URL to the course object router.
CourseObject::getUser public function
CourseObject::hasPolling public function Specify whether fulfillment uses asynchronous polling. 2
CourseObject::isActive public function
CourseObject::isRequired public function Is this course object required for course completion?
CourseObject::isSkippable public function If this course object is required, can be it skipped?
CourseObject::isTemporary function Checks the temporary status of a course object.
CourseObject::optionFilter private function
CourseObject::overrideNavigation public function Override navigation links. 1
CourseObject::overrideOutlineListItem public function Overrides a course outline list item. 1
CourseObject::poll function Give the course object a chance do asynchronous polling and set completion on demand.
CourseObject::renderOptionsSummary public function Get all course object implementations of getOptionsSummary().
CourseObject::setComponent function Set the object component for this course object.
CourseObject::setCourse public function Set the Course for this CourseObject.
CourseObject::setDelete public function Mark this object for deletion.
CourseObject::setId function Set the internal course object ID.
CourseObject::setModule function Set the module that provides this course object.
CourseObject::setUser public function
CourseObject::take public function 6
CourseObject::takeCourseObject final public function Take a course object.
CourseObject::unEnroll function Remove any records associated with this course object for the user. 2
CourseObject::uri public function Generate URI from course object. Overrides Entity::uri
CourseObjectNode::$node protected property
CourseObjectNode::access function Deny access to objects without content. Overrides CourseObject::access
CourseObjectNode::context public static function Course context handler callback. Overrides CourseObject::context
CourseObjectNode::delete public function Destroy the node instance. Overrides CourseObject::delete
CourseObjectNode::freeze function Freeze data to persist over cloning/exporting. Overrides CourseObject::freeze 3
CourseObjectNode::getEditUrl public function Get the URL to edit this course object, if any. Overrides CourseObject::getEditUrl
CourseObjectNode::getNode function
CourseObjectNode::getTakeType public function Simple node course object behavior is to just redirect to the node. Overrides CourseObject::getTakeType 3
CourseObjectNode::getTitle function Get the object title, or return this object's node's title if the option is set. Overrides CourseObject::getTitle
CourseObjectNode::getViewUrl public function Get the URL to view this course object, if any. Overrides CourseObject::getViewUrl
CourseObjectNode::grant function Grant access to course content before going to it. Overrides CourseObject::grant
CourseObjectNode::hasNodePrivacySupport public function
CourseObjectNode::optionsSubmit public function Save object configs to cache. Overrides CourseObject::optionsSubmit 2
CourseObjectNode::optionsValidate public function Validate the options form. Check the node type. Overrides CourseObject::optionsValidate
CourseObjectNode::revoke function Duration expired (or something) - CourseObject is telling us so. Overrides CourseObject::revoke
CourseObjectNode::save function On object write, set privacy on this node. Overrides CourseObject::save 1
CourseObjectNode::setInstanceId function When setting our instance ID, also set the node. Overrides CourseObject::setInstanceId
CourseObjectNode::setNode public function Set the node and instance ID (node ID) of this CourseObjectNode.
CourseObjectNode::__construct public function Overrides CourseHandler::__construct
CourseObjectQuiz::create function Create the quiz node and set it as this object's instance. Overrides CourseObjectNode::create
CourseObjectQuiz::getCloneAbility function Returns an translated error message if this object has issues with cloning. Overrides CourseObjectNode::getCloneAbility
CourseObjectQuiz::getNodeInstances public static function Course node context handler callback. Overrides CourseObjectNode::getNodeInstances
CourseObjectQuiz::getNodeTypes function Return a list of valid node types. Overrides CourseObjectNode::getNodeTypes
CourseObjectQuiz::getOptionsSummary function Get core options summary. Overrides CourseObjectNode::getOptionsSummary
CourseObjectQuiz::getReport public function Let the course object provide its own reports. Overrides CourseObject::getReport
CourseObjectQuiz::getReports public function Let the course object provide its own reports. Overrides CourseObject::getReports
CourseObjectQuiz::getStatus function Get the status of this quiz for the requirements list. Overrides CourseObject::getStatus
CourseObjectQuiz::getTakeUrl function The take URL of the quiz is /take. Overrides CourseObjectNode::getTakeUrl
CourseObjectQuiz::getWarnings public function Let the user know if they have a Quiz without questions. Overrides CourseObjectNode::getWarnings
CourseObjectQuiz::grade function Marks a user's fulfillment record for this object complete if the user passed the quiz.
CourseObjectQuiz::isGraded function Is this object graded? Overrides CourseObject::isGraded
CourseObjectQuiz::optionsDefinition public function Course quiz options. Overrides CourseObjectNode::optionsDefinition
CourseObjectQuiz::optionsForm public function Add an option only pertinent to quiz? Overrides CourseObjectNode::optionsForm
CourseObjectQuiz::thaw function Exception for quiz: we need to set auto_created. Overrides CourseObjectNode::thaw
CourseObjectQuiz::unenroll public function Remove all quiz attempts associated with this fulfillment.
Entity::$defaultLabel protected property 1
Entity::$entityInfo protected property
Entity::$entityType protected property
Entity::$idKey protected property
Entity::$wrapper protected property
Entity::bundle public function Returns the bundle of the entity. Overrides EntityInterface::bundle
Entity::defaultLabel protected function Defines the entity label if the 'entity_class_label' callback is used. 1
Entity::defaultUri protected function Override this in order to implement a custom default URI and specify 'entity_class_uri' as 'uri callback' hook_entity_info().
Entity::entityInfo public function Returns the info of the type of the entity. Overrides EntityInterface::entityInfo
Entity::entityType public function Returns the type of the entity. Overrides EntityInterface::entityType
Entity::export public function Exports the entity. Overrides EntityInterface::export
Entity::getTranslation public function Gets the raw, translated value of a property or field. Overrides EntityInterface::getTranslation
Entity::hasStatus public function Checks if the entity has a certain exportable status. Overrides EntityInterface::hasStatus
Entity::identifier public function Returns the entity identifier, i.e. the entities name or numeric id. Overrides EntityInterface::identifier
Entity::internalIdentifier public function Returns the internal, numeric identifier. Overrides EntityInterface::internalIdentifier
Entity::isDefaultRevision public function Checks whether the entity is the default revision. Overrides EntityInterface::isDefaultRevision
Entity::label public function Returns the label of the entity. Overrides EntityInterface::label
Entity::setUp protected function Set up the object instance on construction or unserializiation.
Entity::view public function Generate an array for rendering the entity. Overrides EntityInterface::view
Entity::wrapper public function Returns the EntityMetadataWrapper of the entity. Overrides EntityInterface::wrapper
Entity::__sleep public function Magic method to only serialize what's necessary.
Entity::__wakeup public function Magic method to invoke setUp() on unserialization.