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 310] [Versions 39 and 311] [Versions 39 and 400] [Versions 39 and 401] [Versions 39 and 402] [Versions 39 and 403]

   1  <?php
   2  // This file is part of Moodle - http://moodle.org/
   3  //
   4  // Moodle is free software: you can redistribute it and/or modify
   5  // it under the terms of the GNU General Public License as published by
   6  // the Free Software Foundation, either version 3 of the License, or
   7  // (at your option) any later version.
   8  //
   9  // Moodle is distributed in the hope that it will be useful,
  10  // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  // GNU General Public License for more details.
  13  //
  14  // You should have received a copy of the GNU General Public License
  15  // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16  
  17  /**
  18   * Tests for the moodle_page class.
  19   *
  20   * @package   core
  21   * @category  phpunit
  22   * @copyright 2009 Tim Hunt
  23   * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  24   */
  25  
  26  defined('MOODLE_INTERNAL') || die();
  27  
  28  global $CFG;
  29  require_once($CFG->libdir . '/pagelib.php');
  30  require_once($CFG->libdir . '/blocklib.php');
  31  
  32  
  33  class core_moodle_page_testcase extends advanced_testcase {
  34  
  35      /**
  36       * @var testable_moodle_page
  37       */
  38      protected $testpage;
  39  
  40      public function setUp() {
  41          parent::setUp();
  42          $this->resetAfterTest();
  43          $this->testpage = new testable_moodle_page();
  44      }
  45  
  46      public function test_course_returns_site_before_set() {
  47          global $SITE;
  48          // Validated.
  49          $this->assertSame($SITE, $this->testpage->course);
  50      }
  51  
  52      public function test_setting_course_works() {
  53          // Setup fixture.
  54          $course = $this->getDataGenerator()->create_course();
  55          $this->testpage->set_context(context_system::instance()); // Avoid trying to set the context.
  56          // Exercise SUT.
  57          $this->testpage->set_course($course);
  58          // Validated.
  59          $this->assertEquals($course, $this->testpage->course);
  60      }
  61  
  62      public function test_global_course_and_page_course_are_same_with_global_page() {
  63          global $COURSE, $PAGE;
  64          // Setup fixture.
  65          $course = $this->getDataGenerator()->create_course();
  66          $this->testpage->set_context(context_system::instance()); // Avoid trying to set the context.
  67          $PAGE = $this->testpage;
  68          // Exercise SUT.
  69          $this->testpage->set_course($course);
  70          // Validated.
  71          $this->assertSame($COURSE, $this->testpage->course);
  72      }
  73  
  74      public function test_global_course_not_changed_with_non_global_page() {
  75          global $COURSE;
  76          $originalcourse = $COURSE;
  77          // Setup fixture.
  78          $course = $this->getDataGenerator()->create_course();
  79          $this->testpage->set_context(context_system::instance()); // Avoid trying to set the context.
  80          // Exercise SUT.
  81          $this->testpage->set_course($course);
  82          // Validated.
  83          $this->assertSame($originalcourse, $COURSE);
  84      }
  85  
  86      /**
  87       * @expectedException coding_exception
  88       */
  89      public function test_cannot_set_course_once_theme_set() {
  90          // Setup fixture.
  91          $this->testpage->force_theme(theme_config::DEFAULT_THEME);
  92          $course = $this->getDataGenerator()->create_course();
  93  
  94          // Exercise SUT.
  95          $this->testpage->set_course($course);
  96      }
  97  
  98      /**
  99       * @expectedException coding_exception
 100       */
 101      public function test_cannot_set_category_once_theme_set() {
 102          // Setup fixture.
 103          $this->testpage->force_theme(theme_config::DEFAULT_THEME);
 104  
 105          // Exercise SUT.
 106          $this->testpage->set_category_by_id(123);
 107      }
 108  
 109      /**
 110       * @expectedException coding_exception
 111       */
 112      public function test_cannot_set_category_once_course_set() {
 113          // Setup fixture.
 114          $course = $this->getDataGenerator()->create_course();
 115          $this->testpage->set_context(context_system::instance()); // Avoid trying to set the context.
 116          $this->testpage->set_course($course);
 117  
 118          // Exercise SUT.
 119          $this->testpage->set_category_by_id(123);
 120      }
 121  
 122      public function test_categories_array_empty_for_front_page() {
 123          global $SITE;
 124          // Setup fixture.
 125          $this->testpage->set_context(context_system::instance()); // Avoid trying to set the context.
 126          $this->testpage->set_course($SITE);
 127          // Exercise SUT and validate.
 128          $this->assertEquals(array(), $this->testpage->categories);
 129      }
 130  
 131      public function test_set_state_normal_path() {
 132          $course = $this->getDataGenerator()->create_course();
 133          $this->testpage->set_context(context_system::instance());
 134          $this->testpage->set_course($course);
 135  
 136          $this->assertEquals(moodle_page::STATE_BEFORE_HEADER, $this->testpage->state);
 137  
 138          $this->testpage->set_state(moodle_page::STATE_PRINTING_HEADER);
 139          $this->assertEquals(moodle_page::STATE_PRINTING_HEADER, $this->testpage->state);
 140  
 141          $this->testpage->set_state(moodle_page::STATE_IN_BODY);
 142          $this->assertEquals(moodle_page::STATE_IN_BODY, $this->testpage->state);
 143  
 144          $this->testpage->set_state(moodle_page::STATE_DONE);
 145          $this->assertEquals(moodle_page::STATE_DONE, $this->testpage->state);
 146      }
 147  
 148      /**
 149       * @expectedException coding_exception
 150       */
 151      public function test_set_state_cannot_skip_one() {
 152          // Exercise SUT.
 153          $this->testpage->set_state(moodle_page::STATE_IN_BODY);
 154      }
 155  
 156      public function test_header_printed_false_initially() {
 157          // Validated.
 158          $this->assertFalse($this->testpage->headerprinted);
 159      }
 160  
 161      public function test_header_printed_becomes_true() {
 162          $course = $this->getDataGenerator()->create_course();
 163          $this->testpage->set_context(context_system::instance());
 164          $this->testpage->set_course($course);
 165  
 166          // Exercise SUT.
 167          $this->testpage->set_state(moodle_page::STATE_PRINTING_HEADER);
 168          $this->testpage->set_state(moodle_page::STATE_IN_BODY);
 169          // Validated.
 170          $this->assertTrue($this->testpage->headerprinted);
 171      }
 172  
 173      public function test_set_context() {
 174          // Setup fixture.
 175          $course = $this->getDataGenerator()->create_course();
 176          $context = context_course::instance($course->id);
 177          // Exercise SUT.
 178          $this->testpage->set_context($context);
 179          // Validated.
 180          $this->assertSame($context, $this->testpage->context);
 181      }
 182  
 183      public function test_pagetype_defaults_to_script() {
 184          global $SCRIPT;
 185          // Exercise SUT and validate.
 186          $SCRIPT = '/index.php';
 187          $this->testpage->initialise_default_pagetype();
 188          $this->assertSame('site-index', $this->testpage->pagetype);
 189      }
 190  
 191      public function test_set_pagetype() {
 192          // Exercise SUT.
 193          $this->testpage->set_pagetype('a-page-type');
 194          // Validated.
 195          $this->assertSame('a-page-type', $this->testpage->pagetype);
 196      }
 197  
 198      public function test_initialise_default_pagetype() {
 199          // Exercise SUT.
 200          $this->testpage->initialise_default_pagetype('admin/tool/unittest/index.php');
 201          // Validated.
 202          $this->assertSame('admin-tool-unittest-index', $this->testpage->pagetype);
 203      }
 204  
 205      public function test_initialise_default_pagetype_fp() {
 206          // Exercise SUT.
 207          $this->testpage->initialise_default_pagetype('index.php');
 208          // Validated.
 209          $this->assertSame('site-index', $this->testpage->pagetype);
 210      }
 211  
 212      public function test_get_body_classes_empty() {
 213          // Validated.
 214          $this->assertSame('', $this->testpage->bodyclasses);
 215      }
 216  
 217      public function test_get_body_classes_single() {
 218          // Exercise SUT.
 219          $this->testpage->add_body_class('aclassname');
 220          // Validated.
 221          $this->assertSame('aclassname', $this->testpage->bodyclasses);
 222      }
 223  
 224      public function test_get_body_classes() {
 225          // Exercise SUT.
 226          $this->testpage->add_body_classes(array('aclassname', 'anotherclassname'));
 227          // Validated.
 228          $this->assertSame('aclassname anotherclassname', $this->testpage->bodyclasses);
 229      }
 230  
 231      public function test_url_to_class_name() {
 232          $this->assertSame('example-com', $this->testpage->url_to_class_name('http://example.com'));
 233          $this->assertSame('example-com--80', $this->testpage->url_to_class_name('http://example.com:80'));
 234          $this->assertSame('example-com--moodle', $this->testpage->url_to_class_name('https://example.com/moodle'));
 235          $this->assertSame('example-com--8080--nested-moodle', $this->testpage->url_to_class_name('https://example.com:8080/nested/moodle'));
 236      }
 237  
 238      public function test_set_docs_path() {
 239          // Exercise SUT.
 240          $this->testpage->set_docs_path('a/file/path');
 241          // Validated.
 242          $this->assertSame('a/file/path', $this->testpage->docspath);
 243      }
 244  
 245      public function test_docs_path_defaults_from_pagetype() {
 246          // Exercise SUT.
 247          $this->testpage->set_pagetype('a-page-type');
 248          // Validated.
 249          $this->assertSame('a/page/type', $this->testpage->docspath);
 250      }
 251  
 252      public function test_set_url_root() {
 253          global $CFG;
 254          // Exercise SUT.
 255          $this->testpage->set_url('/');
 256          // Validated.
 257          $this->assertSame($CFG->wwwroot . '/', $this->testpage->url->out());
 258      }
 259  
 260      public function test_set_url_one_param() {
 261          global $CFG;
 262          // Exercise SUT.
 263          $this->testpage->set_url('/mod/quiz/attempt.php', array('attempt' => 123));
 264          // Validated.
 265          $this->assertSame($CFG->wwwroot . '/mod/quiz/attempt.php?attempt=123', $this->testpage->url->out());
 266      }
 267  
 268      public function test_set_url_two_params() {
 269          global $CFG;
 270          // Exercise SUT.
 271          $this->testpage->set_url('/mod/quiz/attempt.php', array('attempt' => 123, 'page' => 7));
 272          // Validated.
 273          $this->assertSame($CFG->wwwroot . '/mod/quiz/attempt.php?attempt=123&amp;page=7', $this->testpage->url->out());
 274      }
 275  
 276      public function test_set_url_using_moodle_url() {
 277          global $CFG;
 278          // Fixture setup.
 279          $url = new moodle_url('/mod/workshop/allocation.php', array('cmid' => 29, 'method' => 'manual'));
 280          // Exercise SUT.
 281          $this->testpage->set_url($url);
 282          // Validated.
 283          $this->assertSame($CFG->wwwroot . '/mod/workshop/allocation.php?cmid=29&amp;method=manual', $this->testpage->url->out());
 284      }
 285  
 286      public function test_set_url_sets_page_type() {
 287          // Exercise SUT.
 288          $this->testpage->set_url('/mod/quiz/attempt.php', array('attempt' => 123, 'page' => 7));
 289          // Validated.
 290          $this->assertSame('mod-quiz-attempt', $this->testpage->pagetype);
 291      }
 292  
 293      public function test_set_url_does_not_change_explicit_page_type() {
 294          // Setup fixture.
 295          $this->testpage->set_pagetype('a-page-type');
 296          // Exercise SUT.
 297          $this->testpage->set_url('/mod/quiz/attempt.php', array('attempt' => 123, 'page' => 7));
 298          // Validated.
 299          $this->assertSame('a-page-type', $this->testpage->pagetype);
 300      }
 301  
 302      public function test_set_subpage() {
 303          // Exercise SUT.
 304          $this->testpage->set_subpage('somestring');
 305          // Validated.
 306          $this->assertSame('somestring', $this->testpage->subpage);
 307      }
 308  
 309      public function test_set_heading() {
 310          // Exercise SUT.
 311          $this->testpage->set_heading('a heading');
 312          // Validated.
 313          $this->assertSame('a heading', $this->testpage->heading);
 314      }
 315  
 316      public function test_set_title() {
 317          // Exercise SUT.
 318          $this->testpage->set_title('a title');
 319          // Validated.
 320          $this->assertSame('a title', $this->testpage->title);
 321      }
 322  
 323      public function test_default_pagelayout() {
 324          // Exercise SUT and Validate.
 325          $this->assertSame('base', $this->testpage->pagelayout);
 326      }
 327  
 328      public function test_set_pagelayout() {
 329          // Exercise SUT.
 330          $this->testpage->set_pagelayout('type');
 331          // Validated.
 332          $this->assertSame('type', $this->testpage->pagelayout);
 333      }
 334  
 335      public function test_setting_course_sets_context() {
 336          // Setup fixture.
 337          $course = $this->getDataGenerator()->create_course();
 338          $context = context_course::instance($course->id);
 339  
 340          // Exercise SUT.
 341          $this->testpage->set_course($course);
 342  
 343          // Validated.
 344          $this->assertSame($context, $this->testpage->context);
 345      }
 346  
 347      public function test_set_category_top_level() {
 348          global $DB;
 349          // Setup fixture.
 350          $cat = $this->getDataGenerator()->create_category();
 351          $catdbrecord = $DB->get_record('course_categories', array('id' => $cat->id));
 352          // Exercise SUT.
 353          $this->testpage->set_category_by_id($cat->id);
 354          // Validated.
 355          $this->assertEquals($catdbrecord, $this->testpage->category);
 356          $this->assertSame(context_coursecat::instance($cat->id), $this->testpage->context);
 357      }
 358  
 359      public function test_set_nested_categories() {
 360          global $DB;
 361          // Setup fixture.
 362          $topcat = $this->getDataGenerator()->create_category();
 363          $topcatdbrecord = $DB->get_record('course_categories', array('id' => $topcat->id));
 364          $subcat = $this->getDataGenerator()->create_category(array('parent'=>$topcat->id));
 365          $subcatdbrecord = $DB->get_record('course_categories', array('id' => $subcat->id));
 366          // Exercise SUT.
 367          $this->testpage->set_category_by_id($subcat->id);
 368          // Validated.
 369          $categories = $this->testpage->categories;
 370          $this->assertCount(2, $categories);
 371          $this->assertEquals($topcatdbrecord, array_pop($categories));
 372          $this->assertEquals($subcatdbrecord, array_pop($categories));
 373      }
 374  
 375      public function test_cm_null_initially() {
 376          // Validated.
 377          $this->assertNull($this->testpage->cm);
 378      }
 379  
 380      public function test_set_cm() {
 381          // Setup fixture.
 382          $course = $this->getDataGenerator()->create_course();
 383          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 384          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 385          // Exercise SUT.
 386          $this->testpage->set_cm($cm);
 387          // Validated.
 388          $this->assertEquals($cm->id, $this->testpage->cm->id);
 389      }
 390  
 391      /**
 392       * @expectedException coding_exception
 393       */
 394      public function test_cannot_set_activity_record_before_cm() {
 395          // Setup fixture.
 396          $course = $this->getDataGenerator()->create_course();
 397          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 398          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 399          // Exercise SUT.
 400          $this->testpage->set_activity_record($forum);
 401      }
 402  
 403      public function test_setting_cm_sets_context() {
 404          // Setup fixture.
 405          $course = $this->getDataGenerator()->create_course();
 406          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 407          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 408          // Exercise SUT.
 409          $this->testpage->set_cm($cm);
 410          // Validated.
 411          $this->assertSame(context_module::instance($cm->id), $this->testpage->context);
 412      }
 413  
 414      public function test_activity_record_loaded_if_not_set() {
 415          // Setup fixture.
 416          $course = $this->getDataGenerator()->create_course();
 417          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 418          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 419          // Exercise SUT.
 420          $this->testpage->set_cm($cm);
 421          // Validated.
 422          unset($forum->cmid);
 423          $this->assertEquals($forum, $this->testpage->activityrecord);
 424      }
 425  
 426      public function test_set_activity_record() {
 427          // Setup fixture.
 428          $course = $this->getDataGenerator()->create_course();
 429          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 430          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 431          $this->testpage->set_cm($cm);
 432          // Exercise SUT.
 433          $this->testpage->set_activity_record($forum);
 434          // Validated.
 435          unset($forum->cmid);
 436          $this->assertEquals($forum, $this->testpage->activityrecord);
 437      }
 438  
 439      /**
 440       * @expectedException coding_exception
 441       */
 442      public function test_cannot_set_inconsistent_activity_record_course() {
 443          // Setup fixture.
 444          $course = $this->getDataGenerator()->create_course();
 445          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 446          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 447          $this->testpage->set_cm($cm);
 448          // Exercise SUT.
 449          $forum->course = 13;
 450          $this->testpage->set_activity_record($forum);
 451      }
 452  
 453      /**
 454       * @expectedException coding_exception
 455       */
 456      public function test_cannot_set_inconsistent_activity_record_instance() {
 457          // Setup fixture.
 458          $course = $this->getDataGenerator()->create_course();
 459          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 460          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 461          $this->testpage->set_cm($cm);
 462          // Exercise SUT.
 463          $forum->id = 13;
 464          $this->testpage->set_activity_record($forum);
 465      }
 466  
 467      public function test_setting_cm_sets_course() {
 468          // Setup fixture.
 469          $course = $this->getDataGenerator()->create_course();
 470          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 471          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 472          // Exercise SUT.
 473          $this->testpage->set_cm($cm);
 474          // Validated.
 475          $this->assertEquals($course->id, $this->testpage->course->id);
 476      }
 477  
 478      public function test_set_cm_with_course_and_activity_no_db() {
 479          // Setup fixture.
 480          $course = $this->getDataGenerator()->create_course();
 481          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 482          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 483          // This only works without db if we already have modinfo cache
 484          // Exercise SUT.
 485          $this->testpage->set_cm($cm, $course, $forum);
 486          // Validated.
 487          $this->assertEquals($cm->id, $this->testpage->cm->id);
 488          $this->assertEquals($course->id, $this->testpage->course->id);
 489          unset($forum->cmid);
 490          $this->assertEquals($forum, $this->testpage->activityrecord);
 491      }
 492  
 493      /**
 494       * @expectedException coding_exception
 495       */
 496      public function test_cannot_set_cm_with_inconsistent_course() {
 497          // Setup fixture.
 498          $course = $this->getDataGenerator()->create_course();
 499          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 500          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 501          // Exercise SUT.
 502          $cm->course = 13;
 503          $this->testpage->set_cm($cm, $course);
 504      }
 505  
 506      public function test_get_activity_name() {
 507          // Setup fixture.
 508          $course = $this->getDataGenerator()->create_course();
 509          $forum = $this->getDataGenerator()->create_module('forum', array('course'=>$course->id));
 510          $cm = get_coursemodule_from_id('forum', $forum->cmid);
 511          // Exercise SUT.
 512          $this->testpage->set_cm($cm, $course, $forum);
 513          // Validated.
 514          $this->assertSame('forum', $this->testpage->activityname);
 515      }
 516  
 517      public function test_user_is_editing_on() {
 518          // We are relying on the fact that unit tests are always run by admin, to
 519          // ensure the user_allows_editing call returns true.
 520  
 521          // Setup fixture.
 522          global $USER;
 523  
 524          $this->testpage->set_context(context_system::instance());
 525          $this->setAdminUser();
 526  
 527          $USER->editing = true;
 528          // Validated.
 529          $this->assertTrue($this->testpage->user_is_editing());
 530      }
 531  
 532      public function test_user_is_editing_off() {
 533          // We are relying on the fact that unit tests are always run by admin, to
 534          // ensure the user_allows_editing call returns true.
 535  
 536          // Setup fixture.
 537          global $USER;
 538  
 539          $this->testpage->set_context(context_system::instance());
 540          $this->setAdminUser();
 541  
 542          $USER->editing = false;
 543          // Validated.
 544          $this->assertFalse($this->testpage->user_is_editing());
 545      }
 546  
 547      public function test_default_editing_capabilities() {
 548          $this->testpage->set_context(context_system::instance());
 549          $this->setAdminUser();
 550  
 551          // Validated.
 552          $this->assertEquals(array('moodle/site:manageblocks'), $this->testpage->all_editing_caps());
 553      }
 554  
 555      public function test_other_block_editing_cap() {
 556          $this->testpage->set_context(context_system::instance());
 557          $this->setAdminUser();
 558  
 559          // Exercise SUT.
 560          $this->testpage->set_blocks_editing_capability('moodle/my:manageblocks');
 561          // Validated.
 562          $this->assertEquals(array('moodle/my:manageblocks'), $this->testpage->all_editing_caps());
 563      }
 564  
 565      public function test_other_editing_cap() {
 566          $this->testpage->set_context(context_system::instance());
 567          $this->setAdminUser();
 568  
 569          // Exercise SUT.
 570          $this->testpage->set_other_editing_capability('moodle/course:manageactivities');
 571          // Validated.
 572          $actualcaps = $this->testpage->all_editing_caps();
 573          $expectedcaps = array('moodle/course:manageactivities', 'moodle/site:manageblocks');
 574          $this->assertEquals(array_values($expectedcaps), array_values($actualcaps));
 575      }
 576  
 577      public function test_other_editing_caps() {
 578          $this->testpage->set_context(context_system::instance());
 579          $this->setAdminUser();
 580  
 581          // Exercise SUT.
 582          $this->testpage->set_other_editing_capability(array('moodle/course:manageactivities', 'moodle/site:other'));
 583          // Validated.
 584          $actualcaps = $this->testpage->all_editing_caps();
 585          $expectedcaps = array('moodle/course:manageactivities', 'moodle/site:other', 'moodle/site:manageblocks');
 586          $this->assertEquals(array_values($expectedcaps), array_values($actualcaps));
 587      }
 588  
 589      /**
 590       * Test getting a renderer.
 591       */
 592      public function test_get_renderer() {
 593          global $OUTPUT, $PAGE;
 594          $oldoutput = $OUTPUT;
 595          $oldpage = $PAGE;
 596          $PAGE = $this->testpage;
 597  
 598          $this->testpage->set_pagelayout('standard');
 599          $this->assertEquals('standard', $this->testpage->pagelayout);
 600          // Initialise theme and output for the next tests.
 601          $this->testpage->initialise_theme_and_output();
 602          // Check the generated $OUTPUT object is a core renderer.
 603          $this->assertInstanceOf('core_renderer', $OUTPUT);
 604          // Check we can get a core renderer if we explicitly request one (no component).
 605          $this->assertInstanceOf('core_renderer', $this->testpage->get_renderer('core'));
 606          // Check we get a CLI renderer if we request a maintenance renderer. The CLI target should take precedence.
 607          $this->assertInstanceOf('core_renderer_cli',
 608              $this->testpage->get_renderer('core', null, RENDERER_TARGET_MAINTENANCE));
 609  
 610          // Check we can get a coures renderer if we explicitly request one (valid component).
 611          $this->assertInstanceOf('core_course_renderer', $this->testpage->get_renderer('core', 'course'));
 612  
 613          // Check a properly invalid component.
 614          try {
 615              $this->testpage->get_renderer('core', 'monkeys');
 616              $this->fail('Request for renderer with invalid component didn\'t throw expected exception.');
 617          } catch (coding_exception $exception) {
 618              $this->assertEquals('monkeys', $exception->debuginfo);
 619          }
 620  
 621          $PAGE = $oldpage;
 622          $OUTPUT = $oldoutput;
 623      }
 624  
 625      /**
 626       * Tests getting a renderer with a maintenance layout.
 627       *
 628       * This layout has special hacks in place in order to deliver a "maintenance" renderer.
 629       */
 630      public function test_get_renderer_maintenance() {
 631          global $OUTPUT, $PAGE;
 632          $oldoutput = $OUTPUT;
 633          $oldpage = $PAGE;
 634          $PAGE = $this->testpage;
 635  
 636          $this->testpage->set_pagelayout('maintenance');
 637          $this->assertEquals('maintenance', $this->testpage->pagelayout);
 638          // Initialise theme and output for the next tests.
 639          $this->testpage->initialise_theme_and_output();
 640          // Check the generated $OUTPUT object is a core cli renderer.
 641          // It shouldn't be maintenance because there the cli target should take greater precedence.
 642          $this->assertInstanceOf('core_renderer_cli', $OUTPUT);
 643          // Check we can get a core renderer if we explicitly request one (no component).
 644          $this->assertInstanceOf('core_renderer', $this->testpage->get_renderer('core'));
 645          // Check we get a CLI renderer if we request a maintenance renderer. The CLI target should take precedence.
 646          $this->assertInstanceOf('core_renderer_cli',
 647              $this->testpage->get_renderer('core', null, RENDERER_TARGET_MAINTENANCE));
 648          // Check we can get a coures renderer if we explicitly request one (valid component).
 649          $this->assertInstanceOf('core_course_renderer', $this->testpage->get_renderer('core', 'course'));
 650  
 651          try {
 652              $this->testpage->get_renderer('core', 'monkeys');
 653              $this->fail('Request for renderer with invalid component didn\'t throw expected exception.');
 654          } catch (coding_exception $exception) {
 655              $this->assertEquals('monkeys', $exception->debuginfo);
 656          }
 657  
 658          $PAGE = $oldpage;
 659          $OUTPUT = $oldoutput;
 660      }
 661  
 662      public function test_render_to_cli() {
 663          global $OUTPUT;
 664  
 665          $footer = $OUTPUT->footer();
 666          $this->assertEmpty($footer, 'cli output does not have a footer.');
 667      }
 668  
 669      /**
 670       * Validate the theme value depending on the user theme and cohorts.
 671       *
 672       * @dataProvider get_user_theme_provider
 673       */
 674      public function test_cohort_get_user_theme($usertheme, $sitetheme, $cohortthemes, $expected) {
 675          global $DB, $PAGE, $USER;
 676  
 677          $this->resetAfterTest();
 678  
 679          // Enable cohort themes.
 680          set_config('allowuserthemes', 1);
 681          set_config('allowcohortthemes', 1);
 682  
 683          $systemctx = context_system::instance();
 684  
 685          set_config('theme', $sitetheme);
 686          // Create user.
 687          $user = $this->getDataGenerator()->create_user(array('theme' => $usertheme));
 688  
 689          // Create cohorts and add user as member.
 690          $cohorts = array();
 691          foreach ($cohortthemes as $cohorttheme) {
 692              $cohort = $this->getDataGenerator()->create_cohort(array('contextid' => $systemctx->id, 'name' => 'Cohort',
 693                  'idnumber' => '', 'description' => '', 'theme' => $cohorttheme));
 694              $cohorts[] = $cohort;
 695              cohort_add_member($cohort->id, $user->id);
 696          }
 697  
 698          // Get the theme and compare to the expected.
 699          $this->setUser($user);
 700  
 701          // Initialise user theme.
 702          $USER = get_complete_user_data('id', $user->id);
 703  
 704          // Initialise site theme.
 705          $PAGE->reset_theme_and_output();
 706          $PAGE->initialise_theme_and_output();
 707          $result = $PAGE->theme->name;
 708          $this->assertEquals($expected, $result);
 709      }
 710  
 711      /**
 712       * Some user cases for validating the expected theme depending on the cohorts, site and user values.
 713       *
 714       * The result is an array of:
 715       *     'User case description' => [
 716       *      'usertheme' => '', // User theme.
 717       *      'sitetheme' => '', // Site theme.
 718       *      'cohorts' => [],   // Cohort themes.
 719       *      'expected' => '',  // Expected value returned by cohort_get_user_cohort_theme.
 720       *    ]
 721       *
 722       * @return array
 723       */
 724      public function get_user_theme_provider() {
 725          return [
 726              'User not a member of any cohort' => [
 727                  'usertheme' => '',
 728                  'sitetheme' => 'boost',
 729                  'cohorts' => [],
 730                  'expected' => 'boost',
 731              ],
 732              'User member of one cohort which has a theme set' => [
 733                  'usertheme' => '',
 734                  'sitetheme' => 'boost',
 735                  'cohorts' => [
 736                      'classic',
 737                  ],
 738                  'expected' => 'classic',
 739              ],
 740              'User member of one cohort which has a theme set, and one without a theme' => [
 741                  'usertheme' => '',
 742                  'sitetheme' => 'boost',
 743                  'cohorts' => [
 744                      'classic',
 745                      '',
 746                  ],
 747                  'expected' => 'classic',
 748              ],
 749              'User member of one cohort which has a theme set, and one with a different theme' => [
 750                  'usertheme' => '',
 751                  'sitetheme' => 'boost',
 752                  'cohorts' => [
 753                      'classic',
 754                      'someother',
 755                  ],
 756                  'expected' => 'boost',
 757              ],
 758              'User with a theme but not a member of any cohort' => [
 759                  'usertheme' => 'classic',
 760                  'sitetheme' => 'boost',
 761                  'cohorts' => [],
 762                  'expected' => 'classic',
 763              ],
 764              'User with a theme and member of one cohort which has a theme set' => [
 765                  'usertheme' => 'classic',
 766                  'sitetheme' => 'boost',
 767                  'cohorts' => [
 768                      'boost',
 769                  ],
 770                  'expected' => 'classic',
 771              ],
 772          ];
 773      }
 774  }
 775  
 776  /**
 777   * Test-specific subclass to make some protected things public.
 778   */
 779  class testable_moodle_page extends moodle_page {
 780      public function initialise_default_pagetype($script = null) {
 781          parent::initialise_default_pagetype($script);
 782      }
 783      public function url_to_class_name($url) {
 784          return parent::url_to_class_name($url);
 785      }
 786      public function all_editing_caps() {
 787          return parent::all_editing_caps();
 788      }
 789  }