moodle/moodle
3
0
Fork 0
mirror of https://github.com/moodle/moodle.git synced 2025-08-08 02:16:41 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

MDL-50346 core: Allow sub-directories in template names

Browse source
This commit is contained in:
Andrew Nicols 2019-07-24 09:31:17 +08:00
parent 414eca8923
commit 0261d1effa
15 changed files with 209 additions and 64 deletions
Download patch file Download diff file Expand all files Collapse all files

192
lib/tests/mustache_template_finder_test.php
View file

@ -33,66 +33,168 @@ use core\output\mustache_template_finder;
*/
class core_output_mustache_template_finder_testcase extends advanced_testcase {
public function test_get_template_directories_for_component() {
/**
* Data provider which reutrns a set of valid template directories to be used when testing
* get_template_directories_for_component.
*
* @return array
*/
public function valid_template_directories_provider(): array {
return [
'plugin: mod_assign' => [
'component' => 'mod_assign',
'theme' => '',
'paths' => [
'theme/boost/templates/mod_assign/',
'mod/assign/templates/'
],
],
'plugin: mod_assign with classic' => [
'component' => 'mod_assign',
'theme' => 'classic',
'paths' => [
'theme/classic/templates/mod_assign/',
'theme/boost/templates/mod_assign/',
'mod/assign/templates/'
],
],
'subsystem: core_user' => [
'component' => 'core_user',
'theme' => 'classic',
'paths' => [
'theme/classic/templates/core_user/',
'theme/boost/templates/core_user/',
'user/templates/'
],
],
'core' => [
'component' => 'core',
'theme' => 'classic',
'paths' => [
'theme/classic/templates/core/',
'theme/boost/templates/core/',
'lib/templates/'
],
],
];
}
/**
* Tests for get_template_directories_for_component.
*
* @dataProvider valid_template_directories_provider
* @param string $component
* @param string $theme
* @param array $paths
*/
public function test_get_template_directories_for_component(string $component, string $theme, array $paths): void {
global $CFG;
// Test a plugin.
$dirs = mustache_template_finder::get_template_directories_for_component('mod_assign', 'classic');
$dirs = mustache_template_finder::get_template_directories_for_component($component, $theme, $paths);
$correct = array(
'theme/classic/templates/mod_assign/',
'theme/boost/templates/mod_assign/',
'mod/assign/templates/'
);
foreach ($dirs as $index => $dir) {
$this->assertSame($dir, $CFG->dirroot . '/' . $correct[$index]);
}
// Test a subsystem.
$dirs = mustache_template_finder::get_template_directories_for_component('core_user', 'classic');
$correct = array_map(function($path) use ($CFG) {
return implode('/', [$CFG->dirroot, $path]);
}, $paths);
$correct = array(
'theme/classic/templates/core_user/',
'theme/boost/templates/core_user/',
'user/templates/'
);
foreach ($dirs as $index => $dir) {
$this->assertSame($dir, $CFG->dirroot . '/' . $correct[$index]);
}
// Test core.
$dirs = mustache_template_finder::get_template_directories_for_component('core', 'classic');
$correct = array(
'theme/classic/templates/core/',
'theme/boost/templates/core/',
'lib/templates/'
);
foreach ($dirs as $index => $dir) {
$this->assertSame($dir, $CFG->dirroot . '/' . $correct[$index]);
}
return;
$this->assertEquals($correct, $dirs);
}
/**
* Tests for get_template_directories_for_component when dealing with an invalid component.
*
* @expectedException coding_exception
*/
public function test_invalid_get_template_directories_for_component() {
public function test_invalid_component_get_template_directories_for_component() {
// Test something invalid.
$dirs = mustache_template_finder::get_template_directories_for_component('octopus', 'classic');
}
public function test_get_template_filepath() {
global $CFG;
$filename = mustache_template_finder::get_template_filepath('core/pix_icon', 'classic');
$correct = $CFG->dirroot . '/lib/templates/pix_icon.mustache';
$this->assertSame($correct, $filename);
mustache_template_finder::get_template_directories_for_component('octopus', 'classic');
}
/**
* Data provider which reutrns a set of valid template directories to be used when testing
* get_template_directories_for_component.
*
* @return array
*/
public function valid_template_filepath_provider(): array {
return [
'Standard core template' => [
'template' => 'core/modal',
'theme' => '',
'location' => 'lib/templates/modal.mustache',
],
'Template overridden by theme' => [
'template' => 'core_form/element-float-inline',
'theme' => '',
'location' => 'theme/boost/templates/core_form/element-float-inline.mustache',
],
'Template overridden by theme but child theme selected' => [
'template' => 'core_form/element-float-inline',
'theme' => 'classic',
'location' => 'theme/boost/templates/core_form/element-float-inline.mustache',
],
'Template overridden by child theme' => [
'template' => 'core/full_header',
'theme' => 'classic',
'location' => 'theme/classic/templates/core/full_header.mustache',
],
'Template overridden by child theme but tested against defualt theme' => [
'template' => 'core/full_header',
'theme' => '',
'location' => 'lib/templates/full_header.mustache',
],
'Standard plugin template' => [
'template' => 'mod_assign/grading_panel',
'theme' => '',
'location' => 'mod/assign/templates/grading_panel.mustache',
],
'Subsystem template' => [
'template' => 'core_user/status_details',
'theme' => '',
'location' => 'user/templates/status_details.mustache',
],
'Theme own template' => [
'template' => 'theme_classic/columns',
'theme' => '',
'location' => 'theme/classic/templates/columns.mustache',
],
'Theme overridden template against that theme' => [
'template' => 'theme_classic/navbar',
'theme' => 'classic',
'location' => 'theme/classic/templates/navbar.mustache',
],
// Note: This one looks strange but is correct. It is legitimate to request theme's component template in
// the context of another theme. For example, this is used by child themes making use of parent theme
// templates.
'Theme overridden template against the default theme' => [
'template' => 'theme_classic/navbar',
'theme' => '',
'location' => 'theme/classic/templates/navbar.mustache',
],
];
}
/**
* Tests for get_template_filepath.
*
* @dataProvider valid_template_filepath_provider
* @param string $template
* @param string $theme
* @param string $location
*/
public function test_get_template_filepath(string $template, string $theme, string $location) {
global $CFG;
$filename = mustache_template_finder::get_template_filepath($template, $theme);
$this->assertEquals("{$CFG->dirroot}/{$location}", $filename);
}
/**
* Tests for get_template_filepath when dealing with an invalid component.
*
* @expectedException moodle_exception
*/
public function test_invalid_get_template_filepath() {
// Test something invalid.
$dirs = mustache_template_finder::get_template_filepath('core/octopus', 'classic');
public function test_invalid_component_get_template_filepath() {
mustache_template_finder::get_template_filepath('core/octopus', 'classic');
}
}