Merge branch 'MDL-69473-39' of git://github.com/sarjona/moodle into MOODLE_39_STABLE
[moodle.git] / course / classes / editcategory_form.php
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/>.
17 /**
18  * Edit category form.
19  *
20  * @package core_course
21  * @copyright 2002 onwards Martin Dougiamas (http://dougiamas.com)
22  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 defined('MOODLE_INTERNAL') || die;
27 require_once($CFG->libdir.'/formslib.php');
29 /**
30  * Edit category form.
31  *
32  * @package core_course
33  * @copyright 2002 onwards Martin Dougiamas (http://dougiamas.com)
34  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
35  */
36 class core_course_editcategory_form extends moodleform {
38     /**
39      * The form definition.
40      */
41     public function definition() {
42         global $CFG, $DB;
43         $mform = $this->_form;
44         $categoryid = $this->_customdata['categoryid'];
45         $parent = $this->_customdata['parent'];
47         // Get list of categories to use as parents, with site as the first one.
48         $options = array();
49         if (has_capability('moodle/category:manage', context_system::instance()) || $parent == 0) {
50             $options[0] = get_string('top');
51         }
52         if ($categoryid) {
53             // Editing an existing category.
54             $options += core_course_category::make_categories_list('moodle/category:manage', $categoryid);
55             if (empty($options[$parent])) {
56                 // Ensure the the category parent has been included in the options.
57                 $options[$parent] = $DB->get_field('course_categories', 'name', array('id'=>$parent));
58             }
59             $strsubmit = get_string('savechanges');
60         } else {
61             // Making a new category.
62             $options += core_course_category::make_categories_list('moodle/category:manage');
63             $strsubmit = get_string('createcategory');
64         }
66         $mform->addElement('select', 'parent', get_string('parentcategory'), $options);
68         $mform->addElement('text', 'name', get_string('categoryname'), array('size' => '30'));
69         $mform->addRule('name', get_string('required'), 'required', null);
70         $mform->setType('name', PARAM_TEXT);
72         $mform->addElement('text', 'idnumber', get_string('idnumbercoursecategory'), 'maxlength="100" size="10"');
73         $mform->addHelpButton('idnumber', 'idnumbercoursecategory');
74         $mform->setType('idnumber', PARAM_RAW);
76         $mform->addElement('editor', 'description_editor', get_string('description'), null,
77             $this->get_description_editor_options());
79         if (!empty($CFG->allowcategorythemes)) {
80             $themes = array(''=>get_string('forceno'));
81             $allthemes = get_list_of_themes();
82             foreach ($allthemes as $key => $theme) {
83                 if (empty($theme->hidefromselector)) {
84                     $themes[$key] = get_string('pluginname', 'theme_'.$theme->name);
85                 }
86             }
87             $mform->addElement('select', 'theme', get_string('forcetheme'), $themes);
88         }
90         $mform->addElement('hidden', 'id', 0);
91         $mform->setType('id', PARAM_INT);
92         $mform->setDefault('id', $categoryid);
94         $this->add_action_buttons(true, $strsubmit);
95     }
97     /**
98      * Returns the description editor options.
99      * @return array
100      */
101     public function get_description_editor_options() {
102         global $CFG;
103         $context = $this->_customdata['context'];
104         $itemid = $this->_customdata['itemid'];
105         return array(
106             'maxfiles'  => EDITOR_UNLIMITED_FILES,
107             'maxbytes'  => $CFG->maxbytes,
108             'trusttext' => true,
109             'context'   => $context,
110             'subdirs'   => file_area_contains_subdirs($context, 'coursecat', 'description', $itemid),
111         );
112     }
114     /**
115      * Validates the data submit for this form.
116      *
117      * @param array $data An array of key,value data pairs.
118      * @param array $files Any files that may have been submit as well.
119      * @return array An array of errors.
120      */
121     public function validation($data, $files) {
122         global $DB;
123         $errors = parent::validation($data, $files);
124         if (!empty($data['idnumber'])) {
125             if ($existing = $DB->get_record('course_categories', array('idnumber' => $data['idnumber']))) {
126                 if (!$data['id'] || $existing->id != $data['id']) {
127                     $errors['idnumber'] = get_string('categoryidnumbertaken', 'error');
128                 }
129             }
130         }
131         return $errors;
132     }