[Summary view] [Print] [Text view]

   1  <?php  //$Id: grade_form.php,v 1.10.2.3 2008/03/03 10:21:41 nicolasconnault Exp $
   2  
   3  ///////////////////////////////////////////////////////////////////////////
   4  //                                                                       //
   5  // NOTICE OF COPYRIGHT                                                   //
   6  //                                                                       //
   7  // Moodle - Modular Object-Oriented Dynamic Learning Environment         //
   8  //          http://moodle.com                                            //
   9  //                                                                       //
  10  // Copyright (C) 1999 onwards  Martin Dougiamas  http://moodle.com       //
  11  //                                                                       //
  12  // This program is free software; you can redistribute it and/or modify  //
  13  // it under the terms of the GNU General Public License as published by  //
  14  // the Free Software Foundation; either version 2 of the License, or     //
  15  // (at your option) any later version.                                   //
  16  //                                                                       //
  17  // This program is distributed in the hope that it will be useful,       //
  18  // but WITHOUT ANY WARRANTY; without even the implied warranty of        //
  19  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         //
  20  // GNU General Public License for more details:                          //
  21  //                                                                       //
  22  //          http://www.gnu.org/copyleft/gpl.html                         //
  23  //                                                                       //
  24  ///////////////////////////////////////////////////////////////////////////
  25  
  26  require_once $CFG->libdir.'/formslib.php';
  27  
  28  class edit_grade_form extends moodleform {
  29  
  30      function definition() {
  31          global $CFG, $COURSE;
  32  
  33          $mform =& $this->_form;
  34  
  35          $grade_item = $this->_customdata['grade_item'];
  36          $gpr        = $this->_customdata['gpr'];
  37  
  38          /// information fields
  39          $mform->addElement('static', 'user', get_string('user'));
  40          $mform->addElement('static', 'itemname', get_string('itemname', 'grades'));
  41  
  42          $mform->addElement('checkbox', 'overridden', get_string('overridden', 'grades'));
  43          $mform->setHelpButton('overridden', array('overridden', get_string('overridden', 'grades'), 'grade'));
  44  
  45          /// actual grade - numeric or scale
  46          if ($grade_item->gradetype == GRADE_TYPE_VALUE) {
  47              // numeric grade
  48              $mform->addElement('text', 'finalgrade', get_string('finalgrade', 'grades'));
  49              $mform->setHelpButton('finalgrade', array('finalgrade', get_string('finalgrade', 'grades'), 'grade'));
  50              $mform->disabledIf('finalgrade', 'overridden', 'notchecked');
  51  
  52          } else if ($grade_item->gradetype == GRADE_TYPE_SCALE) {
  53              // scale grade
  54              $scaleopt = array();
  55  
  56              if (empty($grade_item->outcomeid)) {
  57                  $scaleopt[-1] = get_string('nograde');
  58              } else {
  59                  $scaleopt[-1] = get_string('nooutcome', 'grades');
  60              }
  61  
  62              $i = 1;
  63              if ($scale = get_record('scale', 'id', $grade_item->scaleid)) {
  64                  foreach (split(",", $scale->scale) as $option) {
  65                      $scaleopt[$i] = $option;
  66                      $i++;
  67                  }
  68              }
  69  
  70              $mform->addElement('select', 'finalgrade', get_string('finalgrade', 'grades'), $scaleopt);
  71              $mform->setHelpButton('finalgrade', array('finalgrade', get_string('finalgrade', 'grades'), 'grade'));
  72              $mform->disabledIf('finalgrade', 'overridden', 'notchecked');
  73          }
  74  
  75          $mform->addElement('advcheckbox', 'excluded', get_string('excluded', 'grades'));
  76          $mform->setHelpButton('excluded', array('excluded', get_string('excluded', 'grades'), 'grade'));
  77  
  78          /// hiding
  79          /// advcheckbox is not compatible with disabledIf !!
  80          $mform->addElement('checkbox', 'hidden', get_string('hidden', 'grades'));
  81          $mform->setHelpButton('hidden', array('hidden', get_string('hidden', 'grades'), 'grade'));
  82          $mform->addElement('date_time_selector', 'hiddenuntil', get_string('hiddenuntil', 'grades'), array('optional'=>true));
  83          $mform->setHelpButton('hiddenuntil', array('hiddenuntil', get_string('hiddenuntil', 'grades'), 'grade'));
  84          $mform->disabledIf('hidden', 'hiddenuntil[off]', 'notchecked');
  85  
  86          /// locking
  87          $mform->addElement('advcheckbox', 'locked', get_string('locked', 'grades'));
  88          $mform->setHelpButton('locked', array('locked', get_string('locked', 'grades'), 'grade'));
  89          $mform->addElement('date_time_selector', 'locktime', get_string('locktime', 'grades'), array('optional'=>true));
  90          $mform->setHelpButton('locktime', array('lockedafter', get_string('locktime', 'grades'), 'grade'));
  91          $mform->disabledIf('locktime', 'gradetype', 'eq', GRADE_TYPE_NONE);
  92  
  93          // Feedback format is automatically converted to html if user has enabled editor
  94          $mform->addElement('htmleditor', 'feedback', get_string('feedback', 'grades'),
  95              array('rows'=>'15', 'course'=>$COURSE->id, 'cols'=>'45'));
  96          $mform->setHelpButton('feedback', array('feedback', get_string('feedback', 'grades'), 'grade'));
  97          $mform->setType('text', PARAM_RAW); // to be cleaned before display, no XSS risk
  98          $mform->addElement('format', 'feedbackformat', get_string('format'));
  99          $mform->setHelpButton('feedbackformat', array('textformat', get_string('helpformatting')));
 100          //TODO: unfortunately we can not disable html editor for external grades when overridden off :-(
 101  
 102          // hidden params
 103          $mform->addElement('hidden', 'oldgrade');
 104          $mform->addElement('hidden', 'oldfeedback');
 105  
 106          $mform->addElement('hidden', 'id', 0);
 107          $mform->setType('id', PARAM_INT);
 108  
 109          $mform->addElement('hidden', 'itemid', 0);
 110          $mform->setType('itemid', PARAM_INT);
 111  
 112          $mform->addElement('hidden', 'userid', 0);
 113          $mform->setType('userid', PARAM_INT);
 114  
 115          $mform->addElement('hidden', 'courseid', $COURSE->id);
 116          $mform->setType('courseid', PARAM_INT);
 117  
 118  /// add return tracking info
 119          $gpr->add_mform_elements($mform);
 120  
 121  //-------------------------------------------------------------------------------
 122          // buttons
 123          $this->add_action_buttons();
 124      }
 125  
 126      function definition_after_data() {
 127          global $CFG, $COURSE;
 128  
 129          $context = get_context_instance(CONTEXT_COURSE, $COURSE->id);
 130  
 131          $mform =& $this->_form;
 132          $grade_item = $this->_customdata['grade_item'];
 133  
 134          // fill in user name if user still exists
 135          $userid = $mform->getElementValue('userid');
 136          if ($user = get_record('user', 'id', $userid)) {
 137              $username = '<a href="'.$CFG->wwwroot.'/user/view.php?id='.$userid.'">'.fullname($user).'</a>';
 138              $user_el =& $mform->getElement('user');
 139              $user_el->setValue($username);
 140          }
 141  
 142          // add activity name + link
 143          if ($grade_item->itemtype == 'mod') {
 144              $cm = get_coursemodule_from_instance($grade_item->itemmodule, $grade_item->iteminstance, $grade_item->courseid);
 145              $itemname = '<a href="'.$CFG->wwwroot.'/mod/'.$grade_item->itemmodule.'/view.php?id='.$cm->id.'">'.$grade_item->get_name().'</a>';
 146          } else {
 147              $itemname = $grade_item->get_name();
 148          }
 149          $itemname_el =& $mform->getElement('itemname');
 150          $itemname_el->setValue($itemname);
 151  
 152          // access control - disable not allowed elements
 153          if (!has_capability('moodle/grade:manage', $context)) {
 154              $mform->hardFreeze('excluded');
 155          }
 156  
 157          if (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:hide', $context)) {
 158              $mform->hardFreeze('hidden');
 159              $mform->hardFreeze('hiddenuntil');
 160          }
 161  
 162          $old_grade_grade = new grade_grade(array('itemid'=>$grade_item->id, 'userid'=>$userid));
 163  
 164          if (!$grade_item->is_overridable_item()) {
 165              $mform->removeElement('overridden');
 166          }
 167  
 168          if ($grade_item->is_hidden()) {
 169              $mform->hardFreeze('hidden');
 170          }
 171  
 172          if ($old_grade_grade->is_locked()) {
 173              if ($grade_item->is_locked()) {
 174                  $mform->hardFreeze('locked');
 175                  $mform->hardFreeze('locktime');
 176              }
 177  
 178              $mform->hardFreeze('overridden');
 179              $mform->hardFreeze('finalgrade');
 180              $mform->hardFreeze('feedback');
 181  
 182          } else {
 183              if (empty($old_grade_grade->id)) {
 184                  $old_grade_grade->locked = $grade_item->locked;
 185                  $old_grade_grade->locktime = $grade_item->locktime;
 186              }
 187  
 188              if (($old_grade_grade->locked or $old_grade_grade->locktime)
 189                and (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:unlock', $context))) {
 190                  $mform->hardFreeze('locked');
 191                  $mform->hardFreeze('locktime');
 192  
 193              } else if ((!$old_grade_grade->locked and !$old_grade_grade->locktime)
 194                and (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:lock', $context))) {
 195                  $mform->hardFreeze('locked');
 196                  $mform->hardFreeze('locktime');
 197              }
 198          }
 199      }
 200  }
 201  
 202  ?>