Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.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/>.

/**
 * Bulk activity completion manager class
 *
 * @package     core_completion
 * @category    completion
 * @copyright   2017 Adrian Greeve
 * @license     http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace core_completion;

> use core\context;
use stdClass; use context_course; use cm_info; use tabobject; use lang_string; use moodle_url; defined('MOODLE_INTERNAL') || die; /** * Bulk activity completion manager class * * @package core_completion * @category completion * @copyright 2017 Adrian Greeve * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class manager { /** * @var int $courseid the course id. */ protected $courseid; /** * manager constructor. * @param int $courseid the course id. */ public function __construct($courseid) { $this->courseid = $courseid; } /**
> * Returns current course context or system level for $SITE courseid. * Gets the data (context) to be used with the bulkactivitycompletion template. > * * > * @return context The course based on current courseid or system context. * @return stdClass data for use with the bulkactivitycompletion template. > */ */ > protected function get_context(): context { public function get_activities_and_headings() { > global $SITE; global $OUTPUT; > $moduleinfo = get_fast_modinfo($this->courseid); > if ($this->courseid && $this->courseid != $SITE->id) { $sections = $moduleinfo->get_sections(); > return context_course::instance($this->courseid); $data = new stdClass; > } $data->courseid = $this->courseid; > return \context_system::instance(); $data->sesskey = sesskey(); > } $data->helpicon = $OUTPUT->help_icon('bulkcompletiontracking', 'core_completion'); > $data->sections = []; > /**
foreach ($sections as $sectionnumber => $section) { $sectioninfo = $moduleinfo->get_section_info($sectionnumber); $sectionobject = new stdClass(); $sectionobject->sectionnumber = $sectionnumber; $sectionobject->name = get_section_name($this->courseid, $sectioninfo); $sectionobject->activities = $this->get_activities($section, true); $data->sections[] = $sectionobject; } return $data; } /** * Gets the data (context) to be used with the activityinstance template * * @param array $cmids list of course module ids * @param bool $withcompletiondetails include completion details * @return array */ public function get_activities($cmids, $withcompletiondetails = false) { $moduleinfo = get_fast_modinfo($this->courseid); $activities = []; foreach ($cmids as $cmid) { $mod = $moduleinfo->get_cm($cmid); if (!$mod->uservisible) { continue; } $moduleobject = new stdClass(); $moduleobject->cmid = $cmid; $moduleobject->modname = $mod->get_formatted_name(); $moduleobject->icon = $mod->get_icon_url()->out(); $moduleobject->url = $mod->url; $moduleobject->canmanage = $withcompletiondetails && self::can_edit_bulk_completion($this->courseid, $mod); // Get activity completion information. if ($moduleobject->canmanage) { $moduleobject->completionstatus = $this->get_completion_detail($mod); } else { $moduleobject->completionstatus = ['icon' => null, 'string' => null]; } if (self::can_edit_bulk_completion($this->courseid, $mod)) { $activities[] = $moduleobject; } } return $activities; } /** * Get completion information on the selected module or module type * * @param cm_info|stdClass $mod either instance of cm_info (with 'customcompletionrules' in customdata) or * object with fields ->completion, ->completionview, ->completionexpected, ->completionusegrade * and ->customdata['customcompletionrules'] * @return array */ private function get_completion_detail($mod) { global $OUTPUT; $strings = []; switch ($mod->completion) { case COMPLETION_TRACKING_NONE: $strings['string'] = get_string('none'); break; case COMPLETION_TRACKING_MANUAL: $strings['string'] = get_string('manual', 'completion'); $strings['icon'] = $OUTPUT->pix_icon('i/completion-manual-y', get_string('completion_manual', 'completion')); break; case COMPLETION_TRACKING_AUTOMATIC: $strings['string'] = get_string('withconditions', 'completion'); $strings['icon'] = $OUTPUT->pix_icon('i/completion-auto-y', get_string('completion_automatic', 'completion')); break; default: $strings['string'] = get_string('none'); break; } // Get the descriptions for all the active completion rules for the module. if ($ruledescriptions = $this->get_completion_active_rule_descriptions($mod)) { foreach ($ruledescriptions as $ruledescription) { $strings['string'] .= \html_writer::empty_tag('br') . $ruledescription; } } return $strings; } /** * Get the descriptions for all active conditional completion rules for the current module. * * @param cm_info|stdClass $moduledata either instance of cm_info (with 'customcompletionrules' in customdata) or * object with fields ->completion, ->completionview, ->completionexpected, ->completionusegrade * and ->customdata['customcompletionrules'] * @return array $activeruledescriptions an array of strings describing the active completion rules. */ protected function get_completion_active_rule_descriptions($moduledata) { $activeruledescriptions = []; if ($moduledata->completion == COMPLETION_TRACKING_AUTOMATIC) { // Generate the description strings for the core conditional completion rules (if set). if (!empty($moduledata->completionview)) { $activeruledescriptions[] = get_string('completionview_desc', 'completion'); } if ($moduledata instanceof cm_info && !is_null($moduledata->completiongradeitemnumber) || ($moduledata instanceof stdClass && !empty($moduledata->completionusegrade))) { $description = 'completionusegrade_desc'; if (!empty($moduledata->completionpassgrade)) { $description = 'completionpassgrade_desc'; } $activeruledescriptions[] = get_string($description, 'completion'); } // Now, ask the module to provide descriptions for its custom conditional completion rules. if ($customruledescriptions = component_callback($moduledata->modname, 'get_completion_active_rule_descriptions', [$moduledata])) { $activeruledescriptions = array_merge($activeruledescriptions, $customruledescriptions); } } if ($moduledata->completion != COMPLETION_TRACKING_NONE) { if (!empty($moduledata->completionexpected)) { $activeruledescriptions[] = get_string('completionexpecteddesc', 'completion', userdate($moduledata->completionexpected)); } } return $activeruledescriptions; } /** * Gets the course modules for the current course. *
> * @param bool $includedefaults Whether the default values should be included or not.
* @return stdClass $data containing the modules */
< public function get_activities_and_resources() {
> public function get_activities_and_resources(bool $includedefaults = true) {
global $DB, $OUTPUT, $CFG; require_once($CFG->dirroot.'/course/lib.php'); // Get enabled activities and resources. $modules = $DB->get_records('modules', ['visible' => 1], 'name ASC'); $data = new stdClass(); $data->courseid = $this->courseid; $data->sesskey = sesskey(); $data->helpicon = $OUTPUT->help_icon('bulkcompletiontracking', 'core_completion'); // Add icon information. $data->modules = array_values($modules);
< $coursecontext = context_course::instance($this->courseid); < $canmanage = has_capability('moodle/course:manageactivities', $coursecontext);
> $context = $this->get_context(); > $canmanage = has_capability('moodle/course:manageactivities', $context);
$course = get_course($this->courseid); foreach ($data->modules as $module) { $module->icon = $OUTPUT->image_url('monologo', $module->name)->out();
< $module->formattedname = format_string(get_string('modulenameplural', 'mod_' . $module->name), < true, ['context' => $coursecontext]);
> $module->formattedname = format_string(get_string('modulename', 'mod_' . $module->name), > true, ['context' => $context]);
$module->canmanage = $canmanage && course_allowed_module($course, $module->name);
> if ($includedefaults) {
$defaults = self::get_default_completion($course, $module, false); $defaults->modname = $module->name; $module->completionstatus = $this->get_completion_detail($defaults); }
> } > // Order modules by displayed name. return $data; > $modules = (array) $data->modules; } > usort($modules, function($a, $b) { > return strcmp($a->formattedname, $b->formattedname); /** > }); * Checks if current user can edit activity completion > $data->modules = $modules;
* * @param int|stdClass $courseorid * @param \cm_info|null $cm if specified capability for a given coursemodule will be check, * if not specified capability to edit at least one activity is checked. */ public static function can_edit_bulk_completion($courseorid, $cm = null) { if ($cm) { return $cm->uservisible && has_capability('moodle/course:manageactivities', $cm->context); } $coursecontext = context_course::instance(is_object($courseorid) ? $courseorid->id : $courseorid); if (has_capability('moodle/course:manageactivities', $coursecontext)) { return true; } $modinfo = get_fast_modinfo($courseorid); foreach ($modinfo->cms as $mod) { if ($mod->uservisible && has_capability('moodle/course:manageactivities', $mod->context)) { return true; } } return false; } /** * Gets the available completion tabs for the current course and user. * * @deprecated since Moodle 4.0 * @param stdClass|int $courseorid the course object or id. * @return tabobject[] */ public static function get_available_completion_tabs($courseorid) { debugging('get_available_completion_tabs() has been deprecated. Please use ' . 'core_completion\manager::get_available_completion_options() instead.', DEBUG_DEVELOPER); $tabs = []; $courseid = is_object($courseorid) ? $courseorid->id : $courseorid; $coursecontext = context_course::instance($courseid); if (has_capability('moodle/course:update', $coursecontext)) { $tabs[] = new tabobject( 'completion', new moodle_url('/course/completion.php', ['id' => $courseid]), new lang_string('coursecompletion', 'completion') ); } if (has_capability('moodle/course:manageactivities', $coursecontext)) { $tabs[] = new tabobject( 'defaultcompletion', new moodle_url('/course/defaultcompletion.php', ['id' => $courseid]), new lang_string('defaultcompletion', 'completion') ); } if (self::can_edit_bulk_completion($courseorid)) { $tabs[] = new tabobject( 'bulkcompletion', new moodle_url('/course/bulkcompletion.php', ['id' => $courseid]), new lang_string('bulkactivitycompletion', 'completion') ); } return $tabs; } /** * Returns an array with the available completion options (url => name) for the current course and user. * * @param int $courseid The course id. * @return array */ public static function get_available_completion_options(int $courseid): array { $coursecontext = context_course::instance($courseid); $options = []; if (has_capability('moodle/course:update', $coursecontext)) { $completionlink = new moodle_url('/course/completion.php', ['id' => $courseid]);
< $options[$completionlink->out(false)] = get_string('coursecompletion', 'completion');
> $options[$completionlink->out(false)] = get_string('coursecompletionsettings', 'completion');
} if (has_capability('moodle/course:manageactivities', $coursecontext)) { $defaultcompletionlink = new moodle_url('/course/defaultcompletion.php', ['id' => $courseid]); $options[$defaultcompletionlink->out(false)] = get_string('defaultcompletion', 'completion'); } if (self::can_edit_bulk_completion($courseid)) { $bulkcompletionlink = new moodle_url('/course/bulkcompletion.php', ['id' => $courseid]); $options[$bulkcompletionlink->out(false)] = get_string('bulkactivitycompletion', 'completion'); } return $options; } /** * Applies completion from the bulk edit form to all selected modules * * @param stdClass $data data received from the core_completion_bulkedit_form * @param bool $updateinstances if we need to update the instance tables of the module (i.e. 'assign', 'forum', etc.) - * if no module-specific completion rules were added to the form, update of the module table is not needed. */ public function apply_completion($data, $updateinstances) { $updated = false; $needreset = []; $modinfo = get_fast_modinfo($this->courseid); $cmids = $data->cmid; $data = (array)$data; unset($data['id']); // This is a course id, we don't want to confuse it with cmid or instance id. unset($data['cmid']); unset($data['submitbutton']); foreach ($cmids as $cmid) { $cm = $modinfo->get_cm($cmid); if (self::can_edit_bulk_completion($this->courseid, $cm) && $this->apply_completion_cm($cm, $data, $updateinstances)) { $updated = true; if ($cm->completion != COMPLETION_TRACKING_MANUAL || $data['completion'] != COMPLETION_TRACKING_MANUAL) { // If completion was changed we will need to reset it's state. Exception is when completion was and remains as manual. $needreset[] = $cm->id; } } // Update completion calendar events. $completionexpected = ($data['completionexpected']) ? $data['completionexpected'] : null; \core_completion\api::update_completion_date_event($cm->id, $cm->modname, $cm->instance, $completionexpected); } if ($updated) { // Now that modules are fully updated, also update completion data if required. // This will wipe all user completion data and recalculate it. rebuild_course_cache($this->courseid, true); $modinfo = get_fast_modinfo($this->courseid); $completion = new \completion_info($modinfo->get_course()); foreach ($needreset as $cmid) { $completion->reset_all_state($modinfo->get_cm($cmid)); } // And notify the user of the result. \core\notification::add(get_string('activitycompletionupdated', 'core_completion'), \core\notification::SUCCESS); } } /** * Applies new completion rules to one course module * * @param \cm_info $cm * @param array $data * @param bool $updateinstance if we need to update the instance table of the module (i.e. 'assign', 'forum', etc.) - * if no module-specific completion rules were added to the form, update of the module table is not needed. * @return bool if module was updated */ protected function apply_completion_cm(\cm_info $cm, $data, $updateinstance) { global $DB; $defaults = [ 'completion' => COMPLETION_DISABLED, 'completionview' => COMPLETION_VIEW_NOT_REQUIRED, 'completionexpected' => 0, 'completiongradeitemnumber' => null, 'completionpassgrade' => 0 ]; $data += ['completion' => $cm->completion, 'completionexpected' => $cm->completionexpected, 'completionview' => $cm->completionview]; if ($cm->completion == $data['completion'] && $cm->completion == COMPLETION_TRACKING_NONE) { // If old and new completion are both "none" - no changes are needed. return false; } if ($cm->completion == $data['completion'] && $cm->completion == COMPLETION_TRACKING_NONE && $cm->completionexpected == $data['completionexpected']) { // If old and new completion are both "manual" and completion expected date is not changed - no changes are needed. return false; } if (array_key_exists('completionusegrade', $data)) { // Convert the 'use grade' checkbox into a grade-item number: 0 if checked, null if not. $data['completiongradeitemnumber'] = !empty($data['completionusegrade']) ? 0 : null; unset($data['completionusegrade']); } else { // Completion grade item number is classified in mod_edit forms as 'use grade'. $data['completionusegrade'] = is_null($cm->completiongradeitemnumber) ? 0 : 1; $data['completiongradeitemnumber'] = $cm->completiongradeitemnumber; } // Update module instance table. if ($updateinstance) { $moddata = ['id' => $cm->instance, 'timemodified' => time()] + array_diff_key($data, $defaults); $DB->update_record($cm->modname, $moddata); } // Update course modules table. $cmdata = ['id' => $cm->id, 'timemodified' => time()] + array_intersect_key($data, $defaults); $DB->update_record('course_modules', $cmdata); \core\event\course_module_updated::create_from_cm($cm, $cm->context)->trigger(); // We need to reset completion data for this activity. return true; } /** * Saves default completion from edit form to all selected module types * * @param stdClass $data data received from the core_completion_bulkedit_form * @param bool $updatecustomrules if we need to update the custom rules of the module - * if no module-specific completion rules were added to the form, update of the module table is not needed.
> * @param string $suffix the suffix to add to the name of the completion rules.
*/
< public function apply_default_completion($data, $updatecustomrules) {
> public function apply_default_completion($data, $updatecustomrules, string $suffix = '') {
global $DB;
> if (!empty($suffix)) { $courseid = $data->id; > // Fields were renamed to avoid conflicts, but they need to be stored in DB with the original name. // MDL-72375 Unset the id here, it should not be stored in customrules. > $modules = property_exists($data, 'modules') ? $data->modules : null; unset($data->id); > if ($modules !== null) { $coursecontext = context_course::instance($courseid); > unset($data->modules); if (!$modids = $data->modids) { > $data = (array)$data; return; > foreach ($data as $name => $value) { } > if (str_ends_with($name, $suffix)) { $defaults = [ > $data[substr($name, 0, strpos($name, $suffix))] = $value; 'completion' => COMPLETION_DISABLED, > unset($data[$name]); 'completionview' => COMPLETION_VIEW_NOT_REQUIRED, > } else if ($name == 'customdata') { 'completionexpected' => 0, > $customrules = $value['customcompletionrules']; 'completionusegrade' => 0, > foreach ($customrules as $rulename => $rulevalue) { 'completionpassgrade' => 0 > if (str_ends_with($rulename, $suffix)) { ]; > $customrules[substr($rulename, 0, strpos($rulename, $suffix))] = $rulevalue; > unset($customrules[$rulename]); $data = (array)$data; > } > } if ($updatecustomrules) { > $data['customdata'] = $customrules; $customdata = array_diff_key($data, $defaults); > } $data['customrules'] = $customdata ? json_encode($customdata) : null; > } $defaults['customrules'] = null; > $data = (object)$data; } > } $data = array_intersect_key($data, $defaults); > } >
// Get names of the affected modules.
> if (!array_key_exists('completionusegrade', $data)) { list($modidssql, $params) = $DB->get_in_or_equal($modids); > $data['completionusegrade'] = 0; $params[] = 1; > } $modules = $DB->get_records_select_menu('modules', 'id ' . $modidssql . ' and visible = ?', $params, '', 'id, name'); > if (!array_key_exists('completionpassgrade', $data)) { > $data['completionpassgrade'] = 0; // Get an associative array of [module_id => course_completion_defaults_id]. > } list($in, $params) = $DB->get_in_or_equal($modids); > if ($data['completionusegrade'] == 0) { $params[] = $courseid; > $data['completionpassgrade'] = 0; $defaultsids = $DB->get_records_select_menu('course_completion_defaults', 'module ' . $in . ' and course = ?', $params, '', > }
< $data = array_intersect_key($data, $defaults);
> $data = array_merge($defaults, $data);
foreach ($modids as $modid) { if (!array_key_exists($modid, $modules)) { continue; } if (isset($defaultsids[$modid])) { $DB->update_record('course_completion_defaults', $data + ['id' => $defaultsids[$modid]]); } else { $defaultsids[$modid] = $DB->insert_record('course_completion_defaults', $data + ['course' => $courseid, 'module' => $modid]); } // Trigger event. \core\event\completion_defaults_updated::create([ 'objectid' => $defaultsids[$modid], 'context' => $coursecontext, 'other' => ['modulename' => $modules[$modid]], ])->trigger(); } // Add notification. \core\notification::add(get_string('defaultcompletionupdated', 'completion'), \core\notification::SUCCESS); } /** * Returns default completion rules for given module type in the given course * * @param stdClass $course * @param stdClass $module * @param bool $flatten if true all module custom completion rules become properties of the same object, * otherwise they can be found as array in ->customdata['customcompletionrules']
> * @param string $suffix the suffix to add to the name of the completion rules.
* @return stdClass */
< public static function get_default_completion($course, $module, $flatten = true) { < global $DB, $CFG; < if ($data = $DB->get_record('course_completion_defaults', ['course' => $course->id, 'module' => $module->id], < 'completion, completionview, completionexpected, completionusegrade, completionpassgrade, customrules')) {
> public static function get_default_completion($course, $module, $flatten = true, string $suffix = '') { > global $DB, $CFG, $SITE; > > $fields = 'completion, completionview, completionexpected, completionusegrade, completionpassgrade, customrules'; > // Check course default completion values. > $params = ['course' => $course->id, 'module' => $module->id]; > $data = $DB->get_record('course_completion_defaults', $params, $fields); > if (!$data && $course->id != $SITE->id) { > // If there is no course default completion, check site level default completion values ($SITE->id). > $params['course'] = $SITE->id; > $data = $DB->get_record('course_completion_defaults', $params, $fields); > } > if ($data) {
if ($data->customrules && ($customrules = @json_decode($data->customrules, true))) { // MDL-72375 This will override activity id for new mods. Skip this field, it is already exposed as courseid. unset($customrules['id']); if ($flatten) { foreach ($customrules as $key => $value) { $data->$key = $value; } } else { $data->customdata['customcompletionrules'] = $customrules; } } unset($data->customrules); } else { $data = new stdClass(); $data->completion = COMPLETION_TRACKING_NONE;
< if ($CFG->completiondefault) { < $completion = new \completion_info(get_fast_modinfo($course->id)->get_course()); < if ($completion->is_enabled() && plugin_supports('mod', $module->name, FEATURE_MODEDIT_DEFAULT_COMPLETION, true)) { < $data->completion = COMPLETION_TRACKING_MANUAL; < $data->completionview = 1;
> } > > // If the suffix is not empty, the completion rules need to be renamed to avoid conflicts. > if (!empty($suffix)) { > $data = (array)$data; > foreach ($data as $name => $value) { > if (str_starts_with($name, 'completion')) { > $data[$name . $suffix] = $value; > unset($data[$name]); > } else if ($name == 'customdata') { > $customrules = $value['customcompletionrules']; > foreach ($customrules as $rulename => $rulevalue) { > if (str_starts_with($rulename, 'completion')) { > $customrules[$rulename . $suffix] = $rulevalue; > unset($customrules[$rulename]);
} }
> $data['customdata'] = $customrules;
}
> } return $data; > $data = (object)$data; } > } } >