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 mod_quiz\output;

use cm_info;

use coding_exception;

use context;

use context_module;

use html_table;

use html_table_cell;

use html_writer;

use mod_quiz\access_manager;

use mod_quiz\form\preflight_check_form;

use mod_quiz\output\grades\grade_out_of;

use mod_quiz\question\display_options;

use mod_quiz\quiz_attempt;

use moodle_url;

use plugin_renderer_base;

use popup_action;

use question_display_options;

use mod_quiz\quiz_settings;

use renderable;

use single_button;

use stdClass;

/**

 * The main renderer for the quiz module.

 *

 * @package   mod_quiz

 * @category  output

 * @copyright 2011 The Open University

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

 */

class renderer extends plugin_renderer_base

{

    /**

     * Builds the review page

     *

     * @param quiz_attempt $attemptobj an instance of quiz_attempt.

     * @param array $slots of slots to be displayed.

     * @param int $page the current page number

     * @param bool $showall whether to show entire attempt on one page.

     * @param bool $lastpage if true the current page is the last page.

     * @param display_options $displayoptions instance of display_options.

     * @param attempt_summary_information|array $summarydata summary information about the attempt.

     *      Passing an array is deprecated.

     * @return string HTML to display.

     */

    public function review_page(

        quiz_attempt $attemptobj,

        $slots,

        $page,

        $showall,

        $lastpage,

        display_options $displayoptions,

        $summarydata

    ) {

        if (is_array($summarydata)) {

            debugging(

                'Since Moodle 4.4, $summarydata passed to review_page should be a attempt_summary_information.',

                DEBUG_DEVELOPER

            );

            $summarydata = $this->filter_review_summary_table($summarydata, $page);

            $summarydata = attempt_summary_information::create_from_legacy_array($summarydata);

        }

        $output = '';

        $output .= $this->header();

        $output .= $this->review_attempt_summary($summarydata, $page);

        $output .= $this->review_form(

            $page,

            $showall,

            $displayoptions,

            $this->questions($attemptobj, true, $slots, $page, $showall, $displayoptions),

            $attemptobj

        );

        $output .= $this->review_next_navigation($attemptobj, $page, $lastpage, $showall);

        $output .= $this->footer();

        return $output;

    }

    /**

     * Renders the review question pop-up.

     *

     * @param quiz_attempt $attemptobj an instance of quiz_attempt.

     * @param int $slot which question to display.

     * @param int $seq which step of the question attempt to show. null = latest.

     * @param display_options $displayoptions instance of display_options.

     * @param attempt_summary_information|array $summarydata summary information about the attempt.

     *      Passing an array is deprecated.

     * @return string HTML to display.

     */

    public function review_question_page(

        quiz_attempt $attemptobj,

        $slot,

        $seq,

        display_options $displayoptions,

        $summarydata

    ) {

        if (is_array($summarydata)) {

            debugging(

                'Since Moodle 4.4, $summarydata passed to review_question_page should be a attempt_summary_information.',

                DEBUG_DEVELOPER

            );

            $summarydata = attempt_summary_information::create_from_legacy_array($summarydata);

        }

        $output = '';

        $output .= $this->header();

        $output .= html_writer::div($this->render($summarydata), 'mb-3');

        if (!is_null($seq)) {

            $output .= $attemptobj->render_question_at_step($slot, $seq, true, $this);

        } else {

            $output .= $attemptobj->render_question($slot, true, $this);

        }

        $output .= $this->close_window_button();

        $output .= $this->footer();

        return $output;

    }

    /**

     * Renders the review question pop-up.

     *

     * @param quiz_attempt $attemptobj an instance of quiz_attempt.

     * @param string $message Why the review is not allowed.

     * @return string html to output.

     */

    public function review_question_not_allowed(quiz_attempt $attemptobj, $message)

    {

        $output = '';

        $output .= $this->header();

        $output .= $this->heading(format_string(

            $attemptobj->get_quiz_name(),

            true,

            ["context" => $attemptobj->get_quizobj()->get_context()]

        ));

        $output .= $this->notification($message);

        $output .= $this->close_window_button();

        $output .= $this->footer();

        return $output;

    }

