/grade/grading/form/rubric/edit_form.php
PHP | 217 lines | 115 code | 20 blank | 82 comment | 26 complexity | 505222a9876c0dfc342a068d8e15c6d3 MD5 | raw file
Possible License(s): MPL-2.0-no-copyleft-exception, LGPL-3.0, GPL-3.0, LGPL-2.1, Apache-2.0, BSD-3-Clause, AGPL-3.0
- <?php
- // This file is part of Moodle - http://moodle.org/
- //
- // Moodle is free software: you can redistribute it and/or modify
- // it under the terms of the GNU General Public License as published by
- // the Free Software Foundation, either version 3 of the License, or
- // (at your option) any later version.
- //
- // Moodle is distributed in the hope that it will be useful,
- // but WITHOUT ANY WARRANTY; without even the implied warranty of
- // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- // GNU General Public License for more details.
- //
- // You should have received a copy of the GNU General Public License
- // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
- /**
- * The form used at the rubric editor page is defined here
- *
- * @package gradingform_rubric
- * @copyright 2011 Marina Glancy <marina@moodle.com>
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- defined('MOODLE_INTERNAL') || die();
- require_once($CFG->dirroot.'/lib/formslib.php');
- require_once(dirname(__FILE__).'/rubriceditor.php');
- MoodleQuickForm::registerElementType('rubriceditor', $CFG->dirroot.'/grade/grading/form/rubric/rubriceditor.php', 'MoodleQuickForm_rubriceditor');
- /**
- * Defines the rubric edit form
- *
- * @package gradingform_rubric
- * @copyright 2011 Marina Glancy <marina@moodle.com>
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- class gradingform_rubric_editrubric extends moodleform {
- /**
- * Form element definition
- */
- public function definition() {
- $form = $this->_form;
- $form->addElement('hidden', 'areaid');
- $form->setType('areaid', PARAM_INT);
- $form->addElement('hidden', 'returnurl');
- $form->setType('returnurl', PARAM_LOCALURL);
- // name
- $form->addElement('text', 'name', get_string('name', 'gradingform_rubric'), array('size'=>52));
- $form->addRule('name', get_string('required'), 'required');
- $form->setType('name', PARAM_TEXT);
- // description
- $options = gradingform_rubric_controller::description_form_field_options($this->_customdata['context']);
- $form->addElement('editor', 'description_editor', get_string('description', 'gradingform_rubric'), null, $options);
- $form->setType('description_editor', PARAM_RAW);
- // rubric completion status
- $choices = array();
- $choices[gradingform_controller::DEFINITION_STATUS_DRAFT] = html_writer::tag('span', get_string('statusdraft', 'core_grading'), array('class' => 'status draft'));
- $choices[gradingform_controller::DEFINITION_STATUS_READY] = html_writer::tag('span', get_string('statusready', 'core_grading'), array('class' => 'status ready'));
- $form->addElement('select', 'status', get_string('rubricstatus', 'gradingform_rubric'), $choices)->freeze();
- // rubric editor
- $element = $form->addElement('rubriceditor', 'rubric', get_string('rubric', 'gradingform_rubric'));
- $form->setType('rubric', PARAM_RAW);
- $buttonarray = array();
- $buttonarray[] = &$form->createElement('submit', 'saverubric', get_string('saverubric', 'gradingform_rubric'));
- if ($this->_customdata['allowdraft']) {
- $buttonarray[] = &$form->createElement('submit', 'saverubricdraft', get_string('saverubricdraft', 'gradingform_rubric'));
- }
- $editbutton = &$form->createElement('submit', 'editrubric', ' ');
- $editbutton->freeze();
- $buttonarray[] = &$editbutton;
- $buttonarray[] = &$form->createElement('cancel');
- $form->addGroup($buttonarray, 'buttonar', '', array(' '), false);
- $form->closeHeaderBefore('buttonar');
- }
- /**
- * Setup the form depending on current values. This method is called after definition(),
- * data submission and set_data().
- * All form setup that is dependent on form values should go in here.
- *
- * We remove the element status if there is no current status (i.e. rubric is only being created)
- * so the users do not get confused
- */
- public function definition_after_data() {
- $form = $this->_form;
- $el = $form->getElement('status');
- if (!$el->getValue()) {
- $form->removeElement('status');
- } else {
- $vals = array_values($el->getValue());
- if ($vals[0] == gradingform_controller::DEFINITION_STATUS_READY) {
- $this->findButton('saverubric')->setValue(get_string('save', 'gradingform_rubric'));
- }
- }
- }
- /**
- * Form vlidation.
- * If there are errors return array of errors ("fieldname"=>"error message"),
- * otherwise true if ok.
- *
- * @param array $data array of ("fieldname"=>value) of submitted data
- * @param array $files array of uploaded files "element_name"=>tmp_file_path
- * @return array of "element_name"=>"error_description" if there are errors,
- * or an empty array if everything is OK (true allowed for backwards compatibility too).
- */
- public function validation($data, $files) {
- $err = parent::validation($data, $files);
- $err = array();
- $form = $this->_form;
- $rubricel = $form->getElement('rubric');
- if ($rubricel->non_js_button_pressed($data['rubric'])) {
- // if JS is disabled and button such as 'Add criterion' is pressed - prevent from submit
- $err['rubricdummy'] = 1;
- } else if (isset($data['editrubric'])) {
- // continue editing
- $err['rubricdummy'] = 1;
- } else if (isset($data['saverubric']) && $data['saverubric']) {
- // If user attempts to make rubric active - it needs to be validated
- if ($rubricel->validate($data['rubric']) !== false) {
- $err['rubricdummy'] = 1;
- }
- }
- return $err;
- }
- /**
- * Return submitted data if properly submitted or returns NULL if validation fails or
- * if there is no submitted data.
- *
- * @return object submitted data; NULL if not valid or not submitted or cancelled
- */
- public function get_data() {
- $data = parent::get_data();
- if (!empty($data->saverubric)) {
- $data->status = gradingform_controller::DEFINITION_STATUS_READY;
- } else if (!empty($data->saverubricdraft)) {
- $data->status = gradingform_controller::DEFINITION_STATUS_DRAFT;
- }
- return $data;
- }
- /**
- * Check if there are changes in the rubric and it is needed to ask user whether to
- * mark the current grades for re-grading. User may confirm re-grading and continue,
- * return to editing or cancel the changes
- *
- * @param gradingform_rubric_controller $controller
- */
- public function need_confirm_regrading($controller) {
- $data = $this->get_data();
- if (isset($data->rubric['regrade'])) {
- // we have already displayed the confirmation on the previous step
- return false;
- }
- if (!isset($data->saverubric) || !$data->saverubric) {
- // we only need confirmation when button 'Save rubric' is pressed
- return false;
- }
- if (!$controller->has_active_instances()) {
- // nothing to re-grade, confirmation not needed
- return false;
- }
- $changelevel = $controller->update_or_check_rubric($data);
- if ($changelevel == 0) {
- // no changes in the rubric, no confirmation needed
- return false;
- }
- // freeze form elements and pass the values in hidden fields
- // TODO MDL-29421 description_editor does not freeze the normal way, uncomment below when fixed
- $form = $this->_form;
- foreach (array('rubric', 'name'/*, 'description_editor'*/) as $fieldname) {
- $el =& $form->getElement($fieldname);
- $el->freeze();
- $el->setPersistantFreeze(true);
- if ($fieldname == 'rubric') {
- $el->add_regrade_confirmation($changelevel);
- }
- }
- // replace button text 'saverubric' and unfreeze 'Back to edit' button
- $this->findButton('saverubric')->setValue(get_string('continue'));
- $el =& $this->findButton('editrubric');
- $el->setValue(get_string('backtoediting', 'gradingform_rubric'));
- $el->unfreeze();
- return true;
- }
- /**
- * Returns a form element (submit button) with the name $elementname
- *
- * @param string $elementname
- * @return HTML_QuickForm_element
- */
- protected function &findButton($elementname) {
- $form = $this->_form;
- $buttonar =& $form->getElement('buttonar');
- $elements =& $buttonar->getElements();
- foreach ($elements as $el) {
- if ($el->getName() == $elementname) {
- return $el;
- }
- }
- return null;
- }
- }