See Release Notes
Long Term Support Release
<?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/>. /**< * Base renderer for outputting course formats.> * Legacy course format renderer file.*< * @package core < * @copyright 2012 Dan Poltawski < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < * @since Moodle 2.3 < */ < < defined('MOODLE_INTERNAL') || die(); < < < /** < * This is a convenience renderer which can be used by section based formats < * to reduce code duplication. It is not necessary for all course formats to < * use this and its likely to change in future releases.> * This file exists only for legacy reasons. Most third party format > * plugins include this file to extend the course format renderer. Now all > * format renderers are located in core_courseformat\output and uses autoload.*< * @package core> * @deprecated since Moodle 4.0 MDL-72656 > * > * @package core_courseformat* @copyright 2012 Dan Poltawski * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 2.3 */< abstract class format_section_renderer_base extends plugin_renderer_base { < < /** @var core_course_renderer contains instance of core course renderer */ < protected $courserenderer; < < /** < * Constructor method, calls the parent constructor < * < * @param moodle_page $page < * @param string $target one of rendering target constants < */ < public function __construct(moodle_page $page, $target) { < parent::__construct($page, $target); < $this->courserenderer = $this->page->get_renderer('core', 'course'); < } < < /** < * Generate the starting container html for a list of sections < * @return string HTML to output. < */ < abstract protected function start_section_list(); < < /** < * Generate the closing container html for a list of sections < * @return string HTML to output. < */ < abstract protected function end_section_list(); < < /** < * Generate the title for this section page < * @return string the page title < */ < abstract protected function page_title(); < < /** < * Generate the section title, wraps it in a link to the section page if page is to be displayed on a separate page < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @return string HTML to output. < */ < public function section_title($section, $course) { < $title = get_section_name($course, $section); < $url = course_get_url($course, $section->section, array('navigation' => true)); < if ($url) { < $title = html_writer::link($url, $title); < } < return $title; < } < < /** < * Generate the section title to be displayed on the section page, without a link < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @return string HTML to output. < */ < public function section_title_without_link($section, $course) { < return get_section_name($course, $section); < } < < /** < * Generate the edit control action menu < * < * @param array $controls The edit control items from section_edit_control_items < * @param stdClass $course The course entry from DB < * @param stdClass $section The course_section entry from DB < * @return string HTML to output. < */ < protected function section_edit_control_menu($controls, $course, $section) { < $o = ""; < if (!empty($controls)) { < $menu = new action_menu(); < $menu->set_menu_trigger(get_string('edit')); < $menu->attributes['class'] .= ' section-actions'; < foreach ($controls as $value) { < $url = empty($value['url']) ? '' : $value['url']; < $icon = empty($value['icon']) ? '' : $value['icon']; < $name = empty($value['name']) ? '' : $value['name']; < $attr = empty($value['attr']) ? array() : $value['attr']; < $class = empty($value['pixattr']['class']) ? '' : $value['pixattr']['class']; < $al = new action_menu_link_secondary( < new moodle_url($url), < new pix_icon($icon, '', null, array('class' => "smallicon " . $class)), < $name, < $attr < ); < $menu->add($al); < } < < $o .= html_writer::div($this->render($menu), 'section_action_menu', < array('data-sectionid' => $section->id)); < } < < return $o; < } < < /** < * Generate the content to displayed on the right part of a section < * before course modules are included < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @param bool $onsectionpage true if being printed on a section page < * @return string HTML to output. < */ < protected function section_right_content($section, $course, $onsectionpage) { < $o = $this->output->spacer(); < < $controls = $this->section_edit_control_items($course, $section, $onsectionpage); < $o .= $this->section_edit_control_menu($controls, $course, $section); < < return $o; < } < < /** < * Generate the content to displayed on the left part of a section < * before course modules are included < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @param bool $onsectionpage true if being printed on a section page < * @return string HTML to output. < */ < protected function section_left_content($section, $course, $onsectionpage) { < $o = ''; < < if ($section->section != 0) { < // Only in the non-general sections. < if (course_get_format($course)->is_section_current($section)) { < $o = get_accesshide(get_string('currentsection', 'format_'.$course->format)); < } < } < < return $o; < } < < /** < * Generate the display of the header part of a section before < * course modules are included < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @param bool $onsectionpage true if being printed on a single-section page < * @param int $sectionreturn The section to return to after an action < * @return string HTML to output. < */ < protected function section_header($section, $course, $onsectionpage, $sectionreturn=null) { < $o = ''; < $currenttext = ''; < $sectionstyle = ''; < < if ($section->section != 0) { < // Only in the non-general sections. < if (!$section->visible) { < $sectionstyle = ' hidden'; < } < if (course_get_format($course)->is_section_current($section)) { < $sectionstyle = ' current'; < } < } < < $o .= html_writer::start_tag('li', [ < 'id' => 'section-'.$section->section, < 'class' => 'section main clearfix'.$sectionstyle, < 'role' => 'region', < 'aria-labelledby' => "sectionid-{$section->id}-title", < 'data-sectionid' => $section->section, < 'data-sectionreturnid' => $sectionreturn < ]); < < $leftcontent = $this->section_left_content($section, $course, $onsectionpage); < $o.= html_writer::tag('div', $leftcontent, array('class' => 'left side')); < < $rightcontent = $this->section_right_content($section, $course, $onsectionpage); < $o.= html_writer::tag('div', $rightcontent, array('class' => 'right side')); < $o.= html_writer::start_tag('div', array('class' => 'content')); < < // When not on a section page, we display the section titles except the general section if null < $hasnamenotsecpg = (!$onsectionpage && ($section->section != 0 || !is_null($section->name))); < < // When on a section page, we only display the general section title, if title is not the default one < $hasnamesecpg = ($onsectionpage && ($section->section == 0 && !is_null($section->name))); < < $classes = ' accesshide'; < if ($hasnamenotsecpg || $hasnamesecpg) { < $classes = ''; < } < $sectionname = html_writer::tag('span', $this->section_title($section, $course)); < $o .= $this->output->heading($sectionname, 3, 'sectionname' . $classes, "sectionid-{$section->id}-title"); < < $o .= $this->section_availability($section); < < $o .= html_writer::start_tag('div', array('class' => 'summary')); < if ($section->uservisible || $section->visible) { < // Show summary if section is available or has availability restriction information. < // Do not show summary if section is hidden but we still display it because of course setting < // "Hidden sections are shown in collapsed form". < $o .= $this->format_summary_text($section); < } < $o .= html_writer::end_tag('div'); < < return $o; < } < < /** < * Generate the display of the footer part of a section < * < * @return string HTML to output. < */ < protected function section_footer() { < $o = html_writer::end_tag('div'); < $o.= html_writer::end_tag('li'); < < return $o; < } < < /** < * @deprecated since Moodle 3.0 MDL-48947 - Use format_section_renderer_base::section_edit_control_items() instead < */ < protected function section_edit_controls() { < throw new coding_exception('section_edit_controls() can not be used anymore. Please use ' . < 'section_edit_control_items() instead.'); < } < < /** < * Generate the edit control items of a section < * < * @param stdClass $course The course entry from DB < * @param stdClass $section The course_section entry from DB < * @param bool $onsectionpage true if being printed on a section page < * @return array of edit control items < */ < protected function section_edit_control_items($course, $section, $onsectionpage = false) { < if (!$this->page->user_is_editing()) { < return array(); < } < < $sectionreturn = $onsectionpage ? $section->section : null; < < $coursecontext = context_course::instance($course->id); < $numsections = course_get_format($course)->get_last_section_number(); < $isstealth = $section->section > $numsections; < < $baseurl = course_get_url($course, $sectionreturn); < $baseurl->param('sesskey', sesskey()); < < $controls = array(); < < if (!$isstealth && has_capability('moodle/course:update', $coursecontext)) { < if ($section->section > 0 < && get_string_manager()->string_exists('editsection', 'format_'.$course->format)) { < $streditsection = get_string('editsection', 'format_'.$course->format); < } else { < $streditsection = get_string('editsection'); < } < < $controls['edit'] = array( < 'url' => new moodle_url('/course/editsection.php', array('id' => $section->id, 'sr' => $sectionreturn)), < 'icon' => 'i/settings', < 'name' => $streditsection, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon edit')); < } < < if ($section->section) { < $url = clone($baseurl); < if (!$isstealth) { < if (has_capability('moodle/course:sectionvisibility', $coursecontext)) { < if ($section->visible) { // Show the hide/show eye. < $strhidefromothers = get_string('hidefromothers', 'format_'.$course->format); < $url->param('hide', $section->section); < $controls['visiblity'] = array( < 'url' => $url, < 'icon' => 'i/hide', < 'name' => $strhidefromothers, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon editing_showhide', < 'data-sectionreturn' => $sectionreturn, 'data-action' => 'hide')); < } else { < $strshowfromothers = get_string('showfromothers', 'format_'.$course->format); < $url->param('show', $section->section); < $controls['visiblity'] = array( < 'url' => $url, < 'icon' => 'i/show', < 'name' => $strshowfromothers, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon editing_showhide', < 'data-sectionreturn' => $sectionreturn, 'data-action' => 'show')); < } < } < < if (!$onsectionpage) { < if (has_capability('moodle/course:movesections', $coursecontext)) { < $url = clone($baseurl); < if ($section->section > 1) { // Add a arrow to move section up. < $url->param('section', $section->section); < $url->param('move', -1); < $strmoveup = get_string('moveup'); < $controls['moveup'] = array( < 'url' => $url, < 'icon' => 'i/up', < 'name' => $strmoveup, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon moveup')); < } < < $url = clone($baseurl); < if ($section->section < $numsections) { // Add a arrow to move section down. < $url->param('section', $section->section); < $url->param('move', 1); < $strmovedown = get_string('movedown'); < $controls['movedown'] = array( < 'url' => $url, < 'icon' => 'i/down', < 'name' => $strmovedown, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon movedown')); < } < } < } < } < < if (course_can_delete_section($course, $section)) { < if (get_string_manager()->string_exists('deletesection', 'format_'.$course->format)) { < $strdelete = get_string('deletesection', 'format_'.$course->format); < } else { < $strdelete = get_string('deletesection'); < } < $url = new moodle_url('/course/editsection.php', array( < 'id' => $section->id, < 'sr' => $sectionreturn, < 'delete' => 1, < 'sesskey' => sesskey())); < $controls['delete'] = array( < 'url' => $url, < 'icon' => 'i/delete', < 'name' => $strdelete, < 'pixattr' => array('class' => ''), < 'attr' => array('class' => 'icon editing_delete')); < } < } < < return $controls; < } < < /** < * Generate a summary of a section for display on the 'course index page' < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course The course entry from DB < * @param array $mods (argument not used) < * @return string HTML to output. < */ < protected function section_summary($section, $course, $mods) { < $classattr = 'section main section-summary clearfix'; < $linkclasses = ''; < < // If section is hidden then display grey section link < if (!$section->visible) { < $classattr .= ' hidden'; < $linkclasses .= ' dimmed_text'; < } else if (course_get_format($course)->is_section_current($section)) { < $classattr .= ' current'; < } < < $title = get_section_name($course, $section); < $o = ''; < $o .= html_writer::start_tag('li', [ < 'id' => 'section-'.$section->section, < 'class' => $classattr, < 'role' => 'region', < 'aria-label' => $title, < 'data-sectionid' => $section->section < ]); < < $o .= html_writer::tag('div', '', array('class' => 'left side')); < $o .= html_writer::tag('div', '', array('class' => 'right side')); < $o .= html_writer::start_tag('div', array('class' => 'content')); < < if ($section->uservisible) { < $title = html_writer::tag('a', $title, < array('href' => course_get_url($course, $section->section), 'class' => $linkclasses)); < } < $o .= $this->output->heading($title, 3, 'section-title'); < < $o .= $this->section_availability($section); < $o.= html_writer::start_tag('div', array('class' => 'summarytext')); < < if ($section->uservisible || $section->visible) { < // Show summary if section is available or has availability restriction information. < // Do not show summary if section is hidden but we still display it because of course setting < // "Hidden sections are shown in collapsed form". < $o .= $this->format_summary_text($section); < } < $o.= html_writer::end_tag('div'); < $o.= $this->section_activity_summary($section, $course, null); < < $o .= html_writer::end_tag('div'); < $o .= html_writer::end_tag('li'); < < return $o; < } < < /** < * Generate a summary of the activites in a section < * < * @param stdClass $section The course_section entry from DB < * @param stdClass $course the course record from DB < * @param array $mods (argument not used) < * @return string HTML to output. < */ < protected function section_activity_summary($section, $course, $mods) { < $modinfo = get_fast_modinfo($course); < if (empty($modinfo->sections[$section->section])) { < return ''; < } < < // Generate array with count of activities in this section: < $sectionmods = array(); < $total = 0; < $complete = 0; < $cancomplete = isloggedin() && !isguestuser(); < $completioninfo = new completion_info($course); < foreach ($modinfo->sections[$section->section] as $cmid) { < $thismod = $modinfo->cms[$cmid]; < < if ($thismod->uservisible) { < if (isset($sectionmods[$thismod->modname])) { < $sectionmods[$thismod->modname]['name'] = $thismod->modplural; < $sectionmods[$thismod->modname]['count']++; < } else { < $sectionmods[$thismod->modname]['name'] = $thismod->modfullname; < $sectionmods[$thismod->modname]['count'] = 1; < } < if ($cancomplete && $completioninfo->is_enabled($thismod) != COMPLETION_TRACKING_NONE) { < $total++; < $completiondata = $completioninfo->get_data($thismod, true); < if ($completiondata->completionstate == COMPLETION_COMPLETE || < $completiondata->completionstate == COMPLETION_COMPLETE_PASS) { < $complete++; < } < } < } < } < < if (empty($sectionmods)) { < // No sections < return ''; < } < < // Output section activities summary: < $o = ''; < $o.= html_writer::start_tag('div', array('class' => 'section-summary-activities pr-2 mdl-right')); < foreach ($sectionmods as $mod) { < $o.= html_writer::start_tag('span', array('class' => 'activity-count')); < $o.= $mod['name'].': '.$mod['count']; < $o.= html_writer::end_tag('span'); < } < $o.= html_writer::end_tag('div'); < < // Output section completion data < if ($total > 0) { < $a = new stdClass; < $a->complete = $complete; < $a->total = $total; < < $o.= html_writer::start_tag('div', array('class' => 'section-summary-activities pr-2 mdl-right')); < $o.= html_writer::tag('span', get_string('progresstotal', 'completion', $a), array('class' => 'activity-count')); < $o.= html_writer::end_tag('div'); < } < < return $o; < } < < /** < * If section is not visible, display the message about that ('Not available < * until...', that sort of thing). Otherwise, returns blank. < * < * For users with the ability to view hidden sections, it shows the < * information even though you can view the section and also may include < * slightly fuller information (so that teachers can tell when sections < * are going to be unavailable etc). This logic is the same as for < * activities. < * < * @param section_info $section The course_section entry from DB < * @param bool $canviewhidden True if user can view hidden sections < * @return string HTML to output < */ < protected function section_availability_message($section, $canviewhidden) { < global $CFG; < $o = ''; < if (!$section->visible) { < if ($canviewhidden) { < $o .= $this->courserenderer->availability_info(get_string('hiddenfromstudents'), 'ishidden'); < } else { < // We are here because of the setting "Hidden sections are shown in collapsed form". < // Student can not see the section contents but can see its name. < $o .= $this->courserenderer->availability_info(get_string('notavailable'), 'ishidden'); < } < } else if (!$section->uservisible) { < if ($section->availableinfo) { < // Note: We only get to this function if availableinfo is non-empty, < // so there is definitely something to print. < $formattedinfo = \core_availability\info::format_info( < $section->availableinfo, $section->course); < $o .= $this->courserenderer->availability_info($formattedinfo, 'isrestricted'); < } < } else if ($canviewhidden && !empty($CFG->enableavailability)) { < // Check if there is an availability restriction. < $ci = new \core_availability\info_section($section); < $fullinfo = $ci->get_full_information(); < if ($fullinfo) { < $formattedinfo = \core_availability\info::format_info( < $fullinfo, $section->course); < $o .= $this->courserenderer->availability_info($formattedinfo, 'isrestricted isfullinfo'); < } < } < return $o; < } < < /** < * Displays availability information for the section (hidden, not available unles, etc.) < * < * @param section_info $section < * @return string < */ < public function section_availability($section) { < $context = context_course::instance($section->course); < $canviewhidden = has_capability('moodle/course:viewhiddensections', $context); < return html_writer::div($this->section_availability_message($section, $canviewhidden), 'section_availability'); < } < < /** < * Show if something is on on the course clipboard (moving around) < * < * @param stdClass $course The course entry from DB < * @param int $sectionno The section number in the course which is being displayed < * @return string HTML to output. < */ < protected function course_activity_clipboard($course, $sectionno = null) { < global $USER; < < $o = ''; < // If currently moving a file then show the current clipboard. < if (ismoving($course->id)) { < $url = new moodle_url('/course/mod.php', < array('sesskey' => sesskey(), < 'cancelcopy' => true, < 'sr' => $sectionno, < ) < ); < < $o.= html_writer::start_tag('div', array('class' => 'clipboard')); < $o.= strip_tags(get_string('activityclipboard', '', $USER->activitycopyname)); < $o.= ' ('.html_writer::link($url, get_string('cancel')).')'; < $o.= html_writer::end_tag('div'); < } < < return $o; < } < < /** < * Generate next/previous section links for naviation < * < * @param stdClass $course The course entry from DB < * @param array $sections The course_sections entries from the DB < * @param int $sectionno The section number in the course which is being displayed < * @return array associative array with previous and next section link < */ < protected function get_nav_links($course, $sections, $sectionno) { < // FIXME: This is really evil and should by using the navigation API. < $course = course_get_format($course)->get_course(); < $canviewhidden = has_capability('moodle/course:viewhiddensections', context_course::instance($course->id)) < or !$course->hiddensections; < < $links = array('previous' => '', 'next' => ''); < $back = $sectionno - 1; < while ($back > 0 and empty($links['previous'])) { < if ($canviewhidden || $sections[$back]->uservisible) { < $params = array(); < if (!$sections[$back]->visible) { < $params = array('class' => 'dimmed_text'); < } < $previouslink = html_writer::tag('span', $this->output->larrow(), array('class' => 'larrow')); < $previouslink .= get_section_name($course, $sections[$back]); < $links['previous'] = html_writer::link(course_get_url($course, $back), $previouslink, $params); < } < $back--; < } < < $forward = $sectionno + 1; < $numsections = course_get_format($course)->get_last_section_number(); < while ($forward <= $numsections and empty($links['next'])) { < if ($canviewhidden || $sections[$forward]->uservisible) { < $params = array(); < if (!$sections[$forward]->visible) { < $params = array('class' => 'dimmed_text'); < } < $nextlink = get_section_name($course, $sections[$forward]); < $nextlink .= html_writer::tag('span', $this->output->rarrow(), array('class' => 'rarrow')); < $links['next'] = html_writer::link(course_get_url($course, $forward), $nextlink, $params); < } < $forward++; < } < < return $links; < } < < /** < * Generate the header html of a stealth section < * < * @param int $sectionno The section number in the course which is being displayed < * @return string HTML to output. < */ < protected function stealth_section_header($sectionno) { < $o = ''; < $o .= html_writer::start_tag('li', [ < 'id' => 'section-'.$sectionno, < 'class' => 'section main clearfix orphaned hidden', < 'data-sectionid' => $sectionno < ]); < $o .= html_writer::tag('div', '', array('class' => 'left side')); < $course = course_get_format($this->page->course)->get_course(); < $section = course_get_format($this->page->course)->get_section($sectionno); < $rightcontent = $this->section_right_content($section, $course, false); < $o .= html_writer::tag('div', $rightcontent, array('class' => 'right side')); < $o .= html_writer::start_tag('div', array('class' => 'content')); < $o .= $this->output->heading( < get_string('orphanedactivitiesinsectionno', '', $sectionno), < 3, < 'sectionname' < ); < return $o; < } < < /** < * Generate footer html of a stealth section < * < * @return string HTML to output. < */ < protected function stealth_section_footer() { < $o = html_writer::end_tag('div'); < $o.= html_writer::end_tag('li'); < return $o; < } < < /** < * Generate the html for a hidden section < * < * @param int $sectionno The section number in the course which is being displayed < * @param int|stdClass $courseorid The course to get the section name for (object or just course id) < * @return string HTML to output. < */ < protected function section_hidden($sectionno, $courseorid = null) { < if ($courseorid) { < $sectionname = get_section_name($courseorid, $sectionno); < $strnotavailable = get_string('notavailablecourse', '', $sectionname); < } else { < $strnotavailable = get_string('notavailable'); < } < < $o = ''; < $o .= html_writer::start_tag('li', [ < 'id' => 'section-'.$sectionno, < 'class' => 'section main clearfix hidden', < 'data-sectionid' => $sectionno < ]); < $o.= html_writer::tag('div', '', array('class' => 'left side')); < $o.= html_writer::tag('div', '', array('class' => 'right side')); < $o.= html_writer::start_tag('div', array('class' => 'content')); < $o.= html_writer::tag('div', $strnotavailable); < $o.= html_writer::end_tag('div'); < $o.= html_writer::end_tag('li'); < return $o; < } < < /** < * Generate the html for the 'Jump to' menu on a single section page. < * < * @param stdClass $course The course entry from DB < * @param array $sections The course_sections entries from the DB < * @param $displaysection the current displayed section number. < * < * @return string HTML to output. < */ < protected function section_nav_selection($course, $sections, $displaysection) { < global $CFG; < $o = ''; < $sectionmenu = array(); < $sectionmenu[course_get_url($course)->out(false)] = get_string('maincoursepage'); < $modinfo = get_fast_modinfo($course); < $section = 1; < $numsections = course_get_format($course)->get_last_section_number(); < while ($section <= $numsections) { < $thissection = $modinfo->get_section_info($section); < $showsection = $thissection->uservisible or !$course->hiddensections; < if (($showsection) && ($section != $displaysection) && ($url = course_get_url($course, $section))) { < $sectionmenu[$url->out(false)] = get_section_name($course, $section); < } < $section++; < } < < $select = new url_select($sectionmenu, '', array('' => get_string('jumpto'))); < $select->class = 'jumpmenu'; < $select->formid = 'sectionmenu'; < $o .= $this->output->render($select); < < return $o; < } < < /** < * Output the html for a single section page . < * < * @param stdClass $course The course entry from DB < * @param array $sections (argument not used) < * @param array $mods (argument not used) < * @param array $modnames (argument not used) < * @param array $modnamesused (argument not used) < * @param int $displaysection The section number in the course which is being displayed < */ < public function print_single_section_page($course, $sections, $mods, $modnames, $modnamesused, $displaysection) { < $modinfo = get_fast_modinfo($course); < $course = course_get_format($course)->get_course(); < < // Can we view the section in question? < if (!($sectioninfo = $modinfo->get_section_info($displaysection)) || !$sectioninfo->uservisible) { < // This section doesn't exist or is not available for the user. < // We actually already check this in course/view.php but just in case exit from this function as well. < print_error('unknowncoursesection', 'error', course_get_url($course), < format_string($course->fullname)); < } < < // Copy activity clipboard.. < echo $this->course_activity_clipboard($course, $displaysection); < $thissection = $modinfo->get_section_info(0); < if ($thissection->summary or !empty($modinfo->sections[0]) or $this->page->user_is_editing()) { < echo $this->start_section_list(); < echo $this->section_header($thissection, $course, true, $displaysection); < echo $this->courserenderer->course_section_cm_list($course, $thissection, $displaysection); < echo $this->courserenderer->course_section_add_cm_control($course, 0, $displaysection); < echo $this->section_footer(); < echo $this->end_section_list(); < } < < // Start single-section div < echo html_writer::start_tag('div', array('class' => 'single-section')); < < // The requested section page. < $thissection = $modinfo->get_section_info($displaysection); < < // Title with section navigation links. < $sectionnavlinks = $this->get_nav_links($course, $modinfo->get_section_info_all(), $displaysection); < $sectiontitle = ''; < $sectiontitle .= html_writer::start_tag('div', array('class' => 'section-navigation navigationtitle')); < $sectiontitle .= html_writer::tag('span', $sectionnavlinks['previous'], array('class' => 'mdl-left')); < $sectiontitle .= html_writer::tag('span', $sectionnavlinks['next'], array('class' => 'mdl-right')); < // Title attributes < $classes = 'sectionname'; < if (!$thissection->visible) { < $classes .= ' dimmed_text'; < } < $sectionname = html_writer::tag('span', $this->section_title_without_link($thissection, $course)); < $sectiontitle .= $this->output->heading($sectionname, 3, $classes); < < $sectiontitle .= html_writer::end_tag('div'); < echo $sectiontitle; < < // Now the list of sections.. < echo $this->start_section_list(); < < echo $this->section_header($thissection, $course, true, $displaysection); < < echo $this->courserenderer->course_section_cm_list($course, $thissection, $displaysection); < echo $this->courserenderer->course_section_add_cm_control($course, $displaysection, $displaysection); < echo $this->section_footer(); < echo $this->end_section_list(); < < // Display section bottom navigation. < $sectionbottomnav = ''; < $sectionbottomnav .= html_writer::start_tag('div', array('class' => 'section-navigation mdl-bottom')); < $sectionbottomnav .= html_writer::tag('span', $sectionnavlinks['previous'], array('class' => 'mdl-left')); < $sectionbottomnav .= html_writer::tag('span', $sectionnavlinks['next'], array('class' => 'mdl-right')); < $sectionbottomnav .= html_writer::tag('div', $this->section_nav_selection($course, $sections, $displaysection), < array('class' => 'mdl-align')); < $sectionbottomnav .= html_writer::end_tag('div'); < echo $sectionbottomnav; < < // Close single-section div. < echo html_writer::end_tag('div'); < } < < /** < * Output the html for a multiple section page < * < * @param stdClass $course The course entry from DB < * @param array $sections (argument not used) < * @param array $mods (argument not used) < * @param array $modnames (argument not used) < * @param array $modnamesused (argument not used) < */ < public function print_multiple_section_page($course, $sections, $mods, $modnames, $modnamesused) { < $modinfo = get_fast_modinfo($course); < $course = course_get_format($course)->get_course(); < < $context = context_course::instance($course->id); < echo $this->output->heading($this->page_title(), 2, 'accesshide'); < < // Copy activity clipboard.. < echo $this->course_activity_clipboard($course, 0); < < // Now the list of sections.. < echo $this->start_section_list(); < $numsections = course_get_format($course)->get_last_section_number(); < < foreach ($modinfo->get_section_info_all() as $section => $thissection) { < if ($section == 0) { < // 0-section is displayed a little different then the others < if ($thissection->summary or !empty($modinfo->sections[0]) or $this->page->user_is_editing()) { < echo $this->section_header($thissection, $course, false, 0); < echo $this->courserenderer->course_section_cm_list($course, $thissection, 0); < echo $this->courserenderer->course_section_add_cm_control($course, 0, 0); < echo $this->section_footer(); < } < continue; < } < if ($section > $numsections) { < // activities inside this section are 'orphaned', this section will be printed as 'stealth' below < continue; < } < // Show the section if the user is permitted to access it, OR if it's not available < // but there is some available info text which explains the reason & should display, < // OR it is hidden but the course has a setting to display hidden sections as unavilable. < $showsection = $thissection->uservisible || < ($thissection->visible && !$thissection->available && !empty($thissection->availableinfo)) || < (!$thissection->visible && !$course->hiddensections); < if (!$showsection) { < continue; < } < < if (!$this->page->user_is_editing() && $course->coursedisplay == COURSE_DISPLAY_MULTIPAGE) { < // Display section summary only. < echo $this->section_summary($thissection, $course, null); < } else { < echo $this->section_header($thissection, $course, false, 0); < if ($thissection->uservisible) { < echo $this->courserenderer->course_section_cm_list($course, $thissection, 0); < echo $this->courserenderer->course_section_add_cm_control($course, $section, 0); < } < echo $this->section_footer(); < } < } < < if ($this->page->user_is_editing() and has_capability('moodle/course:update', $context)) { < // Print stealth sections if present. < foreach ($modinfo->get_section_info_all() as $section => $thissection) { < if ($section <= $numsections or empty($modinfo->sections[$section])) { < // this is not stealth section or it is empty < continue; < } < echo $this->stealth_section_header($section); < echo $this->courserenderer->course_section_cm_list($course, $thissection, 0); < echo $this->stealth_section_footer(); < } < < echo $this->end_section_list(); < < echo $this->change_number_sections($course, 0); < } else { < echo $this->end_section_list(); < } < < } < < /** < * Returns controls in the bottom of the page to increase/decrease number of sections < * < * @param stdClass $course < * @param int|null $sectionreturn < * @return string < */ < protected function change_number_sections($course, $sectionreturn = null) { < $coursecontext = context_course::instance($course->id); < if (!has_capability('moodle/course:update', $coursecontext)) { < return ''; < } < < $format = course_get_format($course); < $options = $format->get_format_options(); < $maxsections = $format->get_max_sections(); < $lastsection = $format->get_last_section_number(); < $supportsnumsections = array_key_exists('numsections', $options); < < if ($supportsnumsections) { < // Current course format has 'numsections' option, which is very confusing and we suggest course format < // developers to get rid of it (see MDL-57769 on how to do it). < // Display "Increase section" / "Decrease section" links. < < echo html_writer::start_tag('div', array('id' => 'changenumsections', 'class' => 'mdl-right')); < < // Increase number of sections. < if ($lastsection < $maxsections) { < $straddsection = get_string('increasesections', 'moodle'); < $url = new moodle_url('/course/changenumsections.php', < array('courseid' => $course->id, < 'increase' => true, < 'sesskey' => sesskey())); < $icon = $this->output->pix_icon('t/switch_plus', $straddsection); < echo html_writer::link($url, $icon.get_accesshide($straddsection), array('class' => 'increase-sections')); < } < < if ($course->numsections > 0) { < // Reduce number of sections sections. < $strremovesection = get_string('reducesections', 'moodle'); < $url = new moodle_url('/course/changenumsections.php', < array('courseid' => $course->id, < 'increase' => false, < 'sesskey' => sesskey())); < $icon = $this->output->pix_icon('t/switch_minus', $strremovesection); < echo html_writer::link($url, $icon.get_accesshide($strremovesection), array('class' => 'reduce-sections')); < } < < echo html_writer::end_tag('div'); < < } else if (course_get_format($course)->uses_sections()) { < if ($lastsection >= $maxsections) { < // Don't allow more sections if we already hit the limit. < return; < } < // Current course format does not have 'numsections' option but it has multiple sections suppport. < // Display the "Add section" link that will insert a section in the end. < // Note to course format developers: inserting sections in the other positions should check both < // capabilities 'moodle/course:update' and 'moodle/course:movesections'. < echo html_writer::start_tag('div', array('id' => 'changenumsections', 'class' => 'mdl-right')); < if (get_string_manager()->string_exists('addsections', 'format_'.$course->format)) { < $straddsections = get_string('addsections', 'format_'.$course->format); < } else { < $straddsections = get_string('addsections'); < } < $url = new moodle_url('/course/changenumsections.php', < ['courseid' => $course->id, 'insertsection' => 0, 'sesskey' => sesskey()]); < if ($sectionreturn !== null) { < $url->param('sectionreturn', $sectionreturn); < } < $icon = $this->output->pix_icon('t/add', ''); < $newsections = $maxsections - $lastsection; < echo html_writer::link($url, $icon . $straddsections, < array('class' => 'add-sections', 'data-add-sections' => $straddsections, 'data-new-sections' => $newsections)); < echo html_writer::end_tag('div'); < } < } < < /** < * Generate html for a section summary text < * < * @param stdClass $section The course_section entry from DB < * @return string HTML to output. < */ < protected function format_summary_text($section) { < $context = context_course::instance($section->course); < $summarytext = file_rewrite_pluginfile_urls($section->summary, 'pluginfile.php', < $context->id, 'course', 'section', $section->id); < < $options = new stdClass(); < $options->noclean = true; < $options->overflowdiv = true; < return format_text($summarytext, $section->summaryformat, $options); < } < }