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/>.

namespace quiz_statistics\task;

use core\dml\sql_join;
use mod_quiz\quiz_attempt;
use quiz_statistics_report;

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

require_once($CFG->dirroot . '/mod/quiz/locallib.php');
require_once($CFG->dirroot . '/mod/quiz/report/statistics/statisticslib.php');
require_once($CFG->dirroot . '/mod/quiz/report/reportlib.php');
require_once($CFG->dirroot . '/mod/quiz/report/statistics/report.php');

/**
 * Re-calculate question statistics.
 *
 * @package    quiz_statistics
 * @copyright  2022 Catalyst IT Australia Pty Ltd
 * @author     Nathan Nguyen <nathannguyen@catalyst-au.net>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class recalculate extends \core\task\adhoc_task {
    /**
     * The time to delay queued runs by, to prevent repeated recalculations.
     */
    const DELAY = HOURSECS;

    /**
     * Create a new instance of the task.
     *
     * This sets the properties so that only one task will be queued at a time for a given quiz.
     *
     * @param int $quizid
     * @return recalculate
     */
    public static function instance(int $quizid): recalculate {
        $task = new self();
        $task->set_component('quiz_statistics');
        $task->set_custom_data((object)[
            'quizid' => $quizid,
        ]);
        return $task;
    }


    public function get_name(): string {
        return get_string('recalculatetask', 'quiz_statistics');
    }

    public function execute(): void {
        global $DB;
        $dateformat = get_string('strftimedatetimeshortaccurate', 'core_langconfig');
        $data = $this->get_custom_data();
        $quiz = $DB->get_record('quiz', ['id' => $data->quizid]);
        if (!$quiz) {
            mtrace('Could not find quiz with ID ' . $data->quizid . '.');
            return;
        }
        $course = $DB->get_record('course', ['id' => $quiz->course]);
        if (!$course) {
            mtrace('Could not find course with ID ' . $quiz->course . '.');
            return;
        }
        $attemptcount = $DB->count_records('quiz_attempts', ['quiz' => $data->quizid, 'state' => quiz_attempt::FINISHED]);
        if ($attemptcount === 0) {
            mtrace('Could not find any finished attempts for course with ID ' . $data->quizid . '.');
            return;
        }

        mtrace("Re-calculating statistics for quiz {$quiz->name} ({$quiz->id}) " .
            "from course {$course->shortname} ({$course->id}) with {$attemptcount} attempts, start time " .
            userdate(time(), $dateformat) . " ...");

        $qubaids = quiz_statistics_qubaids_condition(
            $quiz->id,
            new sql_join(),
            $quiz->grademethod
        );

        $report = new quiz_statistics_report();
        $report->clear_cached_data($qubaids);
        $report->calculate_questions_stats_for_question_bank($quiz->id);
        mtrace('    Calculations completed at ' . userdate(time(), $dateformat) . '.');
    }

    /**
     * Queue an instance of this task to happen after a delay.
     *
     * Multiple events may happen over a short period that require a recalculation. Rather than
     * run the recalculation each time, this will queue a single run of the task for a given quiz,
     * within the delay period.
     *
     * @param int $quizid The quiz to run the recalculation for.
     * @return bool true of the task was queued.
     */
    public static function queue_future_run(int $quizid): bool {
        $task = self::instance($quizid);
        $task->set_next_run_time(time() + self::DELAY);
        return \core\task\manager::queue_adhoc_task($task, true);
    }
}