enrol/manual/manage.php

   1 <?php
   2 // This file is part of Moodle - http://moodle.org/
   3 //
   4 // Moodle is free software: you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation, either version 3 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // Moodle is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 /**
  18  * Manual user enrolment UI.
  19  *
  20  * @package    enrol_manual
  21  * @copyright  2010 Petr Skoda {@link http://skodak.org}
  22  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23  */
  24
  25 require('../../config.php');
  26 require_once($CFG->dirroot.'/enrol/manual/locallib.php');
  27
  28 $enrolid      = required_param('enrolid', PARAM_INT);
  29 $roleid       = optional_param('roleid', -1, PARAM_INT);
  30 $extendperiod = optional_param('extendperiod', 0, PARAM_INT);
  31 $extendbase   = optional_param('extendbase', 0, PARAM_INT);
  32
  33 $instance = $DB->get_record('enrol', array('id'=>$enrolid, 'enrol'=>'manual'), '*', MUST_EXIST);
  34 $course = $DB->get_record('course', array('id'=>$instance->courseid), '*', MUST_EXIST);
  35 $context = context_course::instance($course->id, MUST_EXIST);
  36
  37 require_login($course);
  38 $canenrol = has_capability('enrol/manual:enrol', $context);
  39 $canunenrol = has_capability('enrol/manual:unenrol', $context);
  40 $viewfullnames = has_capability('moodle/site:viewfullnames', $context);
  41
  42 // Note: manage capability not used here because it is used for editing
  43 // of existing enrolments which is not possible here.
  44
  45 if (!$canenrol and !$canunenrol) {
  46     // No need to invent new error strings here...
  47     require_capability('enrol/manual:enrol', $context);
  48     require_capability('enrol/manual:unenrol', $context);
  49 }
  50
  51 if ($roleid < 0) {
  52     $roleid = $instance->roleid;
  53 }
  54 $roles = get_assignable_roles($context);
  55 $roles = array('0'=>get_string('none')) + $roles;
  56
  57 if (!isset($roles[$roleid])) {
  58     // Weird - security always first!
  59     $roleid = 0;
  60 }
  61
  62 if (!$enrol_manual = enrol_get_plugin('manual')) {
  63     throw new coding_exception('Can not instantiate enrol_manual');
  64 }
  65
  66 $instancename = $enrol_manual->get_instance_name($instance);
  67
  68 $PAGE->set_url('/enrol/manual/manage.php', array('enrolid'=>$instance->id));
  69 $PAGE->set_pagelayout('admin');
  70 $PAGE->set_title($enrol_manual->get_instance_name($instance));
  71 $PAGE->set_heading($course->fullname);
  72 navigation_node::override_active_url(new moodle_url('/user/index.php', array('id'=>$course->id)));
  73
  74 // Create the user selector objects.
  75 $options = array('enrolid' => $enrolid, 'accesscontext' => $context);
  76
  77 $potentialuserselector = new enrol_manual_potential_participant('addselect', $options);
  78 $potentialuserselector->viewfullnames = $viewfullnames;
  79 $currentuserselector = new enrol_manual_current_participant('removeselect', $options);
  80 $currentuserselector->viewfullnames = $viewfullnames;
  81
  82 // Build the list of options for the enrolment period dropdown.
  83 $unlimitedperiod = get_string('unlimited');
  84 $periodmenu = array();
  85 for ($i=1; $i<=365; $i++) {
  86     $seconds = $i * 86400;
  87     $periodmenu[$seconds] = get_string('numdays', '', $i);
  88 }
  89 // Work out the apropriate default settings.
  90 if ($extendperiod) {
  91     $defaultperiod = $extendperiod;
  92 } else {
  93     $defaultperiod = $instance->enrolperiod;
  94 }
  95 if ($instance->enrolperiod > 0 && !isset($periodmenu[$instance->enrolperiod])) {
  96     $periodmenu[$instance->enrolperiod] = format_time($instance->enrolperiod);
  97 }
  98 if (empty($extendbase)) {
  99     if (!$extendbase = get_config('enrol_manual', 'enrolstart')) {
 100         // Default to now if there is no system setting.
 101         $extendbase = 4;
 102     }
 103 }
 104
 105 // Build the list of options for the starting from dropdown.
 106 $now = time();
 107 $today = make_timestamp(date('Y', $now), date('m', $now), date('d', $now), 0, 0, 0);
 108 $dateformat = get_string('strftimedatefullshort');
 109
 110 // Enrolment start.
 111 $basemenu = array();
 112 if ($course->startdate > 0) {
 113     $basemenu[2] = get_string('coursestart') . ' (' . userdate($course->startdate, $dateformat) . ')';
 114 }
 115 $basemenu[3] = get_string('today') . ' (' . userdate($today, $dateformat) . ')';
 116 $basemenu[4] = get_string('now', 'enrol_manual') . ' (' . userdate($now, get_string('strftimedatetimeshort')) . ')';
 117
 118 // Process add and removes.
 119 if ($canenrol && optional_param('add', false, PARAM_BOOL) && confirm_sesskey()) {
 120     $userstoassign = $potentialuserselector->get_selected_users();
 121     if (!empty($userstoassign)) {
 122         foreach($userstoassign as $adduser) {
 123             switch($extendbase) {
 124                 case 2:
 125                     $timestart = $course->startdate;
 126                     break;
 127                 case 4:
 128                     // We mimic get_enrolled_sql round(time(), -2) but always floor as we want users to always access their
 129                     // courses once they are enrolled.
 130                     $timestart = intval(substr($now, 0, 8) . '00') - 1;
 131                     break;
 132                 case 3:
 133                 default:
 134                     $timestart = $today;
 135                     break;
 136             }
 137
 138             if ($extendperiod <= 0) {
 139                 $timeend = 0;
 140             } else {
 141                 $timeend = $timestart + $extendperiod;
 142             }
 143             $enrol_manual->enrol_user($instance, $adduser->id, $roleid, $timestart, $timeend);
 144         }
 145
 146         $potentialuserselector->invalidate_selected_users();
 147         $currentuserselector->invalidate_selected_users();
 148
 149         //TODO: log
 150     }
 151 }
 152
 153 // Process incoming role unassignments.
 154 if ($canunenrol && optional_param('remove', false, PARAM_BOOL) && confirm_sesskey()) {
 155     $userstounassign = $currentuserselector->get_selected_users();
 156     if (!empty($userstounassign)) {
 157         foreach($userstounassign as $removeuser) {
 158             $enrol_manual->unenrol_user($instance, $removeuser->id);
 159         }
 160
 161         $potentialuserselector->invalidate_selected_users();
 162         $currentuserselector->invalidate_selected_users();
 163
 164         //TODO: log
 165     }
 166 }
 167
 168
 169 echo $OUTPUT->header();
 170 echo $OUTPUT->heading($instancename);
 171
 172 $addenabled = $canenrol ? '' : 'disabled="disabled"';
 173 $removeenabled = $canunenrol ? '' : 'disabled="disabled"';
 174
 175 ?>
 176 <form id="assignform" method="post" action="<?php echo $PAGE->url ?>"><div>
 177   <input type="hidden" name="sesskey" value="<?php echo sesskey() ?>" />
 178
 179   <table summary="" class="roleassigntable generaltable generalbox boxaligncenter" cellspacing="0">
 180     <tr>
 181       <td id="existingcell">
 182           <p><label for="removeselect"><?php print_string('enrolledusers', 'enrol'); ?></label></p>
 183           <?php $currentuserselector->display() ?>
 184       </td>
 185       <td id="buttonscell">
 186           <div id="addcontrols">
 187               <input name="add" <?php echo $addenabled; ?> id="add" type="submit" value="<?php echo $OUTPUT->larrow().'&nbsp;'.get_string('add'); ?>" title="<?php print_string('add'); ?>" /><br />
 188
 189               <div class="enroloptions">
 190
 191               <p><label for="menuroleid"><?php print_string('assignrole', 'enrol_manual') ?></label><br />
 192               <?php echo html_writer::select($roles, 'roleid', $roleid, false); ?></p>
 193
 194               <p><label for="menuextendperiod"><?php print_string('enrolperiod', 'enrol') ?></label><br />
 195               <?php echo html_writer::select($periodmenu, 'extendperiod', $defaultperiod, $unlimitedperiod); ?></p>
 196
 197               <p><label for="menuextendbase"><?php print_string('startingfrom') ?></label><br />
 198               <?php echo html_writer::select($basemenu, 'extendbase', $extendbase, false); ?></p>
 199
 200               </div>
 201           </div>
 202
 203           <div id="removecontrols">
 204               <input name="remove" id="remove" <?php echo $removeenabled; ?> type="submit" value="<?php echo get_string('remove').'&nbsp;'.$OUTPUT->rarrow(); ?>" title="<?php print_string('remove'); ?>" />
 205           </div>
 206       </td>
 207       <td id="potentialcell">
 208           <p><label for="addselect"><?php print_string('enrolcandidates', 'enrol'); ?></label></p>
 209           <?php $potentialuserselector->display() ?>
 210       </td>
 211     </tr>
 212   </table>
 213 </div></form>
 214 <?php
 215
 216
 217 echo $OUTPUT->footer();