PageRenderTime 40ms CodeModel.GetById 12ms RepoModel.GetById 0ms app.codeStats 0ms

/grade/edit/tree/grade_form.php

http://github.com/moodle/moodle
PHP | 212 lines | 133 code | 43 blank | 36 comment | 28 complexity | 93f951dfb68711eeef1c39144042feb8 MD5 | raw file
Possible License(s): MIT, AGPL-3.0, MPL-2.0-no-copyleft-exception, LGPL-3.0, GPL-3.0, Apache-2.0, LGPL-2.1, BSD-3-Clause
  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. * A moodleform to allow the editing of a user's grade for a particular activity
  18. *
  19. * @package core_grades
  20. * @copyright 2007 Petr Skoda
  21. * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  22. */
  23. if (!defined('MOODLE_INTERNAL')) {
  24. die('Direct access to this script is forbidden.'); /// It must be included from a Moodle page
  25. }
  26. require_once $CFG->libdir.'/formslib.php';
  27. class edit_grade_form extends moodleform {
  28. function definition() {
  29. global $CFG, $COURSE, $DB;
  30. $mform =& $this->_form;
  31. $grade_item = $this->_customdata['grade_item'];
  32. $gpr = $this->_customdata['gpr'];
  33. if ($grade_item->is_course_item()) {
  34. $grade_category = null;
  35. } else if ($grade_item->is_category_item()) {
  36. $grade_category = $grade_item->get_item_category();
  37. $grade_category = $grade_category->get_parent_category();
  38. } else {
  39. $grade_category = $grade_item->get_parent_category();
  40. }
  41. /// information fields
  42. $mform->addElement('static', 'user', get_string('user'));
  43. $mform->addElement('static', 'itemname', get_string('itemname', 'grades'));
  44. $mform->addElement('checkbox', 'overridden', get_string('overridden', 'grades'));
  45. $mform->addHelpButton('overridden', 'overridden', 'grades');
  46. /// actual grade - numeric or scale
  47. if ($grade_item->gradetype == GRADE_TYPE_VALUE) {
  48. // numeric grade
  49. $mform->addElement('text', 'finalgrade', get_string('finalgrade', 'grades'));
  50. $mform->setType('finalgrade', PARAM_RAW);
  51. $mform->addHelpButton('finalgrade', 'finalgrade', 'grades');
  52. $mform->disabledIf('finalgrade', 'overridden', 'notchecked');
  53. } else if ($grade_item->gradetype == GRADE_TYPE_SCALE) {
  54. // scale grade
  55. $scaleopt = array();
  56. if (empty($grade_item->outcomeid)) {
  57. $scaleopt[-1] = get_string('nograde');
  58. } else {
  59. $scaleopt[-1] = get_string('nooutcome', 'grades');
  60. }
  61. $i = 1;
  62. if ($scale = $DB->get_record('scale', array('id' => $grade_item->scaleid))) {
  63. foreach (explode(",", $scale->scale) as $option) {
  64. $scaleopt[$i] = $option;
  65. $i++;
  66. }
  67. }
  68. $mform->addElement('select', 'finalgrade', get_string('finalgrade', 'grades'), $scaleopt);
  69. $mform->addHelpButton('finalgrade', 'finalgrade', 'grades');
  70. $mform->disabledIf('finalgrade', 'overridden', 'notchecked');
  71. }
  72. $mform->addElement('advcheckbox', 'excluded', get_string('excluded', 'grades'));
  73. $mform->addHelpButton('excluded', 'excluded', 'grades');
  74. /// hiding
  75. /// advcheckbox is not compatible with disabledIf !!
  76. $mform->addElement('checkbox', 'hidden', get_string('hidden', 'grades'));
  77. $mform->addHelpButton('hidden', 'hidden', 'grades');
  78. $mform->addElement('date_time_selector', 'hiddenuntil', get_string('hiddenuntil', 'grades'), array('optional'=>true));
  79. $mform->disabledIf('hidden', 'hiddenuntil[off]', 'notchecked');
  80. /// locking
  81. $mform->addElement('advcheckbox', 'locked', get_string('locked', 'grades'));
  82. $mform->addHelpButton('locked', 'locked', 'grades');
  83. $mform->addElement('date_time_selector', 'locktime', get_string('locktime', 'grades'), array('optional'=>true));
  84. $mform->disabledIf('locktime', 'gradetype', 'eq', GRADE_TYPE_NONE);
  85. // Feedback format is automatically converted to html if user has enabled editor
  86. $feedbackoptions = array('maxfiles'=>0, 'maxbytes'=>0); //TODO: no files here for now, if ever gets implemented use component 'grade' and filearea 'feedback'
  87. $mform->addElement('editor', 'feedback', get_string('feedback', 'grades'), null, $feedbackoptions);
  88. $mform->addHelpButton('feedback', 'feedback', 'grades');
  89. $mform->setType('text', PARAM_RAW); // to be cleaned before display, no XSS risk
  90. // hidden params
  91. $mform->addElement('hidden', 'oldgrade');
  92. $mform->setType('oldgrade', PARAM_RAW);
  93. $mform->addElement('hidden', 'oldfeedback');
  94. $mform->setType('oldfeedback', PARAM_RAW);
  95. $mform->addElement('hidden', 'id', 0);
  96. $mform->setType('id', PARAM_INT);
  97. $mform->addElement('hidden', 'itemid', 0);
  98. $mform->setType('itemid', PARAM_INT);
  99. $mform->addElement('hidden', 'userid', 0);
  100. $mform->setType('userid', PARAM_INT);
  101. $mform->addElement('hidden', 'courseid', $COURSE->id);
  102. $mform->setType('courseid', PARAM_INT);
  103. /// add return tracking info
  104. $gpr->add_mform_elements($mform);
  105. //-------------------------------------------------------------------------------
  106. // buttons
  107. $this->add_action_buttons();
  108. }
  109. function definition_after_data() {
  110. global $CFG, $COURSE, $DB;
  111. $context = context_course::instance($COURSE->id);
  112. $mform =& $this->_form;
  113. $grade_item = $this->_customdata['grade_item'];
  114. // fill in user name if user still exists
  115. $userid = $mform->getElementValue('userid');
  116. if ($user = $DB->get_record('user', array('id' => $userid))) {
  117. $username = '<a href="'.$CFG->wwwroot.'/user/view.php?id='.$userid.'">'.fullname($user).'</a>';
  118. $user_el =& $mform->getElement('user');
  119. $user_el->setValue($username);
  120. }
  121. // add activity name + link
  122. if ($grade_item->itemtype == 'mod') {
  123. $cm = get_coursemodule_from_instance($grade_item->itemmodule, $grade_item->iteminstance, $grade_item->courseid);
  124. $itemname = '<a href="'.$CFG->wwwroot.'/mod/'.$grade_item->itemmodule.'/view.php?id='.$cm->id.'">'.$grade_item->get_name().'</a>';
  125. } else {
  126. $itemname = $grade_item->get_name();
  127. }
  128. $itemname_el =& $mform->getElement('itemname');
  129. $itemname_el->setValue($itemname);
  130. // access control - disable not allowed elements
  131. if (!has_capability('moodle/grade:manage', $context)) {
  132. $mform->hardFreeze('excluded');
  133. }
  134. if (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:hide', $context)) {
  135. $mform->hardFreeze('hidden');
  136. $mform->hardFreeze('hiddenuntil');
  137. }
  138. $old_grade_grade = new grade_grade(array('itemid'=>$grade_item->id, 'userid'=>$userid));
  139. if (!$grade_item->is_overridable_item()) {
  140. $mform->removeElement('overridden');
  141. }
  142. if ($grade_item->is_hidden()) {
  143. $mform->hardFreeze('hidden');
  144. }
  145. if ($old_grade_grade->is_locked()) {
  146. if ($grade_item->is_locked()) {
  147. $mform->hardFreeze('locked');
  148. $mform->hardFreeze('locktime');
  149. }
  150. $mform->hardFreeze('overridden');
  151. $mform->hardFreeze('finalgrade');
  152. $mform->hardFreeze('feedback');
  153. } else {
  154. if (empty($old_grade_grade->id)) {
  155. $old_grade_grade->locked = $grade_item->locked;
  156. $old_grade_grade->locktime = $grade_item->locktime;
  157. }
  158. if (($old_grade_grade->locked or $old_grade_grade->locktime)
  159. and (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:unlock', $context))) {
  160. $mform->hardFreeze('locked');
  161. $mform->hardFreeze('locktime');
  162. } else if ((!$old_grade_grade->locked and !$old_grade_grade->locktime)
  163. and (!has_capability('moodle/grade:manage', $context) and !has_capability('moodle/grade:lock', $context))) {
  164. $mform->hardFreeze('locked');
  165. $mform->hardFreeze('locktime');
  166. }
  167. }
  168. }
  169. }