Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.
<?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 string bulk editor bar toolbox */ /** @var bool if uses add section */ > protected $bulkedittoolsclass; 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');
> $this->bulkedittoolsclass = $format->get_output_classname('content\\bulkedittools');
} /** * 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); }
> if ($format->show_editor()) { return $data; > $bulkedittools = new $this->bulkedittoolsclass($format); } > $data->bulkedittools = $bulkedittools->export_for_template($output); > } /** >
* 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(); } }