    /**

     * A chance to filter the information before display.

     *

     * Moodle core uses this to display less infomrmation on pages after the first.

     * This is a separate method, becaus it is a useful hook where themes can overrid things.

     *

     * @param attempt_summary_information $summarydata the data that will be displayed. Modify as desired.

     * @param int $page contains the current page number

     */

    public function filter_review_attempt_summary(

        attempt_summary_information $summarydata,

        int $page

    ): void {

        if ($page > 0) {

            $summarydata->filter_keeping_only(['user', 'attemptlist']);

        }

    }

    /**

     * Outputs the overall summary of the attempt at the top of the review page.

     *

     * @param attempt_summary_information $summarydata contains row data for table.

     * @param int $page contains the current page number

     * @return string HTML to display.

     */

    public function review_attempt_summary(

        attempt_summary_information $summarydata,

        int $page

    ): string {

        $this->filter_review_attempt_summary($summarydata, $page);

        return html_writer::div($this->render($summarydata), 'mb-3');

    }

    /**

     * Filters the summarydata array.

     *

     * @param array $summarydata contains row data for table

     * @param int $page the current page number

     * @return array updated version of the $summarydata array.

     * @deprecated since Moodle 4.4. Replaced by filter_review_attempt_summary.

     */

    protected function filter_review_summary_table($summarydata, $page)

    {

        debugging('filter_review_summary_table() is deprecated. Replaced by filter_review_attempt_summary().', DEBUG_DEVELOPER);

        if ($page == 0) {

            return $summarydata;

        }

        // Only show some of summary table on subsequent pages.

        foreach ($summarydata as $key => $rowdata) {

            if (!in_array($key, ['user', 'attemptlist'])) {

                unset($summarydata[$key]);

            }

        }

        return $summarydata;

    }

    /**

     * Outputs the table containing data from summary data array

     *

     * @param array $summarydata contains row data for table

     * @param int $page contains the current page number

     * @return string HTML to display.

     * @deprecated since Moodle 4.4. Replaced by review_attempt_summary.

     */

    public function review_summary_table($summarydata, $page)

    {

        debugging('review_summary_table() is deprecated. Please use review_attempt_summary() instead.', DEBUG_DEVELOPER);

        $summarydata = $this->filter_review_summary_table($summarydata, $page);

        $this->render(attempt_summary_information::create_from_legacy_array($summarydata));

    }

    /**

     * Renders each question

     *

     * @param quiz_attempt $attemptobj instance of quiz_attempt

     * @param bool $reviewing

     * @param array $slots array of integers relating to questions

     * @param int $page current page number

     * @param bool $showall if true shows attempt on single page

     * @param display_options $displayoptions instance of display_options

     */

    public function questions(

        quiz_attempt $attemptobj,

        $reviewing,

        $slots,

        $page,

        $showall,

        display_options $displayoptions

    ) {

        $output = '';

        foreach ($slots as $slot) {

            $output .= $attemptobj->render_question(

                $slot,

                $reviewing,

                $this,

                $attemptobj->review_url($slot, $page, $showall)

            );

        }

        return $output;

    }

    /**

     * Renders the main bit of the review page.

     *

     * @param int $page current page number

     * @param bool $showall if true display attempt on one page

     * @param display_options $displayoptions instance of display_options

     * @param string $content the rendered display of each question

     * @param quiz_attempt $attemptobj instance of quiz_attempt

     * @return string HTML to display.

     */

    public function review_form($page, $showall, $displayoptions, $content, $attemptobj)

