Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

/**
 * End of branch table
 *
 * @package mod_lesson
 * @copyright  2009 Sam Hemelryk
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 **/

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

 /** End of Branch page */
define("LESSON_PAGE_ENDOFBRANCH",   "21");

class lesson_page_type_endofbranch extends lesson_page {

    protected $type = lesson_page::TYPE_STRUCTURE;
    protected $typeidstring = 'endofbranch';
    protected $typeid = LESSON_PAGE_ENDOFBRANCH;
    protected $string = null;
    protected $jumpto = null;

    public function display($renderer, $attempt) {
        return '';
    }
    public function get_typeid() {
        return $this->typeid;
    }
    public function get_typestring() {
        if ($this->string===null) {
            $this->string = get_string($this->typeidstring, 'lesson');
        }
        return $this->string;
    }
    public function get_idstring() {
        return $this->typeidstring;
    }
    public function callback_on_view($canmanage, $redirect = true) {
        return (int) $this->redirect_to_first_answer($canmanage, $redirect);
    }

    public function redirect_to_first_answer($canmanage, $redirect) {
        global $USER, $PAGE;
        $answers = $this->get_answers();
        $answer = array_shift($answers);
        $jumpto = $answer->jumpto;
        if ($jumpto == LESSON_RANDOMBRANCH) {

            $jumpto = lesson_unseen_branch_jump($this->lesson, $USER->id);

        } elseif ($jumpto == LESSON_CLUSTERJUMP) {

            if (!$canmanage) {
                $jumpto = $this->lesson->cluster_jump($this->properties->id);
            } else {
                if ($this->properties->nextpageid == 0) {
                    $jumpto = LESSON_EOL;
                } else {
                    $jumpto = $this->properties->nextpageid;
                }
            }

        } else if ($answer->jumpto == LESSON_NEXTPAGE) {

            if ($this->properties->nextpageid == 0) {
                $jumpto = LESSON_EOL;
            } else {
                $jumpto = $this->properties->nextpageid;
            }

        } else if ($jumpto == 0) {

            $jumpto = $this->properties->id;

        } else if ($jumpto == LESSON_PREVIOUSPAGE) {

            $jumpto = $this->properties->prevpageid;

        }

        if ($redirect) {
            redirect(new moodle_url('/mod/lesson/view.php', array('id' => $PAGE->cm->id, 'pageid' => $jumpto)));
            die;
        }
        return $jumpto;
    }
    public function get_grayout() {
        return 1;
    }

    public function add_page_link($previd) {
        global $PAGE, $CFG;
        if ($previd != 0) {
            $addurl = new moodle_url('/mod/lesson/editpage.php', array('id'=>$PAGE->cm->id, 'pageid'=>$previd, 'sesskey'=>sesskey(), 'qtype'=>LESSON_PAGE_ENDOFBRANCH));
            return array('addurl'=>$addurl, 'type'=>LESSON_PAGE_ENDOFBRANCH, 'name'=>get_string('addanendofbranch', 'lesson'));
        }
        return false;
    }
    public function valid_page_and_view(&$validpages, &$pageviews) {
        return $this->properties->nextpageid;
    }
> } > /** > * Creates answers within the database for this end of cluster page. Usually only ever class lesson_add_page_form_endofbranch extends lesson_add_page_form_base { > * called when creating a new page instance. > * @param object $properties public $qtype = LESSON_PAGE_ENDOFBRANCH; > * @return array public $qtypestring = 'endofbranch'; > */ protected $standard = false; > public function create_answers($properties) { > global $DB; public function custom_definition() { > global $PAGE, $CFG; > $newanswer = new stdClass; > $newanswer->lessonid = $this->lesson->id; $mform = $this->_form; > $newanswer->pageid = $this->properties->id; $lesson = $this->_customdata['lesson']; > $newanswer->timecreated = $this->properties->timecreated; $jumptooptions = lesson_page_type_branchtable::get_jumptooptions(optional_param('firstpage', false, PARAM_BOOL), $lesson); > > if (isset($properties->jumpto[0])) { $mform->addElement('hidden', 'firstpage'); > $newanswer->jumpto = $properties->jumpto[0]; $mform->setType('firstpage', PARAM_BOOL); > } > $newanswer->id = $DB->insert_record('lesson_answers', $newanswer); $mform->addElement('hidden', 'qtype'); > $answers = [$newanswer->id => new lesson_page_answer($newanswer)]; $mform->setType('qtype', PARAM_TEXT); > $this->answers = $answers; > return $answers; $mform->addElement('text', 'title', get_string("pagetitle", "lesson"), array('size'=>70)); > }
if (!empty($CFG->formatstringstriptags)) { $mform->setType('title', PARAM_TEXT); } else { $mform->setType('title', PARAM_CLEANHTML); } $this->editoroptions = array('noclean'=>true, 'maxfiles'=>EDITOR_UNLIMITED_FILES, 'maxbytes'=>$PAGE->course->maxbytes); $mform->addElement('editor', 'contents_editor', get_string("pagecontents", "lesson"), null, $this->editoroptions); $mform->setType('contents_editor', PARAM_RAW); $this->add_jumpto(0); } public function construction_override($pageid, lesson $lesson) { global $DB, $CFG, $PAGE; require_sesskey(); // first get the preceeding page $timenow = time(); // the new page is not the first page (end of branch always comes after an existing page) if (!$page = $DB->get_record("lesson_pages", array("id" => $pageid))) {
< print_error('cannotfindpagerecord', 'lesson');
> throw new \moodle_exception('cannotfindpagerecord', 'lesson');
} // chain back up to find the (nearest branch table) $btpage = clone($page); $btpageid = $btpage->id; while (($btpage->qtype != LESSON_PAGE_BRANCHTABLE) && ($btpage->prevpageid > 0)) { $btpageid = $btpage->prevpageid; if (!$btpage = $DB->get_record("lesson_pages", array("id" => $btpageid))) {
< print_error('cannotfindpagerecord', 'lesson');
> throw new \moodle_exception('cannotfindpagerecord', 'lesson');
} } if ($btpage->qtype == LESSON_PAGE_BRANCHTABLE) { $newpage = new stdClass; $newpage->lessonid = $lesson->id; $newpage->prevpageid = $pageid; $newpage->nextpageid = $page->nextpageid; $newpage->qtype = $this->qtype; $newpage->timecreated = $timenow; $newpage->title = get_string("endofbranch", "lesson"); $newpage->contents = get_string("endofbranch", "lesson"); $newpageid = $DB->insert_record("lesson_pages", $newpage); // update the linked list... $DB->set_field("lesson_pages", "nextpageid", $newpageid, array("id" => $pageid)); if ($page->nextpageid) { // the new page is not the last page $DB->set_field("lesson_pages", "prevpageid", $newpageid, array("id" => $page->nextpageid)); } // ..and the single "answer" $newanswer = new stdClass; $newanswer->lessonid = $lesson->id; $newanswer->pageid = $newpageid; $newanswer->timecreated = $timenow; $newanswer->jumpto = $btpageid; $newanswerid = $DB->insert_record("lesson_answers", $newanswer); $lesson->add_message(get_string('addedanendofbranch', 'lesson'), 'notifysuccess'); } else { $lesson->add_message(get_string('nobranchtablefound', 'lesson')); } redirect($CFG->wwwroot."/mod/lesson/edit.php?id=".$PAGE->cm->id); } }