course/edit.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/>.
  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             enrol_try_internal_enrol($course->id, $USER->id, $CFG->creatornewroleid);
 170         }
 171
 172         // The URL to take them to if they chose save and display.
 173         $courseurl = new moodle_url('/course/view.php', array('id' => $course->id));
 174
 175         // If they choose to save and display, and they are not enrolled take them to the enrolments page instead.
 176         if (!is_enrolled($context) && isset($data->saveanddisplay)) {
 177             // Redirect to manual enrolment page if possible.
 178             $instances = enrol_get_instances($course->id, true);
 179             foreach($instances as $instance) {
 180                 if ($plugin = enrol_get_plugin($instance->enrol)) {
 181                     if ($plugin->get_manual_enrol_link($instance)) {
 182                         // We know that the ajax enrol UI will have an option to enrol.
 183                         $courseurl = new moodle_url('/user/index.php', array('id' => $course->id, 'newcourse' => 1));
 184                         break;
 185                     }
 186                 }
 187             }
 188         }
 189     } else {
 190         // Save any changes to the files used in the editor.
 191         update_course($data, $editoroptions);
 192         // Set the URL to take them too if they choose save and display.
 193         $courseurl = new moodle_url('/course/view.php', array('id' => $course->id));
 194     }
 195
 196     if (isset($data->saveanddisplay)) {
 197         // Redirect user to newly created/updated course.
 198         redirect($courseurl);
 199     } else {
 200         // Save and return. Take them back to wherever.
 201         redirect($returnurl);
 202     }
 203 }
 204
 205 // Print the form.
 206
 207 $site = get_site();
 208
 209 $streditcoursesettings = get_string("editcoursesettings");
 210 $straddnewcourse = get_string("addnewcourse");
 211 $stradministration = get_string("administration");
 212 $strcategories = get_string("categories");
 213
 214 if (!empty($course->id)) {
 215     // Navigation note: The user is editing a course, the course will exist within the navigation and settings.
 216     // The navigation will automatically find the Edit settings page under course navigation.
 217     $pagedesc = $streditcoursesettings;
 218     $title = $streditcoursesettings;
 219     $fullname = $course->fullname;
 220 } else {
 221     // The user is adding a course, this page isn't presented in the site navigation/admin.
 222     // Adding a new course is part of course category management territory.
 223     // We'd prefer to use the management interface URL without args.
 224     $managementurl = new moodle_url('/course/management.php');
 225     // These are the caps required in order to see the management interface.
 226     $managementcaps = array('moodle/category:manage', 'moodle/course:create');
 227     if ($categoryid && !has_any_capability($managementcaps, context_system::instance())) {
 228         // If the user doesn't have either manage caps then they can only manage within the given category.
 229         $managementurl->param('categoryid', $categoryid);
 230     }
 231     // Because the course category management interfaces are buried in the admin tree and that is loaded by ajax
 232     // we need to manually tell the navigation we need it loaded. The second arg does this.
 233     navigation_node::override_active_url($managementurl, true);
 234
 235     $pagedesc = $straddnewcourse;
 236     $title = "$site->shortname: $straddnewcourse";
 237     $fullname = $site->fullname;
 238     $PAGE->navbar->add($pagedesc);
 239 }
 240
 241 $PAGE->set_title($title);
 242 $PAGE->set_heading($fullname);
 243
 244 echo $OUTPUT->header();
 245 echo $OUTPUT->heading($pagedesc);
 246
 247 $editform->display();
 248
 249 echo $OUTPUT->footer();