[Summary view] [Print] [Text view]

   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   * Edit the grade options for an individual grade category
  19   *
  20   * @package   core_grades
  21   * @copyright 2007 Petr Skoda
  22   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  require_once '../../../config.php';
  26  require_once $CFG->dirroot.'/grade/lib.php';
  27  require_once $CFG->dirroot.'/grade/report/lib.php';
  28  require_once  'category_form.php';
  29  
  30  $courseid = required_param('courseid', PARAM_INT);
  31  $id       = optional_param('id', 0, PARAM_INT); // grade_category->id
  32  
  33  $url = new moodle_url('/grade/edit/tree/category.php', array('courseid'=>$courseid));
  34  if ($id !== 0) {
  35      $url->param('id', $id);
  36  }
  37  $PAGE->set_url($url);
  38  $PAGE->set_pagelayout('admin');
  39  navigation_node::override_active_url(new moodle_url('/grade/edit/tree/index.php',
  40      array('id'=>$courseid)));
  41  
  42  if (!$course = $DB->get_record('course', array('id' => $courseid))) {
  43      print_error('nocourseid');
  44  }
  45  
  46  require_login($course);
  47  $context = context_course::instance($course->id);
  48  require_capability('moodle/grade:manage', $context);
  49  
  50  // default return url
  51  $gpr = new grade_plugin_return();
  52  $returnurl = $gpr->get_return_url('index.php?id='.$course->id);
  53  
  54  
  55  $heading = get_string('categoryedit', 'grades');
  56  
  57  if ($id) {
  58      if (!$grade_category = grade_category::fetch(array('id'=>$id, 'courseid'=>$course->id))) {
  59          print_error('invalidcategory');
  60      }
  61      $grade_category->apply_forced_settings();
  62      $category = $grade_category->get_record_data();
  63      // set parent
  64      $category->parentcategory = $grade_category->parent;
  65      $grade_item = $grade_category->load_grade_item();
  66      // nomalize coef values if needed
  67      $parent_category = $grade_category->get_parent_category();
  68  
  69      foreach ($grade_item->get_record_data() as $key => $value) {
  70          $category->{"grade_item_$key"} = $value;
  71      }
  72  
  73      $decimalpoints = $grade_item->get_decimals();
  74  
  75      $category->grade_item_grademax   = format_float($category->grade_item_grademax, $decimalpoints);
  76      $category->grade_item_grademin   = format_float($category->grade_item_grademin, $decimalpoints);
  77      $category->grade_item_gradepass  = format_float($category->grade_item_gradepass, $decimalpoints);
  78      $category->grade_item_multfactor = format_float($category->grade_item_multfactor, 4);
  79      $category->grade_item_plusfactor = format_float($category->grade_item_plusfactor, 4);
  80      $category->grade_item_aggregationcoef2 = format_float($category->grade_item_aggregationcoef2 * 100.0, 4);
  81  
  82      if (!$parent_category) {
  83          // keep as is
  84      } else if ($parent_category->aggregation == GRADE_AGGREGATE_SUM or $parent_category->aggregation == GRADE_AGGREGATE_WEIGHTED_MEAN2) {
  85          $category->grade_item_aggregationcoef = $category->grade_item_aggregationcoef == 0 ? 0 : 1;
  86      } else {
  87          $category->grade_item_aggregationcoef = format_float($category->grade_item_aggregationcoef, 4);
  88      }
  89  
  90      if ($category->aggregation == GRADE_AGGREGATE_SUM) {
  91          // Input fields for grademin and grademax are disabled for the "Natural" category,
  92          // this means they will be ignored if user does not change aggregation method.
  93          // But if user does change aggregation method the default values should be used.
  94          $category->grademax = 100;
  95          $category->grade_item_grademax = 100;
  96          $category->grademin = 0;
  97          $category->grade_item_grademin = 0;
  98      }
  99  
 100  } else {
 101      $heading = get_string('newcategory', 'grades');
 102      $grade_category = new grade_category(array('courseid'=>$courseid), false);
 103      $grade_category->apply_default_settings();
 104      $grade_category->apply_forced_settings();
 105  
 106      $category = $grade_category->get_record_data();
 107  
 108      $grade_item = new grade_item(array('courseid'=>$courseid, 'itemtype'=>'manual'), false);
 109      foreach ($grade_item->get_record_data() as $key => $value) {
 110          $category->{"grade_item_$key"} = $value;
 111      }
 112  }
 113  
 114  $mform = new edit_category_form(null, array('current'=>$category, 'gpr'=>$gpr));
 115  
 116  if ($mform->is_cancelled()) {
 117      redirect($returnurl);
 118  
 119  } else if ($data = $mform->get_data(false)) {
 120      // If no fullname is entered for a course category, put ? in the DB
 121      if (!isset($data->fullname) || $data->fullname == '') {
 122          $data->fullname = '?';
 123      }
 124  
 125      if (!isset($data->aggregateonlygraded)) {
 126          $data->aggregateonlygraded = 0;
 127      }
 128      if (!isset($data->aggregateoutcomes)) {
 129          $data->aggregateoutcomes = 0;
 130      }
 131      grade_category::set_properties($grade_category, $data);
 132  
 133      /// CATEGORY
 134      if (empty($grade_category->id)) {
 135          $grade_category->insert();
 136  
 137      } else {
 138          $grade_category->update();
 139      }
 140  
 141      /// GRADE ITEM
 142      // grade item data saved with prefix "grade_item_"
 143      $itemdata = new stdClass();
 144      foreach ($data as $k => $v) {
 145          if (preg_match('/grade_item_(.*)/', $k, $matches)) {
 146              $itemdata->{$matches[1]} = $v;
 147          }
 148      }
 149  
 150      if (!isset($itemdata->aggregationcoef)) {
 151          $itemdata->aggregationcoef = 0;
 152      }
 153  
 154      if (!isset($itemdata->gradepass) || $itemdata->gradepass == '') {
 155          $itemdata->gradepass = 0;
 156      }
 157  
 158      if (!isset($itemdata->grademax) || $itemdata->grademax == '') {
 159          $itemdata->grademax = 0;
 160      }
 161  
 162      if (!isset($itemdata->grademin) || $itemdata->grademin == '') {
 163          $itemdata->grademin = 0;
 164      }
 165  
 166      $hidden      = empty($itemdata->hidden) ? 0: $itemdata->hidden;
 167      $hiddenuntil = empty($itemdata->hiddenuntil) ? 0: $itemdata->hiddenuntil;
 168      unset($itemdata->hidden);
 169      unset($itemdata->hiddenuntil);
 170  
 171      $locked   = empty($itemdata->locked) ? 0: $itemdata->locked;
 172      $locktime = empty($itemdata->locktime) ? 0: $itemdata->locktime;
 173      unset($itemdata->locked);
 174      unset($itemdata->locktime);
 175  
 176      $convert = array('grademax', 'grademin', 'gradepass', 'multfactor', 'plusfactor', 'aggregationcoef', 'aggregationcoef2');
 177      foreach ($convert as $param) {
 178          if (property_exists($itemdata, $param)) {
 179              $itemdata->$param = unformat_float($itemdata->$param);
 180          }
 181      }
 182      if (isset($itemdata->aggregationcoef2)) {
 183          $itemdata->aggregationcoef2 = $itemdata->aggregationcoef2 / 100.0;
 184      }
 185  
 186      // When creating a new category, a number of grade item fields are filled out automatically, and are required.
 187      // If the user leaves these fields empty during creation of a category, we let the default values take effect
 188      // Otherwise, we let the user-entered grade item values take effect
 189      $grade_item = $grade_category->load_grade_item();
 190      $grade_item_copy = fullclone($grade_item);
 191      grade_item::set_properties($grade_item, $itemdata);
 192  
 193      if (empty($grade_item->id)) {
 194          $grade_item->id = $grade_item_copy->id;
 195      }
 196      if (empty($grade_item->grademax) && $grade_item->grademax != '0') {
 197          $grade_item->grademax = $grade_item_copy->grademax;
 198      }
 199      if (empty($grade_item->grademin) && $grade_item->grademin != '0') {
 200          $grade_item->grademin = $grade_item_copy->grademin;
 201      }
 202      if (empty($grade_item->gradepass) && $grade_item->gradepass != '0') {
 203          $grade_item->gradepass = $grade_item_copy->gradepass;
 204      }
 205      if (empty($grade_item->aggregationcoef) && $grade_item->aggregationcoef != '0') {
 206          $grade_item->aggregationcoef = $grade_item_copy->aggregationcoef;
 207      }
 208  
 209      // Handle null decimals value - must be done before update!
 210      if (!property_exists($itemdata, 'decimals') or $itemdata->decimals < 0) {
 211          $grade_item->decimals = null;
 212      }
 213  
 214      // Change weightoverride flag. Check if the value is set, because it is not when the checkbox is not ticked.
 215      $itemdata->weightoverride = isset($itemdata->weightoverride) ? $itemdata->weightoverride : 0;
 216      if ($grade_item->weightoverride != $itemdata->weightoverride && $grade_category->aggregation == GRADE_AGGREGATE_SUM) {
 217          // If we are using natural weight and the weight has been un-overriden, force parent category to recalculate weights.
 218          $grade_category->force_regrading();
 219      }
 220      $grade_item->weightoverride = $itemdata->weightoverride;
 221  
 222      $grade_item->outcomeid = null;
 223  
 224      // update hiding flag
 225      if ($hiddenuntil) {
 226          $grade_item->set_hidden($hiddenuntil, false);
 227      } else {
 228          $grade_item->set_hidden($hidden, false);
 229      }
 230  
 231      $grade_item->set_locktime($locktime); // locktime first - it might be removed when unlocking
 232      $grade_item->set_locked($locked, false, true);
 233  
 234      $grade_item->update(); // We don't need to insert it, it's already created when the category is created
 235  
 236      // set parent if needed
 237      if (isset($data->parentcategory)) {
 238          $grade_category->set_parent($data->parentcategory, 'gradebook');
 239      }
 240  
 241      redirect($returnurl);
 242  }
 243  
 244  $PAGE->navbar->add($heading);
 245  print_grade_page_head($courseid, 'settings', null, $heading, false, false, false);
 246  
 247  $mform->display();
 248  
 249  echo $OUTPUT->footer();
 250  die;