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.

Differences Between: [Versions 401 and 403]

   1  <?php
   2  
   3  // This file is part of Moodle - http://moodle.org/
   4  //
   5  // Moodle is free software: you can redistribute it and/or modify
   6  // it under the terms of the GNU General Public License as published by
   7  // the Free Software Foundation, either version 3 of the License, or
   8  // (at your option) any later version.
   9  //
  10  // Moodle is distributed in the hope that it will be useful,
  11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  // GNU General Public License for more details.
  14  //
  15  // You should have received a copy of the GNU General Public License
  16  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  17  
  18  /**
  19   * Edit the section basic information and availability
  20   *
  21   * @copyright 1999 Martin Dougiamas  http://dougiamas.com
  22   * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23   * @package course
  24   */
  25  
  26  require_once("../config.php");
  27  require_once ("lib.php");
  28  require_once($CFG->libdir . '/formslib.php');
  29  
  30  $id = required_param('id', PARAM_INT);    // course_sections.id
  31  $sectionreturn = optional_param('sr', 0, PARAM_INT);
  32  $deletesection = optional_param('delete', 0, PARAM_BOOL);
  33  
  34  $PAGE->set_url('/course/editsection.php', array('id'=>$id, 'sr'=> $sectionreturn));
  35  
  36  $section = $DB->get_record('course_sections', array('id' => $id), '*', MUST_EXIST);
  37  $course = $DB->get_record('course', array('id' => $section->course), '*', MUST_EXIST);
  38  $sectionnum = $section->section;
  39  
  40  require_login($course);
  41  $context = context_course::instance($course->id);
  42  require_capability('moodle/course:update', $context);
  43  
  44  // Get section_info object with all availability options.
  45  $sectioninfo = get_fast_modinfo($course)->get_section_info($sectionnum);
  46  
  47  // Deleting the section.
  48  if ($deletesection) {
  49      $cancelurl = course_get_url($course, $sectioninfo, array('sr' => $sectionreturn));
  50      if (course_can_delete_section($course, $sectioninfo)) {
  51          $confirm = optional_param('confirm', false, PARAM_BOOL) && confirm_sesskey();
  52          if (!$confirm && optional_param('sesskey', null, PARAM_RAW) !== null &&
  53                  empty($sectioninfo->summary) && empty($sectioninfo->sequence) && confirm_sesskey()) {
  54              // Do not ask for confirmation if section is empty and sesskey is already provided.
  55              $confirm = true;
  56          }
  57          if ($confirm) {
  58              course_delete_section($course, $sectioninfo, true, true);
  59              $courseurl = course_get_url($course, $sectioninfo->section - 1, array('sr' => $sectionreturn));
  60              redirect($courseurl);
  61          } else {
  62              if (get_string_manager()->string_exists('deletesection', 'format_' . $course->format)) {
  63                  $strdelete = get_string('deletesection', 'format_' . $course->format);
  64              } else {
  65                  $strdelete = get_string('deletesection');
  66              }
  67              $PAGE->navbar->add($strdelete);
  68              $PAGE->set_title($strdelete);
  69              $PAGE->set_heading($course->fullname);
  70              echo $OUTPUT->header();
  71              echo $OUTPUT->box_start('noticebox');
  72              $optionsyes = array('id' => $id, 'confirm' => 1, 'delete' => 1, 'sesskey' => sesskey());
  73              $deleteurl = new moodle_url('/course/editsection.php', $optionsyes);
  74              $formcontinue = new single_button($deleteurl, get_string('delete'));
  75              $formcancel = new single_button($cancelurl, get_string('cancel'), 'get');
  76              echo $OUTPUT->confirm(get_string('confirmdeletesection', '',
  77                  get_section_name($course, $sectioninfo)), $formcontinue, $formcancel);
  78              echo $OUTPUT->box_end();
  79              echo $OUTPUT->footer();
  80              exit;
  81          }
  82      } else {
  83          notice(get_string('nopermissions', 'error', get_string('deletesection')), $cancelurl);
  84      }
  85  }
  86  
  87  $editoroptions = array(
  88      'context'   => $context,
  89      'maxfiles'  => EDITOR_UNLIMITED_FILES,
  90      'maxbytes'  => $CFG->maxbytes,
  91      'trusttext' => false,
  92      'noclean'   => true,
  93      'subdirs'   => true
  94  );
  95  
  96  $courseformat = course_get_format($course);
  97  $defaultsectionname = $courseformat->get_default_section_name($section);
  98  
  99  $customdata = array(
 100      'cs' => $sectioninfo,
 101      'editoroptions' => $editoroptions,
 102      'defaultsectionname' => $defaultsectionname
 103  );
 104  $mform = $courseformat->editsection_form($PAGE->url, $customdata);
 105  
 106  // set current value, make an editable copy of section_info object
 107  // this will retrieve all format-specific options as well
 108  $initialdata = convert_to_array($sectioninfo);
 109  if (!empty($CFG->enableavailability)) {
 110      $initialdata['availabilityconditionsjson'] = $sectioninfo->availability;
 111  }
 112  $mform->set_data($initialdata);
 113  
 114  if ($mform->is_cancelled()){
 115      // Form cancelled, return to course.
 116      redirect(course_get_url($course, $section, array('sr' => $sectionreturn)));
 117  } else if ($data = $mform->get_data()) {
 118      // Data submitted and validated, update and return to course.
 119  
 120      // For consistency, we set the availability field to 'null' if it is empty.
 121      if (!empty($CFG->enableavailability)) {
 122          // Renamed field.
 123          $data->availability = $data->availabilityconditionsjson;
 124          unset($data->availabilityconditionsjson);
 125          if ($data->availability === '') {
 126              $data->availability = null;
 127          }
 128      }
 129      course_update_section($course, $section, $data);
 130  
 131      $PAGE->navigation->clear_cache();
 132      redirect(course_get_url($course, $section, array('sr' => $sectionreturn)));
 133  }
 134  
 135  // The edit form is displayed for the first time or if there was validation error on the previous step.
 136  $sectionname  = get_section_name($course, $sectionnum);
 137  $stredit      = get_string('edita', '', " $sectionname");
 138  $strsummaryof = get_string('summaryof', '', " $sectionname");
 139  
 140  $PAGE->set_title($stredit);
 141  $PAGE->set_heading($course->fullname);
 142  $PAGE->navbar->add($stredit);
 143  echo $OUTPUT->header();
 144  
 145  echo $OUTPUT->heading($strsummaryof);
 146  
 147  $mform->display();
 148  echo $OUTPUT->footer();