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/>.

/**
 * Page for creating or editing course category name/parent/description.
 *
 * When called with an id parameter, edits the category with that id.
 * Otherwise it creates a new category with default parent from the parent
 * parameter, which may be 0.
 *
 * @package    core_course
 * @copyright  2007 Nicolas Connault
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

require_once('../config.php');
require_once($CFG->dirroot.'/course/lib.php');

require_login();

$id = optional_param('id', 0, PARAM_INT);

$url = new moodle_url('/course/editcategory.php');
if ($id) {
    $coursecat = core_course_category::get($id, MUST_EXIST, true);
    $category = $coursecat->get_db_record();
    $context = context_coursecat::instance($id);
> navigation_node::override_active_url(new moodle_url('/course/index.php', ['categoryid' => $category->id])); > $PAGE->navbar->add(get_string('settings')); $url->param('id', $id); > $PAGE->set_primary_active_tab('home'); $strtitle = new lang_string('editcategorysettings'); > $PAGE->set_secondary_active_tab('edit');
$itemid = 0; // Initialise itemid, as all files in category description has item id 0. $title = $strtitle; $fullname = $coursecat->get_formatted_name(); } else { $parent = required_param('parent', PARAM_INT); $url->param('parent', $parent);
> $strtitle = get_string('addnewcategory');
if ($parent) {
< $DB->record_exists('course_categories', array('id' => $parent), '*', MUST_EXIST);
> $parentcategory = $DB->get_record('course_categories', array('id' => $parent), '*', MUST_EXIST);
$context = context_coursecat::instance($parent);
> navigation_node::override_active_url(new moodle_url('/course/index.php', ['categoryid' => $parent])); } else { > $fullname = format_string($parentcategory->name, true, ['context' => $context->id]); $context = context_system::instance(); > $title = "$fullname: $strtitle"; } > $managementurl = new moodle_url('/course/management.php'); navigation_node::override_active_url(new moodle_url('/course/editcategory.php', array('parent' => $parent))); > // These are the caps required in order to see the management interface. > $managementcaps = array('moodle/category:manage', 'moodle/course:create'); $category = new stdClass(); > if (!has_any_capability($managementcaps, context_system::instance())) { $category->id = 0; > // If the user doesn't have either manage caps then they can only manage within the given category. $category->parent = $parent; > $managementurl->param('categoryid', $parent); $strtitle = new lang_string("addnewcategory"); > } $itemid = null; // Set this explicitly, so files for parent category should not get loaded in draft area. > $PAGE->set_primary_active_tab('home'); $title = "$SITE->shortname: ".get_string('addnewcategory'); > $PAGE->navbar->add(get_string('coursemgmt', 'admin'), $managementurl); $fullname = $SITE->fullname; > $PAGE->navbar->add(get_string('addcategory', 'admin'));
}
> $fullname = $SITE->fullname; > $title = $strtitle; require_capability('moodle/category:manage', $context); > $PAGE->set_secondary_active_tab('courses');
< navigation_node::override_active_url(new moodle_url('/course/editcategory.php', array('parent' => $parent)));
< $strtitle = new lang_string("addnewcategory");
< $title = "$SITE->shortname: ".get_string('addnewcategory'); < $fullname = $SITE->fullname;
$PAGE->set_title($title); $PAGE->set_heading($fullname); $mform = new core_course_editcategory_form(null, array( 'categoryid' => $id, 'parent' => $category->parent, 'context' => $context, 'itemid' => $itemid )); $mform->set_data(file_prepare_standard_editor( $category, 'description', $mform->get_description_editor_options(), $context, 'coursecat', 'description', $itemid )); $manageurl = new moodle_url('/course/management.php'); if ($mform->is_cancelled()) { if ($id) { $manageurl->param('categoryid', $id); } else if ($parent) { $manageurl->param('categoryid', $parent); } redirect($manageurl); } else if ($data = $mform->get_data()) { if (isset($coursecat)) { if ((int)$data->parent !== (int)$coursecat->parent && !$coursecat->can_change_parent($data->parent)) {
< print_error('cannotmovecategory');
> throw new \moodle_exception('cannotmovecategory');
} $coursecat->update($data, $mform->get_description_editor_options()); } else { $category = core_course_category::create($data, $mform->get_description_editor_options()); } $manageurl->param('categoryid', $category->id); redirect($manageurl); } echo $OUTPUT->header(); echo $OUTPUT->heading($strtitle); $mform->display(); echo $OUTPUT->footer();