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/>. /** * Contains the main course format out class. * * @package core_courseformat * @copyright 2020 Ferran Recio <ferran@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ namespace core_courseformat\output\local; use core\output\named_templatable; use core_courseformat\base as course_format; use course_modinfo; use renderable; /** * Base class to render a course format. * * @package core_courseformat * @copyright 2020 Ferran Recio <ferran@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class content implements named_templatable, renderable { use courseformat_named_templatable; /** @var core_courseformat\base the course format class */ protected $format; /** @var string the section format class */ protected $sectionclass; /** @var string the add section output class name */ protected $addsectionclass; /** @var string section navigation class name */ protected $sectionnavigationclass; /** @var string section selector class name */ protected $sectionselectorclass; /** @var bool if uses add section */ protected $hasaddsection = true; /** * Constructor. * * @param course_format $format the coruse format */ public function __construct(course_format $format) { $this->format = $format; // Load output classes names from format. $this->sectionclass = $format->get_output_classname('content\\section'); $this->addsectionclass = $format->get_output_classname('content\\addsection'); $this->sectionnavigationclass = $format->get_output_classname('content\\sectionnavigation'); $this->sectionselectorclass = $format->get_output_classname('content\\sectionselector'); } /** * Export this data so it can be used as the context for a mustache template (core/inplace_editable). * * @param renderer_base $output typically, the renderer that's calling this function * @return stdClass data context for a mustache template */ public function export_for_template(\renderer_base $output) { global $PAGE; $format = $this->format; // Most formats uses section 0 as a separate section so we remove from the list. $sections = $this->export_sections($output); $initialsection = ''; if (!empty($sections)) { $initialsection = array_shift($sections); } $data = (object)[ 'title' => $format->page_title(), // This method should be in the course_format class. 'initialsection' => $initialsection, 'sections' => $sections, 'format' => $format->get_format(), 'sectionreturn' => 0, ]; // The single section format has extra navigation. $singlesection = $this->format->get_section_number(); if ($singlesection) { if (!$PAGE->theme->usescourseindex) { $sectionnavigation = new $this->sectionnavigationclass($format, $singlesection); $data->sectionnavigation = $sectionnavigation->export_for_template($output); $sectionselector = new $this->sectionselectorclass($format, $sectionnavigation); $data->sectionselector = $sectionselector->export_for_template($output); } $data->hasnavigation = true; $data->singlesection = array_shift($data->sections); $data->sectionreturn = $singlesection; } if ($this->hasaddsection) { $addsection = new $this->addsectionclass($format); $data->numsections = $addsection->export_for_template($output); } return $data; } /** * Export sections array data. * * @param renderer_base $output typically, the renderer that's calling this function * @return array data context for a mustache template */ protected function export_sections(\renderer_base $output): array { $format = $this->format; $course = $format->get_course(); $modinfo = $this->format->get_modinfo(); // Generate section list. $sections = []; $stealthsections = []; $numsections = $format->get_last_section_number(); foreach ($this->get_sections_to_display($modinfo) as $sectionnum => $thissection) { // The course/view.php check the section existence but the output can be called // from other parts so we need to check it. if (!$thissection) {< print_error('unknowncoursesection', 'error', course_get_url($course), format_string($course->fullname));> throw new \moodle_exception('unknowncoursesection', 'error', course_get_url($course), > format_string($course->fullname));} $section = new $this->sectionclass($format, $thissection); if ($sectionnum > $numsections) { // Activities inside this section are 'orphaned', this section will be printed as 'stealth' below. if (!empty($modinfo->sections[$sectionnum])) { $stealthsections[] = $section->export_for_template($output); } continue; } if (!$format->is_section_visible($thissection)) { continue; } $sections[] = $section->export_for_template($output); } if (!empty($stealthsections)) { $sections = array_merge($sections, $stealthsections); } return $sections; } /** * Return an array of sections to display. * * This method is used to differentiate between display a specific section * or a list of them. * * @param course_modinfo $modinfo the current course modinfo object * @return section_info[] an array of section_info to display */ private function get_sections_to_display(course_modinfo $modinfo): array { $singlesection = $this->format->get_section_number(); if ($singlesection) { return [ $modinfo->get_section_info(0), $modinfo->get_section_info($singlesection), ]; } return $modinfo->get_section_info_all(); } }