Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.

Differences Between: [Versions 310 and 311] [Versions 310 and 400] [Versions 310 and 401] [Versions 310 and 402] [Versions 310 and 403]

   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   * This page handles editing and creation of lesson overrides
  19   *
  20   * @package   mod_lesson
  21   * @copyright 2015 Jean-Michel Vedrine
  22   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  
  26  require_once(__DIR__ . '/../../config.php');
  27  require_once($CFG->dirroot.'/mod/lesson/lib.php');
  28  require_once($CFG->dirroot.'/mod/lesson/locallib.php');
  29  require_once($CFG->dirroot.'/mod/lesson/override_form.php');
  30  
  31  
  32  $cmid = optional_param('cmid', 0, PARAM_INT);
  33  $overrideid = optional_param('id', 0, PARAM_INT);
  34  $action = optional_param('action', null, PARAM_ALPHA);
  35  $reset = optional_param('reset', false, PARAM_BOOL);
  36  
  37  $override = null;
  38  if ($overrideid) {
  39  
  40      if (! $override = $DB->get_record('lesson_overrides', array('id' => $overrideid))) {
  41          print_error('invalidoverrideid', 'lesson');
  42      }
  43  
  44      $lesson = new lesson($DB->get_record('lesson', array('id' => $override->lessonid), '*',  MUST_EXIST));
  45  
  46      list($course, $cm) = get_course_and_cm_from_instance($lesson, 'lesson');
  47  
  48  } else if ($cmid) {
  49      list($course, $cm) = get_course_and_cm_from_cmid($cmid, 'lesson');
  50      $lesson = new lesson($DB->get_record('lesson', array('id' => $cm->instance), '*', MUST_EXIST));
  51  
  52  } else {
  53      print_error('invalidcoursemodule');
  54  }
  55  $course = $DB->get_record('course', array('id' => $cm->course), '*', MUST_EXIST);
  56  
  57  $url = new moodle_url('/mod/lesson/overrideedit.php');
  58  if ($action) {
  59      $url->param('action', $action);
  60  }
  61  if ($overrideid) {
  62      $url->param('id', $overrideid);
  63  } else {
  64      $url->param('cmid', $cmid);
  65  }
  66  
  67  $PAGE->set_url($url);
  68  
  69  require_login($course, false, $cm);
  70  
  71  $context = context_module::instance($cm->id);
  72  
  73  // Add or edit an override.
  74  require_capability('mod/lesson:manageoverrides', $context);
  75  
  76  if ($overrideid) {
  77      // Editing an override.
  78      $data = clone $override;
  79  
  80      if ($override->groupid) {
  81          if (!groups_group_visible($override->groupid, $course, $cm)) {
  82              print_error('invalidoverrideid', 'lesson');
  83          }
  84      } else {
  85          if (!groups_user_groups_visible($course, $override->userid, $cm)) {
  86              print_error('invalidoverrideid', 'lesson');
  87          }
  88      }
  89  } else {
  90      // Creating a new override.
  91      $data = new stdClass();
  92  }
  93  
  94  // Merge lesson defaults with data.
  95  $keys = array('available', 'deadline', 'review', 'timelimit', 'maxattempts', 'retake', 'password');
  96  foreach ($keys as $key) {
  97      if (!isset($data->{$key}) || $reset) {
  98          $data->{$key} = $lesson->{$key};
  99      }
 100  }
 101  
 102  // True if group-based override.
 103  $groupmode = !empty($data->groupid) || ($action === 'addgroup' && empty($overrideid));
 104  
 105  // If we are duplicating an override, then clear the user/group and override id
 106  // since they will change.
 107  if ($action === 'duplicate') {
 108      $override->id = $data->id = null;
 109      $override->userid = $data->userid = null;
 110      $override->groupid = $data->groupid = null;
 111  }
 112  
 113  $overridelisturl = new moodle_url('/mod/lesson/overrides.php', array('cmid' => $cm->id));
 114  if (!$groupmode) {
 115      $overridelisturl->param('mode', 'user');
 116  }
 117  
 118  // Setup the form.
 119  $mform = new lesson_override_form($url, $cm, $lesson, $context, $groupmode, $override);
 120  $mform->set_data($data);
 121  
 122  if ($mform->is_cancelled()) {
 123      redirect($overridelisturl);
 124  
 125  } else if (optional_param('resetbutton', 0, PARAM_ALPHA)) {
 126      $url->param('reset', true);
 127      redirect($url);
 128  
 129  } else if ($fromform = $mform->get_data()) {
 130      // Process the data.
 131      $fromform->lessonid = $lesson->id;
 132  
 133      // Replace unchanged values with null.
 134      foreach ($keys as $key) {
 135          if ($fromform->{$key} == $lesson->{$key}) {
 136              $fromform->{$key} = null;
 137          }
 138      }
 139  
 140      // See if we are replacing an existing override.
 141      $userorgroupchanged = false;
 142      if (empty($override->id)) {
 143          $userorgroupchanged = true;
 144      } else if (!empty($fromform->userid)) {
 145          $userorgroupchanged = $fromform->userid !== $override->userid;
 146      } else {
 147          $userorgroupchanged = $fromform->groupid !== $override->groupid;
 148      }
 149  
 150      if ($userorgroupchanged) {
 151          $conditions = array(
 152                  'lessonid' => $lesson->id,
 153                  'userid' => empty($fromform->userid) ? null : $fromform->userid,
 154                  'groupid' => empty($fromform->groupid) ? null : $fromform->groupid);
 155          if ($oldoverride = $DB->get_record('lesson_overrides', $conditions)) {
 156              // There is an old override, so we merge any new settings on top of
 157              // the older override.
 158              foreach ($keys as $key) {
 159                  if (is_null($fromform->{$key})) {
 160                      $fromform->{$key} = $oldoverride->{$key};
 161                  }
 162              }
 163  
 164              $lesson->delete_override($oldoverride->id);
 165          }
 166      }
 167  
 168      // Set the common parameters for one of the events we may be triggering.
 169      $params = array(
 170          'context' => $context,
 171          'other' => array(
 172              'lessonid' => $lesson->id
 173          )
 174      );
 175      if (!empty($override->id)) {
 176          $fromform->id = $override->id;
 177          $DB->update_record('lesson_overrides', $fromform);
 178  
 179          // Determine which override updated event to fire.
 180          $params['objectid'] = $override->id;
 181          if (!$groupmode) {
 182              $params['relateduserid'] = $fromform->userid;
 183              $event = \mod_lesson\event\user_override_updated::create($params);
 184          } else {
 185              $params['other']['groupid'] = $fromform->groupid;
 186              $event = \mod_lesson\event\group_override_updated::create($params);
 187          }
 188  
 189          // Trigger the override updated event.
 190          $event->trigger();
 191      } else {
 192          unset($fromform->id);
 193          $fromform->id = $DB->insert_record('lesson_overrides', $fromform);
 194  
 195          // Determine which override created event to fire.
 196          $params['objectid'] = $fromform->id;
 197          if (!$groupmode) {
 198              $params['relateduserid'] = $fromform->userid;
 199              $event = \mod_lesson\event\user_override_created::create($params);
 200          } else {
 201              $params['other']['groupid'] = $fromform->groupid;
 202              $event = \mod_lesson\event\group_override_created::create($params);
 203          }
 204  
 205          // Trigger the override created event.
 206          $event->trigger();
 207      }
 208  
 209      if ($groupmode) {
 210          // Priorities may have shifted, so we need to update all of the calendar events for group overrides.
 211          lesson_update_events($lesson);
 212      } else {
 213          // User override. We only need to update the calendar event for this user override.
 214          lesson_update_events($lesson, $fromform);
 215      }
 216  
 217  
 218      if (!empty($fromform->submitbutton)) {
 219          redirect($overridelisturl);
 220      }
 221  
 222      // The user pressed the 'again' button, so redirect back to this page.
 223      $url->remove_params('cmid');
 224      $url->param('action', 'duplicate');
 225      $url->param('id', $fromform->id);
 226      redirect($url);
 227  
 228  }
 229  
 230  // Print the form.
 231  $pagetitle = get_string('editoverride', 'lesson');
 232  $PAGE->navbar->add($pagetitle);
 233  $PAGE->set_pagelayout('admin');
 234  $PAGE->set_title($pagetitle);
 235  $PAGE->set_heading($course->fullname);
 236  echo $OUTPUT->header();
 237  echo $OUTPUT->heading(format_string($lesson->name, true, array('context' => $context)));
 238  
 239  $mform->display();
 240  
 241  echo $OUTPUT->footer();