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.

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

   1  <?php
   2  
   3  // This file is part of Moodle - http://moodle.org/
   4  //
   5  // Moodle is free software: you can redistribute it and/or modify
   6  // it under the terms of the GNU General Public License as published by
   7  // the Free Software Foundation, either version 3 of the License, or
   8  // (at your option) any later version.
   9  //
  10  // Moodle is distributed in the hope that it will be useful,
  11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  // GNU General Public License for more details.
  14  //
  15  // You should have received a copy of the GNU General Public License
  16  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  17  
  18  /**
  19   * Toggles the manual completion flag for a particular activity or course completion
  20   * and the current user.
  21   *
  22   * If by student params: course=2
  23   * If by manager params: course=2&user=4&rolec=3&sesskey=ghfgsdf
  24   *
  25   * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  26   * @package course
  27   */
  28  
  29  require_once('../config.php');
  30  require_once($CFG->libdir.'/completionlib.php');
  31  
  32  // Parameters
  33  $cmid = optional_param('id', 0, PARAM_INT);
  34  $courseid = optional_param('course', 0, PARAM_INT);
  35  $confirm = optional_param('confirm', 0, PARAM_BOOL);
  36  
  37  // Check if we are marking a user complete via the completion report.
  38  $user = optional_param('user', 0, PARAM_INT);
  39  $rolec = optional_param('rolec', 0, PARAM_INT);
  40  
  41  if (!$cmid && !$courseid) {
  42      throw new \moodle_exception('invalidarguments');
  43  }
  44  
  45  // Process self completion
  46  if ($courseid) {
  47      $PAGE->set_url(new moodle_url('/course/togglecompletion.php', array('course'=>$courseid)));
  48  
  49      // Check user is logged in
  50      $course = $DB->get_record('course', array('id' => $courseid), '*', MUST_EXIST);
  51      $context = context_course::instance($course->id);
  52      require_login($course);
  53  
  54      $completion = new completion_info($course);
  55      $trackeduser = ($user ? $user : $USER->id);
  56  
  57      if (!$completion->is_enabled()) {
  58          throw new moodle_exception('completionnotenabled', 'completion');
  59      } else if (!$completion->is_tracked_user($trackeduser)) {
  60          throw new moodle_exception('nottracked', 'completion');
  61      }
  62  
  63      if ($user && $rolec) {
  64          require_sesskey();
  65  
  66          completion_criteria::factory(array('id'=>$rolec, 'criteriatype'=>COMPLETION_CRITERIA_TYPE_ROLE)); //TODO: this is dumb, because it does not fetch the data?!?!
  67          $criteria = completion_criteria_role::fetch(array('id'=>$rolec));
  68  
  69          if ($criteria and user_has_role_assignment($USER->id, $criteria->role, $context->id)) {
  70              $criteria_completions = $completion->get_completions($user, COMPLETION_CRITERIA_TYPE_ROLE);
  71  
  72              foreach ($criteria_completions as $criteria_completion) {
  73                  if ($criteria_completion->criteriaid == $rolec) {
  74                      $criteria->complete($criteria_completion);
  75                      break;
  76                  }
  77              }
  78          }
  79  
  80          // Return to previous page
  81          $referer = get_local_referer(false);
  82          if (!empty($referer)) {
  83              redirect($referer);
  84          } else {
  85              redirect('view.php?id='.$course->id);
  86          }
  87  
  88      } else {
  89  
  90          // Confirm with user
  91          if ($confirm and confirm_sesskey()) {
  92              $completion = $completion->get_completion($USER->id, COMPLETION_CRITERIA_TYPE_SELF);
  93  
  94              if (!$completion) {
  95                  throw new \moodle_exception('noselfcompletioncriteria', 'completion');
  96              }
  97  
  98              // Check if the user has already marked themselves as complete
  99              if ($completion->is_complete()) {
 100                  throw new \moodle_exception('useralreadymarkedcomplete', 'completion');
 101              }
 102  
 103              $completion->mark_complete();
 104  
 105              redirect($CFG->wwwroot.'/course/view.php?id='.$courseid);
 106              return;
 107          }
 108  
 109          $strconfirm = get_string('confirmselfcompletion', 'completion');
 110          $PAGE->set_title($strconfirm);
 111          $PAGE->set_heading($course->fullname);
 112          $PAGE->navbar->add($strconfirm);
 113          echo $OUTPUT->header();
 114          $buttoncontinue = new single_button(new moodle_url('/course/togglecompletion.php', array('course'=>$courseid, 'confirm'=>1, 'sesskey'=>sesskey())), get_string('yes'), 'post');
 115          $buttoncancel   = new single_button(new moodle_url('/course/view.php', array('id'=>$courseid)), get_string('no'), 'get');
 116          echo $OUTPUT->confirm($strconfirm, $buttoncontinue, $buttoncancel);
 117          echo $OUTPUT->footer();
 118          exit;
 119      }
 120  }
 121  
 122  $targetstate = required_param('completionstate', PARAM_INT);
 123  
 124  $PAGE->set_url('/course/togglecompletion.php', array('id'=>$cmid, 'completionstate'=>$targetstate));
 125  
 126  switch($targetstate) {
 127      case COMPLETION_COMPLETE:
 128      case COMPLETION_INCOMPLETE:
 129          break;
 130      default:
 131          throw new \moodle_exception('unsupportedstate');
 132  }
 133  
 134  // Get course-modules entry
 135  $cm = get_coursemodule_from_id(null, $cmid, null, true, MUST_EXIST);
 136  $course = $DB->get_record('course', array('id'=>$cm->course), '*', MUST_EXIST);
 137  
 138  // Check user is logged in
 139  require_login($course, false, $cm);
 140  require_capability('moodle/course:togglecompletion', context_module::instance($cmid));
 141  
 142  if (isguestuser() or !confirm_sesskey()) {
 143      throw new \moodle_exception('error');
 144  }
 145  
 146  // Set up completion object and check it is enabled.
 147  $completion = new completion_info($course);
 148  if (!$completion->is_enabled()) {
 149      throw new moodle_exception('completionnotenabled', 'completion');
 150  }
 151  
 152  // NOTE: All users are allowed to toggle their completion state, including
 153  // users for whom completion information is not directly tracked. (I.e. even
 154  // if you are a teacher, or admin who is not enrolled, you can still toggle
 155  // your own completion state. You just don't appear on the reports.)
 156  
 157  // Check completion state is manual
 158  if($cm->completion != COMPLETION_TRACKING_MANUAL) {
 159      throw new moodle_exception('cannotmanualctrack');
 160  }
 161  
 162  $completion->update_state($cm, $targetstate);
 163  
 164  // In case of use in other areas of code we allow a 'backto' parameter, otherwise go back to course page.
 165  if ($backto = optional_param('backto', null, PARAM_URL)) {
 166      redirect($backto);
 167  } else {
 168      redirect(course_get_url($course, $cm->sectionnum));
 169  }
 170