Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

/**
 * Defines the form for editing question categories.
 *
 * @package    moodlecore
 * @subpackage questionbank
 * @copyright  2007 Jamie Pratt me@jamiep.org
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
> * @deprecated since Moodle 4.0 MDL-71585 */ > * @see qbank_managecategories\form\category_form > * @todo Final deprecation on Moodle 4.4 MDL-72438
< < < defined('MOODLE_INTERNAL') || die(); < < require_once($CFG->libdir.'/formslib.php'); < < < /** < * Form for editing qusetions categories (name, description, etc.) < * < * @copyright 2007 Jamie Pratt me@jamiep.org < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ < class question_category_edit_form extends moodleform { < < protected function definition() { < $mform = $this->_form; < < $contexts = $this->_customdata['contexts']; < $currentcat = $this->_customdata['currentcat']; < < $mform->addElement('header', 'categoryheader', get_string('addcategory', 'question')); < < $mform->addElement('questioncategory', 'parent', get_string('parentcategory', 'question'), < array('contexts' => $contexts, 'top' => true, 'currentcat' => $currentcat, 'nochildrenof' => $currentcat)); < $mform->setType('parent', PARAM_SEQUENCE); < if (question_is_only_child_of_top_category_in_context($currentcat)) { < $mform->hardFreeze('parent'); < } < $mform->addHelpButton('parent', 'parentcategory', 'question'); < < $mform->addElement('text', 'name', get_string('name'),'maxlength="254" size="50"'); < $mform->setDefault('name', ''); < $mform->addRule('name', get_string('categorynamecantbeblank', 'question'), 'required', null, 'client'); < $mform->setType('name', PARAM_TEXT); < < $mform->addElement('editor', 'info', get_string('categoryinfo', 'question'), < array('rows' => 10), array('noclean' => 1)); < $mform->setDefault('info', ''); < $mform->setType('info', PARAM_RAW); < < $mform->addElement('text', 'idnumber', get_string('idnumber', 'question'), 'maxlength="100" size="10"'); < $mform->addHelpButton('idnumber', 'idnumber', 'question'); < $mform->setType('idnumber', PARAM_RAW); < < $this->add_action_buttons(false, get_string('addcategory', 'question')); < < $mform->addElement('hidden', 'id', 0); < $mform->setType('id', PARAM_INT); < } < < public function set_data($current) { < if (is_object($current)) { < $current = (array) $current; < } < if (!empty($current['info'])) { < $current['info'] = array('text' => $current['info'], < 'infoformat' => $current['infoformat']); < } else { < $current['info'] = array('text' => '', 'infoformat' => FORMAT_HTML); < } < parent::set_data($current); < } < < /** < * Validation. < * < * @param array $data < * @param array $files < * @return array the errors that were found < */ < public function validation($data, $files) { < global $DB; < < $errors = parent::validation($data, $files); < < // Add field validation check for duplicate idnumber. < list($parentid, $contextid) = explode(',', $data['parent']); < if (((string) $data['idnumber'] !== '') && !empty($contextid)) { < $conditions = 'contextid = ? AND idnumber = ?'; < $params = [$contextid, $data['idnumber']]; < if (!empty($data['id'])) { < $conditions .= ' AND id <> ?'; < $params[] = $data['id']; < } < if ($DB->record_exists_select('question_categories', $conditions, $params)) { < $errors['idnumber'] = get_string('idnumbertaken', 'error'); < } < } < < return $errors; < } < }