mirror of
https://github.com/moodle/moodle.git
synced 2025-03-09 18:30:03 +01:00
331 lines
13 KiB
PHP
331 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 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;
|
|
}
|
|
|
|
/**
|
|
* Adds format options elements to the course/section edit form.
|
|
*
|
|
* This function is called from {@link course_edit_form::definition_after_data()}.
|
|
*
|
|
* @param MoodleQuickForm $mform form the elements are added to.
|
|
* @param bool $forsection 'true' if this is a section edit form, 'false' if this is course edit form.
|
|
* @return array array of references to the added form elements.
|
|
*/
|
|
public function create_edit_form_elements(&$mform, $forsection = false) {
|
|
$elements = parent::create_edit_form_elements($mform, $forsection);
|
|
|
|
// Increase the number of sections combo box values if the user has increased the number of sections
|
|
// using the icon on the course page beyond course 'maxsections' or course 'maxsections' has been
|
|
// reduced below the number of sections already set for the course on the site administration course
|
|
// defaults page. This is so that the number of sections is not reduced leaving unintended orphaned
|
|
// activities / resources.
|
|
if (!$forsection) {
|
|
$maxsections = get_config('moodlecourse', 'maxsections');
|
|
$numsections = $mform->getElementValue('numsections');
|
|
$numsections = $numsections[0];
|
|
if ($numsections > $maxsections) {
|
|
$element = $mform->getElement('numsections');
|
|
for ($i = $maxsections+1; $i <= $numsections; $i++) {
|
|
$element->addOption("$i", $i);
|
|
}
|
|
}
|
|
}
|
|
return $elements;
|
|
}
|
|
|
|
/**
|
|
* 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) {
|
|
global $DB;
|
|
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);
|
|
}
|
|
}
|