MDL-62748 course: maxsections is a limit
[moodle.git] / course / changenumsections.php
CommitLineData
1abf1253
DP
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
3a35a9ff
DP
18/**
19 * This script allows the number of sections in a course to be increased
20 * or decreased, redirecting to the course page.
21 *
22 * @package core_course
23 * @copyright 2012 Dan Poltawski
24 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 * @since Moodle 2.3
26 */
1abf1253 27
1fcf0ca8 28require_once(__DIR__.'/../config.php');
1abf1253
DP
29require_once($CFG->dirroot.'/course/lib.php');
30
31$courseid = required_param('courseid', PARAM_INT);
89b909f6
MG
32$increase = optional_param('increase', null, PARAM_BOOL);
33$insertsection = optional_param('insertsection', null, PARAM_INT); // Insert section at position; 0 means at the end.
f24e17c9 34$numsections = optional_param('numsections', 1, PARAM_INT); // Number of sections to insert.
89b909f6
MG
35$returnurl = optional_param('returnurl', null, PARAM_LOCALURL); // Where to return to after the action.
36$sectionreturn = optional_param('sectionreturn', null, PARAM_INT); // Section to return to, ignored if $returnurl is specified.
37
74df2951 38$course = $DB->get_record('course', array('id' => $courseid), '*', MUST_EXIST);
850acb35 39$courseformatoptions = course_get_format($course)->get_format_options();
1abf1253 40
3a35a9ff 41$PAGE->set_url('/course/changenumsections.php', array('courseid' => $courseid));
1abf1253
DP
42
43// Authorisation checks.
44require_login($course);
45require_capability('moodle/course:update', context_course::instance($course->id));
46require_sesskey();
47
7c05d8a3
DW
48$desirednumsections = 0;
49$courseformat = course_get_format($course);
50$lastsectionnumber = $courseformat->get_last_section_number();
51$maxsections = $courseformat->get_max_sections();
52
53if (isset($courseformatoptions['numsections']) && $increase !== null) {
54 $desirednumsections = $courseformatoptions['numsections'] + 1;
55} else if (course_get_format($course)->uses_sections() && $insertsection !== null) {
56 // Count the sections in the course.
57 $desirednumsections = $lastsectionnumber + $numsections;
58}
59
60if ($desirednumsections > $maxsections) {
61 // Increase in number of sections is not allowed.
62 \core\notification::warning(get_string('maxsectionslimit', 'moodle', $maxsections));
63 $increase = null;
64 $insertsection = null;
65 $numsections = 0;
66
67 if (!$returnurl) {
68 $returnurl = course_get_url($course);
69 }
70}
71
89b909f6 72if (isset($courseformatoptions['numsections']) && $increase !== null) {
b5cf83f0
MG
73 if ($increase) {
74 // Add an additional section.
850acb35 75 $courseformatoptions['numsections']++;
89b909f6 76 course_create_sections_if_missing($course, $courseformatoptions['numsections']);
b5cf83f0
MG
77 } else {
78 // Remove a section.
850acb35 79 $courseformatoptions['numsections']--;
b5cf83f0
MG
80 }
81
82 // Don't go less than 0, intentionally redirect silently (for the case of
83 // double clicks).
850acb35 84 if ($courseformatoptions['numsections'] >= 0) {
bb018838
MG
85 update_course((object)array('id' => $course->id,
86 'numsections' => $courseformatoptions['numsections']));
b5cf83f0 87 }
89b909f6
MG
88 if (!$returnurl) {
89 $returnurl = course_get_url($course);
90 $returnurl->set_anchor('changenumsections');
91 }
92
93} else if (course_get_format($course)->uses_sections() && $insertsection !== null) {
94 if ($insertsection) {
95 // Inserting sections at any position except in the very end requires capability to move sections.
96 require_capability('moodle/course:movesections', context_course::instance($course->id));
97 }
f24e17c9
MG
98 $sections = [];
99 for ($i = 0; $i < max($numsections, 1); $i ++) {
100 $sections[] = course_create_section($course, $insertsection);
101 }
89b909f6 102 if (!$returnurl) {
f24e17c9 103 $returnurl = course_get_url($course, $sections[0]->section,
89b909f6
MG
104 ($sectionreturn !== null) ? ['sr' => $sectionreturn] : []);
105 }
3a35a9ff 106}
1abf1253
DP
107
108// Redirect to where we were..
89b909f6 109redirect($returnurl);