Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
/course/ -> edit.php (source)

Differences Between: [Versions 39 and 400] [Versions 39 and 401] [Versions 39 and 402] [Versions 39 and 403]

   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/>.
  16  
  17  /**
  18   * Edit course settings
  19   *
  20   * @package    core_course
  21   * @copyright  1999 onwards Martin Dougiamas (http://dougiamas.com)
  22   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   */
  24  
  25  require_once('../config.php');
  26  require_once ('lib.php');
  27  require_once ('edit_form.php');
  28  
  29  $id = optional_param('id', 0, PARAM_INT); // Course id.
  30  $categoryid = optional_param('category', 0, PARAM_INT); // Course category - can be changed in edit form.
  31  $returnto = optional_param('returnto', 0, PARAM_ALPHANUM); // Generic navigation return page switch.
  32  $returnurl = optional_param('returnurl', '', PARAM_LOCALURL); // A return URL. returnto must also be set to 'url'.
  33  
  34  if ($returnto === 'url' && confirm_sesskey() && $returnurl) {
  35      // If returnto is 'url' then $returnurl may be used as the destination to return to after saving or cancelling.
  36      // Sesskey must be specified, and would be set by the form anyway.
  37      $returnurl = new moodle_url($returnurl);
  38  } else {
  39      if (!empty($id)) {
  40          $returnurl = new moodle_url($CFG->wwwroot . '/course/view.php', array('id' => $id));
  41      } else {
  42          $returnurl = new moodle_url($CFG->wwwroot . '/course/');
  43      }
  44      if ($returnto !== 0) {
  45          switch ($returnto) {
  46              case 'category':
  47                  $returnurl = new moodle_url($CFG->wwwroot . '/course/index.php', array('categoryid' => $categoryid));
  48                  break;
  49              case 'catmanage':
  50                  $returnurl = new moodle_url($CFG->wwwroot . '/course/management.php', array('categoryid' => $categoryid));
  51                  break;
  52              case 'topcatmanage':
  53                  $returnurl = new moodle_url($CFG->wwwroot . '/course/management.php');
  54                  break;
  55              case 'topcat':
  56                  $returnurl = new moodle_url($CFG->wwwroot . '/course/');
  57                  break;
  58              case 'pending':
  59                  $returnurl = new moodle_url($CFG->wwwroot . '/course/pending.php');
  60                  break;
  61          }
  62      }
  63  }
  64  
  65  $PAGE->set_pagelayout('admin');
  66  if ($id) {
  67      $pageparams = array('id' => $id);
  68  } else {
  69      $pageparams = array('category' => $categoryid);
  70  }
  71  if ($returnto !== 0) {
  72      $pageparams['returnto'] = $returnto;
  73      if ($returnto === 'url' && $returnurl) {
  74          $pageparams['returnurl'] = $returnurl;
  75      }
  76  }
  77  $PAGE->set_url('/course/edit.php', $pageparams);
  78  
  79  // Basic access control checks.
  80  if ($id) {
  81      // Editing course.
  82      if ($id == SITEID){
  83          // Don't allow editing of  'site course' using this from.
  84          print_error('cannoteditsiteform');
  85      }
  86  
  87      // Login to the course and retrieve also all fields defined by course format.
  88      $course = get_course($id);
  89      require_login($course);
  90      $course = course_get_format($course)->get_course();
  91  
  92      $category = $DB->get_record('course_categories', array('id'=>$course->category), '*', MUST_EXIST);
  93      $coursecontext = context_course::instance($course->id);
  94      require_capability('moodle/course:update', $coursecontext);
  95  
  96  } else if ($categoryid) {
  97      // Creating new course in this category.
  98      $course = null;
  99      require_login();
 100      $category = $DB->get_record('course_categories', array('id'=>$categoryid), '*', MUST_EXIST);
 101      $catcontext = context_coursecat::instance($category->id);
 102      require_capability('moodle/course:create', $catcontext);
 103      $PAGE->set_context($catcontext);
 104  
 105  } else {
 106      // Creating new course in default category.
 107      $course = null;
 108      require_login();
 109      $category = core_course_category::get_default();
 110      $catcontext = context_coursecat::instance($category->id);
 111      require_capability('moodle/course:create', $catcontext);
 112      $PAGE->set_context($catcontext);
 113  }
 114  
 115  // Prepare course and the editor.
 116  $editoroptions = array('maxfiles' => EDITOR_UNLIMITED_FILES, 'maxbytes'=>$CFG->maxbytes, 'trusttext'=>false, 'noclean'=>true);
 117  $overviewfilesoptions = course_overviewfiles_options($course);
 118  if (!empty($course)) {
 119      // Add context for editor.
 120      $editoroptions['context'] = $coursecontext;
 121      $editoroptions['subdirs'] = file_area_contains_subdirs($coursecontext, 'course', 'summary', 0);
 122      $course = file_prepare_standard_editor($course, 'summary', $editoroptions, $coursecontext, 'course', 'summary', 0);
 123      if ($overviewfilesoptions) {
 124          file_prepare_standard_filemanager($course, 'overviewfiles', $overviewfilesoptions, $coursecontext, 'course', 'overviewfiles', 0);
 125      }
 126  
 127      // Inject current aliases.
 128      $aliases = $DB->get_records('role_names', array('contextid'=>$coursecontext->id));
 129      foreach($aliases as $alias) {
 130          $course->{'role_'.$alias->roleid} = $alias->name;
 131      }
 132  
 133      // Populate course tags.
 134      $course->tags = core_tag_tag::get_item_tags_array('core', 'course', $course->id);
 135  
 136  } else {
 137      // Editor should respect category context if course context is not set.
 138      $editoroptions['context'] = $catcontext;
 139      $editoroptions['subdirs'] = 0;
 140      $course = file_prepare_standard_editor($course, 'summary', $editoroptions, null, 'course', 'summary', null);
 141      if ($overviewfilesoptions) {
 142          file_prepare_standard_filemanager($course, 'overviewfiles', $overviewfilesoptions, null, 'course', 'overviewfiles', 0);
 143      }
 144  }
 145  
 146  // First create the form.
 147  $args = array(
 148      'course' => $course,
 149      'category' => $category,
 150      'editoroptions' => $editoroptions,
 151      'returnto' => $returnto,
 152      'returnurl' => $returnurl
 153  );
 154  $editform = new course_edit_form(null, $args);
 155  if ($editform->is_cancelled()) {
 156      // The form has been cancelled, take them back to what ever the return to is.
 157      redirect($returnurl);
 158  } else if ($data = $editform->get_data()) {
 159      // Process data if submitted.
 160      if (empty($course->id)) {
 161          // In creating the course.
 162          $course = create_course($data, $editoroptions);
 163  
 164          // Get the context of the newly created course.
 165          $context = context_course::instance($course->id, MUST_EXIST);
 166  
 167          if (!empty($CFG->creatornewroleid) and !is_viewing($context, NULL, 'moodle/role:assign') and !is_enrolled($context, NULL, 'moodle/role:assign')) {
 168              // Deal with course creators - enrol them internally with default role.
 169              // Note: This does not respect capabilities, the creator will be assigned the default role.
 170              // This is an expected behaviour. See MDL-66683 for further details.
 171              enrol_try_internal_enrol($course->id, $USER->id, $CFG->creatornewroleid);
 172          }
 173  
 174          // The URL to take them to if they chose save and display.
 175          $courseurl = new moodle_url('/course/view.php', array('id' => $course->id));
 176  
 177          // If they choose to save and display, and they are not enrolled take them to the enrolments page instead.
 178          if (!is_enrolled($context) && isset($data->saveanddisplay)) {
 179              // Redirect to manual enrolment page if possible.
 180              $instances = enrol_get_instances($course->id, true);
 181              foreach($instances as $instance) {
 182                  if ($plugin = enrol_get_plugin($instance->enrol)) {
 183                      if ($plugin->get_manual_enrol_link($instance)) {
 184                          // We know that the ajax enrol UI will have an option to enrol.
 185                          $courseurl = new moodle_url('/user/index.php', array('id' => $course->id, 'newcourse' => 1));
 186                          break;
 187                      }
 188                  }
 189              }
 190          }
 191      } else {
 192          // Save any changes to the files used in the editor.
 193          update_course($data, $editoroptions);
 194          // Set the URL to take them too if they choose save and display.
 195          $courseurl = new moodle_url('/course/view.php', array('id' => $course->id));
 196      }
 197  
 198      if (isset($data->saveanddisplay)) {
 199          // Redirect user to newly created/updated course.
 200          redirect($courseurl);
 201      } else {
 202          // Save and return. Take them back to wherever.
 203          redirect($returnurl);
 204      }
 205  }
 206  
 207  // Print the form.
 208  
 209  $site = get_site();
 210  
 211  $streditcoursesettings = get_string("editcoursesettings");
 212  $straddnewcourse = get_string("addnewcourse");
 213  $stradministration = get_string("administration");
 214  $strcategories = get_string("categories");
 215  
 216  if (!empty($course->id)) {
 217      // Navigation note: The user is editing a course, the course will exist within the navigation and settings.
 218      // The navigation will automatically find the Edit settings page under course navigation.
 219      $pagedesc = $streditcoursesettings;
 220      $title = $streditcoursesettings;
 221      $fullname = $course->fullname;
 222  } else {
 223      // The user is adding a course, this page isn't presented in the site navigation/admin.
 224      // Adding a new course is part of course category management territory.
 225      // We'd prefer to use the management interface URL without args.
 226      $managementurl = new moodle_url('/course/management.php');
 227      // These are the caps required in order to see the management interface.
 228      $managementcaps = array('moodle/category:manage', 'moodle/course:create');
 229      if ($categoryid && !has_any_capability($managementcaps, context_system::instance())) {
 230          // If the user doesn't have either manage caps then they can only manage within the given category.
 231          $managementurl->param('categoryid', $categoryid);
 232      }
 233      // Because the course category management interfaces are buried in the admin tree and that is loaded by ajax
 234      // we need to manually tell the navigation we need it loaded. The second arg does this.
 235      navigation_node::override_active_url($managementurl, true);
 236  
 237      $pagedesc = $straddnewcourse;
 238      $title = "$site->shortname: $straddnewcourse";
 239      $fullname = $site->fullname;
 240      $PAGE->navbar->add($pagedesc);
 241  }
 242  
 243  $PAGE->set_title($title);
 244  $PAGE->set_heading($fullname);
 245  
 246  echo $OUTPUT->header();
 247  echo $OUTPUT->heading($pagedesc);
 248  
 249  $editform->display();
 250  
 251  echo $OUTPUT->footer();