    {

        if ($displayoptions->flags != question_display_options::EDITABLE) {

            return $content;

        }

        $this->page->requires->js_init_call(

            'M.mod_quiz.init_review_form',

            null,

            false,

            quiz_get_js_module()

        );

        $output = '';

        $output .= html_writer::start_tag('form', ['action' => $attemptobj->review_url(

            null,

            $page,

            $showall

        ), 'method' => 'post', 'class' => 'questionflagsaveform']);

        $output .= html_writer::start_tag('div');

        $output .= $content;

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'sesskey',

            'value' => sesskey()

        ]);

        $output .= html_writer::start_tag('div', ['class' => 'submitbtns']);

        $output .= html_writer::empty_tag('input', [

            'type' => 'submit',

            'class' => 'questionflagsavebutton btn btn-secondary',

            'name' => 'savingflags',

            'value' => get_string('saveflags', 'question')

        ]);

        $output .= html_writer::end_tag('div');

        $output .= html_writer::end_tag('div');

        $output .= html_writer::end_tag('form');

        return $output;

    }

    /**

     * Returns either a link or button.

     *

     * @param quiz_attempt $attemptobj instance of quiz_attempt

     */

    public function finish_review_link(quiz_attempt $attemptobj)

    {

        $url = $attemptobj->view_url();

        if ($attemptobj->get_access_manager(time())->attempt_must_be_in_popup()) {

            $this->page->requires->js_init_call(

                'M.mod_quiz.secure_window.init_close_button',

                [$url->out(false)],

                false,

                quiz_get_js_module()

            );

            return html_writer::empty_tag('input', [

                'type' => 'button',

                'value' => get_string('finishreview', 'quiz'),

                'id' => 'secureclosebutton',

                'class' => 'mod_quiz-next-nav btn btn-primary'

            ]);

        } else {

            return html_writer::link(

                $url,

                get_string('finishreview', 'quiz'),

                ['class' => 'mod_quiz-next-nav']

            );

        }

    }

    /**

     * Creates the navigation links/buttons at the bottom of the review attempt page.

     *

     * Note, the name of this function is no longer accurate, but when the design

     * changed, it was decided to keep the old name for backwards compatibility.

     *

     * @param quiz_attempt $attemptobj instance of quiz_attempt

     * @param int $page the current page

     * @param bool $lastpage if true current page is the last page

     * @param bool|null $showall if true, the URL will be to review the entire attempt on one page,

     *      and $page will be ignored. If null, a sensible default will be chosen.

     *

     * @return string HTML fragment.

     */

    public function review_next_navigation(quiz_attempt $attemptobj, $page, $lastpage, $showall = null)

    {

        $nav = '';

        if ($page > 0) {

            $nav .= link_arrow_left(

                get_string('navigateprevious', 'quiz'),

                $attemptobj->review_url(null, $page - 1, $showall),

                false,

                'mod_quiz-prev-nav'

            );

        }

        if ($lastpage) {

            $nav .= $this->finish_review_link($attemptobj);

        } else {

            $nav .= link_arrow_right(

                get_string('navigatenext', 'quiz'),

                $attemptobj->review_url(null, $page + 1, $showall),

                false,

                'mod_quiz-next-nav'

            );

        }

        return html_writer::tag('div', $nav, ['class' => 'submitbtns']);

    }

    /**

     * Return the HTML of the quiz timer.

     *

     * @param quiz_attempt $attemptobj instance of quiz_attempt

     * @param int $timenow timestamp to use as 'now'.

     * @return string HTML content.

     */

    public function countdown_timer(quiz_attempt $attemptobj, $timenow)

    {

        $timeleft = $attemptobj->get_time_left_display($timenow);

        if ($timeleft !== false) {

            $ispreview = $attemptobj->is_preview();

            $timerstartvalue = $timeleft;

            if (!$ispreview) {

                // Make sure the timer starts just above zero. If $timeleft was <= 0, then

                // this will just have the effect of causing the quiz to be submitted immediately.

                $timerstartvalue = max($timerstartvalue, 1);

            }

            $this->initialise_timer($timerstartvalue, $ispreview);

        }

        return $this->output->render_from_template('mod_quiz/timer', (object) []);

    }

    /**

     * Create a preview link

     *

     * @param moodle_url $url URL to restart the attempt.

     */

    public function restart_preview_button($url)

    {

        return $this->single_button($url, get_string('startnewpreview', 'quiz'));

    }

    /**

     * Outputs the navigation block panel

     *

     * @param navigation_panel_base $panel

     */

    public function navigation_panel(navigation_panel_base $panel)

    {

        $output = '';

        $userpicture = $panel->user_picture();

        if ($userpicture) {

            $fullname = fullname($userpicture->user);

            if ($userpicture->size) {

                $fullname = html_writer::div($fullname);

            }

            $output .= html_writer::tag(

                'div',

                $this->render($userpicture) . $fullname,

                ['id' => 'user-picture', 'class' => 'clearfix']

            );

        }

        $output .= $panel->render_before_button_bits($this);

        $bcc = $panel->get_button_container_class();

        $output .= html_writer::start_tag('div', ['class' => "qn_buttons clearfix $bcc"]);

        foreach ($panel->get_question_buttons() as $button) {

            $output .= $this->render($button);

        }

        $output .= html_writer::end_tag('div');

        $output .= html_writer::tag(

            'div',

            $panel->render_end_bits($this),

            ['class' => 'othernav']

        );

        $this->page->requires->js_init_call(

            'M.mod_quiz.nav.init',

            null,

            false,

            quiz_get_js_module()

        );

        return $output;

    }

    /**

     * Display a quiz navigation button.

     *

     * @param navigation_question_button $button

     * @return string HTML fragment.

     */

    protected function render_navigation_question_button(navigation_question_button $button)

    {

        $classes = ['qnbutton', $button->stateclass, $button->navmethod, 'btn'];

        $extrainfo = [];

        if ($button->currentpage) {

            $classes[] = 'thispage';

            $extrainfo[] = get_string('onthispage', 'quiz');

        }

        // Flagged?

        if ($button->flagged) {

            $classes[] = 'flagged';

            $flaglabel = get_string('flagged', 'question');

        } else {

            $flaglabel = '';

        }

        $extrainfo[] = html_writer::tag('span', $flaglabel, ['class' => 'flagstate']);

        if ($button->isrealquestion) {

            $qnostring = 'questionnonav';

        } else {

            $qnostring = 'questionnonavinfo';

        }

        $tooltip = get_string('questionx', 'question', s($button->number)) . ' - ' . $button->statestring;

        $a = new stdClass();

        $a->number = s($button->number);

        $a->attributes = implode(' ', $extrainfo);

        $tagcontents = html_writer::tag('span', '', ['class' => 'thispageholder']) .

            html_writer::tag('span', '', ['class' => 'trafficlight']) .

            get_string($qnostring, 'quiz', $a);

        $tagattributes = [

            'class' => implode(' ', $classes),

            'id' => $button->id,

            'title' => $tooltip,

            'data-quiz-page' => $button->page

        ];

        if ($button->url) {

            return html_writer::link($button->url, $tagcontents, $tagattributes);

        } else {

            return html_writer::tag('span', $tagcontents, $tagattributes);

        }

    }

    /**

     * Display a quiz navigation heading.

     *

     * @param navigation_section_heading $heading the heading.

     * @return string HTML fragment.

     */

    protected function render_navigation_section_heading(navigation_section_heading $heading)

    {

        if (empty($heading->heading)) {

            $headingtext = get_string('sectionnoname', 'quiz');

            $class = ' dimmed_text';

        } else {

            $headingtext = $heading->heading;

            $class = '';

        }

        return $this->heading($headingtext, 3, 'mod_quiz-section-heading' . $class);

    }

    /**

     * Renders a list of links the other attempts.

     *

     * @param links_to_other_attempts $links

     * @return string HTML fragment.

     */

    protected function render_links_to_other_attempts(

        links_to_other_attempts $links

    ) {

        $attemptlinks = [];

        foreach ($links->links as $attempt => $url) {

            if (!$url) {

                $attemptlinks[] = html_writer::tag('strong', $attempt);

            } else {

                if ($url instanceof renderable) {

                    $attemptlinks[] = $this->render($url);

                } else {

                    $attemptlinks[] = html_writer::link($url, $attempt);

                }

            }

        }

        return implode(', ', $attemptlinks);

    }

    /**

     * Render a {@see grade_out_of}.

     *

     * Most of the logic is in methods of the grade_out_of class. However,

     * having this renderer method allows themes to override the default rendering.

     *

     * @param grade_out_of $grade

     * @return string HTML to output.

     */

    protected function render_grade_out_of(grade_out_of $grade): string

    {

        return get_string(

            $grade->get_string_key(),

            'quiz',

            $grade->style_formatted_values($grade->get_formatted_values())

        );

    }

    /**

     * Render the 'start attempt' page.

     *

     * The student gets here if their interaction with the preflight check

     * from fails in some way (e.g. they typed the wrong password).

     *

     * @param \mod_quiz\quiz_settings $quizobj

     * @param preflight_check_form $mform

     * @return string

     */

    public function start_attempt_page(quiz_settings $quizobj, preflight_check_form $mform)

    {

        $output = '';

        $output .= $this->header();

        $output .= $this->during_attempt_tertiary_nav($quizobj->view_url());

        $output .= $this->heading(format_string(

            $quizobj->get_quiz_name(),

            true,

            ["context" => $quizobj->get_context()]

        ));

        $output .= $this->quiz_intro($quizobj->get_quiz(), $quizobj->get_cm());

        $output .= $mform->render();

        $output .= $this->footer();

        return $output;

    }

    /**

     * Attempt Page

     *

     * @param quiz_attempt $attemptobj Instance of quiz_attempt

     * @param int $page Current page number

     * @param access_manager $accessmanager Instance of access_manager

     * @param array $messages An array of messages

     * @param array $slots Contains an array of integers that relate to questions

     * @param int $id The ID of an attempt

     * @param int $nextpage The number of the next page

     * @return string HTML to output.

     */

    public function attempt_page(

        $attemptobj,

        $page,

        $accessmanager,

        $messages,

        $slots,

        $id,

        $nextpage

    ) {

        $output = '';

        $output .= $this->header();

        $output .= $this->during_attempt_tertiary_nav($attemptobj->view_url());

        $output .= $this->quiz_notices($messages);

        $output .= $this->countdown_timer($attemptobj, time());

        $output .= $this->attempt_form($attemptobj, $page, $slots, $id, $nextpage);

        $output .= $this->footer();

        return $output;

    }

    /**

     * Render the tertiary navigation for pages during the attempt.

     *

     * @param string|moodle_url $quizviewurl url of the view.php page for this quiz.

     * @return string HTML to output.

     */

    public function during_attempt_tertiary_nav($quizviewurl): string

    {

        $output = '';

        $output .= html_writer::start_div('container-fluid tertiary-navigation');

        $output .= html_writer::start_div('row');

        $output .= html_writer::start_div('navitem');

        $output .= html_writer::link(

            $quizviewurl,

            get_string('back'),

            ['class' => 'btn btn-secondary']

        );

        $output .= html_writer::end_div();

        $output .= html_writer::end_div();

        $output .= html_writer::end_div();

        return $output;

    }

    /**

     * Returns any notices.

     *

     * @param array $messages

     */

    public function quiz_notices($messages)

    {

        if (!$messages) {

            return '';

        }

        return $this->notification(

            html_writer::tag('p', get_string('accessnoticesheader', 'quiz')) . $this->access_messages($messages),

            'warning',

            false

        );

    }

    /**

     * Outputs the form for making an attempt

     *

     * @param quiz_attempt $attemptobj

     * @param int $page Current page number

     * @param array $slots Array of integers relating to questions

     * @param int $id ID of the attempt

     * @param int $nextpage Next page number

     */

    public function attempt_form($attemptobj, $page, $slots, $id, $nextpage)

    {

        $output = '';

        // Start the form.

        $output .= html_writer::start_tag(

            'form',

            [

                'action' => new moodle_url(

                    $attemptobj->processattempt_url(),

                    ['cmid' => $attemptobj->get_cmid()]

                ),

                'method' => 'post',

                'enctype' => 'multipart/form-data',

                'accept-charset' => 'utf-8',

                'id' => 'responseform'

            ]

        );

        $output .= html_writer::start_tag('div');

        // Print all the questions.

        foreach ($slots as $slot) {

            $output .= $attemptobj->render_question(

                $slot,

                false,

                $this,

                $attemptobj->attempt_url($slot, $page)

            );

        }

        $navmethod = $attemptobj->get_quiz()->navmethod;

        $output .= $this->attempt_navigation_buttons($page, $attemptobj->is_last_page($page), $navmethod);

        // Some hidden fields to track what is going on.

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'attempt',

            'value' => $attemptobj->get_attemptid()

        ]);

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'thispage',

            'value' => $page,

            'id' => 'followingpage'

        ]);

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'nextpage',

            'value' => $nextpage

        ]);

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'timeup',

            'value' => '0',

            'id' => 'timeup'

        ]);

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'sesskey',

            'value' => sesskey()

        ]);

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'mdlscrollto',

            'value' => '',

            'id' => 'mdlscrollto'

        ]);

        // Add a hidden field with questionids. Do this at the end of the form, so

        // if you navigate before the form has finished loading, it does not wipe all

        // the student's answers.

        $output .= html_writer::empty_tag('input', [

            'type' => 'hidden',

            'name' => 'slots',

            'value' => implode(',', $attemptobj->get_active_slots($page))

        ]);

        // Finish the form.

        $output .= html_writer::end_tag('div');

        $output .= html_writer::end_tag('form');

        $output .= $this->connection_warning();

        return $output;

    }

    /**

     * Display the prev/next buttons that go at the bottom of each page of the attempt.

     *

     * @param int $page the page number. Starts at 0 for the first page.

     * @param bool $lastpage is this the last page in the quiz?

     * @param string $navmethod Optional quiz attribute, 'free' (default) or 'sequential'

     * @return string HTML fragment.

     */

    protected function attempt_navigation_buttons($page, $lastpage, $navmethod = 'free')

    {

        $output = '';

        $output .= html_writer::start_tag('div', ['class' => 'submitbtns']);

        if ($page > 0 && $navmethod == 'free') {

            $output .= html_writer::empty_tag('input', [

                'type' => 'submit',

                'name' => 'previous',

                'value' => get_string('navigateprevious', 'quiz'),

                'class' => 'mod_quiz-prev-nav btn btn-secondary',

                'id' => 'mod_quiz-prev-nav'

            ]);

            $this->page->requires->js_call_amd('core_form/submit', 'init', ['mod_quiz-prev-nav']);

        }

        if ($lastpage) {

            $nextlabel = get_string('endtest', 'quiz');

        } else {

            $nextlabel = get_string('navigatenext', 'quiz');

        }

        $output .= html_writer::empty_tag('input', [

            'type' => 'submit',

            'name' => 'next',

            'value' => $nextlabel,

            'class' => 'mod_quiz-next-nav btn btn-primary',

            'id' => 'mod_quiz-next-nav'

        ]);

        $output .= html_writer::end_tag('div');

        $this->page->requires->js_call_amd('core_form/submit', 'init', ['mod_quiz-next-nav']);

        return $output;

    }

    /**

     * Render a button which allows students to redo a question in the attempt.

     *

     * @param int $slot the number of the slot to generate the button for.

     * @param bool $disabled if true, output the button disabled.

     * @return string HTML fragment.

     */

    public function redo_question_button($slot, $disabled)

    {

        $attributes = [

            'type' => 'submit',

            'name' => 'redoslot' . $slot,

            'value' => get_string('redoquestion', 'quiz'),

            'class' => 'mod_quiz-redo_question_button btn btn-secondary',

            'id' => 'redoslot' . $slot . '-submit',

            'data-savescrollposition' => 'true',

        ];

        if ($disabled) {

            $attributes['disabled'] = 'disabled';

        } else {

            $this->page->requires->js_call_amd('core_question/question_engine', 'initSubmitButton', [$attributes['id']]);

        }

        return html_writer::div(html_writer::empty_tag('input', $attributes));

    }

    /**

     * Initialise the JavaScript required to initialise the countdown timer.

     *

     * @param int $timerstartvalue time remaining, in seconds.

     * @param bool $ispreview true if this is a preview attempt.

     */

    public function initialise_timer($timerstartvalue, $ispreview)

    {

        $options = [$timerstartvalue, (bool) $ispreview];

        $this->page->requires->js_init_call('M.mod_quiz.timer.init', $options, false, quiz_get_js_module());

    }

    /**

     * Output a page with an optional message, and JavaScript code to close the

     * current window and redirect the parent window to a new URL.

     *

     * @param moodle_url $url the URL to redirect the parent window to.

     * @param string $message message to display before closing the window. (optional)

     * @return string HTML to output.

     */

    public function close_attempt_popup($url, $message = '')

    {

        $output = '';

        $output .= $this->header();

        $output .= $this->box_start();

        if ($message) {

            $output .= html_writer::tag('p', $message);

            $output .= html_writer::tag('p', get_string('windowclosing', 'quiz'));

            $delay = 5;

        } else {

            $output .= html_writer::tag('p', get_string('pleaseclose', 'quiz'));

            $delay = 0;

        }

        $this->page->requires->js_init_call(

            'M.mod_quiz.secure_window.close',

            [$url->out(false), $delay],

            false,

            quiz_get_js_module()

        );

        $output .= $this->box_end();

        $output .= $this->footer();

        return $output;

    }

    /**

     * Print each message in an array, surrounded by <p>, </p> tags.

     *

     * @param array $messages the array of message strings.

     * @return string HTML to output.

     */

    public function access_messages($messages)

    {

        $output = '';

        foreach ($messages as $message) {

            $output .= html_writer::tag('p', $message, ['class' => 'text-left']);

        }

        return $output;

    }

    /*

     * Summary Page

     */

    /**

     * Create the summary page

     *

     * @param quiz_attempt $attemptobj

     * @param display_options $displayoptions

     */

    public function summary_page($attemptobj, $displayoptions)

    {

        $output = '';

        $output .= $this->header();

        $output .= $this->during_attempt_tertiary_nav($attemptobj->view_url());

        $output .= $this->heading(format_string($attemptobj->get_quiz_name()));

        $output .= $this->heading(get_string('summaryofattempt', 'quiz'), 3);

        $output .= $this->summary_table($attemptobj, $displayoptions);

        $output .= $this->summary_page_controls($attemptobj);

        $output .= $this->footer();

        return $output;

    }

    /**

     * Generates the table of summarydata

     *

     * @param quiz_attempt $attemptobj

     * @param display_options $displayoptions

     */

    public function summary_table($attemptobj, $displayoptions)

    {

        // Prepare the summary table header.

        $table = new html_table();

        $table->attributes['class'] = 'generaltable quizsummaryofattempt boxaligncenter';

        $table->head = [get_string('question', 'quiz'), get_string('status', 'quiz')];

        $table->align = ['left', 'left'];

        $table->size = ['', ''];

        $markscolumn = $displayoptions->marks >= question_display_options::MARK_AND_MAX;

        if ($markscolumn) {

            $table->head[] = get_string('marks', 'quiz');

            $table->align[] = 'left';

            $table->size[] = '';

        }

        $tablewidth = count($table->align);

        $table->data = [];

        // Get the summary info for each question.

        $slots = $attemptobj->get_slots();

        foreach ($slots as $slot) {

            // Add a section headings if we need one here.

            $heading = $attemptobj->get_heading_before_slot($slot);

            if ($heading !== null) {

                // There is a heading here.

                $rowclasses = 'quizsummaryheading';

                if ($heading) {

                    $heading = format_string($heading);

                } else {

                    if (count($attemptobj->get_quizobj()->get_sections()) > 1) {

                        // If this is the start of an unnamed section, and the quiz has more

                        // than one section, then add a default heading.

                        $heading = get_string('sectionnoname', 'quiz');

                        $rowclasses .= ' dimmed_text';

                    }

                }

                $cell = new html_table_cell(format_string($heading));

                $cell->header = true;

                $cell->colspan = $tablewidth;

                $table->data[] = [$cell];

                $table->rowclasses[] = $rowclasses;

            }

            // Don't display information items.

            if (!$attemptobj->is_real_question($slot)) {

                continue;

            }

            // Real question, show it.

            $flag = '';

            if ($attemptobj->is_question_flagged($slot)) {

                // Quiz has custom JS manipulating these image tags - so we can't use the pix_icon method here.

                $flag = html_writer::empty_tag('img', [

                    'src' => $this->image_url('i/flagged'),

                    'alt' => get_string('flagged', 'question'),

                    'class' => 'questionflag icon-post'

                ]);

            }

            if ($attemptobj->can_navigate_to($slot)) {

                $row = [