Proyectos de Subversion Moodle

<?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/>.

namespace core_courseformat\output;

defined('MOODLE_INTERNAL') || die();

global $CFG;

require_once($CFG->dirroot . '/course/renderer.php');

use cm_info;

use coding_exception;

use core_course_renderer;

use core_courseformat\base as course_format;

use html_writer;

use moodle_page;

use renderable;

use section_info;

use stdClass;

/**

 * Contains the default section course format output class.

 *

 * @package   core_courseformat

 * @copyright 2020 Ferran Recio <ferran@moodle.com>

 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

abstract class section_renderer extends core_course_renderer {

    /**

     * 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);

        // Ensure capabilities for section editing controls match those defined in course/view.php to ensure that they work

        // when called via an AJAX request.

        if (course_get_format($page->course)->uses_sections()) {

            $page->set_other_editing_capability('moodle/course:sectionvisibility');

            $page->set_other_editing_capability('moodle/course:movesections');

        }

    }

    /**

     * Renders the provided widget and returns the HTML to display it.

     *

     * Course format templates uses a similar subfolder structure to the renderable classes.

     * This method find out the specific template for a course widget. That's the reason why

     * this render method is different from the normal plugin renderer one.

     *

     * course format templatables can be rendered using the core_course/local/* templates.

     * Format plugins are free to override the default template location using render_xxx methods as usual.

     *

     * @param renderable $widget instance with renderable interface

     * @return string the widget HTML

     */

    public function render(renderable $widget) {

        global $CFG;

        $fullpath = str_replace('\\', '/', get_class($widget));

        $classparts = explode('/', $fullpath);

        // Strip namespaces.

        $classname = array_pop($classparts);

        // Remove _renderable suffixes.

        $classname = preg_replace('/_renderable$/', '', $classname);

        $rendermethod = 'render_' . $classname;

        if (method_exists($this, $rendermethod)) {

            return $this->$rendermethod($widget);

        }

        // If nothing works, let the parent class decide.

        return parent::render($widget);

    }

    /**

     * 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);

    }

    /**

     * Get the updated rendered version of a cm list item.

     *

     * This method is used when an activity is duplicated or copied in on the client side without refreshing the page.

     * Note that the previous method is used every time an activity is rendered, independent of it is the initial page

     * loading or an Ajax update. In this case, course_section_updated_cm_item will only be used when the course editor

     * requires to get an updated cm item HTML to perform partial page refresh. It will be used for suporting the course

     * editor webservices.

     *

     * By default, the template used for update a cm_item is the same as when it renders initially, but format plugins are

     * free to override this methos to provide extra affects or so.

     *

     * @param course_format $format the course format

     * @param section_info $section the section info

     * @param cm_info $cm the course module ionfo

     * @param array $displayoptions optional extra display options

     * @return string the rendered element

     */

    public function course_section_updated_cm_item(

        course_format $format,

        section_info $section,

        cm_info $cm,

        array $displayoptions = []

    ) {

        $cmitemclass = $format->get_output_classname('content\\section\\cmitem');

        $cmitem = new $cmitemclass($format, $section, $cm, $displayoptions);

        return $this->render($cmitem);

    }

    /**

     * Get the updated rendered version of a section.

     *

     * This method will only be used when the course editor requires to get an updated cm item HTML

     * to perform partial page refresh. It will be used for supporting the course editor webservices.

     *

     * By default, the template used for update a section is the same as when it renders initially,

     * but format plugins are free to override this method to provide extra effects or so.

     *

     * @param course_format $format the course format

     * @param section_info $section the section info

     * @return string the rendered element

     */

    public function course_section_updated(

        course_format $format,

        section_info $section

    ): string {

        $sectionclass = $format->get_output_classname('content\\section');

        $output = new $sectionclass($format, $section);

        return $this->render($output);

    }

    /**

     * Get the course index drawer with placeholder.

     *

     * The default course index is loaded after the page is ready. Format plugins can override

     * this method to provide an alternative course index.

     *

     * If the format is not compatible with the course index, this method will return an empty string.

     *

     * @param course_format $format the course format

     * @return String the course index HTML.

     */

    public function course_index_drawer(course_format $format): ?String {

        if ($format->uses_course_index()) {

            include_course_editor($format);

            return $this->render_from_template('core_courseformat/local/courseindex/drawer', []);

        }

        return '';

    }

    /**

     * Render the enable bulk editing button.

     * @param course_format $format the course format

     * @return string|null the enable bulk button HTML (or null if no bulk available).

     */

    public function bulk_editing_button(course_format $format): ?string {

        if (!$format->show_editor() || !$format->supports_components()) {

            return null;

        }

        $widgetclass = $format->get_output_classname('content\\bulkedittoggler');

        $widget = new $widgetclass($format);

        return $this->render($widget);

    }

    /**

     * 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;

    }

}