Proyectos de Subversion Moodle

<?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\matching
 *
 * @package   mod_h5pactivity
 * @copyright 2020 Ferran Recio
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace mod_h5pactivity\output\result;

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

use mod_h5pactivity\output\result;

/**
 * Class to display H5P matching result.
 *
 * @copyright 2020 Ferran Recio
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class matching extends result {

    /**
     * Return the options data structure.
     *
     * @return array|null of options
     */
    protected function export_options(): ?array {
        // Suppose H5P choices have only list of valid answers.
        $correctpattern = reset($this->correctpattern);

        $additionals = $this->additionals;

        // Get sources (options).
        if (isset($additionals->source)) {
            $sources = $this->get_descriptions($additionals->source);
        } else {
            $sources = [];
        }

        // Get targets.
        if (isset($additionals->target)) {
            $targets = $this->get_descriptions($additionals->target);
        } else {
            $targets = [];
        }
        // Create original options array.
        $options = array_map(function ($source) {
            $cloneddraggable = clone $source;
            $cloneddraggable->correctanswers = [];
            return $cloneddraggable;
        }, $sources);

        // Fill options with correct answers flags if they exist.
        foreach ($correctpattern as $pattern) {
            if (!is_array($pattern) || count($pattern) != 2) {
                continue;
            }
            // We assume here that the activity is following the convention sets in:
            // https://github.com/h5p/h5p-php-report/blob/master/type-processors/matching-processor.class.php
            // i.e. source is index 1 and dropzone is index 0.
            if (isset($sources[$pattern[1]]) && isset($targets[$pattern[0]])) {
                $target = $targets[$pattern[0]];
                $source = $sources[$pattern[1]];
                $currentoption = $options[$source->id];
                $currentoption->correctanswers[$target->id] = $target->description;
            }
        }

        // Fill in user responses.
        foreach ($this->response as $response) {
            if (!is_array($response) || count($response) != 2) {
                continue;
            }
            if (isset($sources[$response[1]]) && isset($targets[$response[0]])) {
                $source = $sources[$response[1]];
                $target = $targets[$response[0]];
                $answer = $response[0];
                $option = $options[$source->id] ?? null;
                if ($option) {
                    if (isset($option->correctanswers[$answer])) {
                        $state = parent::CORRECT;
                    } else {
                        $state = parent::INCORRECT;
                    }
                    $option->useranswer = $this->get_answer($state, $target->description);
                }
            }
        }

        // Fill in unchecked options.
        foreach ($options as $option) {
            if (!isset($option->useranswer)) {
                if (!empty($option->correctanswers)) {
                    $option->useranswer = $this->get_answer(parent::INCORRECT,
                        get_string('answer_noanswer', 'mod_h5pactivity'));
                } else {
                    $option->useranswer = $this->get_answer(parent::CORRECT,
                        get_string('answer_noanswer', 'mod_h5pactivity'));
                }
            }
        }

        // Now flattern correct answers.
        foreach ($options as $option) {
            $option->correctanswer = $this->get_answer( parent::TEXT, join(', ', $option->correctanswers));
            unset($option->correctanswers);
        }
        return array_values($options);
    }

    /**
     * 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('result_matching', 'mod_h5pactivity');
    }
}