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

/**
 * Manual user enrolment UI.
 *
 * @package    enrol_manual
 * @copyright  2010 Petr Skoda {@link http://skodak.org}
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

require('../../config.php');
require_once($CFG->dirroot.'/enrol/manual/locallib.php');

$enrolid      = required_param('enrolid', PARAM_INT);
$roleid       = optional_param('roleid', -1, PARAM_INT);
$extendperiod = optional_param('extendperiod', 0, PARAM_INT);
$extendbase   = optional_param('extendbase', 0, PARAM_INT);
$timeend      = optional_param_array('timeend', [], PARAM_INT);

$instance = $DB->get_record('enrol', array('id'=>$enrolid, 'enrol'=>'manual'), '*', MUST_EXIST);
$course = $DB->get_record('course', array('id'=>$instance->courseid), '*', MUST_EXIST);
$context = context_course::instance($course->id, MUST_EXIST);

require_login($course);
$canenrol = has_capability('enrol/manual:enrol', $context);
$canunenrol = has_capability('enrol/manual:unenrol', $context);

// Note: manage capability not used here because it is used for editing
// of existing enrolments which is not possible here.

if (!$canenrol and !$canunenrol) {
    // No need to invent new error strings here...
    require_capability('enrol/manual:enrol', $context);
    require_capability('enrol/manual:unenrol', $context);
}

if ($roleid < 0) {
    $roleid = $instance->roleid;
}
$roles = get_assignable_roles($context);
$roles = array('0'=>get_string('none')) + $roles;

if (!isset($roles[$roleid])) {
    // Weird - security always first!
    $roleid = 0;
}

if (!$enrol_manual = enrol_get_plugin('manual')) {
    throw new coding_exception('Can not instantiate enrol_manual');
}

< $instancename = $enrol_manual->get_instance_name($instance);
> $url = new moodle_url('/enrol/manual/manage.php', ['enrolid' => $instance->id]); > $title = get_string('managemanualenrolements', 'enrol_manual');
< $PAGE->set_url('/enrol/manual/manage.php', array('enrolid'=>$instance->id));
> $PAGE->set_url($url);
$PAGE->set_pagelayout('admin');
< $PAGE->set_title($enrol_manual->get_instance_name($instance));
> $PAGE->set_title($title);
$PAGE->set_heading($course->fullname);
< navigation_node::override_active_url(new moodle_url('/user/index.php', array('id'=>$course->id)));
> navigation_node::override_active_url(new moodle_url('/enrol/instances.php', ['id' => $course->id])); > $PAGE->navbar->add($title, $url);
// Create the user selector objects. $options = array('enrolid' => $enrolid, 'accesscontext' => $context); $potentialuserselector = new enrol_manual_potential_participant('addselect', $options); $currentuserselector = new enrol_manual_current_participant('removeselect', $options); // Build the list of options for the enrolment period dropdown. $unlimitedperiod = get_string('unlimited'); $periodmenu = array(); for ($i=1; $i<=365; $i++) { $seconds = $i * 86400; $periodmenu[$seconds] = get_string('numdays', '', $i); } // Work out the apropriate default settings. if ($extendperiod) { $defaultperiod = $extendperiod; } else { $defaultperiod = $instance->enrolperiod; } if ($instance->enrolperiod > 0 && !isset($periodmenu[$instance->enrolperiod])) { $periodmenu[$instance->enrolperiod] = format_time($instance->enrolperiod); } if (empty($extendbase)) { if (!$extendbase = get_config('enrol_manual', 'enrolstart')) { // Default to now if there is no system setting. $extendbase = 4; } } // Build the list of options for the starting from dropdown. $now = time(); $today = make_timestamp(date('Y', $now), date('m', $now), date('d', $now), 0, 0, 0); $dateformat = get_string('strftimedatefullshort'); // Enrolment start. $basemenu = array(); if ($course->startdate > 0) { $basemenu[2] = get_string('coursestart') . ' (' . userdate($course->startdate, $dateformat) . ')'; } $basemenu[3] = get_string('today') . ' (' . userdate($today, $dateformat) . ')'; $basemenu[4] = get_string('now', 'enrol_manual') . ' (' . userdate($now, get_string('strftimedatetimeshort')) . ')'; // Process add and removes. if ($canenrol && optional_param('add', false, PARAM_BOOL) && confirm_sesskey()) { $userstoassign = $potentialuserselector->get_selected_users(); if (!empty($userstoassign)) { foreach($userstoassign as $adduser) { switch($extendbase) { case 2: $timestart = $course->startdate; break; case 4: // We mimic get_enrolled_sql round(time(), -2) but always floor as we want users to always access their // courses once they are enrolled. $timestart = intval(substr($now, 0, 8) . '00') - 1; break; case 3: default: $timestart = $today; break; } if ($timeend) { $timeend = make_timestamp($timeend['year'], $timeend['month'], $timeend['day'], $timeend['hour'], $timeend['minute']); } else if ($extendperiod <= 0) { $timeend = 0; } else { $timeend = $timestart + $extendperiod; } $enrol_manual->enrol_user($instance, $adduser->id, $roleid, $timestart, $timeend); } $potentialuserselector->invalidate_selected_users(); $currentuserselector->invalidate_selected_users(); //TODO: log } } // Process incoming role unassignments. if ($canunenrol && optional_param('remove', false, PARAM_BOOL) && confirm_sesskey()) { $userstounassign = $currentuserselector->get_selected_users(); if (!empty($userstounassign)) { foreach($userstounassign as $removeuser) { $enrol_manual->unenrol_user($instance, $removeuser->id); } $potentialuserselector->invalidate_selected_users(); $currentuserselector->invalidate_selected_users(); //TODO: log } } echo $OUTPUT->header();
< echo $OUTPUT->heading($instancename);
> echo $OUTPUT->heading($title);
$addenabled = $canenrol ? '' : 'disabled="disabled"'; $removeenabled = $canunenrol ? '' : 'disabled="disabled"'; ?> <form id="assignform" method="post" action="<?php echo $PAGE->url ?>"><div> <input type="hidden" name="sesskey" value="<?php echo sesskey() ?>" /> <table summary="" class="roleassigntable generaltable generalbox boxaligncenter" cellspacing="0"> <tr> <td id="existingcell"> <p><label for="removeselect"><?php print_string('enrolledusers', 'enrol'); ?></label></p> <?php $currentuserselector->display() ?> </td> <td id="buttonscell"> <div id="addcontrols"> <input class="btn btn-secondary" name="add" <?php echo $addenabled; ?> id="add" type="submit" value="<?php echo $OUTPUT->larrow() . '&nbsp;' . get_string('add'); ?>" title="<?php print_string('add'); ?>" /><br /> <div class="enroloptions"> <p><label for="menuroleid"><?php print_string('assignrole', 'enrol_manual') ?></label><br /> <?php echo html_writer::select($roles, 'roleid', $roleid, false); ?></p> <p><label for="menuextendperiod"><?php print_string('enrolperiod', 'enrol') ?></label><br /> <?php echo html_writer::select($periodmenu, 'extendperiod', $defaultperiod, $unlimitedperiod); ?></p> <p><label for="menuextendbase"><?php print_string('startingfrom') ?></label><br /> <?php echo html_writer::select($basemenu, 'extendbase', $extendbase, false); ?></p> </div> </div> <div id="removecontrols"> <input class="btn btn-secondary" name="remove" id="remove" <?php echo $removeenabled; ?> type="submit" value="<?php echo get_string('remove') . '&nbsp;' . $OUTPUT->rarrow(); ?>" title="<?php print_string('remove'); ?>" /> </div> </td> <td id="potentialcell"> <p><label for="addselect"><?php print_string('enrolcandidates', 'enrol'); ?></label></p> <?php $potentialuserselector->display() ?> </td> </tr> </table> </div></form> <?php echo $OUTPUT->footer();