Adrian Greeve
341bfedf90
In the default course settings, setting the maximum number topics / weeks to 0 would not change the default number of sections on the same page as any other number would. A more appropriate check has been put in place. This also incorporates a fix for MDL-28584. The course edit screen now also checks to see if maxsections is set or numeric. If it is not set or numeric then it defaults to 52.
299 lines
12 KiB
PHP
299 lines
12 KiB
PHP
<?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/>.
|
|
|
|
/**
|
|
* This file contains main class for the course format Topic
|
|
*
|
|
* @since 2.0
|
|
* @package format_topics
|
|
* @copyright 2009 Sam Hemelryk
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
defined('MOODLE_INTERNAL') || die();
|
|
require_once($CFG->dirroot. '/course/format/lib.php');
|
|
|
|
/**
|
|
* Main class for the Topics course format
|
|
*
|
|
* @package format_topics
|
|
* @copyright 2012 Marina Glancy
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class format_topics extends format_base {
|
|
|
|
/**
|
|
* Returns true if this course format uses sections
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function uses_sections() {
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns the display name of the given section that the course prefers.
|
|
*
|
|
* Use section name is specified by user. Otherwise use default ("Topic #")
|
|
*
|
|
* @param int|stdClass $section Section object from database or just field section.section
|
|
* @return string Display name that the course format prefers, e.g. "Topic 2"
|
|
*/
|
|
public function get_section_name($section) {
|
|
$section = $this->get_section($section);
|
|
if ((string)$section->name !== '') {
|
|
return format_string($section->name, true,
|
|
array('context' => context_course::instance($this->courseid)));
|
|
} else if ($section->section == 0) {
|
|
return get_string('section0name', 'format_topics');
|
|
} else {
|
|
return get_string('topic').' '.$section->section;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* The URL to use for the specified course (with section)
|
|
*
|
|
* @param int|stdClass $section Section object from database or just field course_sections.section
|
|
* if omitted the course view page is returned
|
|
* @param array $options options for view URL. At the moment core uses:
|
|
* 'navigation' (bool) if true and section has no separate page, the function returns null
|
|
* 'sr' (int) used by multipage formats to specify to which section to return
|
|
* @return null|moodle_url
|
|
*/
|
|
public function get_view_url($section, $options = array()) {
|
|
$course = $this->get_course();
|
|
$url = new moodle_url('/course/view.php', array('id' => $course->id));
|
|
|
|
$sr = null;
|
|
if (array_key_exists('sr', $options)) {
|
|
$sr = $options['sr'];
|
|
}
|
|
if (is_object($section)) {
|
|
$sectionno = $section->section;
|
|
} else {
|
|
$sectionno = $section;
|
|
}
|
|
if ($sectionno !== null) {
|
|
if ($sr !== null) {
|
|
if ($sr) {
|
|
$usercoursedisplay = COURSE_DISPLAY_MULTIPAGE;
|
|
$sectionno = $sr;
|
|
} else {
|
|
$usercoursedisplay = COURSE_DISPLAY_SINGLEPAGE;
|
|
}
|
|
} else {
|
|
$usercoursedisplay = $course->coursedisplay;
|
|
}
|
|
if ($sectionno != 0 && $usercoursedisplay == COURSE_DISPLAY_MULTIPAGE) {
|
|
$url->param('section', $sectionno);
|
|
} else {
|
|
if (!empty($options['navigation'])) {
|
|
return null;
|
|
}
|
|
$url->set_anchor('section-'.$sectionno);
|
|
}
|
|
}
|
|
return $url;
|
|
}
|
|
|
|
/**
|
|
* Returns the information about the ajax support in the given source format
|
|
*
|
|
* The returned object's property (boolean)capable indicates that
|
|
* the course format supports Moodle course ajax features.
|
|
* The property (array)testedbrowsers can be used as a parameter for {@link ajaxenabled()}.
|
|
*
|
|
* @return stdClass
|
|
*/
|
|
public function supports_ajax() {
|
|
$ajaxsupport = new stdClass();
|
|
$ajaxsupport->capable = true;
|
|
$ajaxsupport->testedbrowsers = array('MSIE' => 6.0, 'Gecko' => 20061111, 'Safari' => 531, 'Chrome' => 6.0);
|
|
return $ajaxsupport;
|
|
}
|
|
|
|
/**
|
|
* Loads all of the course sections into the navigation
|
|
*
|
|
* @param global_navigation $navigation
|
|
* @param navigation_node $node The course node within the navigation
|
|
*/
|
|
public function extend_course_navigation($navigation, navigation_node $node) {
|
|
global $PAGE;
|
|
// if section is specified in course/view.php, make sure it is expanded in navigation
|
|
if ($navigation->includesectionnum === false) {
|
|
$selectedsection = optional_param('section', null, PARAM_INT);
|
|
if ($selectedsection !== null && (!defined('AJAX_SCRIPT') || AJAX_SCRIPT == '0') &&
|
|
$PAGE->url->compare(new moodle_url('/course/view.php'), URL_MATCH_BASE)) {
|
|
$navigation->includesectionnum = $selectedsection;
|
|
}
|
|
}
|
|
|
|
// check if there are callbacks to extend course navigation
|
|
parent::extend_course_navigation($navigation, $node);
|
|
}
|
|
|
|
/**
|
|
* Custom action after section has been moved in AJAX mode
|
|
*
|
|
* Used in course/rest.php
|
|
*
|
|
* @return array This will be passed in ajax respose
|
|
*/
|
|
function ajax_section_move() {
|
|
global $PAGE;
|
|
$titles = array();
|
|
$course = $this->get_course();
|
|
$modinfo = get_fast_modinfo($course);
|
|
$renderer = $this->get_renderer($PAGE);
|
|
if ($renderer && ($sections = $modinfo->get_section_info_all())) {
|
|
foreach ($sections as $number => $section) {
|
|
$titles[$number] = $renderer->section_title($section, $course);
|
|
}
|
|
}
|
|
return array('sectiontitles' => $titles, 'action' => 'move');
|
|
}
|
|
|
|
/**
|
|
* Returns the list of blocks to be automatically added for the newly created course
|
|
*
|
|
* @return array of default blocks, must contain two keys BLOCK_POS_LEFT and BLOCK_POS_RIGHT
|
|
* each of values is an array of block names (for left and right side columns)
|
|
*/
|
|
public function get_default_blocks() {
|
|
return array(
|
|
BLOCK_POS_LEFT => array(),
|
|
BLOCK_POS_RIGHT => array('search_forums', 'news_items', 'calendar_upcoming', 'recent_activity')
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Definitions of the additional options that this course format uses for course
|
|
*
|
|
* Topics format uses the following options:
|
|
* - coursedisplay
|
|
* - numsections
|
|
* - hiddensections
|
|
*
|
|
* @param bool $foreditform
|
|
* @return array of options
|
|
*/
|
|
public function course_format_options($foreditform = false) {
|
|
static $courseformatoptions = false;
|
|
if ($courseformatoptions === false) {
|
|
$courseconfig = get_config('moodlecourse');
|
|
$courseformatoptions = array(
|
|
'numsections' => array(
|
|
'default' => $courseconfig->numsections,
|
|
'type' => PARAM_INT,
|
|
),
|
|
'hiddensections' => array(
|
|
'default' => $courseconfig->hiddensections,
|
|
'type' => PARAM_INT,
|
|
),
|
|
'coursedisplay' => array(
|
|
'default' => $courseconfig->coursedisplay,
|
|
'type' => PARAM_INT,
|
|
),
|
|
);
|
|
}
|
|
if ($foreditform && !isset($courseformatoptions['coursedisplay']['label'])) {
|
|
$courseconfig = get_config('moodlecourse');
|
|
$max = $courseconfig->maxsections;
|
|
if (!isset($max) || !is_numeric($max)) {
|
|
$max = 52;
|
|
}
|
|
$sectionmenu = array();
|
|
for ($i = 0; $i <= $max; $i++) {
|
|
$sectionmenu[$i] = "$i";
|
|
}
|
|
$courseformatoptionsedit = array(
|
|
'numsections' => array(
|
|
'label' => new lang_string('numberweeks'),
|
|
'element_type' => 'select',
|
|
'element_attributes' => array($sectionmenu),
|
|
),
|
|
'hiddensections' => array(
|
|
'label' => new lang_string('hiddensections'),
|
|
'help' => 'hiddensections',
|
|
'help_component' => 'moodle',
|
|
'element_type' => 'select',
|
|
'element_attributes' => array(
|
|
array(
|
|
0 => new lang_string('hiddensectionscollapsed'),
|
|
1 => new lang_string('hiddensectionsinvisible')
|
|
)
|
|
),
|
|
),
|
|
'coursedisplay' => array(
|
|
'label' => new lang_string('coursedisplay'),
|
|
'element_type' => 'select',
|
|
'element_attributes' => array(
|
|
array(
|
|
COURSE_DISPLAY_SINGLEPAGE => new lang_string('coursedisplay_single'),
|
|
COURSE_DISPLAY_MULTIPAGE => new lang_string('coursedisplay_multi')
|
|
)
|
|
),
|
|
'help' => 'coursedisplay',
|
|
'help_component' => 'moodle',
|
|
)
|
|
);
|
|
$courseformatoptions = array_merge_recursive($courseformatoptions, $courseformatoptionsedit);
|
|
}
|
|
return $courseformatoptions;
|
|
}
|
|
|
|
/**
|
|
* Updates format options for a course
|
|
*
|
|
* In case if course format was changed to 'topics', we try to copy options
|
|
* 'coursedisplay', 'numsections' and 'hiddensections' from the previous format.
|
|
* If previous course format did not have 'numsections' option, we populate it with the
|
|
* current number of sections
|
|
*
|
|
* @param stdClass|array $data return value from {@link moodleform::get_data()} or array with data
|
|
* @param stdClass $oldcourse if this function is called from {@link update_course()}
|
|
* this object contains information about the course before update
|
|
* @return bool whether there were any changes to the options values
|
|
*/
|
|
public function update_course_format_options($data, $oldcourse = null) {
|
|
if ($oldcourse !== null) {
|
|
$data = (array)$data;
|
|
$oldcourse = (array)$oldcourse;
|
|
$options = $this->course_format_options();
|
|
foreach ($options as $key => $unused) {
|
|
if (!array_key_exists($key, $data)) {
|
|
if (array_key_exists($key, $oldcourse)) {
|
|
$data[$key] = $oldcourse[$key];
|
|
} else if ($key === 'numsections') {
|
|
// If previous format does not have the field 'numsections'
|
|
// and $data['numsections'] is not set,
|
|
// we fill it with the maximum section number from the DB
|
|
$maxsection = $DB->get_field_sql('SELECT max(section) from {course_sections}
|
|
WHERE course = ?', array($this->courseid));
|
|
if ($maxsection) {
|
|
// If there are no sections, or just default 0-section, 'numsections' will be set to default
|
|
$data['numsections'] = $maxsection;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return $this->update_format_options($data);
|
|
}
|
|
}
|