Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.

Differences Between: [Versions 39 and 401] [Versions 39 and 402] [Versions 39 and 403]

   1  <?php
   2  
   3  // This file is part of Moodle - http://moodle.org/
   4  //
   5  // Moodle is free software: you can redistribute it and/or modify
   6  // it under the terms of the GNU General Public License as published by
   7  // the Free Software Foundation, either version 3 of the License, or
   8  // (at your option) any later version.
   9  //
  10  // Moodle is distributed in the hope that it will be useful,
  11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  // GNU General Public License for more details.
  14  //
  15  // You should have received a copy of the GNU General Public License
  16  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  17  
  18  /**
  19   * End of cluster
  20   *
  21   * @package mod_lesson
  22   * @copyright  2009 Sam Hemelryk
  23   * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24   **/
  25  
  26  defined('MOODLE_INTERNAL') || die();
  27  
  28   /** End of Cluster page */
  29  define("LESSON_PAGE_ENDOFCLUSTER",   "31");
  30  
  31  class lesson_page_type_endofcluster extends lesson_page {
  32  
  33      protected $type = lesson_page::TYPE_STRUCTURE;
  34      protected $typeidstring = 'endofcluster';
  35      protected $typeid = LESSON_PAGE_ENDOFCLUSTER;
  36      protected $string = null;
  37      protected $jumpto = null;
  38  
  39      public function display($renderer, $attempt) {
  40          return '';
  41      }
  42      public function get_typeid() {
  43          return $this->typeid;
  44      }
  45      public function get_typestring() {
  46          if ($this->string===null) {
  47              $this->string = get_string($this->typeidstring, 'lesson');
  48          }
  49          return $this->string;
  50      }
  51      public function get_idstring() {
  52          return $this->typeidstring;
  53      }
  54      public function callback_on_view($canmanage, $redirect = true) {
  55          return (int) $this->redirect_to_next_page($canmanage, $redirect);
  56      }
  57      public function redirect_to_next_page($canmanage, $redirect) {
  58          global $PAGE;
  59          if ($this->properties->nextpageid == 0) {
  60              $nextpageid = LESSON_EOL;
  61          } else {
  62              $nextpageid = $this->properties->nextpageid;
  63          }
  64          if ($redirect) {
  65              redirect(new moodle_url('/mod/lesson/view.php', array('id' => $PAGE->cm->id, 'pageid' => $nextpageid)));
  66              die;
  67          }
  68          return $nextpageid;
  69      }
  70      public function get_grayout() {
  71          return 1;
  72      }
  73  
  74      public function override_next_page() {
  75          global $DB;
  76          $jump = $DB->get_field("lesson_answers", "jumpto", array("pageid" => $this->properties->id, "lessonid" => $this->lesson->id));
  77          if ($jump == LESSON_NEXTPAGE) {
  78              if ($this->properties->nextpageid == 0) {
  79                  return LESSON_EOL;
  80              } else {
  81                  return $this->properties->nextpageid;
  82              }
  83          } else {
  84              return $jump;
  85          }
  86      }
  87      public function add_page_link($previd) {
  88          global $PAGE, $CFG;
  89          if ($previd != 0) {
  90              $addurl = new moodle_url('/mod/lesson/editpage.php', array('id'=>$PAGE->cm->id, 'pageid'=>$previd, 'sesskey'=>sesskey(), 'qtype'=>LESSON_PAGE_ENDOFCLUSTER));
  91              return array('addurl'=>$addurl, 'type'=>LESSON_PAGE_ENDOFCLUSTER, 'name'=>get_string('addendofcluster', 'lesson'));
  92          }
  93          return false;
  94      }
  95      public function valid_page_and_view(&$validpages, &$pageviews) {
  96          return $this->properties->nextpageid;
  97      }
  98  }
  99  
 100  class lesson_add_page_form_endofcluster extends lesson_add_page_form_base {
 101  
 102      public $qtype = LESSON_PAGE_ENDOFCLUSTER;
 103      public $qtypestring = 'endofcluster';
 104      protected $standard = false;
 105  
 106      public function custom_definition() {
 107          global $PAGE, $CFG;
 108  
 109          $mform = $this->_form;
 110          $lesson = $this->_customdata['lesson'];
 111          $jumptooptions = lesson_page_type_branchtable::get_jumptooptions(optional_param('firstpage', false, PARAM_BOOL), $lesson);
 112  
 113          $mform->addElement('hidden', 'firstpage');
 114          $mform->setType('firstpage', PARAM_BOOL);
 115  
 116          $mform->addElement('hidden', 'qtype');
 117          $mform->setType('qtype', PARAM_TEXT);
 118  
 119          $mform->addElement('text', 'title', get_string("pagetitle", "lesson"), array('size'=>70));
 120          if (!empty($CFG->formatstringstriptags)) {
 121              $mform->setType('title', PARAM_TEXT);
 122          } else {
 123              $mform->setType('title', PARAM_CLEANHTML);
 124          }
 125  
 126          $this->editoroptions = array('noclean'=>true, 'maxfiles'=>EDITOR_UNLIMITED_FILES, 'maxbytes'=>$PAGE->course->maxbytes);
 127          $mform->addElement('editor', 'contents_editor', get_string("pagecontents", "lesson"), null, $this->editoroptions);
 128          $mform->setType('contents_editor', PARAM_RAW);
 129  
 130          $this->add_jumpto(0);
 131      }
 132  
 133      public function construction_override($pageid, lesson $lesson) {
 134          global $CFG, $PAGE, $DB;
 135          require_sesskey();
 136  
 137          $timenow = time();
 138  
 139          // the new page is not the first page (end of cluster always comes after an existing page)
 140          if (!$page = $DB->get_record("lesson_pages", array("id" => $pageid))) {
 141              print_error('cannotfindpages', 'lesson');
 142          }
 143  
 144          // could put code in here to check if the user really can insert an end of cluster
 145  
 146          $newpage = new stdClass;
 147          $newpage->lessonid = $lesson->id;
 148          $newpage->prevpageid = $pageid;
 149          $newpage->nextpageid = $page->nextpageid;
 150          $newpage->qtype = $this->qtype;
 151          $newpage->timecreated = $timenow;
 152          $newpage->title = get_string("endofclustertitle", "lesson");
 153          $newpage->contents = get_string("endofclustertitle", "lesson");
 154          $newpageid = $DB->insert_record("lesson_pages", $newpage);
 155          // update the linked list...
 156          $DB->set_field("lesson_pages", "nextpageid", $newpageid, array("id" => $pageid));
 157          if ($page->nextpageid) {
 158              // the new page is not the last page
 159              $DB->set_field("lesson_pages", "prevpageid", $newpageid, array("id" => $page->nextpageid));
 160          }
 161          // ..and the single "answer"
 162          $newanswer = new stdClass;
 163          $newanswer->lessonid = $lesson->id;
 164          $newanswer->pageid = $newpageid;
 165          $newanswer->timecreated = $timenow;
 166          $newanswer->jumpto = LESSON_NEXTPAGE;
 167          $newanswerid = $DB->insert_record("lesson_answers", $newanswer);
 168          $lesson->add_message(get_string('addedendofcluster', 'lesson'), 'notifysuccess');
 169          redirect($CFG->wwwroot.'/mod/lesson/edit.php?id='.$PAGE->cm->id);
 170      }
 171  }