Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Contains class mod_h5pactivity\output\result
 *
 * @package   mod_h5pactivity
 * @copyright 2020 Ferran Recio
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace mod_h5pactivity\output;

defined('MOODLE_INTERNAL') || die();

use renderable;
use templatable;
use renderer_base;
use stdClass;

/**
 * Class to display an attempt tesult in mod_h5pactivity.
 *
 * @copyright 2020 Ferran Recio
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class result implements renderable, templatable {

    /** Correct answer state. */
    const CORRECT = 1;

    /** Incorrect answer state. */
    const INCORRECT = 2;

    /** Checked answer state. */
    const CHECKED = 3;

    /** Unchecked answer state. */
    const UNCHECKED = 4;

    /** Pass answer state. */
    const PASS = 5;

    /** Pass answer state. */
    const FAIL = 6;

< /** Unkown answer state. */
> /** Unknown answer state. */
const UNKNOWN = 7; /** Text answer state. */ const TEXT = 8; /** @var stdClass result record */ protected $result; /** @var mixed additional decoded data */ protected $additionals; /** @var mixed response decoded data */ protected $response; /** @var mixed correctpattern decoded data */ protected $correctpattern = []; /** * Constructor. * * @param stdClass $result a h5pactivity_attempts_results record */ protected function __construct(stdClass $result) { $this->result = $result; if (empty($result->additionals)) { $this->additionals = new stdClass(); } else { $this->additionals = json_decode($result->additionals); } $this->response = $this->decode_response($result->response); if (!empty($result->correctpattern)) { $correctpattern = json_decode($result->correctpattern); foreach ($correctpattern as $pattern) { $this->correctpattern[] = $this->decode_response($pattern); } } } /** * return the correct result output depending on the interactiontype * * @param stdClass $result h5pactivity_attempts_results record * @return result|null the result output class if any */ public static function create_from_record(stdClass $result): ?self { // Compound result track is omitted from the report. if ($result->interactiontype == 'compound') { return null; } $classname = "mod_h5pactivity\\output\\result\\{$result->interactiontype}"; $classname = str_replace('-', '', $classname); if (class_exists($classname)) { return new $classname($result); } return new self($result); } /** * Return a decoded response structure. * * @param string $value the current response structure * @return array an array of reponses */ private function decode_response(string $value): array { // If [,] means a list of elements. $list = explode('[,]', $value); // Inside a list element [.] means sublist (pair) and [:] a range. foreach ($list as $key => $item) { if (strpos($item, '[.]') !== false) { $list[$key] = explode('[.]', $item); } else if (strpos($item, '[:]') !== false) { $list[$key] = explode('[:]', $item); } } return $list; } /** * Export this data so it can be used as the context for a mustache template. * * @param renderer_base $output * @return stdClass */ public function export_for_template(renderer_base $output): stdClass { $result = $this->result; $data = (object)[ 'id' => $result->id, 'attemptid' => $result->attemptid, 'subcontent' => $result->subcontent, 'timecreated' => $result->timecreated, 'interactiontype' => $result->interactiontype, 'description' => strip_tags($result->description), 'rawscore' => $result->rawscore, 'maxscore' => $result->maxscore, 'duration' => $result->duration, 'completion' => $result->completion, 'success' => $result->success, ]; $result; $options = $this->export_options(); if (!empty($options)) { $data->hasoptions = true; $data->optionslabel = $this->get_optionslabel(); $data->correctlabel = $this->get_correctlabel(); $data->answerlabel = $this->get_answerlabel(); $data->options = array_values($options); $data->track = true; } if (!empty($result->maxscore)) { $data->score = get_string('score_out_of', 'mod_h5pactivity', $result); } return $data; } /** * Return the options data structure. * * Result types have to override this method generate a specific options report. * * An option is an object with: * - id: the option ID * - description: option description text * - useranswer (optional): what the user answer (see get_answer method) * - correctanswer (optional): the correct answer (see get_answer method) * * @return array of options */ protected function export_options(): ?array { return []; } /** * Return a label for result user options/choices. * * Specific result types can override this method to customize * the result options table header. * * @return string to use in options table */ protected function get_optionslabel(): string { return get_string('choice', 'mod_h5pactivity'); } /** * Return a label for result user correct answer. * * Specific result types can override this method to customize * the result options table header. * * @return string to use in options table */ protected function get_correctlabel(): string { return get_string('correct_answer', 'mod_h5pactivity'); } /** * Return a label for result user attempt answer. * * Specific result types can override this method to customize * the result options table header. * * @return string to use in options table */ protected function get_answerlabel(): string { return get_string('attempt_answer', 'mod_h5pactivity'); } /** * Extract descriptions from array. * * @param array $data additional attribute to parse * @return string[] the resulting strings */ protected function get_descriptions(array $data): array { $result = []; foreach ($data as $key => $value) { $description = $this->get_description($value); $index = $value->id ?? $key; $index = trim($index); if (is_numeric($index)) { $index = intval($index); } $result[$index] = (object)['description' => $description, 'id' => $index]; } ksort($result); return $result; } /** * Extract description from data element. * * @param stdClass $data additional attribute to parse * @return string the resulting string */ protected function get_description(stdClass $data): string { if (!isset($data->description)) { return ''; } $translations = (array) $data->description; if (empty($translations)) { return ''; } // By default, H5P packages only send "en-US" descriptions. $result = $translations['en-US'] ?? array_shift($translations); return trim($result); } /** * Return an answer data to show results. * * @param int $state the answer state * @param string $answer the extra text to display (default null) * @return stdClass with "answer" text and the state attribute to be displayed */ protected function get_answer(int $state, string $answer = null): stdClass { $states = [ self::CORRECT => 'correct', self::INCORRECT => 'incorrect', self::CHECKED => 'checked', self::UNCHECKED => 'unchecked', self::PASS => 'pass', self::FAIL => 'fail',
< self::UNKNOWN => 'unkown',
> self::UNKNOWN => 'unknown',
self::TEXT => 'text', ]; $state = $states[$state] ?? self::UNKNOWN; if ($answer === null) { $answer = get_string('answer_'.$state, 'mod_h5pactivity'); } $result = (object)[ 'answer' => $answer, $state => true, ]; return $result; } }