mirror of
https://github.com/moodle/moodle.git
synced 2025-03-13 04:01:40 +01:00
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.
349 lines
13 KiB
PHP
349 lines
13 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 Weeks
|
|
*
|
|
* @since 2.0
|
|
* @package format_weeks
|
|
* @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 Weeks course format
|
|
*
|
|
* @package format_weeks
|
|
* @copyright 2012 Marina Glancy
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class format_weeks 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.
|
|
*
|
|
* @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 the name the user set.
|
|
return format_string($section->name, true, array('context' => context_course::instance($this->courseid)));
|
|
} else if ($section->section == 0) {
|
|
// Return the general section.
|
|
return get_string('section0name', 'format_weeks');
|
|
} else {
|
|
$dates = $this->get_section_dates($section);
|
|
|
|
// We subtract 24 hours for display purposes.
|
|
$dates->end = ($dates->end - 86400);
|
|
|
|
$dateformat = ' '.get_string('strftimedateshort');
|
|
$weekday = userdate($dates->start, $dateformat);
|
|
$endweekday = userdate($dates->end, $dateformat);
|
|
return $weekday.' - '.$endweekday;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 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;
|
|
}
|
|
}
|
|
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
|
|
*
|
|
* Weeks 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');
|
|
$sectionmenu = array();
|
|
$max = $courseconfig->maxsections;
|
|
if (!isset($max) || !is_numeric($max)) {
|
|
$max = 52;
|
|
}
|
|
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 'weeks', 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);
|
|
}
|
|
|
|
/**
|
|
* Return the start and end date of the passed section
|
|
*
|
|
* @param int|stdClass|section_info $section section to get the dates for
|
|
* @return stdClass property start for startdate, property end for enddate
|
|
*/
|
|
public function get_section_dates($section) {
|
|
$course = $this->get_course();
|
|
if (is_object($section)) {
|
|
$sectionnum = $section->section;
|
|
} else {
|
|
$sectionnum = $section;
|
|
}
|
|
$oneweekseconds = 604800;
|
|
// Hack alert. We add 2 hours to avoid possible DST problems. (e.g. we go into daylight
|
|
// savings and the date changes.
|
|
$startdate = $course->startdate + 7200;
|
|
|
|
$dates = new stdClass();
|
|
$dates->start = $startdate + ($oneweekseconds * ($sectionnum - 1));
|
|
$dates->end = $dates->start + $oneweekseconds;
|
|
|
|
return $dates;
|
|
}
|
|
|
|
/**
|
|
* Returns true if the specified week is current
|
|
*
|
|
* @param int|stdClass|section_info $section
|
|
* @return bool
|
|
*/
|
|
public function is_section_current($section) {
|
|
if (is_object($section)) {
|
|
$sectionnum = $section->section;
|
|
} else {
|
|
$sectionnum = $section;
|
|
}
|
|
if ($sectionnum < 1) {
|
|
return false;
|
|
}
|
|
$timenow = time();
|
|
$dates = $this->get_section_dates($section);
|
|
return (($timenow >= $dates->start) && ($timenow < $dates->end));
|
|
}
|
|
}
|