Current Path : C:/xampp/htdocs/moodle/course/classes/analytics/target/ |
Current File : C:/xampp/htdocs/moodle/course/classes/analytics/target/no_recent_accesses.php |
<?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/>. /** * No recent accesses. * * @package core_course * @copyright 2019 David Monllaó {@link http://www.davidmonllao.com} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_course\analytics\target; defined('MOODLE_INTERNAL') || die(); /** * No recent accesses. * * @package core_course * @copyright 2019 David Monllaó {@link http://www.davidmonllao.com} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class no_recent_accesses extends course_enrolments { /** * Machine learning backends are not required to predict. * * @return bool */ public static function based_on_assumptions() { return true; } /** * Returns the name. * * If there is a corresponding '_help' string this will be shown as well. * * @return \lang_string */ public static function get_name() : \lang_string { return new \lang_string('target:norecentaccesses', 'course'); } /** * Returns the body message for the insight. * * @param \context $context * @param string $contextname * @param \stdClass $user * @param \moodle_url $insighturl * @return array The plain text message and the HTML message */ public function get_insight_body(\context $context, string $contextname, \stdClass $user, \moodle_url $insighturl): array { global $OUTPUT; $a = (object)['coursename' => $contextname, 'userfirstname' => $user->firstname]; $fullmessage = get_string('norecentaccessesinfomessage', 'course', $a) . PHP_EOL . PHP_EOL . $insighturl->out(false); $fullmessagehtml = $OUTPUT->render_from_template('core_analytics/insight_info_message', ['url' => $insighturl->out(false), 'insightinfomessage' => get_string('norecentaccessesinfomessage', 'course', $a)] ); return [$fullmessage, $fullmessagehtml]; } /** * Only past stuff whose start matches the course start. * * @param \core_analytics\local\time_splitting\base $timesplitting * @return bool */ public function can_use_timesplitting(\core_analytics\local\time_splitting\base $timesplitting): bool { return ($timesplitting instanceof \core_analytics\local\time_splitting\past_periodic); } /** * Discards courses that are not yet ready to be used for prediction. * * @param \core_analytics\analysable $course * @param bool $fortraining * @return true|string */ public function is_valid_analysable(\core_analytics\analysable $course, $fortraining = true) { if (!$course->was_started()) { return get_string('coursenotyetstarted', 'course'); } if (!$this->students = $course->get_students()) { return get_string('nocoursestudents', 'course'); } if ($course->get_end() && $course->get_end() < $course->get_start()) { return get_string('errorendbeforestart', 'course'); } // Finished courses can not be used to get predictions. if (!$fortraining && $course->is_finished()) { return get_string('coursealreadyfinished', 'course'); } return true; } /** * Do the user has any read action in the course? * * @param int $sampleid * @param \core_analytics\analysable $analysable * @param int $starttime * @param int $endtime * @return float|null 0 -> accesses, 1 -> no accesses. */ protected function calculate_sample($sampleid, \core_analytics\analysable $analysable, $starttime = false, $endtime = false) { if (!$this->enrolment_active_during_analysis_time($sampleid, $starttime, $endtime)) { // We should not use this sample as the analysis results could be misleading. return null; } $readactions = $this->retrieve('\core\analytics\indicator\any_course_access', $sampleid); if ($readactions == \core\analytics\indicator\any_course_access::get_min_value()) { return 1; } return 0; } }