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);

    }

}