You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
268 lines
14 KiB
268 lines
14 KiB
2 years ago
|
<?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/>.
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Edit course completion settings - the form definition.
|
||
|
|
*
|
||
|
|
* @package core_completion
|
||
|
|
* @category completion
|
||
|
|
* @copyright 2009 Catalyst IT Ltd
|
||
|
|
* @author Aaron Barnes <aaronb@catalyst.net.nz>
|
||
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
||
|
|
*/
|
||
|
|
|
||
|
|
defined('MOODLE_INTERNAL') || die();
|
||
|
|
|
||
|
|
require_once($CFG->libdir.'/formslib.php');
|
||
|
|
require_once($CFG->libdir.'/completionlib.php');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Defines the course completion settings form.
|
||
|
|
*/
|
||
|
|
class course_completion_form extends moodleform {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Defines the form fields.
|
||
|
|
*/
|
||
|
|
public function definition() {
|
||
|
|
global $USER, $CFG, $DB;
|
||
|
|
|
||
|
|
$courseconfig = get_config('moodlecourse');
|
||
|
|
$mform = $this->_form;
|
||
|
|
$course = $this->_customdata['course'];
|
||
|
|
$completion = new completion_info($course);
|
||
|
|
|
||
|
|
$params = array(
|
||
|
|
'course' => $course->id
|
||
|
|
);
|
||
|
|
|
||
|
|
// Check if there are existing criteria completions.
|
||
|
|
if ($completion->is_course_locked()) {
|
||
|
|
$mform->addElement('header', 'completionsettingslocked', get_string('completionsettingslocked', 'completion'));
|
||
|
|
$mform->addElement('static', '', '', get_string('err_settingslocked', 'completion'));
|
||
|
|
$mform->addElement('submit', 'settingsunlock', get_string('unlockcompletiondelete', 'completion'));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Get array of all available aggregation methods.
|
||
|
|
$aggregation_methods = $completion->get_aggregation_methods();
|
||
|
|
|
||
|
|
// Overall criteria aggregation.
|
||
|
|
$mform->addElement('header', 'overallcriteria', get_string('general', 'core_form'));
|
||
|
|
// Map aggregation methods to context-sensitive human readable dropdown menu.
|
||
|
|
$overallaggregationmenu = array();
|
||
|
|
foreach ($aggregation_methods as $methodcode => $methodname) {
|
||
|
|
if ($methodcode === COMPLETION_AGGREGATION_ALL) {
|
||
|
|
$overallaggregationmenu[COMPLETION_AGGREGATION_ALL] = get_string('overallaggregation_all', 'core_completion');
|
||
|
|
} else if ($methodcode === COMPLETION_AGGREGATION_ANY) {
|
||
|
|
$overallaggregationmenu[COMPLETION_AGGREGATION_ANY] = get_string('overallaggregation_any', 'core_completion');
|
||
|
|
} else {
|
||
|
|
$overallaggregationmenu[$methodcode] = $methodname;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
$mform->addElement('select', 'overall_aggregation', get_string('overallaggregation', 'core_completion'), $overallaggregationmenu);
|
||
|
|
$mform->setDefault('overall_aggregation', $completion->get_aggregation_method());
|
||
|
|
|
||
|
|
// Activity completion criteria
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('activitiescompleted', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'activitiescompleted', $label);
|
||
|
|
// Get the list of currently specified conditions and expand the section if some are found.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_ACTIVITY);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('activitiescompleted');
|
||
|
|
}
|
||
|
|
|
||
|
|
$activities = $completion->get_activities();
|
||
|
|
if (!empty($activities)) {
|
||
|
|
|
||
|
|
if (!$completion->is_course_locked()) {
|
||
|
|
$this->add_checkbox_controller(1, null, null, 0);
|
||
|
|
}
|
||
|
|
foreach ($activities as $activity) {
|
||
|
|
$params_a = array('moduleinstance' => $activity->id);
|
||
|
|
$criteria = new completion_criteria_activity(array_merge($params, $params_a));
|
||
|
|
$criteria->config_form_display($mform, $activity);
|
||
|
|
}
|
||
|
|
$mform->addElement('static', 'criteria_role_note', '', get_string('activitiescompletednote', 'core_completion'));
|
||
|
|
|
||
|
|
if (count($activities) > 1) {
|
||
|
|
// Map aggregation methods to context-sensitive human readable dropdown menu.
|
||
|
|
$activityaggregationmenu = array();
|
||
|
|
foreach ($aggregation_methods as $methodcode => $methodname) {
|
||
|
|
if ($methodcode === COMPLETION_AGGREGATION_ALL) {
|
||
|
|
$activityaggregationmenu[COMPLETION_AGGREGATION_ALL] = get_string('activityaggregation_all', 'core_completion');
|
||
|
|
} else if ($methodcode === COMPLETION_AGGREGATION_ANY) {
|
||
|
|
$activityaggregationmenu[COMPLETION_AGGREGATION_ANY] = get_string('activityaggregation_any', 'core_completion');
|
||
|
|
} else {
|
||
|
|
$activityaggregationmenu[$methodcode] = $methodname;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
$mform->addElement('select', 'activity_aggregation', get_string('activityaggregation', 'core_completion'), $activityaggregationmenu);
|
||
|
|
$mform->setDefault('activity_aggregation', $completion->get_aggregation_method(COMPLETION_CRITERIA_TYPE_ACTIVITY));
|
||
|
|
}
|
||
|
|
|
||
|
|
} else {
|
||
|
|
$mform->addElement('static', 'noactivities', '', get_string('err_noactivities', 'completion'));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Course prerequisite completion criteria.
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('dependenciescompleted', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'courseprerequisites', $label);
|
||
|
|
// Get the list of currently specified conditions and expand the section if some are found.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_COURSE);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('courseprerequisites');
|
||
|
|
}
|
||
|
|
|
||
|
|
// Get applicable courses (prerequisites).
|
||
|
|
$selectedcourses = $DB->get_fieldset_sql("SELECT cc.courseinstance
|
||
|
|
FROM {course_completion_criteria} cc WHERE cc.course = ?", [$course->id]);
|
||
|
|
$hasselectablecourses = core_course_category::search_courses(['onlywithcompletion' => true], ['limit' => 2]);
|
||
|
|
unset($hasselectablecourses[$course->id]);
|
||
|
|
if ($hasselectablecourses) {
|
||
|
|
// Show multiselect box.
|
||
|
|
$mform->addElement('course', 'criteria_course', get_string('coursesavailable', 'completion'),
|
||
|
|
array('multiple' => 'multiple', 'onlywithcompletion' => true, 'exclude' => $course->id));
|
||
|
|
$mform->setDefault('criteria_course', $selectedcourses);
|
||
|
|
|
||
|
|
// Map aggregation methods to context-sensitive human readable dropdown menu.
|
||
|
|
$courseaggregationmenu = array();
|
||
|
|
foreach ($aggregation_methods as $methodcode => $methodname) {
|
||
|
|
if ($methodcode === COMPLETION_AGGREGATION_ALL) {
|
||
|
|
$courseaggregationmenu[COMPLETION_AGGREGATION_ALL] = get_string('courseaggregation_all', 'core_completion');
|
||
|
|
} else if ($methodcode === COMPLETION_AGGREGATION_ANY) {
|
||
|
|
$courseaggregationmenu[COMPLETION_AGGREGATION_ANY] = get_string('courseaggregation_any', 'core_completion');
|
||
|
|
} else {
|
||
|
|
$courseaggregationmenu[$methodcode] = $methodname;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
$mform->addElement('select', 'course_aggregation', get_string('courseaggregation', 'core_completion'), $courseaggregationmenu);
|
||
|
|
$mform->setDefault('course_aggregation', $completion->get_aggregation_method(COMPLETION_CRITERIA_TYPE_COURSE));
|
||
|
|
} else {
|
||
|
|
$mform->addElement('static', 'nocourses', '', get_string('err_nocourses', 'completion'));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Completion on date
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('completionondate', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'date', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_DATE);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('date');
|
||
|
|
}
|
||
|
|
$criteria = new completion_criteria_date($params);
|
||
|
|
$criteria->config_form_display($mform);
|
||
|
|
|
||
|
|
// Completion after enrolment duration
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('enrolmentduration', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'duration', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_DURATION);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('duration');
|
||
|
|
}
|
||
|
|
$criteria = new completion_criteria_duration($params);
|
||
|
|
$criteria->config_form_display($mform);
|
||
|
|
|
||
|
|
// Completion on unenrolment
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('unenrolment', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'unenrolment', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_UNENROL);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('unenrolment');
|
||
|
|
}
|
||
|
|
$criteria = new completion_criteria_unenrol($params);
|
||
|
|
$criteria->config_form_display($mform);
|
||
|
|
|
||
|
|
// Completion on course grade
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('coursegrade', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'grade', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_GRADE);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('grade');
|
||
|
|
}
|
||
|
|
$course_grade = $DB->get_field('grade_items', 'gradepass', array('courseid' => $course->id, 'itemtype' => 'course'));
|
||
|
|
if (!$course_grade) {
|
||
|
|
$course_grade = '0.00000';
|
||
|
|
}
|
||
|
|
$criteria = new completion_criteria_grade($params);
|
||
|
|
$criteria->config_form_display($mform, $course_grade);
|
||
|
|
|
||
|
|
// Manual self completion
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('manualselfcompletion', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'manualselfcompletion', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_SELF);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('manualselfcompletion');
|
||
|
|
}
|
||
|
|
$criteria = new completion_criteria_self($params);
|
||
|
|
$criteria->config_form_display($mform);
|
||
|
|
$mform->addElement('static', 'criteria_self_note', '', get_string('manualselfcompletionnote', 'core_completion'));
|
||
|
|
|
||
|
|
// Role completion criteria
|
||
|
|
$label = get_string('coursecompletioncondition', 'core_completion', get_string('manualcompletionby', 'core_completion'));
|
||
|
|
$mform->addElement('header', 'roles', $label);
|
||
|
|
// Expand the condition section if it is currently enabled.
|
||
|
|
$current = $completion->get_criteria(COMPLETION_CRITERIA_TYPE_ROLE);
|
||
|
|
if (!empty($current)) {
|
||
|
|
$mform->setExpanded('roles');
|
||
|
|
}
|
||
|
|
$roles = get_roles_with_capability('moodle/course:markcomplete', CAP_ALLOW, context_course::instance($course->id, IGNORE_MISSING));
|
||
|
|
|
||
|
|
if (!empty($roles)) {
|
||
|
|
foreach ($roles as $role) {
|
||
|
|
$params_a = array('role' => $role->id);
|
||
|
|
$criteria = new completion_criteria_role(array_merge($params, $params_a));
|
||
|
|
$criteria->config_form_display($mform, $role);
|
||
|
|
}
|
||
|
|
$mform->addElement('static', 'criteria_role_note', '', get_string('manualcompletionbynote', 'core_completion'));
|
||
|
|
// Map aggregation methods to context-sensitive human readable dropdown menu.
|
||
|
|
$roleaggregationmenu = array();
|
||
|
|
foreach ($aggregation_methods as $methodcode => $methodname) {
|
||
|
|
if ($methodcode === COMPLETION_AGGREGATION_ALL) {
|
||
|
|
$roleaggregationmenu[COMPLETION_AGGREGATION_ALL] = get_string('roleaggregation_all', 'core_completion');
|
||
|
|
} else if ($methodcode === COMPLETION_AGGREGATION_ANY) {
|
||
|
|
$roleaggregationmenu[COMPLETION_AGGREGATION_ANY] = get_string('roleaggregation_any', 'core_completion');
|
||
|
|
} else {
|
||
|
|
$roleaggregationmenu[$methodcode] = $methodname;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
$mform->addElement('select', 'role_aggregation', get_string('roleaggregation', 'core_completion'), $roleaggregationmenu);
|
||
|
|
$mform->setDefault('role_aggregation', $completion->get_aggregation_method(COMPLETION_CRITERIA_TYPE_ROLE));
|
||
|
|
|
||
|
|
} else {
|
||
|
|
$mform->addElement('static', 'noroles', '', get_string('err_noroles', 'completion'));
|
||
|
|
}
|
||
|
|
|
||
|
|
// Add common action buttons.
|
||
|
|
$this->add_action_buttons();
|
||
|
|
|
||
|
|
// Add hidden fields.
|
||
|
|
$mform->addElement('hidden', 'id', $course->id);
|
||
|
|
$mform->setType('id', PARAM_INT);
|
||
|
|
|
||
|
|
// If the criteria are locked, freeze values and submit button.
|
||
|
|
if ($completion->is_course_locked()) {
|
||
|
|
$except = array('settingsunlock');
|
||
|
|
$mform->hardFreezeAllVisibleExcept($except);
|
||
|
|
$mform->addElement('cancel');
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|