Russell Smith
1fcf0ca8a5
dirname() is a slow function compared with __DIR__ and using '/../'. Moodle has a large number of legacy files that are included each time a page loads and is not able to use an autoloader as it is functional code. This allows those required includes to perform as best as possible in this situation.
218 lines
8.8 KiB
PHP
218 lines
8.8 KiB
PHP
<?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(__DIR__.'/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, 'aria-required' => 'true'));
|
|
$form->addRule('name', get_string('required'), 'required', null, 'client');
|
|
$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;
|
|
}
|
|
}
|